Skip to main content

TimeAxis

时间轴​

一个与工程范围相当的对象，用来存储速度和时间标记。它还能处理物理时间（例如:秒）和音乐时间（例如:¼拍， blicks）之间的转换。

扩展​

方法​

addMeasureMark​

addMeasureMark(measure, nomin, denom)

在 measure 处 (一个小节序号) 插入一个 nomin / denom 拍子标记。如果在 measure 处拍子标记已经存在，则将更新信息。

参数​

参数名类型说明
measure数字
nomin数字译者注：此处意思为 numerator (分子)，但似乎没有 nomin 表示分子的表达，可能此处原文有疏漏
denom数字译者注：即 denominator ，分母

addTempoMark​

addTempoMark(b, bpm)

在 b 处（以 blicks 为单位）插入一个速度为每分钟 bpm 拍的速度标记。如果该处已存在速度标记，则更新。

参数​

参数名类型说明
b数字
bpm数字

clone​

clone() → {TimeAxis}

深复制当前对象。

返回：​

类型：时间轴

getAllMeasureMarks​

getAllMeasureMarks() → {array}

获得所有该 时间轴 内的拍子标记。请参阅时间轴 - getMeasureMarkAt.

返回：​

一个 对象 组

类型：组

getAllTempoMarks​

getAllTempoMarks() → {array}

获得所有该 时间轴 内的速度标记。请参阅时间轴 - getTempoMarkAt.

返回：​

一个 对象 组

类型：组

getBlickFromSeconds​

getBlickFromSeconds(t) → {number}

将物理时间 t（秒）转化为音乐时间 (blicks)。

参数​

参数名类型说明
t数字

返回：​

类型：数字

getIndexInParent​

getIndexInParent() → {number}

继承自: 嵌套对象 - getIndexInParent

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

返回：​

类型：数字

getMeasureAt​

getMeasureAt(b) → {number}

获得 b (blicks) 处的拍子标记。

参数​

参数名类型说明
b数字

返回：​

类型：数字

getMeasureMarkAt​

getMeasureMarkAt(measureNumber) → {object}

在 measureNumber 小节处获取拍子标记。

返回的对象包含以下属性。

  • position: 数字 标记放置处的小节数。
  • positionBlick: 数字 标记位置 (以 blicks 为单位)
  • numerator: 数字 分子（例如，如果是 3/4 时间标记，则为 3）
  • denominator: 数字 分母（例如，如果它是 3/4 时间标记，则为 4）

参数​

参数名类型说明
measureNumber数字

返回：​

类型：object

getMeasureMarkAtBlick​

getMeasureMarkAtBlick(b) → {object}

获取在位置 b (blicks) 处有效的拍子标记。有关返回的对象，请参见 时间轴 - getMeasureMarkAt.

参数​

参数名类型说明
b数字

返回：​

类型：object

getParent​

getParent() → {NestedObject|undefined}

继承自: 嵌套对象 - getParent

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

返回：​

类型：嵌套对象 | undefined

getSecondsFromBlick​

getSecondsFromBlick(b) → {number}

将音乐时间 b (blicks) 转化为物理时间（秒）。

参数​

参数名类型说明
b数字

返回：​

类型：数字

getTempoMarkAt​

getTempoMarkAt(b) → {TempoMark}

获得 b (blicks) 处的有效速度标记。

返回的对象包含以下属性。

  • position: 数字 速度标记的位置(以 blicks 为单位)。
  • positionSeconds: 数字速度标记的位置(以秒为单位)。
  • bpm: 数字 在此速度标记和下一个速度标记之间有效的每分钟节拍值

参数​

参数名类型说明
b数字

返回：​

类型：TempoMark

isMemoryManaged​

isMemoryManaged() → {boolean}

继承自: 嵌套对象 - isMemoryManaged

检查当前对象是否开启了内存管理（即脚本环境收集的垃圾）。

返回：​

类型：布尔

removeMeasureMark​

removeMeasureMark(measure) → {boolean}

删除小节数为 measure 处的拍子标记。如果在此处拍子标记存在，则返回 true 。

参数​

参数名类型说明
measure数字

返回：​

类型：布尔

removeTempoMark​

removeTempoMark(b) → {boolean}

删除 b (blicks) 处的速度标记。如果在此处速度标记存在，则返回 true 。

参数​

参数名类型说明
b数字

返回：​

类型：布尔