钢琴卷帘

钢琴卷帘是 Sonic Vein Studio 内置的专用 MIDI 编辑器，以钢琴卷帘网格图形化展示音符。你可在此精细编辑音符与各类非音符事件：力度、弯音、MIDI CC、演奏技法事件、速度、拍号数据。

钢琴卷帘支持两种打开形式：独立窗口，或嵌入工作区下方面板。嵌入下方面板适合同时查看轨道列表并快速调用编辑器功能。

注释

所有编辑操作支持撤销 / 重做；连续画笔绘制、批量多选拖动会合并为单次撤销事务；跨片段批量编辑统一打包为一次撤销。

本编辑器独有双层数据模型：用户层、AI 渲染层。用户编辑会永久覆盖对应位置 AI 生成内容；关闭片段 AI 开关不会删除你手动编辑的数据。

一、钢琴卷帘窗口布局

钢琴卷帘窗口由多个功能区域组成，用于编辑 MIDI 音符、控制事件、演奏技法及相关时间参数。大部分面板均可通过工具栏中的窗口布局按钮显示或隐藏。

1. 顶部工具栏：提供选择工具、铅笔工具、画笔工具、橡皮擦工具、静音工具、剪刀工具，以及播放跟随、网格吸附、网格显示模式和网格划分等功能。

2. 时间标尺：显示小节与节拍位置，并指示当前播放头的位置。

3. 拍号轨：用于创建和编辑拍号事件，以设置不同时间位置的拍号。

4. 速度轨：用于创建和编辑 BPM 变化曲线。

5. Clip 轨：显示当前 Clip 的时间范围及相关信息。用户可拖动 Clip 的边缘调整其长度，调整结果会同步反映在钢琴卷帘的编辑区域中。该区域还支持乐器的切换、添加及相关管理操作。Clip 上的 AI 渲染状态条用于显示当前聚焦 Clip 的 AI 演奏生成区域及其状态。

6. 音符画布：用于编辑音符的音高、起始位置、时值及静音状态，并支持音符分割等操作。

7. 左侧钢琴键盘：显示对应的音高位置，并支持通过点击琴键试听音高。

8. 动态控制轨区域：用于编辑音符力度、弯音（Pitch Bend）、MIDI CC 及演奏技法等控制事件。

9. 滚动与缩放控件：通过水平、垂直滚动条及缩放控件调整编辑区域的可视范围。

二、钢琴卷帘左侧功能面板

2.1 片段编辑器

片段编辑器用于选择、定位和管理钢琴卷帘中的 Clip，并控制编辑器的显示与编辑范围。

片段选择

支持以下片段选择范围：

• 所有片段：将编辑范围设为全部片段。

• 活动片段：仅编辑当前活动片段。

• 活动轨道上的所有片段：将编辑范围设为当前活动轨道上的全部片段。

编辑器显示选项

• 固定编辑器内容：固定当前编辑器内容，避免编辑对象随活动片段切换而自动改变。

• 显示片段边界：控制片段边界的显示状态，便于识别不同片段的时间范围。

轨道与片段搜索

支持搜索轨道和片段，便于在包含多个轨道或片段的工程中快速定位目标。

活动片段导航

通过上一片段和下一片段按钮，在片段之间切换，快速定位需要编辑的内容。

可见性选择与多片段编辑

通过可见性选择，可以将其他 Clip 同时加入当前钢琴卷帘的编辑视图。

启用后，所选 Clip 将同时显示在 Clip 轨中，其 MIDI 音符也会共同显示在音符画布中，并支持直接编辑。

例如，当需要同时编辑 Serum 和 Piano 两个 Clip 时，可通过可见性选择将两个 Clip 加入当前编辑视图。此时，两个 Clip 的 MIDI 音符会同时显示在同一个钢琴卷帘中，用户可以在统一的时间轴下查看、调整和编辑两个 Clip 的音符，无需在不同 Clip 之间反复切换。

2.2 量化面板

量化面板用于设置音符量化规则及相关参数，以调整音符的时间位置、时值和节奏表现。

基础选项

• 自动应用：控制量化设置是否自动应用。

• 柔和量化：控制量化时音符向目标网格对齐的程度。启用后，可通过量化力度调整贴合程度。

量化参数

三、MIDI 编辑快捷工具栏

在钢琴卷帘中，长按鼠标右键可调出 MIDI 编辑快捷工具栏。工具栏包含选择、铅笔、画笔、橡皮擦、静音和剪刀五种工具。

操作方法

1. 在钢琴卷帘编辑区域内，按住鼠标右键，调出快捷工具栏。

2. 保持右键按下状态，将鼠标滑动至需要使用的工具。

3. 松开鼠标右键，即可选择对应工具。

该操作无需打开顶部工具栏即可快速切换编辑工具，便于在音符编辑过程中连续进行不同类型的操作。