alCSPSendMidi.3p 1.44 KB
.TH alCSPSendMidi 3P local "Silicon Graphics, Inc."

.SH NAME 
.upperok 
alCSPSendMidi \- sends the given MIDI message to the compressed sequence 
player.

.SH SYNOPSIS
.nf
\f3
.Op c
#include <libaudio.h>
.sp .8v
void    alCSPSendMidi(ALCSPlayer *seqp, long ticks, u8 status,
                       u8 byte1, u8 byte2);
.Op
\f1
.fi
.SH PARAMETERS
.TP 10
.B seqp
pointer to compressed MIDI sequence player. 
.TP
.B ticks
time offset, in MIDI clock ticks that the MIDI event is to occur.
.TP
.B status
the message's MIDI status byte.
.TP
.B byte1
the first byte in the message.
.TP
.B byte2
the second byte in the message (if required).
.SH DESCRIPTION
alCSPSendMidi sends a MIDI message to the compressed MIDI sequence player. 
This can be used to trigger notes not in the sequence, add controller
information in realtime, or otherwise change the performance of a
sequence. alCSPSendMidi can be used as an alternative for 
.B alCSPSetChlProgram, alCSPSetChlVol, alCSPSetChlPan, 
and 
.B alCSPSetChlFXMix. 
Note that only channel voice messages are supported. See the
MIDI 1.0 specification or any of the various World Wide Web MIDI pages
for more information.
.PP
The
.I ticks
field contains the time offset (in MIDI clock ticks) at which the
event is to occur. The
.I status
byte contains the message type in the high nibble and the channel
number in the low nibble. The next bytes are the MIDI data, which is
determined by the message type.

.SH SEE ALSO
alCSeqPlayer(3P)