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>AXARTSet3DDistanceScale</TITLE>
7<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
8<META http-equiv="Content-Style-Type" content="text/css">
9</head>
10
11<BODY>
12
13<H1 align="left">AXARTSet3DDistanceScale</H1>
14
15<H2>C Specification</H2>
16<DL>
17<dd><pre><CODE>#include &lt;revolution.h&gt;
18#include &lt;revolution/axart.h&gt;</CODE></pre>
19  </dd>
20<dd><PRE><CODE>void AXARTSet3DDistanceScale(f32 scale);</CODE></PRE>
21  </dd>
22</DL>
23
24<H2>Arguments</H2>
25<TABLE border="1" cellpadding="3" cellspacing="0.1">
26  <TBODY>
27    <TR>
28<TD width="120" bgcolor="#ffffe8"><FONT face="Courier New"><EM><STRONG>scale</STRONG></EM></FONT></TD>
29<TD width="520">Distance scale. </TD>
30    </TR>
31  </TBODY>
32</TABLE>
33
34<h2>Return Values</h2>
35<p>None.</p>
36
37<H2>Description</H2>
38<P><CODE><font face="Courier New">AXARTSet3DDistanceScale()</font></CODE> sets an arbitrary distance scale for the volume attenuation of 3D sounds. The AXART Library finds the distance attenuation of volume based on the distance from the camera using the following formula. The scale set by this function is assigned to <code>scale</code> in the formula, while the <A href="AXART_3D.html"><code>AXART_3D</code></A> articulator member <code>dist</code> is assigned to <code>dist</code>. Calculation results are similarly saved in the <A href="AXART_3D.html"><code>AXART_3D</code></A> articulator member <code>attenuation</code>. </P>
39
40<BLOCKQUOTE><CODE>attenuation = -6dB &times; (dist &divide; scale)</CODE></BLOCKQUOTE>
41
42<H2>See Also</H2>
43<P><FONT face="Courier New"><A href="AXARTSet3DDopplerScale.html">AXARTSet3DDopplerScale</A><BR> <A href="AXART_3D.html">AXART_3D</A></FONT></P>
44
45<H2>Revision History</H2>
46<P>
472006/03/01 Initial version. <br>2006/09/01 Added arguments.
48</P>
49
50<hr>
51<P>CONFIDENTIAL</p>
52</BODY>
53</HTML>
54