alSeqpGetChlVol (function)

alSeqpGetChlVol, n_alSeqpGetChlVol

Returns the volume for the given MIDI channel

Syntax

#include <libaudio.h>     /* libaudio.h */
u8 alSeqpGetChlVol(    ALSeqPlayer *seqp, u8 chan);
#include <n_libaudio.h>     /* n_libaudio.h */
u8 n_alSeqpGetChlVol(N_ALSeqPlayer *seqp, u8 chan);

Arguments

seqp
Pointer to a Type 0 MIDI sequence player

chan
Target (0 based) MIDI channel

Description

alSeqpGetChlVol 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 alSeqpSetChlVol are not processed until the next call to alAudioFrame, a call to alSeqpSetChlVol followed by a call to alSeqpGetChlVol within the same frame will not reflect the new value.

For details on n_audio library, see the "Chapter 28 n_audio library" section of the programming manual.

Note

n addition to channel volume, the sequence player maintains an overall sequence volume that can be retrieved and set by using the alSeqpGetVol and alSeqpSetVol functions.

See Also

alSeqpSetChlVol, alSeqpGetVol, alSeqPlayer

Revision History

1999/04/30 Changed Format