序列实例结构

将序列放置在房间中时,将作为元素放置在层上,并且该元素包含序列实例。 此序列实例的结构中将具有以下属性:

序列实例结构
变量类型描述
sequenceSequence Object Struct这是从中创建序列实例的序列对象结构的 ID(有关详细信息,请参见此处)。您可以获取或设置此结构,从而更改实例所引用的基序列。
headPositionReal这是序列实例的当前播放头位置(以帧为单位)。您可以获取或设置此值,但请注意,将其设置为大于或小于当前定义的播放区域的值将具有不同的效果,具体取决于序列设置的回放类型。有关详细信息,请参见layer_sequence_headpos()
headDirection序列方向常数这是序列实例的当前播放方向。可以使用下表中给出的常量获取或设置此值(请注意,可以使用层函数layer_sequence_get_headdir()layer_sequence_headdir()来获取或设置此值,而无需直接访问该结构)。
speedScaleReal此属性可用于获取或设置播放速度刻度。速度标度为乘数,其中1为默认回放速度,小于1的值将减慢回放速度,大于1的值将加速回放速度,例如:值0.5表示一半回放速度,值2表示双倍回放速度。请注意,可以使用层函数layer_sequence_get_speedscale()layer_sequence_speedscale()获取或设置此值,而无需直接访问该结构。
pausedBoolean您可以检查此属性以查看序列是否已暂停,如果已暂停,则为true,否则为false。这是一个只读属性,但是您可以使用层函数layer_sequence_pause()来暂停播放,并使用layer_sequence_play()\来根据需要再次恢复播放。您还可以使用层函数layer_sequence_is_paused()来检查此属性,而不是直接检查结构中的属性。
finishedBoolean您可以检查此属性以查看某个序列是否已完成播放,如果已播放完毕,则返回true,否则返回false。这是只读属性,仅对于未设置为循环或乒乓的曲目返回true。也可以使用层函数layer_sequence_is_finished()来检查此属性,而不是直接检查结构中的属性。
elementIDSequence Element ID此属性保存 sequence元素的 ID。 此 ID 是与房间编辑器中的层关联的简单标识值,然后可以与相应的层函数一起使用,以查找已指定序列的层或更改某些序列属性,而无需处理该结构。
activeTracksArray of 序列活动跟踪结构s此属性将保存包含序列(图形、序列、音频等)中每个资源轨道的当前状态的信息的"评估"结构数组。这些是顶级轨迹,返回的数组为只读。 对于每个数组条目中返回的资源跟踪结构的内容,请参见以下部分。

 

序列方向常数
常量描述
seqdir_rightThe sequence will play frames in an incremental order from left to right1
seqdir_leftThe sequence will play frames in a decremental order from right to left-1

 

activeTracks 结构体

重要虽然此属性已存在于"序列创建"事件中的序列实例结构中,但仅在第一个"序列开始步骤"事件之后填充有轨迹。因此,首次在此结构中找到值是在序列步长事件的第一次迭代期间。

以下列表包含访问活动跟踪结构时可用的属性(如上面解释的序列实例结构的activeTracks数组中包含的属性)。根据曲目所使用的资源类型,每个资源跟踪结构可以具有以下任何属性(请注意,您可以修改所有这些属性,除非指定为只读),并且返回的所有值都针对当前播放头位置:

序列活动跟踪结构
变量类型描述
matrixMatrix Array这是用于绘制轨迹(精灵、实例和序列轨迹)的变换矩阵。
posxReal资源在序列中沿轨道X轴的当前播放头位置的位置(所有资源)。
posyReal资源在序列中沿轨道Y轴的当前播放头位置的位置(所有资源)。
scalexReal在当前播放头位置("精灵"轨迹,"实例"轨迹与"序列"轨迹),资源在序列中沿轨迹X轴的缩放。
scaleyReal在当前播放头位置("精灵"、"实例"和"序列"轨迹),资源在序列中沿轨迹Y轴的缩放。
xoriginReal轨迹资源的X原点(所有资源)。
yoriginReal轨迹资源的Y原点(所有资源)。
widthReal轨迹(精灵、实例和序列轨迹)资源的宽度(以像素为单位)。
heightReal轨迹(精灵、实例和序列轨迹)资源的高度(以像素为单位)。
imageindexReal资源在序列中当前播放头位置的轨迹上的图像索引(精灵和实例轨迹)。
imagespeedReal资源在当前播放指针位置(精灵与实例轨迹)的序列中的轨迹上的图像速度。
colourMultiplyColour当前播放头位置(精灵、实例和序列曲目)序列中曲目上资源的颜色乘法值。此值为数组,包含4个ARGB值,格式为[A,R,G,B]。请注意,每个组件的值在0和1之间表示,其中0对应于十六进制值# 00,1对应于十六进制值# FF(0- 255,如序列编辑器中多色轨迹的颜色选择器所示)。
soundIndexSound Instance ID在此轨道的发射器 (音轨) 上播放的声音实例的 ID。
emitterIndexAudio Emitter ID属于该音轨的音频发射器的索引(音轨)。
gainReal当前播放头位置(音轨)的音轨增益(音量)。
pitchReal当前播放指针位置的音轨间距(音频音轨)。
particleSystemIndexParticle System Instance此轨迹的粒子系统的ID(粒子系统轨迹)。
frameSizeXReal文本框架(字幕信息)的水平大小。
frameSizeYReal文本框架(字幕信息)的垂直大小。
characterSpacingReal字符间距值(字幕信息)。
lineSpacingReal行距值(字幕信息)。
paragraphSpacingReal段落间距值(字幕信息)。
trackSequence Track Struct此轨道所基于的轨道结构(所有资源,一个只读值)。
parent序列实例结构轨迹的父序列实例ID(所有资源,只读值)。
activeTracksArray of Sequence Track Structs这是资源轨迹包含的每个参数轨迹(所有资源,只读值)的计算结构数组。数组中每个结构的内容在参数轨道结构部分列出。