<h2>Adding new notes</h2>
<p>
- In general, you will probably do most MIDI editing with the mouse in object
- mode. This allows you to select notes, copy, move or delete them and alter
- their properties (see below). But at some point, you're going to want to
- <em>add</em> notes to a MIDI region using the mouse, and if they are to be
- anything other than a fixed length, this means dragging with the mouse.
- Since this would normally be a selection operation if the mouse is in object
- mode, there needs to be some way for you to tell Ardour that you are trying
- to <dfn>draw</dfn> new notes within a MIDI region. Ardour provides two ways
- do this. One is to leave the mouse in object mode and
- <kbd class="mouse mod1">Left</kbd>-drag. The other, useful if you plan to
- enter a lot of notes for a while, is to switch the mouse into
- <kbd class="menu">Draw Notes</kbd> mode, which will now interpret any drags
- and clicks as requests to add a new note. For obvious reasons, you cannot
- use Draw Notes mode while using region-level editing.
+ For light MIDI editing, the Internal Edit Mode can be used. This mode allows
+ to select notes, copy, move or delete them and alter their properties. Adding
+ new notes in this mode is done by <kbd class="mouse
+ mod1">Left</kbd> dragging.
+
+ For more extensive MIDI editing, the <kbd class="menu">Draw Mode</kbd>.
+ allows to <kbd class="mouse">Left</kbd> click or drag to add a new note, without
+ having to hold down <kbd class="mod1n"></kbd>. However, Draw Mode doesn't offer
+ region-level editing nor rubberband selection.
</p>
-<p>So, to summarize:</p>
-<dl class="wide-table">
- <dt>Selecting, moving, copying, trimming, deleting <em>regions</em></dt>
- <dd>
- leave <kbd class="menu">Note Level Editing</kbd> disabled, use object,
- range or other mouse modes
- </dd>
- <dt>Selecting, moving, copying trimming, deleting <em>notes</em></dt>
- <dd>enable <kbd class="menu">Note Level Editing</kbd>and use mouse object mode</dd>
- <dt>Adding new notes</dt>
- <dd>
- enable "Note Level Editing" and then either
- <ul>
- <li>use mouse object mode and <kbd class="mouse mod1">Left</kbd>-drag,
- or</li>
- <li>use mouse draw mode.</li>
- </ul>
- </dd>
-</dl>
<p>
- Note that is also a
- <a href="@@step-entry">a step entry editor</a>
- allowing you to enter notes from a virtual keyboard and lots more besides.
+ In both modes, a mouse <em>click</em> creates a note at the pointer location
+ (or the nearest grid point if grid is enabled), and its duration is one <a
+ href="@@grid-controls">Grid unit</a>, even if the grid is disabled. A mouse
+ <em>drag</em> creates the note like a click does, but allows to set the
+ duration of the note until the mouse button is released.
</p>
+<p>So, to summarize:</p>
+<table class="dl">
+ <tr><th>Selecting, moving, copying, trimming, deleting <em>regions</em></th>
+ <td><kbd class="menu">Note Level Editing</kbd> disabled, using Grab,
+ Range or other mouse modes</td></tr>
+ <tr><th>Selecting, moving, copying trimming, deleting <em>notes</em></th>
+ <td><kbd class="menu">Note Level Editing</kbd> enabled, and using Internal
+ Edit mode</td></tr>
+ <tr><th>Adding new notes</th>
+ <td>enabling "Note Level Editing" and then either
+ <ul>
+ <li>using Draw mode and <kbd class="mouse">Left</kbd>
+ clicking/dragging, or</li>
+ <li>using Internal Edit mode and <kbd
+ class="mouse mod1">Left</kbd> clicking/dragging.</li>
+ </ul>
+ </td></tr>
+</table>
+<p>
+ There is also <a href="@@step-entry">a step entry editor</a> allowing to enter
+ notes from a virtual keyboard and lots more besides.
+</p>