关键帧数据结构

为轨迹定义关键帧结构时,还需要定义与其关联的数据。这由不同的通道组成,其中每个通道仅是关键帧数据结构。根据要设置关键帧数据的曲目类型,可以为通道指定特定类型的数据。

关键帧数据结构包含以下变量:

序列关键帧数据结构
变量类型描述
channelReal这是应用关键帧数据的通道。这是一个从0开始的正整数值,值得注意的是,在为"位置"或"缩放"关键帧创建参数轨迹时,您需要使用非常特定的通道值。这些是:通道0是X位置或X比例,通道1是Y位置或Y比例。
spriteIndexSprite Asset用于轨迹的精灵资源的索引。此属性仅适用于类型为SeqTrackType_Graphic的轨道,您可以获取或设置它。
soundIndexSound Asset要用于音轨的音频资源的索引。此属性仅对类型为SeqTrackType_Audio的轨道可用,您可以获取或设置它。
playbackMode序列音频键常数声音的播放模式。此属性仅对类型为SeqTrackType_Audio的轨道可用,您可以获取或设置它。属性应该是下表中给出的常量之一。
curveAnimation Curve Struct此属性需要动画曲线结构(有关详细信息,请参见此处),并且仅适用于类型为seqtracktype_real的轨迹。 如果没有使用曲线结构,则该属性的值为-1。
valueReal此属性只是一个与关键帧数据通道关联的值,并且仅在未提供曲线结构时可用于类型seqtracktype_real的轨迹。例如,如果放置在"位置"参数轨道内,则可以是轨迹的X或Y位置。
colourArray of Reals此属性返回(或需要,如果已设置)数组,用于格式为[A,R,G,B]的关键帧的颜色值。这仅适用于类型为seqtracktype_colour的曲目。 注意,每个组件的值应表示为0和1之间,其中0对应于十六进制值# 00,1对应于十六进制值# FF(0- 255,如序列编辑器中颜色轨迹的颜色选择器所示)。
sequenceSequence Object Struct此属性将返回(或需要(如果已设置))序列对象结构,并且仅适用于类型为seqtracktype_sequence的轨迹。
objectIndexObject Asset此属性将返回(或需要(如果已设置))对象索引,并且仅适用于类型为seqtracktype_instance的轨迹。
eventsArray of Strings此属性允许访问与关键帧数据结构关联的事件广播消息。可以获取或设置此属性,获取时返回字符串数组,设置时应指定字符串数组。有关事件的更多信息,请参阅"事件和时刻序列"部分。 此属性仅适用于类型seqtracktype_message的轨迹。
eventMethod此属性将返回(或可以设置为)与关键帧数据结构关联的方法。如果未指定方法或希望删除该方法,则属性应为-1。此属性仅适用于类型seqtracktype_moment的轨迹。
Any additional variables listed in the table(s) below

 

playbackMode变量可以是以下常量之一:

序列音频键常数
常量描述
seqaudiokey_loopThe sound will loop when played.0
seqaudiokey_oneshotThe sound will only play once then stop.1

 

文本跟踪数据

如果分配给文本轨道(seqTrackType_text),则该结构将包含以下附加变量:

序列关键帧数据结构
变量类型描述
textString这是在轨道上绘制的文本字符串。
wrapBoolean这是一个布尔值,指示文本是否应该换行(true)或不换行(false)。
alignmentH序列文本对齐常量这是文本的水平对齐方式,将是下面给出的序列文本对齐常数之一。
alignmentV序列文本对齐常量这是文本的垂直对齐,将是下面给出的序列文本对齐常数之一。
fontIndexFont Asset这是文本音轨使用的字体资源

 

alignmentH 可以是以下任何常量:

序列文本对齐常量 (alignmentH)
常量描述
seqtextkey_leftThe text will be aligned to the left of the frame
seqtextkey_rightThe text will be aligned to the right of the frame
seqtextkey_centerThe text will be centred horizontally within the frame
seqtextkey_justifyThe text will be justified within the frame

 

alignmentV 可以是以下任何常量:

序列文本对齐常量 (alignmentV)
常量描述
seqtextkey_topThe text will be aligned to the top of the frame
seqtextkey_bottomThe text will be aligned to the bottom of the frame
seqtextkey_middleThe text will be centred vertically within the frame