N64® Functions Menu

al - Audio Library Functions
gDP - DP GBI Macros
gdSP - General GBI Macros
gSP - SP GBI Macros
gt - Turbo Microcode RDP
gu - Graphics Utilities
Math - Math Functions
nuSys - NuSystem
os - N64 Operating System
sp - Sprite Library Functions
uh - Host to Target IO
64DD - N64 Disk Drive

Nintendo® Confidential

## alSynNew

Syntax

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

Arguments

- drvr is the pointer to the synthesizer driver
- c is the pointer to the synthesizer configuration

Explanation
It 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 are:

- maxVVoices is the maximum number of virtual voices.
- maxPVoices is the maximum number of physical voices.
- maxUpdates is the maximum number of pending parameter updates.
- maxFXBusses is the maximum number of auxiliary effect busses. (Currently this value is ignored, and a maximum of one bus is imposed.)
- dmaproc is the pointer to procedure to use when initializing DMA callbacks.
- heap is the pointer to audio system memory heap.
- outputRate is the number of samples per second for the synthesizer to generate.
- fxType is the 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 is the pointer to an array of arguments to be used in the case of AL_FX_CUSTOM. For more information on these arguments, see the Nintendo 64 Programming Manual audio section that explains how to create custom effects.

See Also
alSynDelete

Nintendo® Confidential Warning: all information in this document is confidential and covered by a non-disclosure agreement. You are responsible for keeping this information confidential and protected. Nintendo will vigorously enforce this responsibility.
Copyright © 1998
Nintendo of America Inc. All rights reserved
Nintendo and N64 are registered trademarks of Nintendo
Last Updated April, 1999