Shamusworld >> Repos - ardour-manual/blob - include/midi-list-editor.html

   1
   2 <figure>
   3   <img src="/images/midi-list-editor.png" alt="The MIDI List Editor window">
   4   <figcaption>
   5     The MIDI List Editor window
   6   </figcaption>
   7 </figure>
   8
   9 <p>
  10   The <dfn>List Editor</dfn> is a way to look at the MIDI data of a region, not
  11   graphically as they are displayed in the Editor, but in a tabular form.
  12   This way of seeing the MIDI data allows for a quicker "debugging" of a MIDI region,
  13   and for a fast <em>non-graphical</em> (i.e. no mouse involved) editing. This
  14   list has a vertical flow, i.e. the first events (in time) are on the top
  15   of the window, and the latest are at its bottom.
  16 </p>
  17 <p>
  18   It is accessed by selecting the <kbd class="menu">Region &gt; MIDI &gt; List Editor&hellip;</kbd>
  19   menu while having one MIDI region selected, or by <kbd class="mouse">Right</kbd>
  20   clicking the MIDI region and choosing <kbd class="menu"><em>Name_Of_The_Region</em>
  21   &gt; MIDI &gt; List Editor&hellip;</kbd>
  22 </p>
  23 <p>
  24   The window displays the following MIDI data:
  25 </p>
  26 <dl>
  27   <dt>Start</dt><dd>the timestamp of the start of the note</dd>
  28   <dt>Channel</dt><dd>the MIDI channel of the event</dd>
  29   <dt>Num</dt><dd>The <a href="@@midi-notes-ref">MIDI number</a> of the note</dd>
  30   <dt>Name</dt><dd>The MIDI name of the note, made of its english name and octave (e.g. "C4")</dd>
  31   <dt>Vel</dt><dd>the velocity of the note (i.e. its intensity, between 0 and 127)</dd>
  32   <dt>Length</dt><dd>duration of the note, either expressed as a number (in ticks, related to the tempo) or as a text (fraction of a beat, also related to the tempo)</dd>
  33 </dl>
  34
  35 <p>
  36   At the top of the window is a <kbd class="menu">Sound Selected MIDI Notes</kbd>,
  37   which is a toggle button allowing to listen to a note as it is selected.
  38 </p>
  39
  40 <p>
  41   Each value can be manually modified, by <kbd class="mouse">Left</kbd> clicking it.
  42   The Name field is related to the Number one, and cannot be edited. To change a
  43   note, its number must be changed, which will be reflected in the Name field.
  44 </p>