+<p class="fixme">step_editing.bindings doesn't seem to exist anywhere discoverable by an average user; also, what does "Insert Snap-Rest" mean? And what key is the "bar" key and why doesn't it work?</p>
+
<p>
- 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. Step editing and recording MIDI via the track's MIDI port cannot happen
- simultaneously.
+ Entering notes in Ardour can be done by using a connected MIDI device like a MIDI keyboard or pad controller, or by using the mouse. A third option, which provides for fine-grained control, precision and speed comes from using Ardour's Step Entry dialog.
</p>
<figure>
- <img src="/images/a3_step_entry.png" alt="Ardour's Step Entry dialog">
- <figcaption>
- Ardour's Step Entry dialog
- </figcaption>
+<img class="fit" src="/images/step_entry.png" alt="Ardour's Step Entry dialog">
+<figcaption class="center">Ardour's Step Entry dialog.</figcaption>
</figure>
<p>
- The dialog (quite closely modelled on Logic's) contains:
+ The step entry dialog is accessed by <kbd class="mouse">right</kbd>-clicking on the <kbd class="menu" style="color:red;">●</kbd> (Rec-Enable) button of the <a href="@@midi-track-controls">MIDI track</a> to be edited and selecting <kbd class="menu">Step Entry</kbd> from the menu that appears.
+</p>
+
+<p class="note">
+ Step editing and recording MIDI via the track's MIDI port cannot happen simultaneously.
+</p>
+
+<p>
+ The dialog (closely modelled on Logic's) contains:
</p>
<ul>
<li>Insert a rest of the current grid step size</li>
<li>Move back to the last inserted note</li>
<li>Move forward to the next beat, or bar</li>
- <li>Move forward to the edit point</li>
+ <li>Move to the edit point</li>
</ul>
</li>
<li>Dynamics controls from pianississimo to fortississimo</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.
+ Almost 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
+ typically not necessary—even for complex data entry.
</p>
+
<p>
The default key bindings for this (configured in <tt>step_editing.bindings</tt>) are:
</p>
-<dl>
- <dt><tt>grave</tt></dt>
- <dd>octave-0</dd>
- <dt><tt>1</tt></dt>
- <dd>octave-1</dd>
- <dt><tt>2</tt></dt>
- <dd>octave-2</dd>
- <dt><tt>3</tt></dt>
- <dd>octave-3</dd>
- <dt><tt>4</tt></dt>
- <dd>octave-4</dd>
- <dt><tt>5</tt></dt>
- <dd>octave-5</dd>
- <dt><tt>6</tt></dt>
- <dd>octave-6</dd>
- <dt><tt>7</tt></dt>
- <dd>octave-7</dd>
- <dt><tt>8</tt></dt>
- <dd>octave-8</dd>
- <dt><tt>9</tt></dt>
- <dd>octave-9</dd>
- <dt><tt>0</tt></dt>
- <dd>octave-10</dd>
-</dl>
-<dl>
- <dt><tt>F1</tt></dt>
- <dd>note-length-whole</dd>
- <dt><tt>F2</tt></dt>
- <dd>note-length-half</dd>
- <dt><tt>F3</tt></dt>
- <dd>note-length-third</dd>
- <dt><tt>F4</tt></dt>
- <dd>note-length-quarter</dd>
- <dt><tt>F5</tt></dt>
- <dd>note-length-eighth</dd>
- <dt><tt>F6</tt></dt>
- <dd>note-length-sixteenth</dd>
- <dt><tt>F7</tt></dt>
- <dd>note-length-thirtysecond</dd>
- <dt><tt>F8</tt></dt>
- <dd>note-length-sixtyfourth</dd>
-</dl>
-<dl>
- <dt><tt>a</tt></dt>
- <dd>insert-c</dd>
- <dt><tt>w</tt></dt>
- <dd>insert-csharp</dd>
- <dt><tt>s</tt></dt>
- <dd>insert-d</dd>
- <dt><tt>e</tt></dt>
- <dd>insert-dsharp</dd>
- <dt><tt>d</tt></dt>
- <dd>insert-e</dd>
- <dt><tt>f</tt></dt>
- <dd>insert-f</dd>
- <dt><tt>t</tt></dt>
- <dd>insert-fsharp</dd>
- <dt><tt>g</tt></dt>
- <dd>insert-g</dd>
- <dt><tt>y</tt></dt>
- <dd>insert-gsharp</dd>
- <dt><tt>h</tt></dt>
- <dd>insert-a</dd>
- <dt><tt>u</tt></dt>
- <dd>insert-asharp</dd>
- <dt><tt>j</tt></dt>
- <dd>insert-b</dd>
-</dl>
-<dl>
- <dt><tt>Tab</tt></dt>
- <dd>insert-rest</dd>
- <dt><tt>Primary-Tab</tt></dt>
- <dd>insert-snap-rest</dd>
- <dt><tt>BackSpace</tt></dt>
- <dd>back</dd>
-</dl>
-<dl>
- <dt><tt>z</tt></dt>
- <dd>note-velocity-ppp</dd>
- <dt><tt>x</tt></dt>
- <dd>note-velocity-pp</dd>
- <dt><tt>c</tt></dt>
- <dd>note-velocity-p</dd>
- <dt><tt>v</tt></dt>
- <dd>note-velocity-mp</dd>
- <dt><tt>b</tt></dt>
- <dd>note-velocity-mf</dd>
- <dt><tt>n</tt></dt>
- <dd>note-velocity-f</dd>
- <dt><tt>m</tt></dt>
- <dd>note-velocity-ff</dd>
- <dt><tt>comma</tt></dt>
- <dd>note-velocity-fff</dd>
-</dl>
-<dl>
- <dt><tt>Up</tt></dt>
- <dd>next-note-velocity</dd>
- <dt><tt>Down</tt></dt>
- <dd>prev-note-velocity</dd>
- <dt><tt>Primary-Up</tt></dt>
- <dd>next-note-length</dd>
- <dt><tt>Primary-Down</tt></dt>
- <dd>prev-note-length</dd>
-</dl>
-<dl>
- <dt><tt>apostrophe</tt></dt>
- <dd>toggle-triplet</dd>
- <dt><tt>period</tt></dt>
- <dd>toggle-dotted</dd>
- <dt><tt>Primary-period</tt></dt>
- <dd>no-dotted</dd>
- <dt><tt>bar</tt></dt>
- <dd>toggle-chord</dd>
-</dl>
+<table>
+ <tr><td><kbd>`</kbd> (grave accent)</td><td>Set octave 0</td></tr>
+ <tr><td><kbd>1</kbd> to <kbd>9</kbd></td><td>Set octave 1 to 9</td></tr>
+ <tr><td><kbd>0</kbd></td><td>Set octave 10</td></tr>
+
+ <tr><td><kbd>f1</kbd></td><td>Set note length whole</td></tr>
+ <tr><td><kbd>f2</kbd></td><td>Set note length half</td></tr>
+ <tr><td><kbd>f3</kbd></td><td>Set note length third</td></tr>
+ <tr><td><kbd>f4</kbd> to <kbd>f8</kbd></td><td>Set 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 class="mod1">tab</kbd></td><td>Insert snap rest (?)</td></tr>
+ <tr><td><kbd>backspace</kbd></td><td>Set insert cursor back one note length</td></tr>
+
+ <tr><td><kbd>z</kbd></td><td>Set note velocity 𝆏𝆏𝆏</td></tr>
+ <tr><td><kbd>x</kbd></td><td>Set note velocity 𝆏𝆏</td></tr>
+ <tr><td><kbd>c</kbd></td><td>Set note velocity 𝆏</td></tr>
+ <tr><td><kbd>v</kbd></td><td>Set note velocity 𝆐𝆏</td></tr>
+ <tr><td><kbd>b</kbd></td><td>Set note velocity 𝆐𝆑</td></tr>
+ <tr><td><kbd>n</kbd></td><td>Set note velocity 𝆑</td></tr>
+ <tr><td><kbd>m</kbd></td><td>Set note velocity 𝆑𝆑</td></tr>
+ <tr><td><kbd>,</kbd> (comma)</td><td>Set note velocity 𝆑𝆑𝆑</td></tr>
+
+ <tr><td><kbd>↑</kbd></td><td>Set next note velocity</td></tr>
+ <tr><td><kbd>↓</kbd></td><td>Set prev note velocity</td></tr>
+ <tr><td><kbd class="mod1">↑</kbd></td><td>Set next note length</td></tr>
+ <tr><td><kbd class="mod1">↓</kbd></td><td>Set prev note length</td></tr>
+
+ <tr><td><kbd>'</kbd></td><td>Toggle triplet</td></tr>
+ <tr><td><kbd>.</kbd></td><td>Set single dotted</td></tr>
+ <tr><td><kbd class="mod1">.</kbd></td><td>Clear dotted</td></tr>
+ <tr><td><kbd>bar (?)</kbd></td><td>Toggle chord</td></tr>
+</table>
+