SND_SetTrackPitch 
Syntax
#include <nitro/snd.h>void SND_SetTrackPitch( int playerNo, u32 trackBitMask, int pitch );
Arguments
playerNo |
The player number. Takes a value between 0 and 15. |
trackBitMask |
This is the track bit mask. It designates which track to use. |
pitch |
The degree to which to change the pitch. Takes a value between -32768 and 32767. |
Description
Changes the track pitch of the sequence being played by the Player specified by playerNo.
The track bit mask, trackBitMask, designates which track to use. Each bit expresses a track in descending order track 0 as the lowest bit. Operations are performed only on tracks with active bits.
Setting a positive value for pitch raises the pitch, while setting a negative value lowers the pitch. A value of +/- 64 changes the pitch by exactly one half-note.
Note
This function is an ARM7 reserved function. After this function is called, its processing will occur only after the command is issued with the SND_FlushCommand function.
If program execution must be synchronized with process completion, first use the SND_GetCurrentCommandTag function to obtain the command tag immediately after calling this function. Then, after the command is issued, use the command tag and call either the SND_IsFinishedCommandTag or SND_WaitForCommandProc function to confirm that processing has finished or to wait for it to complete.
See Also
SND_FlushCommand, SND_GetCurrentCommandTag, SND_IsFinishedCommandTag, SND_WaitForCommandProc
Revision History
2005/02/17 Added a note about ARM7 command processing.
2004/07/01 Initial version.