alSeqpSendMidi.3p
1.41 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
.TH alSeqpSendMidi 3P local "Silicon Graphics, Inc."
.SH NAME
.upperok
alSeqpSendMidi \- sends the given MIDI message to the sequence player.
.SH SYNOPSIS
.nf
\f3
.Op c
#include <libaudio.h>
.sp .8v
void alSeqpSendMidi(ALSeqPlayer *seqp, long ticks, u8 status,
u8 byte1, u8 byte2);
.Op
\f1
.fi
.SH PARAMETERS
.TP 10
.I seqp
pointer to sequence player.
.TP
.I ticks
time offset, in MIDI clock ticks that the MIDI event is to occur.
.TP
.I status
the message's MIDI status byte.
.TP
.I byte1
the first byte in the message.
.TP
.I byte2
the second byte in the message (if required).
.SH DESCRIPTION
alSeqpSendMidi sends a MIDI message to the 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. alSeqpSendMidi can be used as an alternative for
.B alSeqpSetChlProgram, alSeqpSetChlVol, alSeqpSetChlPan,
and
.B alSeqpSetChlFXMix.
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
.IR alSeqPlayer (3P)