alSeqpGetChlVol.3p 1.03 KB
.TH alSeqpGetChlVol 3P local "Silicon Graphics, Inc."

.SH NAME 
.upperok 
alSeqpGetChlVol \- returns the volume for the given MIDI channel.

.SH SYNOPSIS
.nf
\f3
.Op c
#include <libaudio.h>
.sp .8v
u8   alSeqpGetChlVol(ALSeqPlayer *seqp, u8 chan);
.Op
\f1
.fi
.SH PARAMETERS
.TP 10
.i seqp
pointer to a Type 0 MIDI sequence player. 
.TP
.I chan
the target (0 based) MIDI channel.
.SH DESCRIPTION
alSeqpGetChlVol returns the volume for the given MIDI channel at the end of 
the last call to 
.I alAudioFrame. 
A value of 127 is full volume, and 0 is "off". Because messages generated by 
.I alSeqpSetChlVol 
are not processed until the next 
call to 
.I alAudioFrame,
a call to 
.I alSeqpSetChlVol 
followed by a call to
.I alSeqpGetChlVol 
within the same frame will not reflect 
the new value.

.SH NOTE
In addition to channel volume, the sequence player maintains an overall
sequence volume which can be accessed and set with
.I alSeqpGetVol
and 
.I alSeqpSetVol.

.SH SEE ALSO 
.IR alSeqpSetChlVol (3P),
.IR alSeqpGetVol (3P),
.IR alSeqPlayer (3P)