From: durian@advtech.uswest.com (Mike Durian)
Newsgroups: comp.lang.tcl
Subject: tclm0.1 - tcl with MIDI extensions (3/7)
Date: 12 Jan 93 20:28:40 GMT
Organization: U S WEST Advanced Technologies

# This is a shell archive.  Save it in a file, remove anything before
# this line, and then unpack it by entering "sh file".  Note, it may
# create directories; files and directories will be owned by you and
# have default permissions.
#
# This archive contains:
#
#	tclm0.1/doc
#	tclm0.1/doc/midiconfig.n
#	tclm0.1/doc/midifixtovar.n
#	tclm0.1/doc/midifree.n
#	tclm0.1/doc/midiget.n
#	tclm0.1/doc/midimake.n
#	tclm0.1/doc/midimpu.n
#	tclm0.1/doc/midiplay.n
#	tclm0.1/doc/midiput.n
#	tclm0.1/doc/midiread.n
#	tclm0.1/doc/midirewind.n
#	tclm0.1/doc/midistop.n
#	tclm0.1/doc/miditiming.n
#	tclm0.1/doc/midivartofix.n
#	tclm0.1/doc/midiwrite.n
#	tclm0.1/doc/minfo.n
#	tclm0.1/doc/mplay.n
#	tclm0.1/doc/tclm.n
#
echo c - tclm0.1/doc
mkdir tclm0.1/doc > /dev/null 2>&1
echo x - tclm0.1/doc/midiconfig.n
sed 's/^X//' >tclm0.1/doc/midiconfig.n << 'END-of-tclm0.1/doc/midiconfig.n'
X.Dt MIDICONFIG 3 TCLM
X.Os TCLM
X.Dd Jan 10, 1993
X.Sh NAME
X.Nm midiconfig
X.Nd "tclm command to get or modify the configuration values of a Standard MIDI File"
X.Sh SYNOPSIS
X.Nm
X.Ar mfileId
X.Ar {format | division | tracks}
X.Op value
X.Sh DESCRIPTION
X.Nm
Xis a tclm command that
Xgets or modifies the configurations
Xvalues of
Xa Standard MIDI File.
X.Pp
X.Nm
Xtakes three or four arguments.
XThe first is a tclm Standard MIDI File
Xdescriptor as
Xreturned by
X.Xr midiread 3TCLM ,
Xor
X.Xr midimake 3TCLM .
X.Pp
XThe second argument specifies which
Xconfiguration value to manipulate.
XIt should be either
X.Dq format,
X.Dq division
Xor
X.Dq tracks.
XThe
X.Dq format
Xoption
Xallows you to get or change the
Xformat value of the Standard MIDI File,
Xand should be either 0, 1 or 2.
XThe
X.Dq division
Xoption allows you to get or set
Xthe timing for the file in units
Xper beat.
XFinally,
X.Dq tracks
Xallows you to get or change
Xthe number of tracks in the file.
XThis is how you create tracks in an empty
Xfile generated by
X.Xr midimake 3TCLM .
X.Pp
XThe final optional argument specifies
Xthat the configuration value should be
Xchanged and contains the new value.
XWithout this argument,
X.Nm
Xreturns the current setting for the
Xspecified value.
X.Sh RETURN VALUES
X.Nm
Xreturns
Xthe current setting of the specified
Xvalue if the forth argument is missing,
Xotherwise it returns nothing.
X.Sh SEE ALSO
X.Bl -item -compact
X.It
X.Xr midiread 3TCLM ,
X.It
X.Xr midimake 3TCLM
X.El
X.Sh AUTHORS
XMike Durian - durian@advtech.uswest.com
END-of-tclm0.1/doc/midiconfig.n
echo x - tclm0.1/doc/midifixtovar.n
sed 's/^X//' >tclm0.1/doc/midifixtovar.n << 'END-of-tclm0.1/doc/midifixtovar.n'
X.Dt MIDIFIXTOVAR 3 TCLM
X.Os TCLM
X.Dd Jan 10, 1993
X.Sh NAME
X.Nm midifixtovar
X.Nd "tclm command that converts an integer value to a variable length value"
X.Sh SYNOPSIS
X.Nm
X.Ar value
X.Sh DESCRIPTION
X.Nm
Xis a tclm command that
Xconverts an integer value to a Standard MIDI File
Xvariable length value.
XThis command takes only one argument, which is
Xthe value to be converted.
XThe value should be representable in a four byte
Xinteger value (typically a long).
X.Sh RETURN VALUES
X.Nm
Xreturns a list of bytes representing the
Xspecified value in variable length form.
XThe individual bytes are in hex form
X(0x??).
X.Sh AUTHORS
XMike Durian - durian@advtech.uswest.com
END-of-tclm0.1/doc/midifixtovar.n
echo x - tclm0.1/doc/midifree.n
sed 's/^X//' >tclm0.1/doc/midifree.n << 'END-of-tclm0.1/doc/midifree.n'
X.Dt MIDIFREE 3 TCLM
X.Os TCLM
X.Dd Jan 10, 1993
X.Sh NAME
X.Nm midifree
X.Nd "tclm command to free the space used by a Standard MIDI File"
X.Sh SYNOPSIS
X.Nm
X.Ar mfileId
X.Sh DESCRIPTION
X.Nm
Xis a tclm command that
Xfrees the space used by a
XStandard MIDI File.
XIt
Xtakes one argument that specifies
Xthe Standard MIDI File.
XThis argument is a value returned by
X.Xr midiread 3TCLM
Xor
X.Xr midimake 3TCLM .
X.Sh RETURN VALUES
X.Nm
Xdoes not return anything.
X.Sh SEE ALSO
X.Bl -item -compact
X.It
X.Xr midiread 3TCLM ,
X.It
X.Xr midimake 3TCLM
X.El
X.Sh AUTHORS
XMike Durian - durian@advtech.uswest.com
END-of-tclm0.1/doc/midifree.n
echo x - tclm0.1/doc/midiget.n
sed 's/^X//' >tclm0.1/doc/midiget.n << 'END-of-tclm0.1/doc/midiget.n'
X.Dt MIDIGET 3 TCLM
X.Os TCLM
X.Dd Jan 10, 1993
X.Sh NAME
X.Nm midiget
X.Nd "tclm command to get one event from a track in a Standard MIDI File"
X.Sh SYNOPSIS
X.Nm
X.Ar mfileId
X.Ar track
X.Sh DESCRIPTION
X.Nm
Xis a tclm command that
Xgets one event from the specified track
Xof a
XStandard MIDI File.
XThe first argument specifies the Standard MIDI File
Xand should be a value returned by either
X.Xr midiread 3TCLM
Xor
X.Xr midimake 3TCLM .
XThe second argument specifies which
Xtrack from which to get the event.
XSuccessive calls to
X.Nm
Xon the same track
Xwill get successive events from
Xthat track.
X.Xr midirewind 3TCLM
Xcan be used to
Xreturn to the begining of the track.
X.Sh RETURN VALUES
X.Nm
Xreturns a string of bytes consisting
Xof one complete MIDI event.
XThe bytes are represented in hex form
X(0x??).
X.Sh SEE ALSO
X.Bl -item -compact
X.It
X.Xr midiread 3TCLM ,
X.It
X.Xr midimake 3TCLM ,
X.It
X.Xr midirewind 3TCLM
X.El
X.Sh AUTHORS
XMike Durian - durian@advtech.uswest.com
END-of-tclm0.1/doc/midiget.n
echo x - tclm0.1/doc/midimake.n
sed 's/^X//' >tclm0.1/doc/midimake.n << 'END-of-tclm0.1/doc/midimake.n'
X.Dt MIDIMAKE 3 TCLM
X.Os TCLM
X.Dd Jan 10, 1993
X.Sh NAME
X.Nm midimake
X.Nd "tclm command to create an empty Standard MIDI File"
X.Sh SYNOPSIS
X.Nm
X.Sh DESCRIPTION
X.Nm
Xis a tclm command that creates an empty Standard MIDI File for
Xuse by other MIDI specific tclm commands.
XBy default the Standard MIDI File is created with zero
Xtracks allocated, the format is type one and the division
Xis 120.
XThese defaults can then be changed with
Xthe
X.Xr midiconfig 3TCLM
Xcommand.
X.Pp
XSince
X.Nm
Xallocates space for the Standard MIDI File,
X.Xr midifree 3TCLM
Xshould be used
Xwhen the file is no longer needed.
X.Sh RETURN VALUES
X.Nm
Xreturns a MIDI file
XID for use by other MIDI specific
Xtclm commands.
X.Sh SEE ALSO
X.Xr midiconfig 3TCLM
X.Sh AUTHORS
XMike Durian - durian@advtech.uswest.com
END-of-tclm0.1/doc/midimake.n
echo x - tclm0.1/doc/midimpu.n
sed 's/^X//' >tclm0.1/doc/midimpu.n << 'END-of-tclm0.1/doc/midimpu.n'
X.Dt MIDIMPU 3 TCLM
X.Os TCLM
X.Dd Jan 10, 1993
X.Sh NAME
X.Nm midimpu
X.Nd "tclm command to determine if the MPU-401 commands are available"
X.Sh SYNOPSIS
X.Nm
X.Sh DESCRIPTION
X.Nm
Xis a simple command that returns 1 if the MPU-401
Xcommands,
X.Xr midiplay 3TCLM
Xand
X.Xr midistop 3TCLM ,
Xare available for use.
XSince the MPU-401 commands are currently available only
Xon BSD/386 systems with an MPU-401 compatible MIDI card,
Xthis function is useful for writing programs with
Xvarying functionality.
X.Sh RETURN VALUES
X.Nm
Xreturns 1 if the commands
X.Xr midiplay 3TCLM
Xand
X.Xr midistop 3TCLM
Xare available
Xand 0 if they are not.
X.Sh SEE ALSO
X.Bl -item -compact
X.It
X.Xr midiplay 3TCLM ,
X.It
X.Xr midistop 3TCLM
X.El
X.Sh AUTHORS
XMike Durian - durian@advtech.uswest.com
END-of-tclm0.1/doc/midimpu.n
echo x - tclm0.1/doc/midiplay.n
sed 's/^X//' >tclm0.1/doc/midiplay.n << 'END-of-tclm0.1/doc/midiplay.n'
X.Dt MIDIPLAY 3 TCLM
X.Os TCLM
X.Dd Jan 10, 1993
X.Sh NAME
X.Nm midiplay
X.Nd "tclm command to play a Standard MIDI File"
X.Sh SYNOPSIS
X.Nm
X.Op bg | background
X.Op repeat
X.Op tracks Ar track_list
X.Op reltempo Ar tempo_scalar
X.Ar mfileId
X.Sh DESCRIPTION
X.Nm
Xis a tclm command that plays a Standard MIDI File through
Xthe MPU-401 compatible device under BSD/386.
XIt will not work on systems without BSDI's MPU-401 device
Xdriver.
X.Pp
XIn the most basic form
X.Nm
Xtakes no options and only one argument specifying the
Xfile to be played.
XThis argument should be a MIDI file ID as returned by
X.Xr midiread 3TCLM
Xor
X.Xr midimake 3TCLM .
X.Pp
XIn the other forms,
X.Nm
Xcan take various options to control how
Xthe file is played.
XThe usage of the various options is as follows:
X.Bl -tag -width "bg or background" -offset indent
X.It bg or background
XThese options make
X.Nm
Xfork and play the file in a
Xseparate process.
XThe call returns immediately.
XWithout this option
X.Nm
Xwill block until the file is
Xfinished playing.
X.It repeat
XThis option causes
X.Nm
Xto play the file continuously,
Xrepeating from the beginning of the file
Xwhen the end is reached.
X.It reltempo
XThis option
Xtakes one argument which specifies a value
Xused to scale
Xany tempos found in the file.
XThis value should be a float and
Xshould be in the range 0
Xto 4.
X.It tracks
XThis option takes an argument
Xconsisting of a list of track numbers.
XThe list should be enclosed by curly braces
Xor double quotes.
XWith this option, only those tracks specified
Xin the track
Xlist will be played.
XTrack 0 is the first track.
X.El
X.Sh RETURN VALUES
X.Nm
Xreturns 0
Xwhen called without the
X.Em bg
Xoption, and
Xthe process ID of forked process
Xwhen called with the
X.Em bg
Xoption.
XThis process ID can then be used with the
X.Xr midistop 3TCLM
Xtclm function.
X.Sh SEE ALSO
X.Bl -item -compact
X.It
X.Xr midiread 3TCLM ,
X.It
X.Xr midimake 3TCLM ,
X.It
X.Xr midistop 3TCLM
X.El
X.Sh AUTHORS
XMike Durian - durian@advtech.uswest.com
END-of-tclm0.1/doc/midiplay.n
echo x - tclm0.1/doc/midiput.n
sed 's/^X//' >tclm0.1/doc/midiput.n << 'END-of-tclm0.1/doc/midiput.n'
X.Dt MIDIPUT 3 TCLM
X.Os TCLM
X.Dd Jan 10, 1993
X.Sh NAME
X.Nm midiput
X.Nd "tclm command to put an event in a track in a Standard MIDI File"
X.Sh SYNOPSIS
X.Nm
X.Ar mfileId
X.Ar track
X.Ar event
X.Sh DESCRIPTION
X.Nm
Xis a tclm command that
Xputs an event at the end of a specified
Xtrack in a
XStandard MIDI File.
XThe first argument specifies the Standard MIDI File
Xand should be a value returned by either
X.Xr midiread 3TCLM
Xor
X.Xr midimake 3TCLM .
XThe second argument specifies the
Xtrack in which to get the event.
XThe third argument is the event to
Xinsert.
XIt should be in tcl list form,
Xwith each value in the list being
Xone byte of the event.
XThe event should be surrounded by
Xeither double-quotes or curly braces.
X.Sh RETURN VALUES
X.Nm
Xreturns nothing.
X.Sh BUGS
X.Nm
Xshould only be used at the end
Xof a track.
XIt should be rewritten to handle
Xinserting events in the middle
Xof a track.
X.Sh SEE ALSO
X.Bl -item -compact
X.It
X.Xr midiread 3TCLM ,
X.It
X.Xr midimake 3TCLM ,
X.El
X.Sh AUTHORS
XMike Durian - durian@advtech.uswest.com
END-of-tclm0.1/doc/midiput.n
echo x - tclm0.1/doc/midiread.n
sed 's/^X//' >tclm0.1/doc/midiread.n << 'END-of-tclm0.1/doc/midiread.n'
X.Dt MIDIREAD 3 TCLM
X.Os TCLM
X.Dd Jan 10, 1993
X.Sh NAME
X.Nm midiread
X.Nd "tclm command to read a Standard MIDI File"
X.Sh SYNOPSIS
X.Nm
X.Ar fileId
X.Sh DESCRIPTION
X.Nm
Xis a tclm command that reads a Standard MIDI File for
Xuse by other MIDI specific tclm commands.
X.Pp
X.Nm
Xtakes one argument that specifies a file
Xdescriptor from which to read the Standard MIDI File.
XThis argument should be a value returned by
Xthe
X.Xr open 3TCL
Xtcl command, or
X.Em stdin .
X.Pp
XSince
X.Nm
Xallocates space for the Standard MIDI File,
X.Xr midifree 3TCLM
Xshould be used
Xwhen the file is no longer needed.
X.Sh RETURN VALUES
X.Nm
Xreturns a MIDI file
XID for use by other MIDI specific
Xtclm commands.
XIf there is no data to be read,
X.Nm
Xforces an error and returns
X.Dq EOF.
XThis facilitates determining
Xwhen there are no more files
Xto be read from
X.Em stdin .
X.Sh SEE ALSO
X.Bl -item -compact
X.It
X.Xr open 3TCL ,
X.It
X.Xr midifree 3TCLM
X.El
X.Sh AUTHORS
XMike Durian - durian@advtech.uswest.com
END-of-tclm0.1/doc/midiread.n
echo x - tclm0.1/doc/midirewind.n
sed 's/^X//' >tclm0.1/doc/midirewind.n << 'END-of-tclm0.1/doc/midirewind.n'
X.Dt MIDIREWIND 3 TCLM
X.Os TCLM
X.Dd Jan 10, 1993
X.Sh NAME
X.Nm midirewind
X.Nd "tclm command to reset a Standard MIDI File to the beginning"
X.Sh SYNOPSIS
X.Nm
X.Ar mfileId
X.Op track_list
X.Sh DESCRIPTION
X.Nm
Xis a tclm command that
Xsets the internal place keeper of
Xspecified tracks of
Xa Standard MIDI File to the beginning.
XThe next
X.Xr midiget 3TCLM
Xon one of the specified tracks
Xwill return an event from
Xthe start of that track regardless
Xof the location of any previous
X.Xr midiget 3TCLM
Xcalls.
X.Pp
X.Nm
Xtakes
Xone argument specifying a
XStandard MIDI File descriptor as returned
Xby
X.Xr midiread 3TCLM
Xor
X.Xr midimake 3TCLM ,
Xand one optional
Xargument specifying a list
Xof tracks to be rewound.
XThe track list should be in tcl
Xform and enclosed in either double-quotes
Xor curly braces.
XIf a track list is not specified,
Xall tracks will be rewound.
X.Sh RETURN VALUES
X.Nm
Xdoes not return anything.
X.Sh SEE ALSO
X.Bl -item -compact
X.It
X.Xr midiread 3TCLM ,
X.It
X.Xr midimake 3TCLM ,
X.It
X.Xr midiget 3TCLM
X.El
X.Sh AUTHORS
XMike Durian - durian@advtech.uswest.com
END-of-tclm0.1/doc/midirewind.n
echo x - tclm0.1/doc/midistop.n
sed 's/^X//' >tclm0.1/doc/midistop.n << 'END-of-tclm0.1/doc/midistop.n'
X.Dt MIDISTOP 3 TCLM
X.Os TCLM
X.Dd Jan 10, 1993
X.Sh NAME
X.Nm midistop
X.Nd "tclm command to stop playing a Standard MIDI File playing in the background"
X.Sh SYNOPSIS
X.Nm
X.Ar process_ID
X.Sh DESCRIPTION
X.Nm
Xis a tclm command that stops a Standard MIDI File
Xplaying in the background.
XIt will not work on systems without BSDI's MPU-401 device
Xdriver.
X.Pp
X.Nm
Xtakes one argument that specifies the process ID
Xof the process playing the Standard MIDI File.
XThis value can be obtained by using the return code
Xof the
X.Xr midiplay 3TCLM
Xcommand.
X.Nm
Xwill only work on files being played by executing
X.Xr midiplay 3TCLM
Xwith the
X.Em bg
Xoption.
X.Sh RETURN VALUES
X.Nm
Xreturns 1
Xif it could successfully
Xstop playing the file.
XIt returns 0 if the process
XID does not exist.
X.Sh SEE ALSO
X.Xr midiplay 3TCLM
X.Sh AUTHORS
XMike Durian - durian@advtech.uswest.com
END-of-tclm0.1/doc/midistop.n
echo x - tclm0.1/doc/miditiming.n
sed 's/^X//' >tclm0.1/doc/miditiming.n << 'END-of-tclm0.1/doc/miditiming.n'
X.Dt MIDITIMING 3 TCLM
X.Os TCLM
X.Dd Jan 10, 1993
X.Sh NAME
X.Nm miditiming
X.Nd "tclm command that gets the timing portion of a Standard MIDI File event"
X.Sh SYNOPSIS
X.Nm
X.Ar event
X.Sh DESCRIPTION
X.Nm
Xis a tclm command that
Xreturns the timing portion of a Standard MIDI File event.
XThis command takes only one argument;
Xa Standard MIDI File event.
XThis argument should be
Xin tcl list form,
Xwith each value in the list being
Xone byte of the event.
XThe event should be surrounded by
Xeither double-quotes or curly braces.
X.Sh RETURN VALUES
X.Nm
Xreturns the timing portion of the specified
Xevent.
XSince Standard MIDI File events are in
Xvariable length form, one to four bytes
Xmay be returned.
XThe individual bytes will be in hex notation
X(0x??).
X.Sh SEE ALSO
X.Bl -item -compact
X.It
X.Xr midiget 3TCLM
X.It
X.El
X.Sh AUTHORS
XMike Durian - durian@advtech.uswest.com
END-of-tclm0.1/doc/miditiming.n
echo x - tclm0.1/doc/midivartofix.n
sed 's/^X//' >tclm0.1/doc/midivartofix.n << 'END-of-tclm0.1/doc/midivartofix.n'
X.Dt MIDIVARTOFIX 3 TCLM
X.Os TCLM
X.Dd Jan 10, 1993
X.Sh NAME
X.Nm midivartofix
X.Nd "tclm command that converts a variable length value to a fixed length value"
X.Sh SYNOPSIS
X.Nm
X.Ar event
X.Sh DESCRIPTION
X.Nm
Xis a tclm command that
Xconverts a variable length value specified in a Standard MIDI File
Xevent to a fixed length value.
XThis command takes only one argument;
Xa series of bytes forming a
XStandard MIDI File variable length value.
XAdditional bytes are ignored so complete events can be
Xpassed to
X.Nm
Xto convert the timing portion of the event directly to
Xa fixed length value.
XThis argument should be
Xin tcl list form,
Xwith each value in the list being
Xone byte of the event.
XThe event should be surrounded by
Xeither double-quotes or curly braces.
X.Sh RETURN VALUES
X.Nm
Xreturns a four byte integer (typically a long in C)
Xrepresentation of a Standard MIDI File
Xvariable length value.
XThough a variable length value could represent
Xa value that would not fit in a long, this
Xnever happens in actual usage.
X.Sh AUTHORS
XMike Durian - durian@advtech.uswest.com
END-of-tclm0.1/doc/midivartofix.n
echo x - tclm0.1/doc/midiwrite.n
sed 's/^X//' >tclm0.1/doc/midiwrite.n << 'END-of-tclm0.1/doc/midiwrite.n'
X.Dt MIDIWRITE 3 TCLM
X.Os TCLM
X.Dd Jan 10, 1993
X.Sh NAME
X.Nm midiwrite
X.Nd "tclm command to write a Standard MIDI File"
X.Sh SYNOPSIS
X.Nm
X.Ar mfileId
X.Ar fileId
X.Sh DESCRIPTION
X.Nm
Xis a tclm command that writes Standard MIDI File to
Xan open tcl file descriptor.
X.Pp
XThis command
Xtakes two arguments.
XThe first is a tclm Standard MIDI File descriptor
Xas returned by
X.Xr midiread 3TCLM
Xor
X.Xr midimake 3TCLM ,
Xwhile the second is a tcl file descriptor as
Xreturned by
X.Xr open 3TCL
Xor
X.Em stdout
Xor
X.Em stderr .
X.Sh RETURN VALUES
X.Nm
Xdoes not return anything.
X.Sh SEE ALSO
X.Bl -item -compact
X.It
X.Xr open 3TCL ,
X.It
X.Xr midiread 3TCLM ,
X.It
X.Xr midimake 3TCLM
X.El
X.Sh AUTHORS
XMike Durian - durian@advtech.uswest.com
END-of-tclm0.1/doc/midiwrite.n
echo x - tclm0.1/doc/minfo.n
sed 's/^X//' >tclm0.1/doc/minfo.n << 'END-of-tclm0.1/doc/minfo.n'
X.Dt MINFO 1 TCLM
X.Os TCLM
X.Dd Jan 10, 1993
X.Sh NAME
X.Nm minfo
X.Nd "a tcl script to print a Standard MIDI File in human readable form"
X.Sh SYNOPSIS
X.Nm
X.Op file
X.Sh DESCRIPTION
X.Nm
Xis a
X.Nm tcl
Xscript that reads a Standard MIDI File
Xand prints the data in human readable form.
XIf a file is not specified on the command
Xline
X.Nm
Xwill read from
X.Em stdin .
X.Sh SEE ALSO
X.Xr tclm 3TCLM
X.Sh AUTHORS
XMike Durian - durian@advtech.uswest.com
END-of-tclm0.1/doc/minfo.n
echo x - tclm0.1/doc/mplay.n
sed 's/^X//' >tclm0.1/doc/mplay.n << 'END-of-tclm0.1/doc/mplay.n'
X.Dt MPLAY 1 TCLM
X.Os TCLM
X.Dd Jan 10, 1993
X.Sh NAME
X.Nm mplay
X.Nd "a tcl script to play Standard MIDI Files"
X.Sh SYNOPSIS
X.Nm
X.Op Fl r
X.Op Fl t Ar tracks
X.Op Fl s Ar speed
X.Op file ...
X.Sh DESCRIPTION
X.Nm
Xis a
X.Nm tcl
Xscript that plays Standard MIDI Files.
XMultiple files may be specified on
Xthe command line, or files can be
Xread from
X.Em stdin .
XThe options are as follows:
X.Bl -tag -width -offset indent
X.It Fl r
XPlay the first file repeatedly.
XThe playing will continue until the
Xprocess is killed.
X.It Fl t
XSpecifies a list of tracks to be played
Xinstead of the default, which is to play
Xall tracks.
XThis option has an argument that lists
Xthe tracks.
XThe argument needs to be treated as one argument
Xinstead of multiple values, and thus should
Xbe enclosed in double or single quotes.
X.It Fl s
XSpecifies a tempo modifier.
XThe argument to this option is a float
Xvalue in the range 0 to 4 that acts as
Xa multipiler for the tempo values found
Xin the Standard MIDI Files.
X.El
X.Pp
XSince
X.Nm
Xmakes use of the
X.Nm midiplay
X.Nm tclm
Xcommand,
Xthis program will only work on
XBSD/386 systems equipped with
Xa MPU-401 compatible MIDI card.
XAn error message is printed to
Xstderr if the script is run
Xby a
X.Nm tclm
Xinterpreter without the MPU-401
Xextensions.
X.Sh SEE ALSO
X.Xr tclm 3TCLM
X.Sh AUTHORS
XMike Durian - durian@advtech.uswest.com
END-of-tclm0.1/doc/mplay.n
echo x - tclm0.1/doc/tclm.n
sed 's/^X//' >tclm0.1/doc/tclm.n << 'END-of-tclm0.1/doc/tclm.n'
X.Dt TCLM 1 TCLM
X.Os TCLM
X.Dd Jan 10, 1993
X.Sh NAME
X.Nm tclm
X.Nd "a tcl interpreter with MIDI extensions"
X.Sh SYNOPSIS
X.Nm
X.Op Fl f Op Ar filename
X.Sh DESCRIPTION
X.Nm
Xis a
X.Nm tcl
Xinterpreter with MIDI extensions allowing
Xit to manipulate Standard MIDI Files and in some
Xcases play Standard MIDI Files.
X.Nm Tcl
Xis a Tool Command Language
Xwritten by John Ousterhout.
X.Pp
X.Nm
Xhas only one option:
X.Bl -tag -width Fl f -offset indent
X.It Fl f
XThis option has one optional argument
Xthat specifies the name of a file
Xcontaining tclm commands.
XThese commands are executed
Xin place of reading from stdin.
XWithout the optional argument
Xcommands are read from
X.Em stdin .
X.El
XWithout the
X.Fl f
Xoption
X.Nm
Xdisplays a
X.Dq tclm:
Xprompt and reads
Xcommands from
X.Em stdin .
X.Ss TCLM EXTENSION
X.Nm
Xhas a few extensions which
Xaid in the manipulation of
XStandard MIDI Files (SMF).
XThey are:
X.Bl -tag -width "midivartofix" -offset indent
X.It Nm midiconfig
XChanges configuration values in a SMF.
X.It Nm midifixtovar
XConverts fixed length integers to SMF variable
Xlength values.
X.It Nm midifree
XFrees the space used by SMF's.
X.It Nm midiget
XGets one event from a track in a SMF.
X.It Nm midimake
XCreates an empty SMF.
X.It Nm midimpu
XChecks to see if the MPU-401 extensions are available.
X.It Nm midiput
XPuts an event in a track in a SMF.
X.It Nm midiread
XReads a SMF from an open file descriptor.
X.It Nm midirewind
XResets a SMF to its beginning.
X.It Nm miditiming
XGets the timing portion of a SMF event.
X.It Nm midivartofix
XConverts a SMF variable length value to a fixed
Xlength integer.
X.It Nm midiwrite
XWrites a SMF to an open file descriptor.
X.El
X.Pp
XThere are also two commands available for playing
XSMF.
XSince they use BSDI's MPU-401 device driver, they
Xare only available for BSD/386 machines with
Xan MPU-401 card.
XThe
X.Nm midimpu
Xcommand can be used to selectively
Xenable or disable MPU-401 specific commands
Xin scripts meant to run on BSD/386 as well
Xas other machines.
XThese commands are:
X.Bl -tag -width midiplay -offset indent
X.It Nm midiplay
XPlay a SMF.
X.It Nm midistop
XStop a SMF that is currently playing in the background.
X.El
X.Sh SEE ALSO
X.Xr midiconfig 3TCLM ,
X.Xr midifixtovar 3TCLM ,
X.Xr midifree 3TCLM ,
X.Xr midiget 3TCLM ,
X.Xr midimake 3TCLM ,
X.Xr midimpu 3TCLM ,
X.Xr midiplay 3TCLM ,
X.Xr midiput 3TCLM ,
X.Xr midiread 3TCLM ,
X.Xr midirewind 3TCLM ,
X.Xr midistop 3TCLM ,
X.Xr miditiming 3TCLM ,
X.Xr midivartofix 3TCLM ,
X.Xr midiwrite 3TCLM
X.Sh AUTHORS
X.Bl -item -compact
X.It
XJohn Ousterhout - ouster@cs.berkely.edu for the TCL stuff
X.It
XMike Durian - durian@advtech.uswest.com for the MIDI stuff
X.El
END-of-tclm0.1/doc/tclm.n
exit
Newsgroups: comp.lang.tcl