]> Shamusworld >> Repos - ardour-manual/blobdiff - include/add-new-notes.html
Correct OSC personal monitoring to Foldback
[ardour-manual] / include / add-new-notes.html
index 382dfbbfc996de78d3b351706f54e92d308a003b..96137ceb739685188ab31d381a434fcfeea18e5d 100644 (file)
@@ -1,44 +1,44 @@
-  
+
 <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="/working-with-midi/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>