Skip to main content

Track

轨道​

轨道 (Track) 是 音符组引用 的集合。一个 轨道 也包括了 音符组 ，它是音轨的主要组。音轨内的第一个 音符组引用 始终指向主要组。

轨道 默认的声库属性由第一个 音符组引用 决定（即主要组）。

扩展​

方法​

addGroupReference​

addGroupReference(group) → {number}

向该 轨道 添加一个 音符组引用 ，并返回添加组的索引。它按照起始位置对所有组进行排序。

参数​

参数名类型说明
group音符组引用

返回：​

类型：数

clone​

clone() → {Track}

深复制当前对象。

返回：​

类型：轨道

getDisplayColor​

getDisplayColor() → {string}

获得轨道的颜色（十六进制字符串）

返回：​

类型：字符串

getDisplayOrder​

getDisplayOrder() → {number}

获取父 工程 中轨道的显示顺序。轨道的显示顺序可以与其储存的索引不同。在编曲区界面中显示的轨道顺序总是基于显示顺序。

返回：​

类型：数

getDuration​

getDuration() → {number}

获取 轨道 的持续时间，被定义为最后一个 音符组引用 结束的位置，以块 (blicks) 为单位，

返回：​

类型：数

getGroupReference​

getGroupReference(index) → {NoteGroupReference}

获取第 index 个 音符组引用 索引。第一个是主组，后跟项目库中引用了 音符组的组。这些组按起始位置升序排序。

参数​

参数名类型说明
index数字

返回：​

类型：音符组引用

getIndexInParent​

getIndexInParent() → {number}

继承自：嵌套对象 - getIndexInParent

获取当前对象在其父对象中的索引。 在 Lua 中，这个索引从 1 开始。在 JavaScript 中，这个索引从 0 开始。

返回：​

类型：数

getName​

getName() → {string}

获得轨道名称。

返回：​

类型：字符串

getNumGroups​

getNumGroups() → {number}

获取该 轨道 中的 音符组引用 的数量，包括主要组。

返回：​

类型：数

getParent​

getParent() → {NestedObject|undefined}

继承自：嵌套对象 - getParent

获取父 嵌套对象 。如果当前对象未附加到父对象，则返回 undefined 。

返回：​

类型：嵌套对象 | undefined

getParent​

isBounced() → {boolean}

用于决定是否导出到文件，它显示在"渲染面板 - 音轨"中。

返回：​

类型：布尔

isMemoryManaged​

isMemoryManaged() → {boolean}

继承自：嵌套对象 - isMemoryManaged

检测选中的对象是否被内存管理（即脚本环境的垃圾回收）。

返回：​

类型：布尔

removeGroupReference​

removeGroupReference(index)

从 音轨 中移除第 index 个 音符组引用 。

参数​

参数名类型说明
index数字

setBounced​

setBounced(enabled)

设置是否将 轨道 导出到文件。请参阅 轨道 - isBounced。

参数​

参数名类型说明
enabled布尔

setDisplayColor​

setDisplayColor(colorStr)

设置 轨道 的显示颜色。（十六进制字符串）

参数​

参数名类型说明
colorStr字符串

setName​

setName(name)

设置当前 轨道 的名称。

参数​

参数名类型说明
name字符串