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

   1
   2 <figure>
   3   <img src="/images/midi-tracer.png" alt="The MIDI Tracer window">
   4   <figcaption>
   5     The MIDI Tracer window
   6   </figcaption>
   7 </figure>
   8
   9 <p>
  10   The <dfn>MIDI Tracer</dfn> is similar to the <a href="@@midi-list-editor">MIDI
  11   List Editor</a>, in the way that it displays MIDI information as a tabular text
  12   view, and has a vertical flow, i.e. the events follow a top to bottom time
  13   order.
  14 </p>
  15 <p>
  16   Its use is different though, as it is <em>not</em> bound to a specific region or track:
  17   the MIDI that is monitored is any global input or output Ardour presents to the
  18   system. It is hence a very useful option to monitor a MIDI port, be it an external
  19   controller/device or the in/output of any track.
  20 </p>
  21 <p>
  22   It is accessed by selecting the <kbd class="menu">Window &gt; MIDI Tracer</kbd>
  23   menu.
  24 </p>
  25 <p>
  26   The window is made of:
  27 </p>
  28 <table class="dl">
  29   <tr><th><dfn>Port</dfn></th><td>a list of all the MIDI ports Ardour presents to the system. They
  30     are both internal and external and are the same ports Ardour presents to JACK, if
  31     enabled.</td></tr>
  32   <tr><th>the events list</th><td>where all the events for this port are listed, see below</td></tr>
  33   <tr><th><dfn>Line history</dfn></th><td>how many lines should be kept in the events list</td></tr>
  34   <tr><th><dfn>Delta times</dfn></th><td>if checked, shows the times as the duration since the last event, instead of the <a href="@@on-clock-and-time">absolute time</a></td></tr>
  35   <tr><th><dfn>Decimal</dfn></th><td>if checked, shows the MIDI data as decimal values instead of the original hexadecimal values</td></tr>
  36   <tr><th><dfn>Enabled</dfn></th><td>if checked, the events are displayed in the events list, otherwise stops the logging</td></tr>
  37   <tr><th><dfn>Auto-Scroll</dfn></th><td>if checked, the events list scrolls as new events are logged, allowing to keep the newest events on screen</td></tr>
  38 </table>
  39
  40 <p>
  41   The events list displays the events as columns:
  42 </p>
  43 <table class="dl">
  44   <tr><th>time of the event</th><td>either absolute or relative, based on the <kbd class="option">Delta times</kbd> checkbox</td></tr>
  45   <tr><th>MIDI status (event type)</th><td>what midi events happened (e.g. Note On, Note Off, Pitch Bend, &hellip;)</td></tr>
  46   <tr><th>MIDI channel</th><td>in which MIDI channel did the event happen</td></tr>
  47   <tr><th>MIDI data bytes (event parameters)</th><td>parameters of the event, e.g. for a Note On: what <a gref="@@midi-notes-ref">note</a> was it, and which was the note's velocity</td></tr>
  48 </table>
  49
  50 <p class="note">
  51   Note: The MIDI Tracer can lists all kind of MIDI events, "audio" ones, but also <a href="@@midi-scene-automation">scene automation</a> or <a href="@@timecode-generators-and-slaves">timecodes</a> ones.
  52 </p>
  53