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

   

alSndpSetPitch

Format
#include <libaudio.h>
void alSndpSetPitch(ALSndPlayer *sndp, f32 pitch);


Arguments
  • sndp is the pointer to a sound player
  • pitch is the pitch value (1 for the original pitch, fractional values for lower pitches (for example, use .5 for an octave lower than the original pitch), 2 for the maximum (an octave higher))
What This Function Does
It sets the pitch of the current target sound. If the sound is playing, the pitch will be adjusted. If the sound is not playing, this call will effect the pitch of the sound when it is played.

To set the target sound, call alSndpSetSound.

The maximum allowable pitch is 2.0. Values greater than 2.0 are clipped to 2.0 when the sound is played. The minimum allowable pitch is 0.0001. Values less than 0.0001 are clipped to 0.0001 when the sound is played. Note that this value represents the practical limit for pitch shifting because it causes a 20 kHz sound to be played at 20 Hz.

See Also
alSndpSetSound
alSndpSetVol
alSndpSetPan
alSndpSetFXMix



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 January 1998