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





n_alSynAddSndPlayer

Syntax
#include <n_libaudio.h>
void n_alSynAddSndPlayer(ALPlayer *client);

Arguments

  • client is the pointer to the sound player client to be added

Explanation
This function is available in the n_audio library. It registers the sound player at the synthesizer driver as a client. To optimize performance, n_audio allows a synthesizer to have only one sound player active (registered) at any one point in time. All clients are called back by the driver when client event times are reached.

Ensure that this function is not called while a call to n_alAudioFrame is processing. This could happen if n_alSynAddSndPlayer is called from within a voice handler, or if the thread that calls n_alAudioFrame is blocked for some reason.

Note that this function is for use by those who want to develop their own client players. It is already called from within n_alSndpNew function. For information on how to build your own client player, see the audio section of the N64 Programming Manual.

See Also
n_alSynRemovePlayer
n_alAudioFrame
n_alSndpNew



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