DragonFly On-Line Manual Pages

Search: Section:  

TCLMIDI(1)             DragonFly General Commands Manual            TCLMIDI(1)


NAME

     tclmidi - a TCL based interpreter for manipulating MIDI files


SYNOPSIS

     tclmidi


DESCRIPTION

     tclmidi is an extension of John Ousterhout's TCL language.  The extension
     commands are designed to facilitate the creation and modification of MIDI
     files.  tclmidi is based on an earlier program called tclm, but provides
     many improvements.  Among these are

           absolute time indexing.  Events may now be inserted and removed
           from any place in the MIDI song.

           a note concept.  NoteOn and NoteOff events may now be handled
           together as a single Note event.

           an underlying object oriented design.  tclmidi is just a wrapper
           around a powerful C++ library called libmidi++.a.

           a song structure based on a red/black tree.  This allows access to
           events in a reasonable time frame regardless of the song size.
           Sequential access is also quick due to the leaves of the tree being
           a double-linked list.
     In addition to the normal TCL commands, the following are also available.

           midiconfig  get or modify the configuration values of a MIDI song

           mididevice  get or modify the configuration values of a MIDI device

           midifree    free the space used by a MIDI song

           midiget     get one event from a MIDI song

           midimake    create an empty MIDI song

           midimerge   merge multiple tracks of MIDI songs to one track

           midiplay    play a MIDI song

           midiput     insert an event in a MIDI song

           midiread    read a MIDI song from a Standard MIDI File

           midirecord  record a MIDI song

           midirewind  reset a MIDI song pointer to the beginning

           midisplit   split a track into a meta track and an other event
                       track

           midistop    stop playing or recording a MIDI song

           miditrack   get information about a track in a MIDI song

           midiwait    block until a MIDI song finishes playing

           midiwrite   write a MIDI song as a Standard MIDI File

           midiversion
                       report the tclmidi(1) version number

     The commands, mididevice(n), midiplay(n), midirecord(n), midistop(n), and
     midiwait(n) are only supported for certain MIDI drivers.  Currently this
     is limited to the MPU-401 UART driver for the following operating
     systems:
           BSD/386
           Linux
           NetBSD
           SVR4


SEE ALSO

     midiconfig(n), mididevice(n), midifree(n), midiget(n), midimake(n),
     midimerge(n), midiplay(n), midiput(n), midiread(n), midirecord(n),
     midirewind(n), midisplit(n), midistop(n), miditrack(n), midiwait(n),
     midiwrite(n), midiversion(n), midievents(n), minfo(1), mplay(1),
     mrecord(1), midtotcl(1)


AUTHORS

     Mike Durian - durian@boogie.com

DragonFly 6.5-DEVELOPMENT      February 3, 1993      DragonFly 6.5-DEVELOPMENT

Search: Section: