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    <style type="text/css"><!--
8      span.static_style
9      {
10        font-size			: 8pt;
11        color				: white;
12        font-weight			: bold;
13        background			: #44f;
14        border-left			: solid 1px #aaf;
15        border-top			: solid 1px #aaf;
16        border-right		: solid 1px #00c;
17        border-bottom		: solid 1px #00c;
18        padding-left		: 2px;
19        padding-right		: 2px;
20      }
21      span.virtual_style
22      {
23        font-size			 : 8pt;
24        color				 : white;
25        font-weight			: bold;
26        background			: #0a0;
27        border-left			: solid 1px #0f0;
28        border-top			: solid 1px #0f0;
29        border-right		: solid 1px #060;
30        border-bottom		: solid 1px #060;
31        padding-left		: 2px;
32        padding-right		: 2px;
33      }
34      span.protected_style
35      {
36        font-size			 : 8pt;
37        color				 : white;
38        font-weight			: bold;
39        background			: #444;
40        border-left			: solid 1px #ccc;
41        border-top			: solid 1px #ccc;
42        border-right		: solid 1px #222;
43        border-bottom		: solid 1px #222;
44        padding-left		: 2px;
45        padding-right		: 2px;
46      }
47        --></style>
48    <title>nw::snd::SoundStartable::StartInfo</title>
49  </head>
50  <body>
51    <h1><CODE><a href="../../../../nw/Overview.html">nw</a>::<a href="../../../../nw/snd/Overview.html">snd</a>::<a href="../../../../nw/snd/SoundStartable/Overview.html">SoundStartable</a>::StartInfo</CODE> Structure</h1>
52    <div class="section">
53      <b>Header file: </b>nw/snd/snd_SoundStartable.h</div>
54    <h2>Syntax</h2>
55    <div class="section">
56      <pre class="definition">struct StartInfo
57{
58   <span>u32</span> enableFlag;
59   <a href="../../../../nw/snd/SoundStartable/StartInfo/StartOffsetType.html">StartOffsetType</a> startOffsetType;
60   int startOffset;
61   <a href="../../../../nw/snd/SoundArchive/ItemId.html">SoundArchive::ItemId</a> playerId;
62   int playerPriority;
63   int actorPlayerId;
64   <a href="../../../../nw/snd/SoundStartable/StartInfo/SeqSoundInfo/Overview.html">SeqSoundInfo</a> seqSoundInfo;
65};
66</pre>
67    </div>
68    <h2>Description</h2>
69    <div class="section">
70      <p>These are detailed playback parameters that are passed during sound playback.</p><p>They are passed to functions such as <CODE><A href="snd_SoundStartable_StartSound.html">nw4r::snd::SoundStartable::StartSound</A></CODE>. Even if this structure is not used, sounds can be played back.</p><p>You can start playback from part way through a sound if <CODE>startOffsetType</CODE> and <CODE>startOffset</CODE> are set. You must set both of these parameters at the same time. To enable the set parameters, set the ENABLE_START_OFFSET bit of the enableFlag.</p><p>Even if the offset values are the same, the processing time required for midstream playback may vary, depending on the type of data. This sometimes takes a large amount of processing time.</p><p>Sequence Sound<br />If you want to idle a sequence until part way through, the larger the size of the start offset, the longer the processing time.</p><p>Stream Sound<br />If the data is PCM, there is almost no processing time taken for midstream playback, regardless of the size of the start offset. If the data is ADPCM, it requires processing by the CPU for decoding the data for a maximum of 14336 samples.</p><p>Stream Sound<br />If the data is PCM, there is almost no processing time taken for midstream playback, regardless of the size of the start offset. If the data is ADPCM, the processing time that is taken corresponds to the size of the start offset because all samples from the start of the data through the playback starting position must be decoded by the CPU.</p><p>Sounds are played back using the player whose ID is set in the sound archive. However, if you want to specify a different player for playback, specify it in playerId. To enable the set parameters, set the ENABLE_PLAYER_ID bit of the enableFlag.</p><p>Sounds are played back using the player priority set in the sound archive, but if you want to specify a different priority value for playback, set playerPriority. To enable the set parameters, set the ENABLE_PLAYER_PRIORITY bit of the enableFlag.</p><p><CODE>actorPlayerId</CODE> sets the actor player number to use for playback by the <CODE><a href="../../../../nw/snd/SoundActor/Overview.html">SoundActor</a></CODE> class. Takes values in the range of 0 to 3. To enable the set parameters, set the ENABLE_ACTOR_PLAYER_ID bit of the enableFlag. (Under NW4C-0.4.1, currently there is no effect even if this value is set.)</p><p>seqSoundInfo holds parameters that relate to sequence sounds. It is only valid when playing sequence sounds. It is possible to overwrite the sequence sound-related information that is set within a sound archive. For details, refer to the <A href="snd_SoundStartable_StartInfo_SeqSoundInfo.html"><CODE>SeqSoundInfo</CODE></A> structure. To enable the set parameters, set the ENABLE_SEQ_SOUND_INFO bit of the enableFlag.</p></div>
71    <a name="struct" id="struct">
72      <h2>Structures</h2>
73      <div class="section">
74        <table class="members">
75          <tr>
76            <th>
77              <a href="../../../../nw/snd/SoundStartable/StartInfo/SeqSoundInfo/Overview.html">nw::snd::SoundStartable::StartInfo::SeqSoundInfo</a>
78            </th>
79            <td>A structure of parameters related to sequence sounds.</td>
80          </tr> </table>
81      </div>
82    </a> <a name="enum" id="enum">
83      <h2>Enumerated Types</h2>
84      <div class="section">
85        <table class="members">
86          <tr>
87            <td width="100"> </td>
88            <th>
89              <a href="../../../../nw/snd/SoundStartable/StartInfo/EnableFlagBit.html">EnableFlagBit</a>
90            </th>
91            <td><CODE><a href="../../../../nw/snd/SoundStartable/StartInfo/Overview.html">StartInfo</a></CODE> Defines bit flags used to enable structure parameters.</td>
92          </tr>
93          <tr>
94            <td width="100"> </td>
95            <th>
96              <a href="../../../../nw/snd/SoundStartable/StartInfo/StartOffsetType.html">StartOffsetType</a>
97            </th>
98            <td>Defines the unit of the sound start offset value.</td>
99          </tr> </table>
100      </div>
101    </a> <a name="variable" id="variable">
102      <h2>Member Variables</h2>
103      <div class="section">
104        <table class="members">
105          <tr>
106            <td width="100"> </td>
107            <th>
108              <span class="argument">enableFlag</span>
109            </th>
110            <td width="100"><span>u32</span></td>
111            <td>Bit flag for enabling the values set in the structure. With the default value, all are disabled.</td>
112          </tr>
113          <tr>
114            <td width="100"> </td>
115            <th>
116              <span class="argument">startOffsetType</span>
117            </th>
118            <td width="100"><a href="../../../../nw/snd/SoundStartable/StartInfo/StartOffsetType.html">StartOffsetType</a></td>
119            <td>Unit of the sound start offset value.</td>
120          </tr>
121          <tr>
122            <td width="100"> </td>
123            <th>
124              <span class="argument">startOffset</span>
125            </th>
126            <td width="100">int</td>
127            <td>Sound start offset value. </td>
128          </tr>
129          <tr>
130            <td width="100"> </td>
131            <th>
132              <span class="argument">playerId</span>
133            </th>
134            <td width="100"><a href="../../../../nw/snd/SoundArchive/ItemId.html">SoundArchive::ItemId</a></td>
135            <td>Player ID used when playing sounds.</td>
136          </tr>
137          <tr>
138            <td width="100"> </td>
139            <th>
140              <span class="argument">playerPriority</span>
141            </th>
142            <td width="100">int</td>
143            <td>Player priority set for the sound.</td>
144          </tr>
145          <tr>
146            <td width="100"> </td>
147            <th>
148              <span class="argument">actorPlayerId</span>
149            </th>
150            <td width="100">int</td>
151            <td>Actor player number to use for playback with a SoundActor. (Under NW4C-0.4.1, currently there is no effect even if this value is set.)</td>
152          </tr>
153          <tr>
154            <td width="100"> </td>
155            <th>
156              <span class="argument">seqSoundInfo</span>
157            </th>
158            <td width="100"><a href="../../../../nw/snd/SoundStartable/StartInfo/SeqSoundInfo/Overview.html">SeqSoundInfo</a></td>
159            <td>A parameter related to sequence sounds.</td>
160          </tr> </table>
161      </div>
162    </a> <a name="function" id="function">
163      <h2>Member Functions</h2>
164      <div class="section">
165        <table class="members">
166          <tr>
167            <td width="100">  </td>
168            <th>
169              <a href="../../../../nw/snd/SoundStartable/StartInfo/StartInfo.html">StartInfo</a>
170            </th>
171            <td>Constructor.</td>
172          </tr> </table>
173      </div>
174    </a>
175    <h2>See Also</h2>
176    <div class="section">
177      <p class="reference"><a href="../../../../nw/snd/SoundStartable/StartSound.html">SoundStartable::StartSound</a><br /> </p>
178    </div>
179    <h2>Revision History</h2>
180    <div class="section">
181      <dl class="history">
182        <dt>2010/01/25</dt>
183        <dd>Initial version.<br />
184        </dd>
185      </dl>
186    </div>
187  <hr><p>CONFIDENTIAL</p></body>
188</html>
189