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