alInit, n_allnit

Initializes the N64 Audio Library

Syntax

#include <libaudio.h>     /* libaudio.h */
void alInit(ALGlobals *globals, ALSynConfig *c);

#include <n_libaudio.h>     /* n_libaudio.h */
void n_alInit(N_ALGlobals *globals, ALSynConfig *c);

Arguments

globals

Pointer to the ALGlobals structure

c

Pointer to the Synthesis Driver configuration structure

Description

To use the Audio Library, you must first call the allnit function, which initializes a Synthesis driver with the configuration specified by c and initializes the Audio Library global variables.

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

Configuration Structure

The configuration structure includes these members:

• maxVVoices is maximum number of virtual voices to allocate
• maxPVoices is the maximum number of physical voices to allocate
• maxUpdates is the maximum number of synthesizer updates to allocate
• maxFXBusses is the maximum number of effects busses to allocate
• dmaproc is the pointer to the Audio DMA callback initialization routine, which is called once for each physical voice and must return a pointer to the ALDMAproc that the voice will use when requesting a direct memory access (DMA) of audio samples
• heap is the pointer to an ALHeap structure that has been already been initialized by a call to the alHeapInit function
• outputRate is the desired hardware output rate (22k, 32k, or 44.1k)
• fxType is the desired effects type
• params is the pointer to the parameter list to use when constructing a custom effects chain

See Also

alClose, alHeapInit

Revision History

1999/04/30 Changed Format