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>AXART_3D</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">AXART_3D</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
20typedef struct
21{
22    AXART_ART   art;
23
24    // runtime user parameters
25
26    f32         hAngle;         // horizontal angle
27    f32         vAngle;         // vertical angle
28    f32         dist;           // distance from listener
29    f32         closingSpeed;   // for Doppler
30    u32         update;         // set to true after changing parameters
31
32    // do not write to these parameters
33
34    u8          pan;
35    u8          span;
36    u8          src;
37    u16         itdL;
38    u16         itdR;
39    f32         pitch;
40    s32         attenuation;
41
42} AXART_3D;
43</pre></dd></dl>
44
45<h2>Elements</h2>
46<TABLE class="arguments" border="1" >
47  <TR>
48<TH>art</TH>
49<TD>AXART articulator descriptor maintained by AXART. Do not write to this parameter.</TD>
50  </TR>
51  <TR>
52<TH>hAngle</TH>
53<TD>Horizontal angle for the sound source relative to the camera. Units are in radians.</TD>
54  </TR>
55  <TR>
56<TH>vAngle</TH>
57<TD>Vertical angle for the sound source relative to the camera. Units are in radians.</TD>
58  </TR>
59  <TR>
60<TH>dist</TH>
61<TD>Distance for the sound source relative to the camera.</TD>
62  </TR>
63  <TR>
64<TH>closingSpeed</TH>
65<TD>Closing speed for the sound source relative to the camera.</TD>
66  </TR>
67  <TR>
68<TH>update</TH>
69<TD>Set to <CODE>TRUE</CODE> after changing <SPAN class="argument">hAngle</SPAN>, <SPAN class="argument">vAngle</SPAN>, <SPAN class="argument">dist</SPAN>, or <SPAN class="argument">closingSpeed</SPAN>. This causes AXART to update the sound position, pitch and volume.</TD>
70  </TR>
71  <TR>
72<TH>pan</TH>
73<TD>AXART generated pan value. Do not write to this parameter.</TD>
74  </TR>
75  <TR>
76<TH>span</TH>
77<TD>AXART generated surround pan value. Do not write to this parameter.</TD>
78  </TR>
79  <TR>
80<TH>src</TH>
81<TD>AXART generated SRC type.&nbsp;Do not write to this parameter.</TD>
82  </TR>
83  <TR>
84<TH>itdL</TH>
85<TD>AXART generated ITD. Do not write to this parameter.</TD>
86  </TR>
87  <TR>
88<TH>itdR</TH>
89<TD>AXART generated ITD. Do not write to this parameter.</TD>
90  </TR>
91  <TR>
92<TH>pitch</TH>
93<TD>AXART generated pitch. Do not write to this parameter.</TD>
94  </TR>
95  <TR>
96<TH>attenuation</TH>
97<TD>AXART generated volume attenuation. Do not write to this parameter.</TD>
98  </TR>
99</TABLE>
100
101<H2>Description</H2>
102<P><CODE>AXART_3D</CODE> is a data structure that denotes a 3D sound articulator. This articulator will place an <CODE>AXART_SOUND</CODE> in 3D space. Do not use this articulator sound in conjunction with <CODE>AXART_PANNING</CODE> or <CODE>AXART_ITD</CODE>. For the <CODE>AXART_3D</CODE> structure, you must call the <CODE>AXARTInitArt3D</CODE> function prior to calling <CODE>AXARTAddArticulator</CODE>.</P>
103
104<H2>See Also</H2>
105<P class="reference">
106<A href="AXARTSet3DDistanceScale.html">AXARTSet3DDistanceScale</A>,
107<A href="AXARTSet3DDopplerScale.html">AXARTSet3DDopplerScale</A>,
108<A href="AXARTInitArt3D.html">AXARTInitArt3D</A>,
109<A href="AXARTAddArticulator.html">AXARTAddArticulator</A>,
110<A href="AXART_PANNING.html">AXART_PANNING</A>,
111<A href="AXART_ITD.html">AXART_ITD</A>,
112<A href="AXART_ART.html">AXART_ART</A>,
113<A href="AXART_SOUND.html">AXART_SOUND</A>
114</P>
115
116<h2>Revision History</h2>
117<P>
1182006/03/01 Initial version.<BR>
119</P>
120
121<hr><p>CONFIDENTIAL</p></body>
122</HTML>
123