#include <nitro/snd.h>
void SND_SetTrackVolume( int playerNo, u32 trackBitMask, int volume );
playerNo |
The Player number. Takes a value between 0 and 15. |
trackBitMask |
This is the track bit mask. It designates which track to use. |
volume |
The volume. Set in units of 0.1dB, takes a value between -723 and 0. |
Changes the volume of the tracks 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.
This volume value affects individual tracks. To change the volume of the overall sequence, use the SND_SetPlayerVolume
function.
This function is an ARM7 reserved function. After this function is called, processing occurs only after the command is issued with the SND_FlushCommand
function.
When it is necessary to synchronize something with the completion of the process, first use SND_GetCurrentCommandTag
to obtain the command tag immediately after calling this function. After the command is issued, use the command tag and call either the SND_IsFinishedCommandTag
or SND_WaitForCommandProc
function to confirm that the process has finished or to wait for it to complete.
SND_SetPlayerVolume, SND_FlushCommand, SND_GetCurrentCommandTag, SND_IsFinishedCommandTag, SND_WaitForCommandProc
02/17/2005 Added a note about ARM7 command processing
07/01/2004 Initial version