#include <nitro/snd.h>
void SND_PrepareSeq( int playerNo, const void* base, u32 offset, const SNDBankData* bank );
playerNo |
The Player number. Takes a value between 0 and 15. |
base |
The base address of the sequence data. |
offset |
The start position offset for the sequence data. |
bank |
This is the bank data pointer. |
Prepares the sequence for playback.
Prepares the sequence for playback on the player indicated by playerNo
. Any sequence that is already being played on that player will be forcibly stopped.
Sequence data is processed from the offset position (offset
) from the base address (base
).
For bank, bank
, specify the bank which the sequence uses for sound generation. Furthermore, the waveform archive needs to be connected with SND_AssignWaveArc
function beforehand.
To play a sequence that has been prepared for playback, call SND_StartPreparedSeq
.
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_AssignWaveArc, SND_StartPreparedSeq, SND_FlushCommand, SND_GetCurrentCommandTag, SND_IsFinishedCommandTag, SND_WaitForCommandProc
04/14/2005 Initial version