1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html>
3
4<head>
5<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css">
6<title>AXSetMode</title>
7<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
8<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 6.5.0.0 for Windows">
9<META http-equiv="Content-Style-Type" content="text/css">
10</head>
11
12<body>
13
14<h1 align="left">AXSetMode</h1>
15
16<h2>Syntax</h2>
17<dl><dd><pre class="construction">
18#include &lt;revolution/ax.h&gt;
19
20void AXSetMode(u32 mode);
21</pre></dd></dl>
22
23<h2>Arguments</h2>
24<TABLE class="arguments" border="1" >
25  <tr>
26<th>mode</th>
27    <td>
28      <TABLE class="arguments" border="1" >
29        <tr>
30<th>AX_MODE_STEREO</th>
31<td>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.</td>
32        </tr>
33        <tr>
34<th>AX_MODE_SURROUND</th>
35<td>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.</td>
36        </tr>
37        <tr>
38<th>AX_MODE_DPL2</th>
39<td>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.</td>
40        </tr>
41      </table>
42    </td>
43  </tr>
44</table>
45
46<h2>Return Values</h2>
47<p>None.</p>
48
49<h2>Description</h2>
50<p>The <code>AXSetMode</code> function sets the output mode of AX.</p>
51<P>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.</P>
52
53<h2>See Also</h2>
54<p class="reference">
55<a href="AXGetMode.html">AXGetMode</a>
56</p>
57
58<h2>Revision History</h2>
59<P>
602006/06/19 Corrected the effect bus, which is disabled in DPL2 mode (changed from Aux B to Aux C). <br>2006/03/01 Initial version.<br>
61</P>
62
63<hr><p>CONFIDENTIAL</p></body>
64</html>
65