TCLMIDI(1) BSD General Commands Manual TCLMIDI(1)NAMEtclmidi — a TCL based interpreter for manipulating MIDI files
SYNOPSIStclmidiDESCRIPTIONtclmidi 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 sys‐
tems:
BSD/386
Linux
NetBSD
SVR4
SEE ALSOmidiconfig(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
BSD February 3, 1993 BSD
