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
22      span.virtual_style
23      {
24        font-size			 : 8pt;
25        color				 : white;
26        font-weight			: bold;
27        background			: #0a0;
28        border-left			: solid 1px #0f0;
29        border-top			: solid 1px #0f0;
30        border-right		: solid 1px #060;
31        border-bottom		: solid 1px #060;
32        padding-left		: 2px;
33        padding-right		: 2px;
34      }
35
36      span.protected_style
37      {
38        font-size			 : 8pt;
39        color				 : white;
40        font-weight			: bold;
41        background			: #444;
42        border-left			: solid 1px #ccc;
43        border-top			: solid 1px #ccc;
44        border-right		: solid 1px #222;
45        border-bottom		: solid 1px #222;
46        padding-left		: 2px;
47        padding-right		: 2px;
48      }
49        --></style>
50    <title>nw::snd::MemorySoundArchive</title>
51  </head>
52  <body>
53    <h1>nw::snd::MemorySoundArchive Class</h1>
54    <div class="section">
55      <b>Header file: </b>nw/snd/snd_MemorySoundArchive.h</div>
56    <h2>Syntax</h2>
57    <div class="section">
58      <pre class="definition">class MemorySoundArchive : public <a href="../../../nw/snd/SoundArchive/Overview.html">nw::snd::SoundArchive</a></pre>
59    </div>
60    <h2>Description</h2>
61    <div class="section">
62      <p>This class handles sound archive data in memory.</p><p>The <a href="../../../nw/snd/MemorySoundArchive/Overview.html"><CODE>MemorySoundArchive</CODE></a> class cannot handle data being referenced externally by a sound archive. The playback of externally referenced data will always fail.</p><p>If a sound archive contains waveform data (waveform archives), that sound archive must be loaded into device memory.</p></div>
63    <a name="enum" id="enum">
64      <h2>Enumerated Types</h2>
65      <div class="section">
66        <table class="members">
67          <tr>
68            <td width="100"> </td>
69            <th>
70              <a href="../../../nw/snd/SoundArchive/SoundType.html"><CODE>SoundType</CODE></a>
71            </th>
72            <td>Type of sound.(Inherited from <a href="../../../nw/snd/SoundArchive/Overview.html"><CODE>SoundArchive</CODE></a>.</td>
73          </tr> </table>
74      </div>
75    </a> <a name="typedef" id="typedef">
76      <h2><CODE>typedef</CODE> Definitions</h2>
77      <div class="section">
78        <table class="members">
79          <tr>
80            <td width="100" />
81            <th>
82              <a href="../../../nw/snd/SoundArchive/ItemId.html"><CODE>ItemId</CODE></a>
83            </th>
84            <td>A type that represents item IDs in sound archives.(Inherited from <a href="../../../nw/snd/SoundArchive/Overview.html"><CODE>SoundArchive</CODE></a>.</td>
85          </tr>
86          <tr>
87            <td width="100" />
88            <th>
89              <a href="../../../nw/snd/SoundArchive/FileId.html"><CODE>FileId</CODE></a>
90            </th>
91            <td>A type that represents file IDs in sound archives.(Inherited from <a href="../../../nw/snd/SoundArchive/Overview.html"><CODE>SoundArchive</CODE></a>.</td>
92          </tr>
93          <tr>
94            <td width="100" />
95            <th>
96              <a href="../../../nw/snd/SoundArchive/StringId.html"><CODE>StringId</CODE></a>
97            </th>
98            <td>A type that represents string IDs in sound archives.(Inherited from <a href="../../../nw/snd/SoundArchive/Overview.html"><CODE>SoundArchive</CODE></a>.</td>
99          </tr> </table>
100      </div>
101    </a> <a name="constant" id="constant">
102      <h2>Member Constants</h2>
103      <div class="section">
104        <table class="members">
105          <tr>
106            <th class="category" colspan="3">Other</th>
107          </tr>
108          <tr>
109            <td width="100">
110              <span class="static_style" title="static">S</span>
111            </td>
112            <th>
113              <span class="argument"><a href="../../../nw/snd/SoundArchive/INVALID_ID.html"><CODE>INVALID_ID</CODE></a></span>
114            </th>
115            <td>Represents an invalid ID.(Inherited from <a href="../../../nw/snd/SoundArchive/Overview.html"><CODE>SoundArchive</CODE></a>.</td>
116          </tr>
117          <tr>
118            <td width="100">
119              <span class="static_style" title="static">S</span>
120            </td>
121            <th>
122              <span class="argument"><a href="../../../nw/snd/SoundArchive/SEQ_BANK_MAX.html"><CODE>SEQ_BANK_MAX</CODE></a></span>
123            </th>
124            <td>The maximum number of banks that can be associated with a sequence sound.(Inherited from <a href="../../../nw/snd/SoundArchive/Overview.html"><CODE>SoundArchive</CODE></a>.</td>
125          </tr> </table>
126      </div>
127    </a> <a name="function" id="function">
128      <h2>Member Functions</h2>
129      <div class="section">
130        <table class="members">
131          <tr>
132            <th class="category" colspan="3">Constructors/Destructors</th>
133          </tr>
134          <tr>
135            <td width="100">  </td>
136            <th>
137              <a href="../../../nw/snd/MemorySoundArchive/MemorySoundArchive.html">MemorySoundArchive</a>
138            </th>
139            <td>Constructor.</td>
140          </tr>
141          <tr>
142            <td width="100"> <span class="virtual_style" title="virtual">V</span>
143            </td>
144            <th>
145              <a href="../../../nw/snd/MemorySoundArchive/~MemorySoundArchive.html">~MemorySoundArchive</a>
146            </th>
147            <td>Destructor.</td>
148          </tr>
149          <tr>
150            <th class="category" colspan="3">Setup</th>
151          </tr>
152          <tr>
153            <td width="100">  </td>
154            <th>
155              <a href="../../../nw/snd/MemorySoundArchive/Initialize.html"><CODE>Initialize</CODE></a>
156            </th>
157            <td>Initializes sound archive data in memory.</td>
158          </tr>
159          <tr>
160            <td width="100">  </td>
161            <th>
162              <a href="../../../nw/snd/MemorySoundArchive/Finalize.html"><CODE>Finalize</CODE></a>
163            </th>
164            <td>Finalizes sound archive data in memory.</td>
165          </tr>
166          <tr>
167            <th class="category" colspan="3">Status Retrieval</th>
168          </tr>
169          <tr>
170            <td width="100">  </td>
171            <th>
172              <a href="../../../nw/snd/SoundArchive/IsAvailable.html">IsAvailable</a>
173            </th>
174            <td>Checks whether the data in the sound archive is usable.(Inherited from <a href="../../../nw/snd/SoundArchive/Overview.html"><CODE>SoundArchive</CODE></a>.</td>
175          </tr>
176          <tr>
177            <th class="category" colspan="3">ID/Label character string</th>
178          </tr>
179          <tr>
180            <td width="100">  </td>
181            <th>
182              <a href="../../../nw/snd/SoundArchive/GetSoundCount.html"><CODE>GetSoundCount</CODE></a>
183            </th>
184            <td>Obtains the number of sounds in the sound archive.(Inherited from <a href="../../../nw/snd/SoundArchive/Overview.html"><CODE>SoundArchive</CODE></a>.</td>
185          </tr>
186          <tr>
187            <td width="100">  </td>
188            <th>
189              <a href="../../../nw/snd/SoundArchive/GetGroupCount.html"><CODE>GetGroupCount</CODE></a>
190            </th>
191            <td>Obtains the number of groups in the sound archive.(Inherited from <a href="../../../nw/snd/SoundArchive/Overview.html"><CODE>SoundArchive</CODE></a>.</td>
192          </tr>
193          <tr>
194            <td width="100">  </td>
195            <th>
196              <a href="../../../nw/snd/SoundArchive/GetPlayerCount.html"><CODE>GetPlayerCount</CODE></a>
197            </th>
198            <td>Obtains the number of players in the sound archive.(Inherited from <a href="../../../nw/snd/SoundArchive/Overview.html"><CODE>SoundArchive</CODE></a>.</td>
199          </tr>
200          <tr>
201            <td width="100">  </td>
202            <th>
203              <a href="../../../nw/snd/SoundArchive/GetBankCount.html"><CODE>GetBankCount</CODE></a>
204            </th>
205            <td>Gets the number of banks in the sound archive.(Inherited from <a href="../../../nw/snd/SoundArchive/Overview.html"><CODE>SoundArchive</CODE></a>.</td>
206          </tr>
207          <tr>
208            <td width="100">  </td>
209            <th>
210              <a href="../../../nw/snd/SoundArchive/GetWaveArchiveCount.html"><CODE>GetWaveArchiveCount</CODE></a>
211            </th>
212            <td>Gets the number of waveform archives in the sound archive.(Inherited from <a href="../../../nw/snd/SoundArchive/Overview.html"><CODE>SoundArchive</CODE></a>.</td>
213          </tr>
214          <tr>
215            <td width="100">  </td>
216            <th>
217              <a href="../../../nw/snd/SoundArchive/GetItemLabel.html"><CODE>GetItemLabel</CODE></a>
218            </th>
219            <td>Gets the label string that corresponds to an item ID.(Inherited from <a href="../../../nw/snd/SoundArchive/Overview.html"><CODE>SoundArchive</CODE></a>.</td>
220          </tr>
221          <tr>
222            <td width="100">  </td>
223            <th>
224              <a href="../../../nw/snd/SoundArchive/GetItemId.html"><CODE>GetItemId</CODE></a>
225            </th>
226            <td>Converts a label string into its corresponding item ID.(Inherited from <a href="../../../nw/snd/SoundArchive/Overview.html"><CODE>SoundArchive</CODE></a>.</td>
227          </tr>
228          <tr>
229            <td width="100">  </td>
230            <th>
231              <a href="../../../nw/snd/SoundArchive/GetItemFileId.html"><CODE>GetItemFileId</CODE></a>
232            </th>
233            <td>Gets the file ID that corresponds to an item ID.(Inherited from <a href="../../../nw/snd/SoundArchive/Overview.html"><CODE>SoundArchive</CODE></a>.</td>
234          </tr>
235          <tr>
236            <td width="100">
237              <span class="static_style" title="static">S</span> </td>
238            <th>
239              <a href="../../../nw/snd/SoundArchive/GetSoundIdFromIndex.html">GetSoundIdFromIndex</a>
240            </th>
241            <td>Converts the sound serial number to a sound ID.(Inherited from <a href="../../../nw/snd/SoundArchive/Overview.html"><CODE>SoundArchive</CODE></a>.</td>
242          </tr>
243          <tr>
244            <td width="100">
245              <span class="static_style" title="static">S</span> </td>
246            <th>
247              <a href="../../../nw/snd/SoundArchive/GetBankIdFromIndex.html">GetBankIdFromIndex</a>
248            </th>
249            <td>Converts the bank serial number to a bank ID.(Inherited from <a href="../../../nw/snd/SoundArchive/Overview.html"><CODE>SoundArchive</CODE></a>.</td>
250          </tr>
251          <tr>
252            <td width="100">
253              <span class="static_style" title="static">S</span> </td>
254            <th>
255              <a href="../../../nw/snd/SoundArchive/GetPlayerIdFromIndex.html">GetPlayerIdFromIndex</a>
256            </th>
257            <td>Converts the player serial number to a player ID.(Inherited from <a href="../../../nw/snd/SoundArchive/Overview.html"><CODE>SoundArchive</CODE></a>.</td>
258          </tr>
259          <tr>
260            <td width="100">
261              <span class="static_style" title="static">S</span> </td>
262            <th>
263              <a href="../../../nw/snd/SoundArchive/GetWaveArchiveIdFromIndex.html">GetWaveArchiveIdFromIndex</a>
264            </th>
265            <td>Converts the wave archive serial number to a wave archive ID.(Inherited from <a href="../../../nw/snd/SoundArchive/Overview.html"><CODE>SoundArchive</CODE></a>.</td>
266          </tr>
267          <tr>
268            <td width="100">
269              <span class="static_style" title="static">S</span> </td>
270            <th>
271              <a href="../../../nw/snd/SoundArchive/GetGroupIdFromIndex.html">GetGroupIdFromIndex</a>
272            </th>
273            <td>Converts the group serial number to a group ID.(Inherited from <a href="../../../nw/snd/SoundArchive/Overview.html"><CODE>SoundArchive</CODE></a>.</td>
274          </tr>
275          <tr>
276            <th class="category" colspan="3">Getting Information</th>
277          </tr>
278          <tr>
279            <td width="100">  </td>
280            <th>
281              <a href="../../../nw/snd/SoundArchive/GetSoundUserParam.html"><CODE>GetSoundUserParam</CODE></a>
282            </th>
283            <td>Gets the user parameter of the sound having the specified ID.(Inherited from <a href="../../../nw/snd/SoundArchive/Overview.html"><CODE>SoundArchive</CODE></a>.</td>
284          </tr>
285          <tr>
286            <td width="100">  </td>
287            <th>
288              <a href="../../../nw/snd/SoundArchive/GetSoundType.html"><CODE>GetSoundType</CODE></a>
289            </th>
290            <td>Gets the sound having the specified ID.(Inherited from <a href="../../../nw/snd/SoundArchive/Overview.html"><CODE>SoundArchive</CODE></a>.</td>
291          </tr>
292          <tr>
293            <td width="100">  </td>
294            <th>
295              <a href="../../../nw/snd/SoundArchive/ReadSoundInfo.html"><CODE>ReadSoundInfo</CODE></a>
296            </th>
297            <td>Gets information for the sound having the specified ID.(Inherited from <a href="../../../nw/snd/SoundArchive/Overview.html"><CODE>SoundArchive</CODE></a>.</td>
298          </tr>
299          <tr>
300            <td width="100">  </td>
301            <th>
302              <a href="../../../nw/snd/SoundArchive/ReadSequenceSoundInfo.html"><CODE>ReadSequenceSoundInfo</CODE></a>
303            </th>
304            <td>Gets the information for the sequence sound having the specified ID.(Inherited from <a href="../../../nw/snd/SoundArchive/Overview.html"><CODE>SoundArchive</CODE></a>.</td>
305          </tr>
306          <tr>
307            <td width="100">  </td>
308            <th>
309              <a href="../../../nw/snd/SoundArchive/ReadBankInfo.html"><CODE>ReadBankInfo</CODE></a>
310            </th>
311            <td>Gets bank information for the specified ID.(Inherited from <a href="../../../nw/snd/SoundArchive/Overview.html"><CODE>SoundArchive</CODE></a>.</td>
312          </tr>
313          <tr>
314            <td width="100">  </td>
315            <th>
316              <a href="../../../nw/snd/SoundArchive/ReadPlayerInfo.html"><CODE>ReadPlayerInfo</CODE></a>
317            </th>
318            <td>Retrieves information for the player with the specified ID.(Inherited from <a href="../../../nw/snd/SoundArchive/Overview.html"><CODE>SoundArchive</CODE></a>.</td>
319          </tr>
320          <tr>
321            <td width="100">  </td>
322            <th>
323              <a href="../../../nw/snd/SoundArchive/ReadSoundArchivePlayerInfo.html"><CODE>ReadSoundArchivePlayerInfo</CODE></a>
324            </th>
325            <td>Obtains sound archive player information.(Inherited from <a href="../../../nw/snd/SoundArchive/Overview.html"><CODE>SoundArchive</CODE></a>.</td>
326          </tr>
327          <tr>
328            <td width="100">  </td>
329            <th>
330              <a href="../../../nw/snd/SoundArchive/ReadSound3DInfo.html"><CODE>ReadSound3DInfo</CODE></a>
331            </th>
332            <td>Gets 3D sound information for the specified ID.(Inherited from <a href="../../../nw/snd/SoundArchive/Overview.html"><CODE>SoundArchive</CODE></a>.</td>
333          </tr>
334          <tr>
335            <th class="category" colspan="3">File Path</th>
336          </tr>
337          <tr>
338            <td width="100">  </td>
339            <th>
340              <a href="../../../nw/snd/SoundArchive/SetExternalFileRoot.html"><CODE>SetExternalFileRoot</CODE></a>
341            </th>
342            <td>Sets the root directory for an external reference file.(Inherited from <a href="../../../nw/snd/SoundArchive/Overview.html"><CODE>SoundArchive</CODE></a>.</td>
343          </tr> </table>
344      </div>
345    </a>
346    <h2>Class Hierarchy</h2>
347    <div class="section">
348      <p class="hierarchy"><a href="../../../nw/snd/SoundArchive/Overview.html">nw::snd::SoundArchive</a><br />  <b>nw::snd::MemorySoundArchive</b>
349      </p>
350    </div>
351    <h2>Revision History</h2>
352    <div class="section">
353      <dl class="history">
354        <dt>2010/04/30</dt>
355        <dd>Added a note stating that sound archives must be loaded in device memory.<br />
356        </dd>
357        <dt>2010/01/15</dt>
358        <dd>Initial version.<br />
359        </dd>
360      </dl>
361    </div>
362  <hr><p>CONFIDENTIAL</p></body>
363</html>