模块 clock

时钟协程

norns脚本参考 有此模块的示例。

函数

run (f[, ...]) 使用norns时钟调度器创建并启动协程。
cancel (coro_id) 停止之前使用clock.run启动的协程的执行。
sleep (s) 暂停调用协程的执行并在指定时间后安排恢复。
sync (beat[, offset]) 暂停调用协程的执行并在指定值的下一个同步量子处安排恢复。
set_source (source) 选择同步源。
get_beats () 获取当前节拍时间。
get_tempo () 获取当前速度。
get_beat_sec () 获取当前速度下单个节拍的长度(秒)。

字段

clock.transport.start 时钟传输启动时的静态回调; 用户脚本可以重新定义
clock.transport.stop 时钟传输停止时的静态回调; 用户脚本可以重新定义
tempo_change_handler 通过参数 > 时钟 > 速度调整时钟速度时的静态回调; 用户脚本可以重新定义


函数

run (f[, ...])
使用norns时钟调度器创建并启动协程。

参数:

  • f function 协程主体函数
  • ... 任何额外参数将传递给主体函数 (可选)

返回:

    integer 可用于clock.cancel的协程句柄

另请参阅:

cancel (coro_id)
停止之前使用clock.run启动的协程的执行。

参数:

  • coro_id integer 协程句柄

另请参阅:

sleep (s)
暂停调用协程的执行并在指定时间后安排恢复。 必须从之前使用clock.run启动的协程中调用。

参数:

  • s float 等待的秒数
sync (beat[, offset])
暂停调用协程的执行并在指定值的下一个同步量子处安排恢复。 必须从之前使用clock.run启动的协程中调用。

参数:

  • beat float 同步量子。可以大于1
  • offset float 如果设置,此值将添加到同步量子 (可选)
set_source (source)
选择同步源。

参数:

  • source string "internal"、"midi"或"link"
get_beats ()
获取当前节拍时间。
get_tempo ()
获取当前速度。
get_beat_sec ()
获取当前速度下单个节拍的长度(秒)。

字段

clock.transport.start
时钟传输启动时的静态回调; 用户脚本可以重新定义
clock.transport.stop
时钟传输停止时的静态回调; 用户脚本可以重新定义
tempo_change_handler
通过参数 > 时钟 > 速度调整时钟速度时的静态回调; 用户脚本可以重新定义
  • bpm : 新速度
由 LDoc 1.5.0 生成 最后更新于 2025-04-06 15:35:25