DragonFly On-Line Manual Pages

Search: Section:  

MIDICONFIG(N)                          N                         MIDICONFIG(N)


NAME

     midiconfig - tclmidi command to get or modify the configuration values of
     a MIDI song


SYNOPSIS

     midiconfig mfileId [format [value]] [division [value]] [tracks [value]]


DESCRIPTION

     midiconfig is a tclmidi(1) command that gets or modifies the
     configurations values of a MIDI song.

     Without arguments midiconfig reports all three configuration values.  It
     can also take up to three optional arguments.  All arguments should be
     lists consisting of the parameter name followed by an optional value.  If
     a value for a parameter is not specified then the current setting is
     reported.  If a value is specified then the song parameter is changed.

     mfileId is a valid MIDI song identifier as returned by midimake(n) or
     midiread(n).

     The different parameters are:

     format    This option determines the song type.  There are three valid
               values: 0, 1 and 2.  A format 0 song has only one track which
               intermixes meta and normal events.  A format 1 song can have
               many tracks, but track 0 always contains most of the meta
               events, specifically MetaTempo events.  A format 2 song is
               similar to format 1, but each track can be played separately
               instead of playing them all in parallel.

     division  This specifies the resolution of the timing for the song.  If
               the unit of quanta for a song is is clock tick, there will be
               value clock ticks per beat.

     tracks    This option specifies the number of tracks in the song.  These
               will by dynamically created and freed automatically.  The
               tracks are numbered 0 through value - 1 including.  A format 0
               song should have only one track.


RETURN VALUES

     If parameters are being set, midiconfig will return nothing.  If
     parameters are being queried, a list of lists will be returned.  Each
     sublist will contain the parameter name and its associated value.  The
     parameters are returned in the order specified or in the order format,
     division, tracks if midiconfig is called without arguments.


SEE ALSO

     tclmidi(1), midiread(n), midimake(n)


AUTHOR

     Mike Durian - durian@boogie.com

DragonFly 6.5-DEVELOPMENT      January 14, 1994      DragonFly 6.5-DEVELOPMENT

Search: Section: