MIXInitChannel

Syntax

#include <revolution.h>
#include <revolution/mix.h>

void MIXInitChannel(
                   AXVPB *p,       //pointer to voice
                   u32   mode,     // Aux A, Aux B, Aux C mode and mute settings
                   int   input,    //initial input atten/gain
                   int   auxA,     //initial aux A atten/gain
                   int   auxB,     //initial aux B atten/gain
                   int auxC,       //Aux C initial atten/gain
                   int   pan,      //initial pan
                   int   span,     //initial span
                   int   fader     //initial fader atten/gain
                   );

Arguments

p Specifies a pointer to the AXVPB structure acquired from AX by the user. This must be a valid pointer returned by AXAcquireVoice.
mode Specifies the initial modes for controlling Aux A, Aux B, Aux C, and mute. This value is the bits identified by the OR logic within the following:
MIX_MODE_AUXA_PREFADER Specifies that Aux A is in pre-fader mode. If not specified, Aux A is in post-fader mode.
MIX_MODE_AUXB_PREFADER Specifies that Aux B is in pre-fader mode. If not specified, Aux B is in post-fader mode.
MIX_MODE_AUXC_PREFADER Indicates that Aux C is in pre-fader mode. If not specified, Aux C is in post-fader mode.
MIX_MODE_MUTE Indicates that input will be muted. If not specified, input will not be muted.
input Specifies the initial attenuation for input control in 0.1-dB increments (1 = 0.1 dB).
auxA Specifies the initial attenuation for Aux A control in 0.1-dB increments (1 = 0.1 dB).
auxB Specifies the initial attenuation for Aux B control in 0.1-dB increments (1 = 0.1 dB).
auxC Specifies the initial attenuation for AuxC control in 0.1-dB increments  (1 = 0.1 dB). This value is ignored when the sound mode is Dolby Pro Logic II (MIX_SOUND_MODE_DPL2).
pan Specifies the initial value for pan control (left = 0, center = 64, right = 127).
span Specifies the initial value for span control (surround = 0, center = 64, front = 127).
fader Specifies the initial attenuation for fader control in 0.1-dB increments (1 = 0.1 dB).

Return Values

None.

Description

The MIXInitChannel function associates the AX voice specified by the argument with a mixer channel, and initializes the parameters of the mixer channel.

In order to control AX voices via the mixer, you need to use this function to assign each AX voice to a separate mixer channel. First use the AXAcquireVoice function to get an AX voice (AXVPB). Then specify the pointer to that voice as the first argument of the function.

See Also

AXAcquireVoice

Revision History

2009/05/15 Revised the description of the auxC argument. Edited Description.
2006/03/01 Initial version.

CONFIDENTIAL