]> Shamusworld >> Repos - ardour-manual/blobdiff - include/midi-track-controls.html
OSC: new for 6.0
[ardour-manual] / include / midi-track-controls.html
index 388975b0ed376c044f7e421890da0d30d391db96..6a4b5966ea5533f1d1ecaff0cbf0900330310fb1 100644 (file)
 </p>
 <p>
   A MIDI track has the same basic controls as an <a href="@@audio-track-controls">audio track</a>,
-  with the addition of two extra elements:
+  with the addition of three extra elements:
 </p>
 <ol>
   <li>Some meters for the track's outputs (MIDI in <span style="color:red;">red</span>,
     Audio in <span style="color:green;">green</span>)</li>
-  <li>The <dfn>Scroomer</dfn>, a zoom and scroll controller for the midi notes range.</li>
+  <li>The <dfn>Scroomer</dfn>, a zoom and scroll controller for the midi notes range</li>
+  <li>When the track is tall enough, the External MIDI Device selection dropdown appears.</li>
 </ol>
+
+<p>
+       Also, <kbd class="mouse">right</kbd> clicking the <kbd style="color:red;">&#9679;</kbd>
+       (record) button shows the <a href="@@step-entry">Step Entry</a> dialog instead of
+       controlling the rec-safe.
+</p>
+
+<h2>The Scroomer</h2>
+
 <p>
   The Scroomer performs a couple of functions:
 </p>
 <ul>
   <li>The scrollbar controls the range of pitches that are visible on the
-  track, as visualized by the piano keyboard. Drag the body of the scrollbar up
-  and down to display higher or lower pitches.</li>
-  <li>Drag the scrollbar handles to zooms in and out and increase and decrease the
-  range of visible pitches.</li>
-  <li>clicking on the piano plays the corresponding MIDI note for reference.</li>
+    track, as visualized by the piano keyboard. Dragging the body of the scrollbar up
+    and down displays higher or lower pitches.</li>
+  <li>Dragging the scrollbar handles zooms in and out and increases or decreases the
+    range of visible pitches.</li>
+  <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>
+
+<h3>The Channel Selector</h3>
+
+<figure class="right">
+    <img class="mini" src="/images/midi_channel_control.png" alt="The MIDI channel control window">
+    <figcaption>
+      The MIDI channel control window
+    </figcaption>
+</figure>
+
 <p>
   A MIDI track's data may span any number of the 16 available MIDI channels, and sometimes it is
   useful to view only a subset of those channels; different instruments may,
   the <kbd class="menu">Channel Selector</kbd> allows to control the <dfn>MIDI channel</dfn>(s)
   that will be visible in the editor.
 </p>
+
+<p>
+  This window also gives control over which channel(s) will be recorded, and which will be played back, choosing between:
+</p>
+
+<ul>
+  <li>All channels</li>
+  <li>Only selected channels &mdash;Ardour then proposes to choose amongst the 16 channels which are to be recorded/played</li>
+  <li>Force all to one channel &mdash;Ardour then 'routes' all the channels to one user selectable channel.</li>
+</ul>
+
+<h3 class="clear">The Patch Selector</h3>
+
+<figure class="left">
+    <img class="mini" src="/images/patch_selector.png" alt="The Patch Selector window">
+    <figcaption>
+      The Patch Selector window
+    </figcaption>
+</figure>
+
+<p>
+  The Patch Selector window is an easy way to set which instrument will be used on any of the MIDI channels.
+  Although patches can be changed at any time using a <a href="@@patch-change">patch change</a>, this dialog
+  provides an easy and convenient way to preview patches in software and hardware instruments. It
+  integrates fully with Ardour's support for MIDNAM (patch definition files), so Ardour can display named programs/patches
+  for both General MIDI synths and those with MIDNAM files.
+</p>
+<p>
+  The window itself makes it easy to choose a channel, a bank number, optionally choosing a bank number through its <dfn title="Most Significant Byte">MSB</dfn>
+  and <dfn title="Least Significant Byte">LSB</dfn> numbers (CC#00 and CC#32) for large banks, then choosing an instrument.
+</p>
+<p>
+  The keyboard at the bottom of the window allows for a quick preview of the selected instrument, either automatically
+  (using the buttons on top of the keyboard) or manually by either clicking a note or using the computer keyboard as a
+  piano keyboard.
+</p>
+
 <p>
   To edit the contents of a MIDI track see <a href="@@edit-midi">MIDI Editing</a>.
 </p>