模块 lib.lattice
基于单个快速“超级时钟”创建 sprocket 网格的模块
norns 脚本参考 有 此模块的示例。
信息：
- 发布版本：v2.0
- 作者：tyleretters & ezra & zack & rylee
函数
| new ([args]) | 实例化一个新的网格 |
| start () | 开始运行网格 |
| reset () | 重置 norns 时钟而不重新开始网格 |
| hard_restart () | 重置 norns 时钟并重新开始网格 |
| stop () | 停止网格 |
| toggle () | 切换网格 |
| destroy () | 销毁网格 |
| set_meter (_) | set_meter 已弃用 |
| auto_pulse (s) | 使用 norns 时钟进行脉冲 |
| pulse () | 通过脉冲，手动调用此方法如果网格.auto = false |
| new_sprocket ([args]) | 工厂方法，将新 sprocket 添加到此网格 |
| new_pattern (args) | new_pattern 已弃用 |
| order_sprockets () | "私有"方法，保持 sprocket 编号顺序，用于脉冲时使用 |
| Sprocket:new (args) | "私有"方法，实例化一个新的 sprocket，仅由 Lattice:new_sprocket() 调用 |
| Sprocket:start () | 开始 sprocket |
| Sprocket:stop () | 停止 sprocket |
| Sprocket:toggle () | 切换 sprocket |
| Sprocket:destroy () | 标记 sprocket 为销毁 |
| Sprocket:set_division (n) | 设置 sprocket 的 division |
| Sprocket:set_action (fn) | 设置 sprocket 的动作 |
| Sprocket:set_swing (swing) | 设置 sprocket 的 swing |
| Sprocket:set_delay (delay) | 设置 sprocket 的延迟 |
函数
- new ([args])
-
实例化一个新的网格
参数:
- args table 可选的命名属性是： - "auto" (boolean) 关闭 norns 时钟的 "auto" 脉冲，默认为 true - "ppqn" (number) 此超级时钟每个四分音符的脉冲数，默认为 96 (optional)
返回:
-
table
一个新的网格
- start ()
- 开始运行网格
- reset ()
- 重置 norns 时钟而不重新开始网格
- hard_restart ()
- 重置 norns 时钟并重新开始网格
- stop ()
- 停止网格
- toggle ()
- 切换网格
- destroy ()
- 销毁网格
- set_meter (_)
-
set_meter 已弃用
参数:
- _
- auto_pulse (s)
-
使用 norns 时钟进行脉冲
参数:
- s table 此网格
- pulse ()
- 通过脉冲，手动调用此方法如果网格.auto = false
- new_sprocket ([args])
-
工厂方法，将新 sprocket 添加到此网格
参数:
- args
table
可选的命名属性是：
- "action" (function) 在每个步骤中调用（网格.transport 作为参数传递），默认为空操作
- "division" (number) sprocket 的 division，默认为 1/4
- "enabled" (boolean) 此 sprocket 是否启用，默认为 true
- "swing" (number) swing 的百分比 (0 - 100%)，默认为 50
- "delay" (number) 延迟的量，作为 division 的分数 (0.0 - 1.0)，默认为 0
- "order" (number) 指定此网格在行中的位置，从 1 到 5，先低，默认为 3
返回:
-
table
一个新的 sprocket
- args
table
- new_pattern (args)
-
new_pattern 已弃用
参数:
- args
- order_sprockets ()
- "私有"方法，保持 sprocket 编号顺序，用于脉冲时使用
- Sprocket:new (args)
-
"私有"方法，实例化一个新的 sprocket，仅由 Lattice:new_sprocket() 调用
参数:
- args
返回:
-
table
a new sprocket
- Sprocket:start ()
- 开始 sprocket
- Sprocket:stop ()
- 停止 sprocket
- Sprocket:toggle ()
- 切换 sprocket
- Sprocket:destroy ()
- 标记 sprocket 为销毁
- Sprocket:set_division (n)
-
设置 sprocket 的 division
参数:
- n number sprocket 的 division
- Sprocket:set_action (fn)
-
设置 sprocket 的动作
参数:
- fn 动作
- Sprocket:set_swing (swing)
-
设置 sprocket 的 swing
参数:
- swing swing 的值 (0-100%)
- Sprocket:set_delay (delay)
-
设置 sprocket 的延迟
参数:
- delay 延迟的量，作为 division 的分数 (0.0 - 1.0)