ardour
/
manual
13
0
Fork 0
Code Pull Requests Releases Activity

Updated MIDI note selection/addition

This commit is contained in:
Ed Ward 2019-08-28 13:17:06 +02:00
parent e74c09802c
commit b394cd776f
3 changed files with 59 additions and 44 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

41
include/add-new-notes.html
View File

@ -1,31 +1,44 @@
<h2>Adding new notes</h2>
<p>
For light MIDI editing, you can use the Internal Edit Mode.
This mode lets you select notes, copy, move or delete them and alter their
properties (see below). To <em>add</em> notes using the mouse, <kbd class="mouse mod1">Left</kbd>-drag.
For more extensive MIDI editing, you may prefer <kbd class="menu">Draw Mode</kbd>.
You can click or drag to add a new note, without having to hold down Ctrl. However,
Draw Mode doesn't offer 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>
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 object,
range or other mouse modes</td></tr>
<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 mouse object mode</td></tr>
<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 mouse object mode and <kbd class="mouse mod1">Left</kbd>-drag, or</li>
<li>using mouse draw mode.</li>
<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>
Note that there is also <a href="@@step-entry">a step entry editor</a> allowing to
enter notes from a virtual keyboard and lots more besides.
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>

5
include/midi-track-controls.html
View File

@ -43,6 +43,11 @@
<li>Double clicking the scrollbar auto-adjusts the zooms to make the range of
visible pitches fit the actual content of the track.</li>
<li>Clicking on the piano plays the corresponding MIDI note for reference.</li>
<li><kbd class="mouse mod3">left</kbd> clicking on a note adds the note to the
selection (for all regions on the track). See <a href="@@note-selection">Note
Selection</a>.</li>
<li><kbd class="mouse">middle</kbd> clicking a note clears the selection, selects
only the note.</li>
</ul>
<h2>Channel and patch selection</h2>

57
include/note-selection.html
View File

@ -1,41 +1,38 @@
<h2>Selecting/Navigating note-by-note</h2>
<p>
<kbd>Tab</kbd> 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.
</p>
<h2>Selecting notes with the mouse</h2>
<p>
While in mouse object mode, any note can be clicked to select it. Once a note
has been selected, <kbd class="mouse mod3">Left</kbd>-clicking on another
selects all notes between them. Adding or removing a note to/from the
selection is done by <kbd class="mouse mod1">Left</kbd> clicking it. Clicking and
dragging outside of a note <dfn>rubberband selects</dfn> a series of notes.
While in Draw mode or Internal Edit mode, any note can be clicked to select
it. Once a note has been selected, <kbd class="mouse
mod3">Left</kbd>-clicking on another selects all notes between them. Adding
or removing a note to/from the selection is done by <kbd class="mouse
mod1">Left</kbd> clicking it.
</p>
<p>
Three different selection operations are possible while in 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 occurences
of that note, clearing the selection. These Scroomer selections works on all
MIDI regions of the 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&mdash;the track must
be tall enough to display it) will select all occurrences 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>
In Internal Edit mode only, <kbd class="mouse">left</kbd> clicking and dragging
outside of a note <dfn>rubberband selects</dfn> a series of notes.
<kbd class="mod3n"></kbd> rubberband selecting adds the notes to the selection.
</p>
<h2>Selecting/navigating note-by-note</h2>
<p>
<kbd>Tab</kbd> selects the next note as defined by their starting time.
<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.
</p>
<h2>Listening to selected notes</h2>
<p>
If <kbd class="menu">Edit &gt; Preferences &gt; MIDI &gt; Sound MIDI notes
as they are selected</kbd> is enabled, Ardour will send a pair of
as they are selected in the editor</kbd> is enabled, Ardour will send a pair of
NoteOn/NoteOff messages through the track, which will typically allow to
hear each note as it is selected.
</p>