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>SetTrackSilence</title>
8  </head>
9  <body>
10    <h1>nw::snd::SequenceSoundHandle::SetTrackSilence Member Function</h1>
11    <h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">#include &lt;nw/snd/snd_SequenceSoundHandle.h&gt;
14
15void SetTrackSilence(
16     <span>u32</span> trackBitFlag,
17     bool silenceFlag,
18     int fadeTimes
19);
20</pre>
21    </div>
22    <h2>Arguments</h2>
23    <div class="section">
24      <table class="arguments">
25        <thead>
26          <tr>
27            <td width="15" />
28            <th>Name</th>
29            <td>Description</td>
30          </tr>
31        </thead>
32        <tr>
33          <td>in</td>
34          <th>trackBitFlag</th>
35          <td>Bit flag for each track.</td>
36        </tr>
37        <tr>
38          <td>in</td>
39          <th>silenceFlag</th>
40          <td>Specify true when a track is put in silent status; false when silent status is cancelled.</td>
41        </tr>
42        <tr>
43          <td>in</td>
44          <th>fadeTimes</th>
45          <td>Fade time (in milliseconds) to be applied when changing the silent status.</td>
46        </tr> </table>
47    </div>
48    <h2>Return Values</h2>
49    <div class="section">
50                None.
51               </div>
52    <h2>Description</h2>
53    <div class="section">
54      <p>Places a sequence sound track in silent status, or cancels silent status.</p><p>Changes the silent status of the sound sequence track associated with the handle. This function does not perform any action if the stream handle is invalid.</p><p>The trackBitFlag argument specifies the track. Tracks are identified from the lower bit in sequence; for example, Track 0, Track 1, Track 2 and so on. The silent status will change for all tracks with enabled bits. For example, to change the silent status of Track 2 and Track 5, use  (1 &lt;&lt; 2) | (1 &lt;&lt; 5); i.e., 0x0024.</p><p>Silent status is simlar to mute status (<a href="../../../nw/snd/SequenceSoundHandle/SetTrackMute.html">SetTrackMute</a>). Sound is no longer output for a track that is in mute status because the note on processing is not performed. Although note on processing can be performed for a track in silent status, it can be set to not produce sound by setting the volume to zero. This allows for sound to suddenly begin playing midway through a note when silent status is canceled.</p><p>Note that fadeTimes has an effect only on sounds that are currently being played when this function is called. Consequently, sounds that begin to play during the fade interval (the interval in which previously playing sounds transition to silent status) will begin playing in mute status.</p><p>Note: In silent status, voices for which note was performed are used while the sound is off.</p><p>Mute status and silent status can be set separately. If both are set, a track not produce sound until both are cancelled.</p></div>
55    <h2>See Also</h2>
56    <div class="section">
57      <p class="reference"><a href="../../../nw/snd/SequenceSoundHandle/SetTrackMute.html">SetTrackMute</a><br /> </p>
58    </div>
59    <h2>Revision History</h2>
60    <div class="section">
61      <dl class="history">
62        <dt>2010/01/22</dt>
63        <dd>Initial version.<br />
64        </dd>
65      </dl>
66    </div>
67  <hr><p>CONFIDENTIAL</p></body>
68</html>