DragonFly On-Line Manual Pages

MIDIGREP(N)                            N                           MIDIGREP(N)

NAME
     midigrep - tclmidi command to find events matching a given pattern in a
     MIDI track

SYNOPSIS
     midigrep MidiID track event [event ...]

DESCRIPTION
     midigrep is a tclmidi(1) command that will find all events in a specified
     track that match the pattern events in the command argumets.  This first
     argument is the descriptor for the MIDI song.  This descriptor should be
     one returned by midimake(n) or midiread(n).  The second argument
     specifies the track to index.  The third and remaining arguments are
     events that you wish to locate.  The syntax of these events is the same
     as that specified in midievent(n), except that any field besides the
     event type field may be replaced by the * character.  The * character
     then acts as a wildcard and will match any value normally found for that
     parameter of the specified event type.  Any number of fields for an event
     can be wildcarded.

     For example, midigrep song0 1 {* Note 1 42 * *} will find all Note events
     in song0 track 1 that are for channel 1, pitch 42, regardless of the note
     velocity, duration or the time the Note event occurs.

RETURN VALUES
     midigrep returns a list off all the events that match the given event
     patterns.

SEE ALSO
     tclmidi(1), midiread(n), midimake(n), midievents(n)

AUTHOR
     Mike Durian - durian@boogie.com

DragonFly 6.5-DEVELOPMENT      February 25, 1996     DragonFly 6.5-DEVELOPMENT