序列对象结构

序列对象结构是从序列资源检索到的结构的名称。在运行时,序列的所有数据存储在此结构中,并由在房间中创建的序列的任何元素引用。这意味着,如果修改此结构(或其任何嵌套结构内)中的任何变量,原始序列将改变(直到游戏关闭并重新打开),并且其任何现有的序列元素将受到影响。

结构将具有以下可更改的属性:

序列对象结构
变量类型描述
nameString这是序列的字符串名称,您可以根据需要获取或设置此值。请注意,使用函数sequence_create()创建的序列将没有名称,这将只是空字符串""。
loopmode顺序播放模式常数这是序列对象的播放模式,可以获取或设置。这可以是下表中显示的任一常数。
playbackSpeedReal这指定了序列的播放速度,根据playSpeedType(见下文),序列的播放速度可以解释为每秒帧或每帧帧。您可以获取或设置此值。
playbackSpeedTypeSprite Speed Constant这指定了如何解释PlaybackSpeed,您可以获取或设置此值。
lengthReal以帧为单位的序列长度。您可以获取或设置此值,但请注意,如果引用此序列的序列实例将其播放头设置为超过新长度,则使序列更短可能会导致问题。
volumeReal这是一个从0到1的标量值,用于缩放序列中所有音轨的音量。您可以获取或设置此值,它将修改所有音轨的全局音频输出-例如,如果您有一个音量为0.8的音轨,然后将"序列音量"属性设置为0.5,则该音轨的最终音量将为0.4。
xoriginReal这是沿X轴的序列的原点。
yoriginReal这是沿Y轴的序列的原点。
messageEventKeyframesArray of Sequence Keyframe Structs这允许访问序列的消息事件关键帧。可以获取或设置这些消息事件,当获得此属性时,将返回关键帧结构数组,要设置属性,您应提供关键帧结构数组。有关更多信息,请参见序列事件和时刻上的页面。
momentKeyframesArray of Sequence Keyframe Structs这允许访问序列的瞬间事件关键帧。可以获取或设置这些瞬间事件,当获得此属性时,将返回关键帧结构数组,要设置该属性,您应提供关键帧结构数组。有关更多信息,请参见序列事件和时刻上的页面。
tracksArray of Sequence Track Structs这允许访问序列顶层上的资源轨迹列表。可以获取或设置此属性,并且当获得此属性时,将返回轨迹结构数组,要设置属性,应提供一个轨迹结构数组。有关更多信息,请参阅轨道结构一节。

 

loopMode可以是以下任一常量:

顺序播放模式常数
常量描述
seqplay_oneshotThe sequence will play once then stop when finished.0
seqplay_loopThe sequence will loop, with the playhead going back to the start when it reaches the end of the playback region.1
seqplay_pingpongThe sequence will loop, with the playhead reversing direction when it reaches the end of the playback region.2


 

备注

请注意,如果要访问在资源浏览器中创建的序列的属性,必须先调用资源索引上的函数sequence_get()来检索序列对象结构。另请注意,对此序列结构所做的任何更改将意味着此序列资源的所有其他实例也将具有这些更改,只要游戏正在运行,即使您调用game_restart()函数,它们也会得到维护。