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

   1
   2 <figure class="right">
   3   <img src="/images/midi-tracer.png" alt="The MIDI Tracer window">
   4   <figcaption class="center">
   5     The MIDI Tracer window
   6   </figcaption>
   7 </figure>
   8
   9 <p>
  10   The <dfn>MIDI Tracer</dfn> window, which is accessed by selecting <kbd
  11   class="menu">Window &gt; MIDI Tracer</kbd> from the main menu, is similar to
  12   the <a href="@@midi-list-editor">MIDI List Editor</a> in that it displays
  13   MIDI information as tabular text, and has a vertical flow (i.e. the
  14   events follow a top to bottom time-oriented order).
  15 </p>
  16
  17 <p>
  18   Its use is different however, as it is <em>not</em> bound to a specific
  19   region or track; the MIDI shown in the MIDI Tracer window is any global input
  20   or output Ardour presents to the system. As such, it is a very useful way to
  21   monitor MIDI traffic, whether it is an external controller or device or the
  22   input or output of any track.
  23 </p>
  24
  25 <p class="note">
  26   The MIDI Tracer can list all types of MIDI and "audio" events, and <a href="@@midi-scene-automation">scene automation</a> and <a href="@@timecode-generators-and-slaves">timecode</a> events as well.
  27 </p>
  28
  29 <p>
  30   The window consists of:
  31 </p>
  32
  33 <table class="dl">
  34 <tr>
  35   <th><dfn>Port</dfn></th>
  36   <td>A list of all the MIDI ports Ardour presents to the system. They are both
  37   internal and external and are the same ports Ardour presents to JACK, if
  38   enabled</td>
  39 </tr>
  40 <tr>
  41   <th>The events list</th>
  42   <td>Where all the events for this port are listed, see below</td>
  43 </tr>
  44 <tr>
  45   <th><dfn>Line history</dfn></th>
  46   <td>How many lines should be kept in the events list; once this limit is
  47   reached, older events will be removed from the list</td>
  48 </tr>
  49 <tr>
  50   <th><dfn>Delta times</dfn></th>
  51   <td>If checked, shows the times as the duration since the last event, instead
  52   of <a href="@@on-clock-and-time">absolute times</a></td>
  53 </tr>
  54 <tr>
  55   <th><dfn>Decimal</dfn></th>
  56   <td>If checked, shows the MIDI data as decimal values instead of
  57   hexadecimal</td>
  58 </tr>
  59 <tr>
  60   <th><dfn>Enabled</dfn></th>
  61   <td>If checked, events are displayed in the events list as they occur,
  62   otherwise stops the logging</td>
  63 </tr>
  64 <tr>
  65   <th><dfn>Auto-Scroll</dfn></th>
  66   <td>If checked, the events list scrolls as new events are logged, keeping the
  67   newest events on screen</td>
  68 </tr>
  69 </table>
  70
  71 <p>
  72   The events list displays the events as columns:
  73 </p>
  74
  75 <table class="dl">
  76 <tr>
  77   <th>Time of the event</th>
  78   <td>Either absolute or relative, based on the <kbd class="option">Delta
  79   times</kbd> checkbox</td>
  80 </tr>
  81 <tr>
  82   <th>MIDI status (event type)</th>
  83   <td>What MIDI events happened (e.g. Note On, Note Off, Pitch Bend, etc.)</td>
  84 </tr>
  85 <tr>
  86   <th>MIDI channel</th>
  87   <td>The MIDI channel the event happened in</td>
  88 </tr>
  89 <tr>
  90   <th>MIDI data bytes (event parameters)</th>
  91   <td>Parameters of the event, e.g. for a Note On: what the <a
  92   href="@@midi-notes-ref">note</a> was, and its velocity</td>
  93 </tr>
  94 </table>
  95