> For the complete documentation index, see [llms.txt](https://docs.lmms.io/user-manual/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.lmms.io/user-manual/jian-ti-zhong-wen/shu-xi-lmms/gang-qin-juan-lian-chuang-pianoroll.md).

# 钢琴卷帘窗（Piano-Roll）

<figure><img src="https://3710990805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZRacsG2wvxpXwri0XH6G%2Fuploads%2FVmBP3jbyXsSymRtRnbR6%2Fimage.png?alt=media&amp;token=97ecf994-2ed3-40cb-9aa0-5a1c85163d40" alt=""><figcaption><p>钢琴卷帘窗</p></figcaption></figure>

钢琴卷帘窗是处理旋律与和弦的主要场所。它可以通过对下列对象进行双击或右键唤出上下文菜单打开：

* 一个乐器轨道的片段，像这样：![](https://3710990805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZRacsG2wvxpXwri0XH6G%2Fuploads%2FExMpAn47fnp77l87S15Z%2Fimage.png?alt=media\&token=18ae6aa6-e675-438a-bb9f-018940e65269) 。
* 样式编辑器中一个轨道的步进。

您也可以通过使用工具栏中的 **显示/隐藏钢琴窗** ![](https://3710990805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZRacsG2wvxpXwri0XH6G%2Fuploads%2FpZYoJDxFjfm60HPLP9UU%2Fimage.png?alt=media\&token=bf3db9aa-fc16-4d72-8432-c2bcef50d287) 或快捷键 <kbd>F7</kbd>（在 1.3 版本中为 <kbd>Ctrl+3</kbd> ）。

{% hint style="warning" %}
请注意，**显示/隐藏钢琴窗** 按钮打开的是最后编辑的片段。如果您刚刚开始一个新的会话 (不要与开始一个新项目混淆)，您必须首先将钢琴窗连接到一个片段才能使用它。LMMS 不会记住从一个会话到另一个会话的最后编辑片段。
{% endhint %}

## 工具栏

<figure><img src="https://3710990805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZRacsG2wvxpXwri0XH6G%2Fuploads%2FVuW12tphI8FobAcujt2u%2Fimage.png?alt=media&amp;token=ef5c9089-1161-46e2-8fcb-e48af3259c3b" alt=""><figcaption><p>钢琴卷帘窗的顶部工具栏</p></figcaption></figure>

很多的工具和歌曲编辑器中的相类似，下面是一些值得注意的稍微不一样的地方：

### 播放和录制（Playback and Record）

<figure><img src="https://3710990805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZRacsG2wvxpXwri0XH6G%2Fuploads%2FHAk8oFeNbRhh4WDEWy6G%2Fimage.png?alt=media&amp;token=a930e9c6-9cd4-40c1-9661-70645395eb76" alt=""><figcaption><p>播放和录制按钮</p></figcaption></figure>

除了播放和停止控件之外，还加了两个用于 **录制** 的按钮用于录制以下两种音符输入：

* 附带的 MIDI 键盘
* 您的计算机键盘

点击 ![](https://3710990805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZRacsG2wvxpXwri0XH6G%2Fuploads%2FIG4qsJPjJi1KmwBRmy55%2Fimage.png?alt=media\&token=27fa7780-db52-40bd-a7cd-50bc264aa87e) 可以在不播放歌曲编辑器/样式编辑器的环境下录制，![](https://3710990805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZRacsG2wvxpXwri0XH6G%2Fuploads%2FEZI9ohlgZmbygJmDKRgn%2Fimage.png?alt=media\&token=c47c43f0-6bce-48df-a93b-82e4ded54c4d) 则可以在播放歌曲编辑器/样式编辑器的环境下录制。\
点击 ![](https://3710990805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZRacsG2wvxpXwri0XH6G%2Fuploads%2FOZenYsvUlahBQAqcahJP%2Fimage.png?alt=media\&token=9e29b4c6-9667-4afb-b9f9-dd2ca610e7c3) 可以停止播放和录制。键盘上的 **空格键** 可以执行播放/停止（播放和录制）。\
从 1.3 开始, ![](https://3710990805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZRacsG2wvxpXwri0XH6G%2Fuploads%2F3DkbQD1sEWvQx2x4U69g%2Fimage.png?alt=media\&token=38476df0-bbfc-42a2-ba0d-cbe6f9928fe0) 允许您一次录制一个音符。

当您按下停止，您可以在钢琴窗看到所有播放的音符。这些音符和别的音符一样可以被编辑。

### 编辑（Editing）

<figure><img src="https://3710990805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZRacsG2wvxpXwri0XH6G%2Fuploads%2FXMBwHIGkZKfQp8KgErZ3%2Fimage.png?alt=media&amp;token=c5679b87-721e-4db1-a673-9f86cd7325db" alt=""><figcaption><p>编辑工具</p></figcaption></figure>

被选择的音符可以被统一处理。下面是一些快捷键：

* 移动被选音符：<kbd>鼠标左键拖拽</kbd> 。
* 复制被选音符：<kbd>Shift</kbd> + <kbd>鼠标左键拖拽</kbd> 。
* 定量移动被选音符（ <kbd>Shift</kbd> / <kbd>Ctrl</kbd> + <kbd>方向键</kbd> ）。Shift 会每次移动被选音符一拍（竖方向就是一个半音），而 Ctrl 会每次移动被选音符一个小节（竖方向就是一个八度）。

四个编辑模式（工具）分别是 **绘制** 、**擦除** 、**选择** 和 **变调** 。\
在钢琴窗的网格中，您也可以通过左键 / 右键来 **绘制** / **移除** 音符。（本章的“编辑注释”中有更详细的解释）。

**选择** 模式工具允许您自由选择音符，使之组成一组“被选择的”音符。您可以对它们进行统一操作。

您可以在选择模式下做出以下操作，被选择的音符会被渲染为蓝色：

* **框选：**&#x7528;鼠标拉出一个矩形框，确认选区后松开鼠标，被矩形框触及到的音符会被选择。
* **单选：**&#x76F4;接左键单击来选择一个音符。
* **逐个多选：**&#x60A8;可以通过按住 <kbd>Shift</kbd> 键来逐个点击音符，被点击的音符会被选择。如果您 <kbd>Shift</kbd> + 左键拖拽出了一个矩形选框，那么其中被选择的音符会反而取消选择，而未被选择的音符会被选择（即反选）。
* **取消选择全部音符：**&#x76F4;接左键单击钢琴窗网格中的一个空白区域即可。

<figure><img src="https://3710990805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZRacsG2wvxpXwri0XH6G%2Fuploads%2FBWLk1Ywmlx6QpAHy75Nj%2Fimage.png?alt=media&amp;token=50256851-97bd-48ce-927b-700f7dd32bc0" alt=""><figcaption><p>音符变调的自动化控制 （注意与自动化编辑器相区分）</p></figcaption></figure>

**变调** 模式允许您编辑单个音符的音高变化。在该模式下选中一个音符，将会出现对应该音符的一个自动化控制编辑器。接着，您就可以在这里面通过鼠标来描点音高的变化曲线，这样音符就会在播放时按您绘制的音高曲线移调。\
留意被您移调过的音符，在钢琴中会显示去对应的音高曲线。

{% hint style="warning" %}
移调工具对 VST 乐器无效。您可能还是要在乐器窗口中 VST 自带的 PITCH（音高）旋钮来改变音符音高。
{% endhint %}

### 剪贴板（Clipboard）

<figure><img src="https://3710990805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZRacsG2wvxpXwri0XH6G%2Fuploads%2FqBAKsdHDWcxdEe15l1qk%2Fimage.png?alt=media&amp;token=b8b077fc-b7fc-4afd-887c-abbac038a3ab" alt=""><figcaption><p>剪贴板工具</p></figcaption></figure>

剪贴板工具允许您剪切、复制、粘贴被选音符。另外，对被选音符按下 <kbd>Delete</kbd> 可以删除它们。

* 按下 **复制** 按钮（或 <kbd>Ctrl+C</kbd> ）可以复制被选音符（把它们放到剪贴板里）。按住 <kbd>Shift</kbd> 拖拽被选音符到远离原位置的另一个位置，可以复制被选音符到新位置。

### 播放控制（Playback Control）

<figure><img src="https://3710990805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZRacsG2wvxpXwri0XH6G%2Fuploads%2FHnw03CaG9ZpxAXJ89F7R%2Fimage.png?alt=media&amp;token=a50bb15f-a3f8-4c87-91b1-7f3619a24dc6" alt=""><figcaption><p>播放控制工具</p></figcaption></figure>

These work the same as the playback controls in the Song Editor. To repatriate loops:

* **Set right loop-point:** use right mouse button only
* **Set left loop-point:** use right mouse button + Shift
* **(1.3 and later) Set both right/left loop-points**: use right mouse button near desired loop-point

Hold Ctrl to place loop-points freely.

### 缩放（Zoom）

<figure><img src="https://3710990805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZRacsG2wvxpXwri0XH6G%2Fuploads%2FdlEQN4FXrNbw7WnOOA9N%2Fimage.png?alt=media&amp;token=c0f80663-81b3-4ecc-89d2-9fea4b08607e" alt=""><figcaption><p>视图缩放工具</p></figcaption></figure>

该控件的作用和歌曲编辑器中的那个一样，点出下拉菜单可以设置横向缩放。

<figure><img src="https://3710990805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZRacsG2wvxpXwri0XH6G%2Fuploads%2FUfEbdXfdF9pR1DDQe6W8%2Fimage.png?alt=media&amp;token=7d9e932f-14db-4f45-9d46-5768abd107b5" alt=""><figcaption><p>纵向缩放工具</p></figcaption></figure>

到了 1.3，支持在歌曲编辑器进行纵向缩放。<br>

### 量化（Quantification）

<figure><img src="https://3710990805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZRacsG2wvxpXwri0XH6G%2Fuploads%2F4FRvEV56LE5TRSA4bymU%2Fimage.png?alt=media&amp;token=aac1a914-695c-474e-89fa-2c0102228f82" alt=""><figcaption><p>量化工具</p></figcaption></figure>

该控件决定了量化精度，可以通过下拉菜单进行设置。量化精度允许您在绘制和录制时，以该小节分数作为最小精度来操控音符长度。

例如，将量化设置为 1/1，那么您将只能在整小节的起始位置放置音符，并且只能以 1 小节为单位来调整它们的长度。

如果将量化设置为 1/16，那么您将可以在 1/16 小节的时间间隔上放置音符，并且以 1/16 小节的步进来调整它们的长度。

其他依此类推。

![](https://3710990805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZRacsG2wvxpXwri0XH6G%2Fuploads%2F6KADz9diUDsk070D68IG%2Fimage.png?alt=media\&token=9005e80e-a355-49ac-8348-412bafb6acf6) 将钢琴窗中的音符吸附到离网格最近（这取决于量化精度）的位置。

### 工具

1.3 之后，工具控件将在 ![](https://3710990805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZRacsG2wvxpXwri0XH6G%2Fuploads%2Fl99D7TIpyznFx1wZXU0k%2Fimage.png?alt=media\&token=5db8c7fb-c1d9-4dfb-9ea6-358d710c4765) 按钮后以下拉菜单的形式出现。

<figure><img src="https://3710990805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZRacsG2wvxpXwri0XH6G%2Fuploads%2FAwuVxgjwZDxYp727vRae%2Fimage.png?alt=media&amp;token=a4453f52-de0e-4d7b-a976-a5061fa2e9f6" alt=""><figcaption><p>工具</p></figcaption></figure>

* **合并（** <kbd>Shift+G</kbd> **）：**&#x5982;果两个音符彼此相邻且音高相同，则将其合并。

<figure><img src="https://3710990805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZRacsG2wvxpXwri0XH6G%2Fuploads%2FiSTjjfZY1nMWhc4YxJEx%2Fimage.png?alt=media&amp;token=2d77d4a2-9628-4ba0-a3cb-cb8c8e6b19d6" alt=""><figcaption><p>胶水工具</p></figcaption></figure>

### 编辑音符

#### 绘制和移动音符

使用绘制模式工具来放置音符。当您将鼠标悬停在钢琴窗的网格（即钢琴窗的工作区）中时，一条灰色的水平线会跟踪鼠标光标的垂直位置，以帮助您顺回钢琴键来定位当前悬停在哪个音高。

* 左键单击一个网格可以放置一个音符，如果您选择了一个和弦类型，则：
  * 以当前音高为根音放置和弦的音符。
  * <kbd>Shift</kbd> + 左键单击以琶音模式放置音符（this will only duplicate notes onto themselves if no chord is selected）。
* 将鼠标光标悬停在音符上，光标会变成十字四向箭头，此时：
  * **直接拖拽** 音符可以改变其时间位置和音高。音符在拖拽过程中会自动吸附到设置好的量化精度的网格上。
  * **Alt + 拖拽** 也可以改变其时间位置和音高，但不会吸附到设置好的量化精度的网格上，而是允许您以 1/192 的时间精度（这是 LMMS 中最大的细分数）进行移动。
* 将鼠标光标悬停在音符的尾部（右侧），光标会变成水平双向箭头，此时：
  * **直接拖拽** 音符的尾部可以改变其音符长度（可以认为是时值），音符的尾部在拖拽过程中会自动吸附到设置好的量化精度的网格上。
  * **Alt + 拖拽** 也可以改变音符的长度，但不会吸附到设置好的量化精度的网格上，而是允许您以 1/192 的时间精度（这是 LMMS 中最大的细分数）“自由”拖拽。

{% hint style="info" %}
在绘制模式下按住 <kbd>Ctrl</kbd> 键会将鼠标光标切换为选择模式工具，并在释放时返回绘制模式。
{% endhint %}

#### 擦除音符

有三个办法移除音符：

* 选择 **擦除模式** 来删除要删除的音符（无论鼠标左键还是右键）。
* 在 **绘制模式** 下鼠标右键来删除音符。
* 选择 **选择模式**（或 <kbd>Ctrl+鼠标拖拽</kbd> ）选择一至多个音符，然后按 <kbd>Delete</kbd> 键。

### 默认音符长度（Note Length）

<figure><img src="https://3710990805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZRacsG2wvxpXwri0XH6G%2Fuploads%2FBuLEMQpUjVjnvG5pzAbt%2Fimage.png?alt=media&amp;token=02e4365d-85e3-4102-9fb1-62153f2b28e5" alt=""><figcaption><p>音符长度工具</p></figcaption></figure>

您可以通过下拉菜单来设置 **默认音符长度**（以小节为单位），这个设置决定了当您在钢琴窗中使用绘制模式工具创建音符时，音符的默认长度。\
你可以选择一个固定不变的音符长度，也可以选择让下一个音符与上一次绘制的音符长度相同。一旦你已经确定了一个理想的音符长度和位置，通常就会更倾向于使用“上一个音符”这个设置。

## 音符力度（Volume）和声像（Panning）

<figure><img src="https://3710990805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZRacsG2wvxpXwri0XH6G%2Fuploads%2FWgsKx2Rb3l6wCkvg2z7T%2Fimage.png?alt=media&amp;token=dbf22795-011b-4059-926b-b78e0cf7cecb" alt=""><figcaption><p>单个音符力度</p></figcaption></figure>

点击钢琴键盘下方的 **Note Volume / Note Panning（音符音量 / 音符声像）** 按钮，可以在音符音量编辑器和音符声像编辑器之间切换。\
在音符音量编辑器中，力度（Velocity）会显示为音符下方的一根绿色竖条。\
您可以直接在竖条上点击，或者拖动竖条的头部，来改变该音符的力度大小。力度越大，音符自身的颜色越亮；力度越小，音符自身的颜色越暗。

{% hint style="info" %}
如果您正在使用支持力度感压的 MIDI 键盘，则每个音符的力度会基于 **录制** 自动设定。\
音符的力度可能不只影响音量，这由演奏乐器决定。
{% endhint %}

<figure><img src="https://3710990805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZRacsG2wvxpXwri0XH6G%2Fuploads%2FTkgNzAS0EEUxMiXaxKfG%2Fimage.png?alt=media&amp;token=0f9cc592-26fb-49dd-9c8a-f5c6889e8c4b" alt=""><figcaption><p>单个音符声相</p></figcaption></figure>

**声像（Pan）**&#x8868;示该音符的音量在右声道与左声道之间的分配比例。\
在音符声像编辑器中，音符的声像值显示为绿色竖条。\
您可以直接在竖条上点击，或者拖动竖条的头部，来改变该音符的声像的方向和它的强度。基于调配的声像方向和强度，音符自身的一侧颜色会变暗（右：底部变暗，左：顶部变暗）。

## 钢琴键

<figure><img src="https://3710990805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZRacsG2wvxpXwri0XH6G%2Fuploads%2F79z1f2Ux6PsiLPgeNsYq%2Fimage.png?alt=media&amp;token=5b4202ce-6fc7-4e0e-9b17-8bd68985f144" alt=""><figcaption><p>竖排钢琴键</p></figcaption></figure>

您可以使用窗口右侧的滚动条。或者直接滑动鼠标滚轮来垂直滚动竖排钢琴键（按住 Shift 再拖拽则可以横向滚动）。

左键单击钢琴键或已绘制的音符，乐器都会演奏相应的音。

{% hint style="info" %}
您仍可以在钢琴窗内使用电脑键盘来演奏乐器。
{% endhint %}

您可以通过 设置（Settings） -> **通用**（General）-> **显示钢琴窗中的所有音符标签**（Enable note labels in Piano roll）来显示/隐藏所有音符标签。

<figure><img src="https://3710990805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZRacsG2wvxpXwri0XH6G%2Fuploads%2F0SWP2NEfjCH6YVxmhI7B%2Fimage.png?alt=media&amp;token=df752e06-0ddc-423c-a88c-2ecdda991c28" alt=""><figcaption><p>启用了标签显示的竖排钢琴键</p></figcaption></figure>

您可以高亮单个音高、和弦和音阶。所有这些选项都可以由上下文菜单提供，方法是右键单击左侧竖排钢琴的某个键，然后在上下文菜单中选择 **您想要的高亮方式** 。

下面是您可以选择的高亮方式：

* **标记音阶、和弦、各级的八度音或单个音。**
* **取消标记各级的八度音、单个音或所有音高。**
* **select all corresponding octave semitones.**&#x20;

<figure><img src="https://3710990805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZRacsG2wvxpXwri0XH6G%2Fuploads%2FUPe7uJYTgi2ZVYzwXLY1%2Fimage.png?alt=media&amp;token=4d6da4e1-5b6e-4c85-aa33-be56b989ba05" alt=""><figcaption><p>标记了所有 C 和弦组成音的竖排钢琴键</p></figcaption></figure>

{% hint style="info" %}
若要标记/取消标记音阶/和弦，您首先要在钢琴窗的工具栏中选择一个音阶/和弦类型。

和弦与音阶分别从其根音和第一级音开始进行标记。
{% endhint %}
