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>AXSetAuxA/B/CReturnVolume</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">AXSetAuxA/B/CReturnVolume</h1>
15
16<h2>Syntax</h2>
17<dl><dd><pre class="construction">
18#include &lt;revolution/ax.h&gt;
19
20void AXSetAuxAReturnVolume(u16 volume);
21void AXSetAuxBReturnVolume(u16 volume);
22void AXSetAuxCReturnVolume(u16 volume);
23</pre></dd></dl>
24
25<h2>Arguments</h2>
26<TABLE class="arguments" border="1" >
27  <tr>
28<th>volume</th>
29<td>AUX bus return volume value.</td>
30  </tr>
31</table>
32
33<h2>Return Values</h2>
34<p>None.</p>
35
36<H2>Description</H2>
37<p><code>AXSetAuxA/B/CReturnVolume</code> functions configures the return volume of the individual AUX buses in AX. The volume is a 16-bit fixed point number (where the high order bit represent the integer part and 15 bits the fractional part), and the selectable range is between 0x0000 (= 0.0) and 0xffff (= 2.0). The default value is 0x8000 (= 1.0).</p>
38
39<p>The return volume is multiplied by the effect data when the effect data processed by the CPU (using the AXFX library) is mixed to the main bus using the DSP.</p>
40
41<p>Appropriately using the return volume will allow smooth switching of effects when, for example, transitioning from the game to the Home Menu. However, if a value is set in the return value that is much different from the current value (for example, 0x8000 -&gt; 0x0000), noise may be generated. Change the return volume gradually in appropriately timed steps within the application.</p>
42
43<H2>See Also</H2>
44<p class="reference">
45<a href="AXGetAuxReturnVolume.html">AXGetAuxA/B/CReturnVolume</a>
46</p>
47
48<H2>Revision History</H2>
49<p>
502006/10/23 Initial version.<BR>
51</p>
52
53<hr><p>CONFIDENTIAL</p></body>
54</html>