MIDI Tools

MIDI Tools

MIDI Tools 提供三个独立的 MIDI 节点：通道拆分、16×16 矩阵和 SF2/SFZ 加载器，位于节点库的「Midi Tools」分类。

MIDI 通道拆分

按 MIDI 通道把输入分发到 16 个输出。

• 端口：MIDI_IN → MIDI_OUT_01 到 MIDI_OUT_16。
• 保留原始通道号；系统消息会广播到所有输出。
• 没有业务窗口，参数面板只提供「客户端名称」和「应用」。

MIDI 矩阵

16×16 的端口路由矩阵，默认对角线连通（输入 1 → 输出 1）。

• 行是输入端口，列是输出端口；点击「1→1」这样的交点切换通断。
• 保留原始 MIDI 通道号，不做通道转换。
• 端口：MIDI_IN_01 到 MIDI_IN_16 → MIDI_OUT_01 到 MIDI_OUT_16。
• 同一音高、同一通道的多个源合流后无法再区分。

SF2/SFZ 加载器

16 通道的 SF2/SFZ 合成音源，MIDI_IN 输入，输出为 OUT_L / OUT_R。

操作步骤：

1. 双击节点打开加载器窗口。
2. 点「导入」选择 SF2 或 SFZ 文件；浏览列表不会切换演奏音色。
3. 选中条目后点「加载所选资源」。
4. SFZ 可设置 Bank MSB / LSB / Program（0–127）。
5. 在 16 个通道中设置当前演奏音色、增益、静音、独奏和电平。
6. 用「主输出」调整整体增益。

窗口还会显示资源状态（未加载、就绪、文件缺失、加载失败、准备中、没有匹配音色）和诊断计数（丢弃、溢出、淘汰、不支持）。

资源预算在「全局设置」中配置，默认 64 MiB（SF2 按文件大小约 8 倍预留）。音色文件需要自备，不会嵌入工程。

保存

• 拆分：客户端名称。
• 矩阵：256 个路由位。
• SF2/SFZ：资源路径、映射、16 通道混音和主输出。
• 工程不会保存正在发声的音符。

注意

• SF2/SFZ 加载器是 JackOnly 节点，没有虚拟（VIRT）模式，不能放进子图。
• 音色文件放在工程外部；移动或删除文件后，工程再次打开会显示「文件缺失」。