manual/include/midi-track-controls.html

<p>A typical <dfn>MIDI track header</dfn> looks like this:</p>
<figure>
    <img src="/images/typical-midi-track-controls.png" alt="A MIDI track header">
    <figcaption>
      A MIDI track header
    </figcaption>
</figure>

<p>
  To show the full set of MIDI track controls, the <a href="@@track-height">track height</a>
  must be increased beyond the default. MIDI tracks show only a few of the control elements
  when there is insufficient vertical space.
</p>
<p>
  A MIDI track has the same basic controls as an <a href="@@audio-track-controls">audio track</a>,
  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>When the track is tall enough, the External MIDI Device selection dropdown appears.</li>
</ol>
<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. 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>
</ul>
<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,
  for example, be put on different channels. In the context menu (<kbd class="mouse">right</kbd> click),
  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>
  To edit the contents of a MIDI track see <a href="@@edit-midi">MIDI Editing</a>.
</p>