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

.SH NAME
.upperok
alInit \- initialize the Ultra 64 Audio Library

.SH SYNOPSIS
.nf
\f3
.Op c
#include <libaudio.h>
.sp .8v
void    alInit(ALGlobals *globals, ALSynConfig *c);
.Op
\f1
.fi
.SH PARAMETERS
.TP 10
.B globals
pointer to the ALGlobals structure.
.TP
.B c
pointer to the Synthesis Driver configuration structure.
.SH DESCRIPTION
In order to use the Audio Library, you must first call
.I
alInit(),
which initializes a Synthesis driver with the configuration,
.I c,
and initializes the Audio Library global variables.
.SH CONFIGURATION STRUCTURE
.TP 10
.I maxVVoices
maximum number of virtual voices to allocate.
.TP
.I maxPVoices
maximum number of physical voices to allocate.
.TP
.I maxUpdates
maximum number of synthesizer updates to allocate.
.TP
.I maxFXBusses
maximum number of effects busses to allocate.
.TP
.I dmaproc
pointer to the Audio DMA callback initialization routine. This routine
will get called once for each physical voice, and must return a pointer
to the ALDMAproc the voice will use when requesting a DMA of audio samples.
.TP
.I heap
a pointer to an ALHeap structure that has been initialize with a call to 
alHeapInit().
.TP
.I outputRate
the desired hardware output rate. (ie. 22k, 32k, 44.1k)
.TP 
.I fxType
the desired effects type. 
.TP
.I params
pointer to the parameter list to use when constructing a custom 
effects chain.
.SH SEE ALSO
.IR alClose (3P),
.IR alHeapInit (3p)