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>Syntax</H2>
16<dl><dd><pre class="construction">
17#include &lt;revolution.h&gt;
18#include &lt;revolution/axart.h&gt;
19
20void AXARTSet3DDistanceScale(f32 scale);
21</pre></dd></dl>
22
23<H2>Arguments</H2>
24<TABLE class="arguments" border="1" >
25  <TBODY>
26    <TR>
27<TH>scale</TH>
28<TD>Distance scale. </TD>
29    </TR>
30  </TBODY>
31</TABLE>
32
33<h2>Return Values</h2>
34<p>None.</p>
35
36<H2>Description</H2>
37<P>The <code>AXARTSet3DDistanceScale</code> function 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 <code>AXART_3D</code> articulator member <code>dist</code> is assigned to <code>dist</code>. Calculation results are saved in the same <code>AXART_3D</code> articulator's member <code>attenuation</code>.</P>
38
39<BLOCKQUOTE><CODE>attenuation = -6dB &times; (dist &divide; scale)</CODE></BLOCKQUOTE>
40
41<H2>See Also</H2>
42<P class="reference">
43<A href="AXARTSet3DDopplerScale.html">AXARTSet3DDopplerScale</A>, <A href="AXART_3D.html">AXART_3D</A>
44</P>
45
46<H2>Revision History</H2>
47<P>
482006/09/01 Added an argument.<br>2006/03/01 Initial version.<BR>
49</P>
50
51<hr><p>CONFIDENTIAL</p></body>
52</HTML>
53