alCSPGetChlVol, n_alCSPGetChlVol

Returns the volume for the given MIDI channel

Syntax

#include <libaudio.h>     /* libaudio.h */
u8 alCSPGetChlVol(    ALCSPlayer *seqp, u8 chan);

#include <n_libaudio.h>     /* n_libaudio.h */
u8 n_alCSPGetChlVol(N_ALCSPlayer *seqp, u8 chan);

Arguments

seqp

Pointer to the compressed MIDI sequence player

chan

Target (0 based) MIDI channel

Description

alCSPGetChlVol returns the volume for the given MIDI channel at the end of the last call to alAudioFrame. A value of 127 is full volume, and 0 is off.

Because messages generated by the alCSPSetChlVol function are not processed until the next call to alAudioFrame , a call to alCSPSetChlVol followed by a call to alCSPGetChlVol within the same frame will not reflect the new value.

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

Note

In addition to channel volume, the sequence player maintains an overall sequence volume that can be accessed and set by using the alCSPGetVol and alCSPSetVol functions.

See Also

alCSPSetChlVol, alCSPGetVol, alCSeqPlayer, and alCSPSetVol

Revision History

1999/04/30 Changed Format