1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<HTML>
3<HEAD>
4<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css">
5<TITLE>MIXInitChannel</TITLE>
6<META http-equiv="Content-Type" content="text/html; charset=utf-8">
7<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 6.5.0.0 for Windows">
8<META http-equiv="Content-Style-Type" content="text/css">
9</HEAD>
10<BODY>
11
12<H1 align="left">MIXInitChannel</H1>
13
14<H2>Syntax</H2>
15<dl><dd><pre class="construction">
16#include &lt;revolution.h&gt;
17#include &lt;revolution/mix.h&gt;
18
19void MIXInitChannel(
20                   AXVPB *p,       //pointer to voice
21                   u32   mode,     // Aux A, Aux B, Aux C mode and mute settings
22                   int   input,    //initial input atten/gain
23                   int   auxA,     //initial aux A atten/gain
24                   int   auxB,     //initial aux B atten/gain
25                   int auxC,       //Aux C initial atten/gain
26                   int   pan,      //initial pan
27                   int   span,     //initial span
28                   int   fader     //initial fader atten/gain
29                   );
30</pre></dd></dl>
31
32<H2>Arguments</H2>
33<TABLE class="arguments" border="1" >
34  <TBODY>
35    <TR>
36<TH>p</TH>
37<TD>Specifies a pointer to the <CODE>AXVPB</CODE> structure acquired from AX by the user. This must be a valid pointer returned by <A href="../../ax/Voice_Allocation/AXAcquireVoice.html"><CODE>AXAcquireVoice</CODE></A>.</TD>
38    </TR>
39    <TR>
40<TH>mode</TH>
41<TD>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:<br>
42        <TABLE class="arguments" border="1" >
43          <tr>
44<th>MIX_MODE_AUXA_PREFADER</th>
45<td>Specifies that Aux A is in pre-fader mode. If not specified, Aux A is in post-fader mode.</td>
46          </tr>
47          <tr>
48<th>MIX_MODE_AUXB_PREFADER</th>
49<td>Specifies that Aux B is in pre-fader mode. If not specified, Aux B is in post-fader mode.</td>
50          </tr>
51          <tr>
52<th>MIX_MODE_AUXC_PREFADER</th>
53<td>Indicates that Aux C is in pre-fader mode. If not specified, Aux C is in post-fader mode.</td>
54          </tr>
55          <tr>
56<th>MIX_MODE_MUTE</th>
57<td>Indicates that input will be muted. If not specified, input will not be muted.</td>
58          </tr>
59        </table>
60      </TD>
61    </TR>
62    <TR>
63<TH>input</TH>
64<TD>Specifies the initial attenuation for input control in 0.1-dB increments (1 = 0.1 dB).</TD>
65    </TR>
66    <TR>
67<TH>auxA</TH>
68<TD>Specifies the initial attenuation for Aux A control in 0.1-dB increments (1 = 0.1 dB).</TD>
69    </TR>
70    <TR>
71<TH>auxB</TH>
72<TD>Specifies the initial attenuation for Aux B control in 0.1-dB increments (1 = 0.1 dB).</TD>
73    </TR>
74    <TR>
75<TH>auxC</TH>
76<TD>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 (<code>MIX_SOUND_MODE_DPL2</code>).</TD>
77    </TR>
78    <TR>
79<TH>pan</TH>
80<TD>Specifies the initial value for pan control (left = 0, center = 64, right = 127).</TD>
81    </TR>
82    <TR>
83<TH>span</TH>
84<TD>Specifies the initial value for span control (surround = 0, center = 64, front = 127).</TD>
85    </TR>
86    <TR>
87<TH>fader</TH>
88<TD>Specifies the initial attenuation for fader control in 0.1-dB increments (1 = 0.1 dB).</TD>
89    </TR>
90  </TBODY>
91</TABLE>
92
93<H2>Return Values</H2>
94<P>None.</P>
95
96<H2>Description</H2>
97<P>The <CODE>MIXInitChannel</CODE> function associates the AX voice specified by the argument with a mixer channel, and initializes the parameters of the mixer channel.</P>
98
99<P>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 <A href="../../ax/Voice_Allocation/AXAcquireVoice.html"><CODE>AXAcquireVoice</CODE></A> function to get an AX voice (<code>AXVPB</code>). Then specify the pointer to that voice as the first argument of the function.</P>
100<h2>See Also</h2>
101<p class="reference">
102<A href="../../ax/Voice_Allocation/AXAcquireVoice.html"><CODE>AXAcquireVoice</CODE></A>
103</p>
104
105<h2>Revision History</h2>
106<P>
1072009/05/15 Revised the description of the <code>auxC</code> argument. Edited <B>Description</B>.<br>2006/03/01 Initial version.<br>
108</P>
109
110<hr><p>CONFIDENTIAL</p></body>
111</HTML>
112