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





alInit

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

Arguments

  • globals is the pointer to the ALGlobals structure
  • c is the pointer to the Synthesis Driver configuration structure

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

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



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