<p>
- Sometimes you will want to edit MIDI data directly from a connected
- MIDI device like a music keyboard or pad controller. Sometimes you will
- want to use the mouse. Sometimes you'll want the fine-grain control,
- precision and speed of entry that comes from using a custom note entry
- dialog.
+ Editing MIDI can be a tedious task. Ardour allows using a connected
+ MIDI device like a music keyboard or pad controller, or use the mouse.
+ A third option, providing fine-grain control, precision and speed of entry
+ comes from using a custom note entry dialog.
</p>
<p>
- The step entry dialog is accessed via a right click context menu on the
- rec-enable button, because step entry is related to <em>recording</em>
- MIDI data. You cannot simultaneously step edit and record MIDI via the
- track's MIDI port.
+ The step entry dialog is accessed via a <kbd class="mouse">right click</kbd>
+ context menu on the <kbd>rec-enable</kbd> button, because step entry is related
+ to <em>recording</em> MIDI data. Step editing and recording MIDI via the
+ track's MIDI port cannot happen simultaneously, so the track should <em>not</em>
+ be rec-armed.
</p>
-<img src="/images/a3_step_entry.png" />
-<p>The dialog (quite closely modelled on Logic's) contains:</p>
+
+<figure>
+ <img src="/images/step_entry.png" alt="Ardour's Step Entry dialog">
+ <figcaption>
+ Ardour's Step Entry dialog
+ </figcaption>
+</figure>
+
+<p>
+ The dialog (quite closely modelled on Logic's) contains:
+</p>
+
<ul>
- <li>
- Chord entry switch (successive notes are stacked in a chord until
+ <li>Chord entry switch (successive notes are stacked in a chord until
it is released)</li>
<li>Note length selectors</li>
<li>Triplet toggle</li>
</li>
<li>Dynamics controls from pianississimo to fortississimo</li>
<li>Channel selector</li>
- <li>
- Explicit numerical velocity selector, for more precise control
- than the dynamics selectors offer
- </li>
+ <li>Explicit numerical velocity selector, for more precise control
+ than the dynamics selectors offer</li>
<li>Octave selector</li>
<li>Buttons to add bank or program change events</li>
<li>a full 10 octave virtual keyboard</li>
</ul>
+
+<p>
+ More or less all actions in the step entry dialog can be driven directly from
+ the keyboard, so that moving back and forth from the keyboard to the mouse is
+ not necessary even for complex data insertion.
+</p>
<p>
- More or less all actions in the step entry dialog can be driven
- directly from the keyboard, so you do not need to keep moving back
- and forth from keyboard to mouse to do complex data insertion.
+ The default key bindings for this (configured in <tt>step_editing.bindings</tt>) are:
</p>
+<table>
+ <tr><td><kbd>grave</kbd></td><td>octave 0</td></tr>
+ <tr><td><kbd>1</kbd> to <kbd>9</kbd></td><td>octave 1 to 9</td></tr>
+ <tr><td><kbd>0</kbd></td><td>octave 10</td></tr>
+
+ <tr><td><kbd>F1</kbd></td><td>note length whole</td></tr>
+ <tr><td><kbd>F2</kbd></td><td>note length half</td></tr>
+ <tr><td><kbd>F3</kbd></td><td>note length third</td></tr>
+ <tr><td><kbd>F4</kbd> to <kbd>F8</kbd></td><td>note length quarter to sixtyfourth</td></tr>
+
+ <tr><td><kbd>a</kbd></td><td>insert C</td></tr>
+ <tr><td><kbd>w</kbd></td><td>insert C ♯</td></tr>
+ <tr><td><kbd>s</kbd></td><td>insert D</td></tr>
+ <tr><td><kbd>e</kbd></td><td>insert D ♯</td></tr>
+ <tr><td><kbd>d</kbd></td><td>insert E</td></tr>
+ <tr><td><kbd>f</kbd></td><td>insert F</td></tr>
+ <tr><td><kbd>t</kbd></td><td>insert F ♯</td></tr>
+ <tr><td><kbd>g</kbd></td><td>insert G</td></tr>
+ <tr><td><kbd>y</kbd></td><td>insert G ♯</td></tr>
+ <tr><td><kbd>h</kbd></td><td>insert A</td></tr>
+ <tr><td><kbd>u</kbd></td><td>insert A ♯</td></tr>
+ <tr><td><kbd>j</kbd></td><td>insert B</td></tr>
+
+ <tr><td><kbd>Tab</kbd></td><td>insert rest</td></tr>
+ <tr><td><kbd>Primary Tab</kbd></td><td>insert snap rest</td></tr>
+ <tr><td><kbd>BackSpace</kbd></td><td>back</td></tr>
+
+ <tr><td><kbd>z</kbd></td><td>note velocity 𝆏𝆏𝆏</td></tr>
+ <tr><td><kbd>x</kbd></td><td>note velocity 𝆏𝆏</td></tr>
+ <tr><td><kbd>c</kbd></td><td>note velocity 𝆏</td></tr>
+ <tr><td><kbd>v</kbd></td><td>note velocity 𝆐𝆏</td></tr>
+ <tr><td><kbd>b</kbd></td><td>note velocity 𝆐𝆑</td></tr>
+ <tr><td><kbd>n</kbd></td><td>note velocity 𝆑</td></tr>
+ <tr><td><kbd>m</kbd></td><td>note velocity 𝆑𝆑</td></tr>
+ <tr><td><kbd>comma</kbd></td><td>note velocity 𝆑𝆑𝆑</td></tr>
+
+ <tr><td><kbd>Up</kbd></td><td>next note velocity</td></tr>
+ <tr><td><kbd>Down</kbd></td><td>prev note velocity</td></tr>
+ <tr><td><kbd>Primary Up</kbd></td><td>next note length</td></tr>
+ <tr><td><kbd>Primary Down</kbd></td><td>prev note length</td></tr>
+
+ <tr><td><kbd>apostrophe</kbd></td><td>toggle triplet</td></tr>
+ <tr><td><kbd>period</kbd></td><td>toggle dotted</td></tr>
+ <tr><td><kbd>Primary period</kbd></td><td>no dotted</td></tr>
+ <tr><td><kbd>bar</kbd></td><td>toggle chord</td></tr>
+
+</table>