DragonFly On-Line Manual Pages

MIDIRECORD(N)                          N                         MIDIRECORD(N)

NAME
     midirecord - tclmidi command to record a MIDI song

SYNOPSIS
     midirecord DevID RecMidiID [PlayMidiID [repeat]]

DESCRIPTION
     midirecord is a tclmidi(1) command that records events from a MIDI device
     and puts them in a MIDI song.

     The first argument to midirecord is a MIDI device identifier as returned
     from a call to mididevice(n).  The second argument is the MIDI song
     descriptor of the record song.  It should be one returned from
     midimake(n) or midiread(n).  The third argument is an optional MIDI song
     descriptor for a song that should be played while recording.
     Furthermore, an optional fourth argument of "repeat" may be specified so
     the play song will be repeated.

     Recording continues until the midistop(n) command is issued.  midiwait(n)
     may be used to block until the play song finishes.

     All recorded events are put into track 0 of the MIDI song.

RETURN VALUES
     midirecord returns immediately with 0 if no MIDI devices are available,
     or 1 if one is.

BUGS
     The MPU-401 device interface dynamically creates events in the record
     MIDI song asynchronously.  Since this involves a call to malloc(3) which
     is not re-entrant, this is a potential hazard.  Until I figure out a way
     around this, avoid other calls to malloc(3) while recording.  The current
     TCL signal synchronizing commands found are not adequate for this task.

SEE ALSO
     tclm(1), mididevice(n), midiplay(n), midiread(n), midimake(n),
     midistop(n), midiwait(n)

AUTHOR
     Mike Durian - durian@boogie.com

DragonFly 6.5-DEVELOPMENT      January 30, 1994      DragonFly 6.5-DEVELOPMENT