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>C Specification</h2>
17
18<BLOCKQUOTE>
19<pre><code>#include &lt;revolution.h&gt;
20
21void AXSetAuxAReturnVolume(u16 volume);
22void AXSetAuxBReturnVolume(u16 volume);
23void AXSetAuxCReturnVolume(u16 volume);
24
25</code></pre>
26</BLOCKQUOTE>
27
28<h2>Arguments</h2>
29
30<table border="1" cellpadding="3" cellspacing="0.1">
31  <tr>
32<td width="120" bgcolor="#ffffe8"><em><strong><code>volume</code></strong></em></td>
33    <td width="520">AUX bus return volume value.</td>
34  </tr>
35</table>
36
37<h2>Return Values</h2>
38
39<p>
40None.
41</p>
42
43<H2>Description</H2>
44
45<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 represents 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>
46
47<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>
48
49<p>Appropriately using the return volume will allow smooth switching of effects when, for example, transitioning from the game to the Home Menu. If a value very different from the current value is set to the return volume (e.g., 0x8000 -&gt; 0x0000), it may result in generation of noise. Change the return volume gradually in appropriately timed steps within the application.</p>
50
51<H2>See Also</H2>
52
53<p>
54<code><a href="AXGetAuxReturnVolume.html">AXGetAuxA/B/CReturnVolume</a></code>
55</p>
56
57<H2>Revision History</H2>
58
59<p>2006/10/23 Initial version.</p>
60
61<hr>
62<P>CONFIDENTIAL</p>
63</BODY>
64</HTML>