alSeqpSendMidi, n_alSeqpSendMidi

Sends the given MIDI message to the sequence player

Syntax

#include <libaudio.h>     /* libaudio.h */
void alSeqpSendMidi(    ALSeqPlayer *seqp, long ticks, u8 status, u8 byte1, u8 byte2);

#include <n_libaudio.h>     /* n_libaudio.h */
void n_alSeqpSendMidi(N_ALSeqPlayer *seqp, s32 ticks,  u8 status, u8 byte1, u8 byte2);

Arguments

seqp

Pointer to sequence player

ticks

Time offset, in MIDI clock ticks, when the MIDI event is to occur

status

Message's MIDI status byte

byte1

The first byte in the message

byte2

The second byte in the message (if required)

Description

alSeqpSendMidi sends a MIDI message to the sequence player. You can use it to trigger notes, not in the sequence. For instance, it adds controller information in real time or changes the performance of a sequence. You can also use it as an alternative to the following function calls such as alSeqpSetChlProgram, alSeqpSetChlVol, alSeqpSetChlPan, and alSeqpSetChlFXMix.

Only channel voice messages are supported. See the MIDI 1.0 specification or any other relating documents for more information.

ticks contains the time offset, in MIDI clock ticks, when the MIDI event is to occur. The 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.

For details on n_audio library, see "Chapter 28: n_audio library" in the N64 Programming Manual.

Revision History

1999/04/30 Changed Format