alSynNew, n_alSynNew

Allocates the specified synthesizer driver

Syntax

#include <libaudio.h>     /* libaudio.h */
void alSynNew(ALSynth *drvr, ALSynConfig *c);

#include <n_libaudio.h>     /* n_libaudio.h */
void n_alSynNew(             ALSynConfig *c);

Arguments

drvr

Pointer to the synthesizer driver

c

Pointer to the synthesizer configuration

Description

alSynNew initializes the synthesizer driver structure pointed to by the drvr argument by using the arguments specified in the configuration structure. This function allocates memory from the heap for voices and driver objects. Always call this function before calling alAudioFrame. The configuration structure arguments include

maxVVoices

maximum number of virtual voices

maxPVoices

maximum number of physical voices

maxUpdates

maximum number of pending parameter updates

maxFXBusses

maximum number of auxiliary effect busses (Currently it is ignored as one bus is supported)

dmaproc

Pointer to procedure to use when initializing DMA callbacks.

heap

Pointer to audio system memory heap

outputRate

Number of samples per second for the synthesizer to generate

fxType

type of effect to use. It can be AL_FX_NONE, AL_FX_SMALLROOM, AL_FX_BIGROOM, AL_FX_ECHO, AL_FX_CHORUS, AL_FX_FLANGE or AL_FX_CUSTOM.

params

Pointer to an array of arguments to be used in the case of AL_FX_CUSTOM.

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

See Also

alSynDelete

Revision History

1999/04/30 Changed Format