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

   1
   2 <figure class="right">
   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 quicker "debugging" of a MIDI
  13   region, and for fast <em>non-graphical</em> (i.e. no mouse involved)
  14   editing. The list has a vertical flow, i.e. the first events (in time) are
  15   at the top of the window, and the last are at the bottom.
  16 </p>
  17
  18 <p>
  19   It is accessed by selecting the <kbd class="menu">Region &gt; MIDI &gt; List
  20   Editor&hellip;</kbd> menu while having one MIDI region selected, or by <kbd
  21   class="mouse">Right</kbd> clicking the MIDI region and choosing <kbd
  22   class="menu"><em>Name_Of_The_Region</em> &gt; MIDI &gt; List
  23   Editor&hellip;</kbd>.
  24 </p>
  25
  26 <p>
  27   The window displays the following MIDI data:
  28 </p>
  29
  30 <table class="dl">
  31   <tr><th>Start</th><td>the timestamp of the start of the note</td></tr>
  32   <tr><th>Channel</th><td>the MIDI channel of the event</td></tr>
  33   <tr><th>Num</th><td>The <a href="@@midi-notes-ref">MIDI number</a> of the note</td></tr>
  34   <tr><th>Name</th><td>The MIDI name of the note, made of its English name and octave (e.g. "C4")</td></tr>
  35   <tr><th>Vel</th><td>the velocity of the note, i.e. its volume, between 0 (silent) and 127 (full)</td></tr>
  36   <tr><th>Length</th><td>duration of the note, either expressed as a number (in ticks, related to the tempo) or as a text
  37   (fraction of a beat, also related to the tempo)</td></tr>
  38 </table>
  39
  40 <p>
  41   At the top of the window is a <kbd class="menu">Sound Selected MIDI
  42   Notes</kbd> button, which toggles playing a note as it is selected.
  43 </p>
  44
  45 <p>
  46   Each value can be manually modified, by <kbd class="mouse">left</kbd>
  47   clicking it. However, the <em>Name</em> field is derived from the
  48   <em>Number</em> field, and cannot be edited. To change a note, its number
  49   must be changed, which will be reflected in the <em>Name</em> field.
  50 </p>
  51