-<h2>Selecting/Navigating note-by-note</h2>
+<h2>Navigating/Selecting notes with the keyboard</h2>
+
<p>
- Tab selects the next note. <kbd class="mod1">Tab</kbd> selects the previous
- note. <kbd class="mod3">Tab</kbd> or <kbd class="mod13">Tab</kbd> adds
- the next/previous note to the selection.
+ <kbd>tab</kbd> selects the next note in a MIDI region, while <kbd
+ class="mod1">tab</kbd> selects the previous note. Holding down the <kbd
+ class="mod3"></kbd> key as well prevents previously visited notes from being
+ deselected.
</p>
<h2>Selecting notes with the mouse</h2>
+
<p>
- While in mouse object mode, you can click on a note to select it. Once you
- have selected one note, <kbd class="mouse mod3">Left</kbd>-click on another
- to select all notes between them. To add or remove a note to/from the
- selection, click <kbd class="mouse mod1">Left</kbd>. You can also click and
- drag outside of a note to <dfn>rubberband select</dfn> a series of notes.
+ While in <a href="@@toolbox">Object Mode</a>, any note can be clicked on to select it. Once a note has been selected, <kbd class="mouse mod3">left</kbd>-clicking on another note selects all notes between the first note selected and the second one. Adding or removing a note to or from the selection is done by <kbd class="mouse mod1">left</kbd>-clicking it. Clicking and dragging outside of a note will <dfn>rubberband select</dfn> any notes enclosed by the selection rectangle; holding down the <kbd class="mod3n"></kbd> key will prevent any previously selected notes from being deselected.
</p>
+
<p>
- Three different selection operations are possible if you switch to mouse
- range mode:
+ In any mode, <kbd class="mod3 mouse">left</kbd>-clicking on a note on the
+ Scroomer (the piano header of the track, see <a
+ href="@@midi-track-controls">MIDI Track Controls</a>) will add all
+ occurrences of that note to the selection, while <kbd
+ class="mouse">middle</kbd>-clicking will only select/deselect all occurrences
+ of that note, clearing the previous selection. Scroomer selections work on
+ all MIDI regions of a track at once.
</p>
-<ul>
- <li>
- Vertical drags within the MIDI region will select all notes within the
- spanned note range.
- </li>
- <li>
- Clicks on the piano header of the track (if visible—the track must
- be tall enough to display it) will select all occurences of that note.
- </li>
- <li>
- Drags on the piano header of the track will select all notes within the
- spanned note range.
- </li>
-</ul>
<h2>Listening to Selected Notes</h2>
+
<p>
- If <kbd class="menu">Edit > Preferences > MIDI > Sound MIDI notes
- as they are selected</kbd> is enabled, Ardour will send a pair of
- NoteOn/NoteOff messages through the track, which will typically allow you to
- hear each note as it is selected.
+ If <kbd class="menu">Edit > Preferences > MIDI > Sound MIDI notes as
+ they are selected</kbd> is enabled, Ardour will send a pair of NoteOn/NoteOff
+ messages through the track as notes are selected. Assuming there is an
+ appropriate device or synthesizer attached to the track, these should be
+ audible.
</p>
-