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_alSndpSetPitch

Format
#include <n_libaudio.h>
void n_alSndpSetPitch(f32 pitch);


Arguments
  • 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
This function is available in the n_audio library. It sets the pitch of the current target sound. If the pitch argument is a fraction less than one, the pitch goes down; if it is greater than one, the pitch goes up. If the sound is playing, the pitch is adjusted immediately. If the sound is not playing, this call changes the pitch of the sound when it is played.

To set the target sound, call n_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
n_alSndpSetSound
n_alSndpSetVol
n_alSndpSetPan
n_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