Shamusworld >> Repos - ardour-manual/blob - include/midi-track-controls.html

   1
   2 <p class=fixme>Item #3 below does not hold in all cases; check to make sure the rest of the content is sane as well</p>
   3
   4 <figure>
   5 <img src="/images/typical-midi-track-controls.png" alt="A MIDI track header">
   6 <figcaption class="center">MIDI track header, stretched to show normally hidden controls.</figcaption>
   7 </figure>
   8
   9 <p>
  10   A MIDI track has the same basic controls as an <a
  11   href="@@audio-track-controls">audio track</a>, with the following
  12   differences:
  13 </p>
  14
  15 <ol>
  16   <li>The level meters for the track's outputs show MIDI output in <span
  17   style="color:red;">red</span>, on the left; Audio output in <span
  18   style="color:green;">green</span>, on the right</li>
  19   <li>The <dfn>Scroomer</dfn>, a combined scroll and zoom widget for
  20   controlling MIDI notes display range, is unique to MIDI tracks</li>
  21   <li>An External MIDI Device combobox can appear, for selecting <a
  22   href="@@patch-change#midnam">MIDNAMs</a></li>
  23   <li>An External Device Mode combobox can appear, for selecting an external
  24   device's mode</li>
  25 </ol>
  26
  27 <p class="note">
  28   To show the full set of MIDI track controls, the <a
  29   href="@@track-height">track height</a> must be increased beyond the default
  30   height. MIDI tracks will show only a few of the control elements when there
  31   is insufficient vertical space. Further, the External MIDI Device and
  32   External Device Mode comboboxes will <strong>not</strong> appear if there is
  33   a synth plugin on the track that comes with an associated <a
  34   href="@@patch-change#midnam">MIDNAM</a>.
  35 </p>
  36
  37 <h2>The Scroomer</h2>
  38
  39 <p>
  40   The Scroomer performs the following functions:
  41 </p>
  42
  43 <ul>
  44   <li>The scrollbar controls the range of pitches that are visible on the
  45   track, as visualized by the piano keyboard. Dragging the body of the
  46   scrollbar up and down displays higher or lower pitches.</li>
  47   <li>Dragging the scrollbar handles zooms in and out and increases or
  48   decreases the range of visible pitches.</li>
  49   <li>Double clicking the scrollbar auto-adjusts the zooms to make the range of
  50   visible pitches fit the actual content of the track.</li>
  51   <li>Clicking on the piano plays the corresponding MIDI note for reference.</li>
  52   <li><kbd class="mouse mod3">left</kbd> clicking on a note adds the note to the
  53                 selection (for all regions on the track). See <a href="@@note-selection">Note
  54                 Selection</a>.</li>
  55         <li><kbd class="mouse">middle</kbd> clicking a note clears the selection, selects
  56                 only the note.</li>
  57 </ul>
  58
  59 <h2>Channel and Patch Selection</h2>
  60
  61 <h3>The Channel Selector</h3>
  62
  63 <figure class="right">
  64 <img src="/images/midi-chan-sel-dlg.png" alt="The MIDI channel control window">
  65 <figcaption class="center">The MIDI channel control window.</figcaption>
  66 </figure>
  67
  68 <p>
  69   A MIDI track's data may utilize any number of the 16 available <dfn>MIDI channels</dfn>, and it is useful to be able to filter out a subset of those or force the input or output to utilize only certain channels. The Channel Selector dialog allows for filtering or modification of both the input and output of any given MIDI track.
  70 </p>
  71
  72 <p>
  73   The Channel Selector dialog is activated by <kbd class="mouse">right</kbd>-clicking on a MIDI track's header and selecting <kbd class="menu">Channel Selector...</kbd> from the menu that appears. Filtering or modification of Inbound MIDI events for the given MIDI track is done by selecting among:
  74 </p>
  75
  76 <ul>
  77   <li><kbd class=menu>Record only selected channels</kbd></li>
  78   <li><kbd class=menu>Force all channels to 1 channel</kbd></li>
  79 </ul>
  80
  81 <p class="note">
  82   Selecting <kbd class=menu>Record all channels</kbd> does no filtering of inbound MIDI events.
  83 </p>
  84
  85 <p>
  86   If simple filtering of incoming MIDI events is desired, <kbd class=menu>Record only selected channels</kbd> should be selected. A 1-by-16 grid of squares with numbers in them will become sensitive to mouse clicks, and the desired channels to be allowed through the filter can then be selected by clicking on them. Channels that are allowed to pass through will be highlighted in green.
  87 </p>
  88
  89 <p>
  90   <kbd class=menu>Force all channels to 1 channel</kbd> will rewrite the channel number of all incoming events of the selected MIDI track to whichever channel is highlighted in the 1-by-16 grid of squares. When this option is chosen, one and only one channel can be selected.
  91 </p>
  92
  93 <p>
  94   Filtering or modification of outbound MIDI events is done by selecting among:
  95 </p>
  96
  97 <ul>
  98   <li><kbd class=menu>Play only selected channels</kbd></li>
  99   <li><kbd class=menu>Use a single fixed channel for all playback</kbd></li>
 100 </ul>
 101
 102 <p class="note">
 103   Selecting <kbd class=menu>Playback all channels</kbd> does no filtering of outbound MIDI events.
 104 </p>
 105
 106 <p>
 107   Simple filtering of outgoing MIDI events is done similarly to simple filtering of incoming MIDI events, and is done by selecting <kbd class=menu>Play only selected channels</kbd>. Also similarly to the incoming case, <kbd class=menu>Use a single fixed channel for all playback</kbd> will rewrite the channel number of all outgoing events of the selected MIDI track to whichever channel is selected.
 108 </p>
 109
 110 <p>
 111   When either <kbd class=menu>Record only selected channels</kbd> or <kbd class=menu>Playback only selected channels</kbd> is selected, a group of three buttons, each appearing below their respective 1-by-16 grids, will become sensitive to mouse clicks. They perform the following functions:
 112 </p>
 113
 114 <table>
 115 <tr>
 116   <th>All</th>
 117   <td>Selects all the channels in the 1-by-16 grid above it; all the squares become lit with green</td>
 118 </tr>
 119 <tr>
 120   <th>None</th>
 121   <td>Deselects all the channels in the 1-by-16 grid above it; all the squares become unlit</td>
 122 </tr>
 123 <tr>
 124   <th>Invert</th>
 125   <td>Any channel in the 1-by-16 grid that is lit green becomes unlit, and any unlit channel becomes lit with green</td>
 126 </tr>
 127 </table>
 128
 129 <h3 class="clear">The Patch Selector</h3>
 130
 131 <figure class="left">
 132 <img class="mini" src="/images/midi-patch-selector.png" alt="The Patch Selector window">
 133 <figcaption class="center">The Patch Selector window.</figcaption>
 134 </figure>
 135
 136 <a href="@@patch-change"></a>
 137 <p>
 138   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.
 139 </p>
 140
 141 <p>
 142   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.
 143 </p>
 144
 145 <p>
 146   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.
 147 </p>
 148