manual/include/step-entry.html

<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.
</p>

<figure>
    <img src="/images/a3_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
    it is released)</li>
  <li>Note length selectors</li>
  <li>Triplet toggle</li>
  <li>Normal, single, double and triple dotted note selectors</li>
  <li>Sustain button</li>
  <li>Buttons to:
    <ul>
     <li>Insert a rest of the current selected note duration</li>
     <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>
    </ul>
  </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>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>
  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>