MIDI音符编辑工具

音符编辑概述

音符画布是钢琴卷帘的核心编辑区域，用于创建、选择、移动、修剪、分割、静音和量化 MIDI 音符，并支持对多个音符进行批量操作。

钢琴卷帘提供六种专用编辑工具：选择工具、铅笔工具、画笔工具、橡皮擦工具、静音工具和剪刀工具。用户可根据编辑任务切换工具，也可长按鼠标右键调出 MIDI 编辑快捷工具栏，快速选择所需工具。

音符显示设置

在「设置 - 钢琴卷帘」中，可开启或关闭以下音符附加信息的显示：

• MIDI 音符编号：显示音符对应的 MIDI 音符编号。

• 力度：显示音符的力度信息。

• 演奏技法标签：显示音符关联的演奏技法信息，例如图示中的技法标签。

音符数据与 AI 演奏

Sonic Vein Studio 采用用户编辑层与 AI 演奏层相分离的数据模型。用户对 MIDI 音符所做的修改会作为独立的可撤销操作记录，不会直接覆盖 AI 生成的演奏时序数据。

一.选择工具

选择工具用于选中和操作音符及其他可编辑对象，是进行音符位置、时值等精细调整的基础工具。

主要操作包括：

1. 选择音符：单击目标音符，将其设为当前选中对象。

2. 框选音符：在画布中拖动鼠标，框选范围内的音符。

3. 移动音符：拖动选中的音符，调整其起始位置或音高。

4. 修剪音符：拖动音符边缘，调整音符长度。

5. 批量编辑：选中多个音符后，对选中对象进行支持的批量操作。

音符移动时，可根据网格吸附的开关状态及当前网格设置，调整音符的时间位置。

二.铅笔工具

铅笔工具用于创建单个音符，并支持对音符长度和力度进行调整，适合精确录入音符或逐个编辑音符。

创建音符

1. 在 Clip 内的空白网格处单击，创建一个音符，其初始长度由当前网格设置决定。

2. 在创建过程中横向拖动鼠标，可调整音符长度；纵向拖动可同步调整音符力度，力度范围为 1–127。

3. 如果在已有音符上单击并进入长度调整状态，可拖动音符右侧边缘修改其长度。

在 Clip 外创建音符

当在尚无 Clip 覆盖的空白画布区域绘制音符时，系统会自动在当前小节起点创建一个长度为 8 小节的 Clip，并将新音符写入该 Clip。

试听反馈

创建音符时，系统采用节流试听机制，避免连续操作造成重复触发或爆音。

三.画笔工具

画笔工具用于连续绘制多个音符，适合快速录入连续旋律、重复音型或和弦音符。

1. 在音符画布中按住鼠标并横向拖动，沿拖动路径连续创建音符。

2. 每个新建音符的默认长度由当前网格设置决定。

3. 拖动过程中改变鼠标的纵向位置，可同步调整所绘制音符的力度。

4. 一次完整的画笔操作会合并为一条撤销记录，便于整体撤销本次绘制。

5. 在同一音高、同一网格位置重复经过时，系统不会重复创建相同位置的音符。

四.橡皮擦工具

橡皮擦工具用于删除音符及其他支持擦除的编辑对象。

1. 删除单个音符：单击目标音符即可将其删除。

2. 批量删除音符：按住鼠标拖动并扫过多个音符，可连续删除经过的音符。单次拖动过程中，每个音符只会被删除一次。

3. 删除选中音符：选中一个或多个音符后，按下 Delete 键，即可批量删除选中的音符。

删除操作可通过撤销功能恢复。

五.静音工具

静音工具用于切换音符的静音状态，不会删除音符，也不会修改音符原有的时间位置、音高、长度或力度数据。

1. 切换单个音符状态：单击音符，根据其当前静音状态切换为静音或取消静音。

2. 批量切换状态：按住鼠标拖动并扫过多个音符，以本次操作确定的目标状态统一处理经过的音符。

3. 适用范围：静音工具仅对音符生效，不用于修改 Clip、自动化、拍号等其他对象。

六.剪刀工具

剪刀工具用于在指定时间位置分割音符，并同步处理相关的持续型演奏技法事件。

1. 分割音符：在音符画布中单击目标时间位置，分割当前聚焦 Clip 内所有跨越该切点的音符。分割位置遵循当前网格吸附设置。

2. 处理持续型演奏技法：分割音符时，系统会同步处理相关的持续型演奏技法事件，并在切点处复制当前生效的技法事件，以保证分割后技法的连续性。

3. 适用范围：剪刀工具用于分割音符及相关演奏技法事件，不用于切割 Clip，也不用于分割弯音（Pitch Bend）或 MIDI CC 自动化曲线。

七.力度管理轨

以柱状图形式展示每个音符的力度值（范围 1-127），支持铅笔 / 画笔工具批量绘制力度曲线

支持力度包络批量变换，可对选中力度点进行倾斜、整体偏移、垂直缩放、中心缩放等操作，快速塑造乐句强弱起伏