为轨迹定义关键帧结构时,还需要定义与其关联的数据。这由不同的通道组成,其中每个通道仅是关键帧数据结构。根据要设置关键帧数据的曲目类型,可以为通道指定特定类型的数据。
关键帧数据结构包含以下变量:
序列关键帧数据结构 | ||
---|---|---|
变量 | 类型 | 描述 |
channel | Real | 这是应用关键帧数据的通道。这是一个从0开始的正整数值,值得注意的是,在为"位置"或"缩放"关键帧创建参数轨迹时,您需要使用非常特定的通道值。这些是:通道0是X位置或X比例,通道1是Y位置或Y比例。 |
spriteIndex | Sprite Asset | 用于轨迹的精灵资源的索引。此属性仅适用于类型为SeqTrackType_Graphic的轨道,您可以获取或设置它。 |
soundIndex | Sound Asset | 要用于音轨的音频资源的索引。此属性仅对类型为SeqTrackType_Audio的轨道可用,您可以获取或设置它。 |
playbackMode | 序列音频键常数 | 声音的播放模式。此属性仅对类型为SeqTrackType_Audio的轨道可用,您可以获取或设置它。属性应该是下表中给出的常量之一。 |
curve | Animation Curve Struct | 此属性需要动画曲线结构(有关详细信息,请参见此处),并且仅适用于类型为seqtracktype_real的轨迹。 如果没有使用曲线结构,则该属性的值为-1。 |
value | Real | 此属性只是一个与关键帧数据通道关联的值,并且仅在未提供曲线结构时可用于类型seqtracktype_real的轨迹。例如,如果放置在"位置"参数轨道内,则可以是轨迹的X或Y位置。 |
colour | Array of Reals | 此属性返回(或需要,如果已设置)数组,用于格式为[A,R,G,B]的关键帧的颜色值。这仅适用于类型为seqtracktype_colour的曲目。 注意,每个组件的值应表示为0和1之间,其中0对应于十六进制值# 00,1对应于十六进制值# FF(0- 255,如序列编辑器中颜色轨迹的颜色选择器所示)。 |
sequence | Sequence Object Struct | 此属性将返回(或需要(如果已设置))序列对象结构,并且仅适用于类型为seqtracktype_sequence的轨迹。 |
objectIndex | Object Asset | 此属性将返回(或需要(如果已设置))对象索引,并且仅适用于类型为seqtracktype_instance的轨迹。 |
events | Array of Strings | 此属性允许访问与关键帧数据结构关联的事件和广播消息。可以获取或设置此属性,获取时返回字符串数组,设置时应指定字符串数组。有关事件的更多信息,请参阅"事件和时刻序列"部分。 此属性仅适用于类型seqtracktype_message的轨迹。 |
event | Method | 此属性将返回(或可以设置为)与关键帧数据结构关联的方法。如果未指定方法或希望删除该方法,则属性应为-1。此属性仅适用于类型seqtracktype_moment的轨迹。 |
Any additional variables listed in the table(s) below |
playbackMode变量可以是以下常量之一:
序列音频键常数 | ||
---|---|---|
常量 | 描述 | 值 |
seqaudiokey_loop | The sound will loop when played. | 0 |
seqaudiokey_oneshot | The sound will only play once then stop. | 1 |
如果分配给文本轨道(seqTrackType_text),则该结构将包含以下附加变量:
序列关键帧数据结构 | ||
---|---|---|
变量 | 类型 | 描述 |
text | String | 这是在轨道上绘制的文本字符串。 |
wrap | Boolean | 这是一个布尔值,指示文本是否应该换行(true)或不换行(false)。 |
alignmentH | 序列文本对齐常量 | 这是文本的水平对齐方式,将是下面给出的序列文本对齐常数之一。 |
alignmentV | 序列文本对齐常量 | 这是文本的垂直对齐,将是下面给出的序列文本对齐常数之一。 |
fontIndex | Font Asset | 这是文本音轨使用的字体资源。 |
alignmentH 可以是以下任何常量:
序列文本对齐常量 (alignmentH) | |
---|---|
常量 | 描述 |
seqtextkey_left | The text will be aligned to the left of the frame |
seqtextkey_right | The text will be aligned to the right of the frame |
seqtextkey_center | The text will be centred horizontally within the frame |
seqtextkey_justify | The text will be justified within the frame |
alignmentV 可以是以下任何常量:
序列文本对齐常量 (alignmentV) | |
---|---|
常量 | 描述 |
seqtextkey_top | The text will be aligned to the top of the frame |
seqtextkey_bottom | The text will be aligned to the bottom of the frame |
seqtextkey_middle | The text will be centred vertically within the frame |