SND_SetOutputSelector

Syntax

#include <nitro/snd.h>
void SND_SetOutputSelector(
        SNDOutput left,
        SNDOutput right,
        SNDChannelOut channel1,
        SNDChannelOut channel3 );

Arguments

left The left output selector.
right The right output selector.
channel1 The channel 1 output selector.
channel3 The channel 3 output selector.

Return Values

None.

Description

Changes the output selector.

Choose from among the following values for the left output selector left and the right output selector right.

Table. SNDOutput

Label Description
SND_OUTPUT_MIXER Output LR mixer output at final stage.
SND_OUTPUT_CHANNEL1 Output the channel 1 output at final stage.
SND_OUTPUT_CHANNEL3 Output the channel 3 output at final stage.
SND_OUTPUT_CHANNEL1_3 Output channel 1 + channel 3 output at final stage.

Choose from among the following values for the channel 1 selector channel1 and the channel 3 selector channel3.

Table. SNDChannelOut

Label Description
SND_CHANNEL_OUT_MIXER Send channel 1 output or channel 3 output to the mixer. (It is also sent to the bypass.)
SND_CHANNEL_OUT_BYPASS Have the channel 1 output or channel 3 output bypass the mixer. (It is not sent to the mixer.)

In the initial settings, left and right are set to SND_OUTPUT_MIXER, and channel1 and channel3 are set to SND_CHANNEL_OUT_MIXER.

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/06/13 Made changes following revisions to the NITRO Programming Manual.
2005/02/17 Added a note on ARM7 command processing.
2005/07/20 Initial version.

CONFIDENTIAL