.TH alSynAddPlayer 3P local "Silicon Graphics, Inc."

.SH NAME 
.upperok 
alSynAddPlayer \- add a client player to the synthesizer.

.SH SYNOPSIS
.nf
\f3
.Op c
#include <libaudio.h>
.sp .8v
void	alSynAddPlayer(ALSynth *drvr, ALPlayer *client);
.Op
\f1
.fi
.SH PARAMETERS
.TP 10
.I drvr
pointer to the synthesizer driver. 
.TP
.I client
pointer to the client to be added.
.SH DESCRIPTION
Add a client player (e.g. a sequence player) to the synthesizer driver.
A synthesizer can have multiple players. All clients will be called back 
by the driver when client event times are reached.

Care must be taken that alSynAddPlayer is not called while a call to 
alAudioFrame is processing. This could happen if alSynAddPlayer is 
called from within a voice handler, or if the thread that calls 
alAudioFrame is blocked for some reason.

Note that this function is for use by those who wish to develop their
own client players. This function is already called from within
alSeqpNew and alSndpNew. Details of building your own client player 
are discussed in the Ultra 64 Programming Guide's audio section.
.SH SEE ALSO
.IR alSynRemovePlayer (3P)