1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2<html xml:lang="en-US" lang="en-US" xmlns="http://www.w3.org/1999/xhtml">
3  <head>
4    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
5    <meta http-equiv="Content-Style-Type" content="text/css" />
6    <link rel="stylesheet" href="../../../css/manpage.css" type="text/css" />
7    <title>SetPosition</title>
8  </head>
9  <body>
10    <h1><CODE><a href="../../../nw/Overview.html">nw</a>::<a href="../../../nw/snd/Overview.html">snd</a>::<a href="../../../nw/snd/Sound3DActor/Overview.html">Sound3DActor</a>::SetPosition</CODE> Member Function</h1>
11    <h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">#include &lt;nw/snd/snd_Sound3DActor.h&gt;
14void SetPosition(
15     const nw::math::VEC3 & position
16);
17</pre>
18    </div>
19    <h2>Arguments</h2>
20    <div class="section">
21      <table class="arguments">
22        <thead>
23          <tr>
24            <td width="15" />
25            <th>Name</th>
26            <td>Description</td>
27          </tr>
28        </thead>
29        <tr>
30          <td>in</td>
31          <th>position</th>
32          <td>Actor position coordinates.</td>
33        </tr> </table>
34    </div>
35    <h2>Return Values</h2>
36    <div class="section">
37                None.
38               </div>
39    <h2>Description</h2>
40    <div class="section">
41      <p>This function sets actor position information.</p><p>It sets the position information for 3D sound actors. The set coordinates are used to calculate 3D sound parameters.</p><p>When new position information is set, the difference between it and the previously set position information is calculated, and the 3D sound actor's velocity is automatically set. The actor's velocity is reflected in pitch changes, in accordance with the Doppler effect. The velocity can also be set explicitly by <a href="../../../nw/snd/Sound3DActor/SetVelocity.html">nw::snd::Sound3DActor::SetVelocity</a>.</p><p>If the coordinates jump to a different position, the distance traversed will be used to calculate velocity. This causes a kind of processing that applies to movement at extremely high speed, resulting in sudden pitch changes. Note that in such cases, you must call <A href="snd_Sound3DActor_SetVelocity.html"><CODE>nw::snd::Sound3DActor::SetVelocity</CODE></A> after calling this function, and explicitly set the velocity.</p></div>
42    <h2>See Also</h2>
43    <div class="section">
44      <p class="reference"><a href="../../../nw/snd/Sound3DActor/SetVelocity.html">SetVelocity</a><br /><a href="../../../nw/snd/Sound3DActor/GetPosition.html">GetPosition</a><br /> </p>
45    </div>
46    <h2>Revision History</h2>
47    <div class="section">
48      <dl class="history">
49        <dt>2010/02/15</dt>
50        <dd>Initial version.<br />
51        </dd>
52      </dl>
53    </div>
54  <hr><p>CONFIDENTIAL</p></body>
55</html>
56