update to the MIDI track header page

diff --git a/include/midi-track-controls.html b/include/midi-track-controls.html
index b5f51f2f67c3d4590236b0ec649ce8386d08fc20..388975b0ed376c044f7e421890da0d30d391db96 100644 (file)
--- a/include/midi-track-controls.html
+++ b/include/midi-track-controls.html
@@ -1,37 +1,44 @@
 
 <p>A typical <dfn>MIDI track header</dfn> looks like this:</p>
-<img src="/images/typical-midi-track-controls.png" alt="midi track controls"
-  />
+<figure>
+    <img src="/images/typical-midi-track-controls.png" alt="A MIDI track header">
+    <figcaption>
+      A MIDI track header
+    </figcaption>
+</figure>
 
 <p>
-  To see the full set of MIDI track controls, you need to increase the
-  <a href="@@track-height">track height</a>
-  beyond the default. MIDI tracks show only a few of the control elements
+  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
-  <a href="@@audio-track-controls">controls as an audio track</a>,
-  with the addition of two extra elements. The set of buttons below the main track
-  controls the <dfn>MIDI channel</dfn>(s) that will be visible in the editor. 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. Clicking on a channel number toggles
-  its visibility.
+  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:
 </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>
+</ol>
 <p>
-  To the right of the MIDI track controls is a representation of a piano keyboard
-  called the <dfn>scroomer</dfn>. This performs a couple of functions.
-  The scrollbar controls the range of pitches that are visible on the
-  track, as visualized by the piano keyboard.<br>
-  Drag the body of the scrollbar up and down to display higher or lower
-  pitches.<br>
-  Drag the scrollbar handles to zooms in and out and increase and decrease the
-  range of visible pitches.<br>
-  clicking on the piano plays the corresponding MIDI note for reference.
+  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>
+</ul>
 <p>
-  To edit the contents of a MIDI track see <a href="@@edit-midi">Edit
-  MIDI</a>.
+  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>
-

diff --git a/source/images/typical-midi-track-controls.png b/source/images/typical-midi-track-controls.png
index 7ceb9d43aed7de6c23ebfb54b8f785a65efd890d..f2a7941f20555a1f95f47443885d7c538b0280df 100644 (file)
Binary files a/source/images/typical-midi-track-controls.png and b/source/images/typical-midi-track-controls.png differ