X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=include%2Fmidi-tracer.html;h=7bde96c0ba6254dd656737690e8253a8b14d93c5;hb=a61fbacdfcb7a76fe425fada61f49fc85751e47a;hp=91220cdd81fce87de26c23980b8e7eb668cff4f2;hpb=8b72d27963928a6d72d0f171a24d53d46840088d;p=ardour-manual diff --git a/include/midi-tracer.html b/include/midi-tracer.html index 91220cd..7bde96c 100644 --- a/include/midi-tracer.html +++ b/include/midi-tracer.html @@ -1,52 +1,95 @@ -
+
The MIDI Tracer window -
+
The MIDI Tracer window

- The MIDI Tracer is similar to the MIDI - List Editor, in the way that it displays MIDI information as a tabular text - view, and has a vertical flow, i.e. the events follow a top to bottom time - order. + The MIDI Tracer window, which is accessed by selecting Window > MIDI Tracer from the main menu, is similar to + the MIDI List Editor in that it displays + MIDI information as tabular text, and has a vertical flow (i.e. the + events follow a top to bottom time-oriented order).

+

- Its use is different though, as it is not bound to a specific region or track: - the MIDI that is monitored is any global input or output Ardour presents to the - system. It is hence a very useful option to monitor a MIDI port, be it an external - controller/device or the in/output of any track. + Its use is different however, as it is not bound to a specific + region or track; the MIDI shown in the MIDI Tracer window is any global input + or output Ardour presents to the system. As such, it is a very useful way to + monitor MIDI traffic, whether it is an external controller or device or the + input or output of any track.

-

- It is accessed by selecting the Window > MIDI Tracer - menu. + +

+ The MIDI Tracer can list all types of MIDI and "audio" events, and scene automation and timecode events as well.

+

- The window is made of: + The window consists of:

-
-
Port
a list of all the MIDI ports Ardour presents to the system. They - are both internal and external and are the same ports Ardour presents to JACK, if - enabled.
-
the events list
where all the events for this port are listed, see below
-
Line history
how many lines should be kept in the events list
-
Delta times
if checked, shows the times as the duration since the last event, instead of the absolute time
-
Decimal
if checked, shows the MIDI data as decimal values instead of the original hexadecimal values
-
Enabled
if checked, the events are displayed in the events list, otherwise stops the logging
-
Auto-Scroll
if checked, the events list scrolls as new events are logged, allowing to keep the newest events on screen
-
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
PortA list of all the MIDI ports Ardour presents to the system. They are both + internal and external and are the same ports Ardour presents to JACK, if + enabled
The events listWhere all the events for this port are listed, see below
Line historyHow many lines should be kept in the events list; once this limit is + reached, older events will be removed from the list
Delta timesIf checked, shows the times as the duration since the last event, instead + of absolute times
DecimalIf checked, shows the MIDI data as decimal values instead of + hexadecimal
EnabledIf checked, events are displayed in the events list as they occur, + otherwise stops the logging
Auto-ScrollIf checked, the events list scrolls as new events are logged, keeping the + newest events on screen

The events list displays the events as columns:

-
-
time of the event
either absolute or relative, based on the Delta times checkbox
-
MIDI status (event type)
what midi events happened (e.g. Note On, Note Off, Pitch Bend, …)
-
MIDI channel
in which MIDI channel did the event happen
-
MIDI data bytes (event parameters)
parameters of the event, e.g. for a Note On: what note was it, and which was the note's velocity
-
-

- Note: The MIDI Tracer can lists all kind of MIDI events, "audio" ones, but also scene automation or timecodes ones. -

+ + + + + + + + + + + + + + + + + +
Time of the eventEither absolute or relative, based on the Delta + times checkbox
MIDI status (event type)What MIDI events happened (e.g. Note On, Note Off, Pitch Bend, etc.)
MIDI channelThe MIDI channel the event happened in
MIDI data bytes (event parameters)Parameters of the event, e.g. for a Note On: what the note was, and its velocity
+