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>SetTrackPitch</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/SequenceSoundHandle/Overview.html">SequenceSoundHandle</a>::SetTrackPitch</CODE> Member Function</h1>
11    <h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">#include &lt;nw/snd/snd_SequenceSoundHandle.h&gt;
14void SetTrackPitch(
15     <span>u32</span> trackBitFlag,
16     <span>f32</span> pitch
17);
18</pre>
19    </div>
20    <h2>Arguments</h2>
21    <div class="section">
22      <table class="arguments">
23        <thead>
24          <tr>
25            <td width="15" />
26            <th>Name</th>
27            <td>Description</td>
28          </tr>
29        </thead>
30        <tr>
31          <td />
32          <th>trackBitFlag</th>
33          <td>Bit flag for each track.</td>
34        </tr>
35        <tr>
36          <td />
37          <th>pitch</th>
38          <td>The frequency ratio of the pitch change.</td>
39        </tr> </table>
40    </div>
41    <h2>Return Values</h2>
42    <div class="section">
43                None.
44               </div>
45    <h2>Description</h2>
46    <div class="section">
47      <p>Changes the track pitch of the sequence sound.</p><p>Changes the sequence track pitch of the sound associated with the handle. If the handle is invalid, the function does nothing.</p><p>The value specified by this function operates independently of other low-pass filter cut-off parameters, which are all superimposed on top of each other.</p><p>The trackBitFlag argument specifies the track. The tracks are identified from the lower bit in sequence: Track 0, Track 1, Track 2 .... All tracks with enabled bits will have their pitch changed. For example, to change the pitch of Track 2 and Track 5, use  (1 &lt;&lt; 2) | (1 &lt;&lt; 5); i.e., 0x0024.</p><p><span>pitch</span> specifies the frequency ratio. In other words, there is no effect on the pitch if 1.0 will be specified. When 2.0 is specified, the frequency to be reproduced is doubled, and the pitch is one octave higher. If 0.5 is specified, the pitch will be one octave lower. The default value is 1.0.</p></div>
48    <h2>Revision History</h2>
49    <div class="section">
50      <dl class="history">
51        <dt>2010/09/29</dt>
52        <dd>Corrected an error (changed &quot;volume parameter&quot; to &quot;pitch parameter&quot;).<BR>
53        </dd>
54        <dt>2010/06/25</dt>
55        <dd>Corrected a mistake (silent status &gt; pitch).
56        </dd>
57        <dt>2010/01/22</dt>
58        <dd>Initial version.<br />
59        </dd>
60      </dl>
61    </div>
62  <hr><p>CONFIDENTIAL</p></body>
63</html>
64