From: Paul Davis <paul@linuxaudiosystems.com>
Date: Wed, 5 Oct 2022 18:54:23 +0000 (-0600)
Subject: add a new subsection on controlling MIDI note range
X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?p=ardour-manual;a=commitdiff_plain;h=5623d47770ee834b92291a6cb0c9c1b17dd001b8

add a new subsection on controlling MIDI note range
---

diff --git a/include/controlling-midi-range.html b/include/controlling-midi-range.html
new file mode 100644
index 0000000..9c09990
--- /dev/null
+++ b/include/controlling-midi-range.html
@@ -0,0 +1,36 @@
+
+<p>
+  The visible note range in a MIDI track can be controlled in two
+  principle ways: the note scroomer, or the scroll wheel of your
+  mouse. 
+<p>
+
+<h2 id="add-new-notes-using-the-mouse">Using the scroomer</h2>
+
+<p>
+  The scroomer offers two kinds of control. You can "grab" it in the
+  middle and move it up or down - this adjusts the absolute note range
+  displayed up or down. Alternatively you can "grab" the top or bottom
+  handle of the scroomer, and move that up or down - this adjusts the
+  extent of the note range displayed.
+
+<figure>
+<img style="width:75%" src="/images/midi-scroomer.png" alt="MIDI scroomer">
+<figcaption>MIDI scroomer</figcaption>
+</figure>
+
+<h2 id="add-new-notes-using-scroll">Using your scroll wheel</h2>
+
+
+<p>
+  Several scroll operations can be used to control the visible note
+  range:
+  <li>In internal edit mode, with no notes selected, unmodified
+    scrolling will move the visible range up and down.</li>
+  <li><kbd class="mod1">scroll</kbd> will increase and decrease the
+    visible range (zoom out and in)</li>
+  <li><kbd class="mod13">scroll</kbd> will expand either the top or
+    bottom of the visible note range (depending on scroll
+    direction). Think of this as "show me higher pitches" or "show me
+    lower pitches".
+</p>
diff --git a/include/edit-midi.html b/include/edit-midi.html
index 5dc4592..683d11c 100644
--- a/include/edit-midi.html
+++ b/include/edit-midi.html
@@ -14,17 +14,11 @@
     window or pane. Notes are edited right where they appear.
   </li>
   <li>
-    Editing note information in Ardour occurs in only a single region. There is
-    no way currently to edit note data for multiple regions at the same time;
-    so, for example, notes cannot be selected in several regions and then all
-    deleted, nor can they be copied and pasted from one region to another.
-    Regions, however, <em>can</em> be copied and pasted just as with audio.
-  </li>
-  <li>
-	When using jackd as the audio server for Ardour, all MIDI I/O is done
-	via JACK for sample accurate timing and maximal efficiency when communicating
-	with external software synthesizers. Otherwise, Ardour connects to midi
-	via the existing OS MIDI system.
+    Editing note information in Ardour occurs in only a single
+    region. There is no way currently to edit note data for multiple
+    regions at the same time; so, for example, notes cannot be
+    selected in several regions at once and then all deleted. However
+    they can they be copied and pasted from one region to another.
   </li>
   <li>
     Every MIDI track has its own MIDI port for input; it may have an
@@ -44,9 +38,11 @@
     There is a Normal and a Percussive mode for note data editing.
   </li>
   <li>
-    The vertical dimension of the region window is controlled by a
+    The visible note range is controlled by a
     <dfn>scroomer</dfn> widget, which is a combination scroll/zoom tool for
-    altering the zoom level and range of visible MIDI data.
+    altering the zoom level and range of visible MIDI data. When in
+    internal edit mode, you can also use scroll operations to adjust
+    the visible range in various ways.
   </li>
 </ul>
 
diff --git a/master-doc.txt b/master-doc.txt
index 90e2025..33c61b8 100644
--- a/master-doc.txt
+++ b/master-doc.txt
@@ -1378,6 +1378,14 @@ uri: working-with-midi
 part: chapter
 ---
 
+---
+title: Adding New Notes
+include: controlling-midi-range.html
+link: controlling-midi-range
+uri: working-with-midi/controlling-midi-range
+part: subchapter
+---
+
 ---
 title: Adding New Notes
 include: add-new-notes.html
diff --git a/source/images/midi-scroomer.png b/source/images/midi-scroomer.png
new file mode 100644
index 0000000..14202c5
Binary files /dev/null and b/source/images/midi-scroomer.png differ