AXSetMode

Syntax

#include <revolution/ax.h>

void AXSetMode(u32 mode);

Arguments

mode

AX_MODE_STEREO	This is the default mode of AX. Any sounds panned to the surround channel will be delayed by one audio frame, then distributed into main left and right. Volume must be attenuated by -3 dB for the surround channel.
AX_MODE_SURROUND	Any sounds panned to the surround channel will be surround-encoded. The encoding method is compatible with Dolby Surround and Dolby Prologic decoders. Note that this output mode supports a single (mono) surround channel. Sounds panned to the surround channel must be attenuated by -3 dB.
AX_MODE_DPL2	This output mode supports two surround channels via Dolby Prologic II encoding. Note: The Aux C effect bus is not available in this output mode.

Return Values

None.

Description

The AXSetMode function sets the output mode of AX.

In order to play surround data that is compatible with the Dolby Surround and Dolby Pro Logic II Decoder, the surround channel needs to be attenuated by -3 dB. Within AX related libraries, this -3 dB attenuation is processed by the MIX library. When not using the MIX library, the application needs to process this -3 dB attenuation. To see an example of implementing for Dolby Surround, refer to the source code of the MIX library.

Revision History

2006/06/19 Corrected the effect bus, which is disabled in DPL2 mode (changed from Aux B to Aux C).
2006/03/01 Initial version.