--- /dev/null
+
+<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>
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
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>