1<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN"> 2<html lang="ja"> 3 4 <head> 5<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> 6<meta http-equiv="Content-Style-Type" content="text/css"> 7<link href="../../css/manpage.css" rel="stylesheet" type="text/css"> 8 9<title>Groups</title> 10</head> 11 12 <body> 13 <h1 id="ADV_SSET_GROUP">Groups</h1> 14 <p>Select the <B>Group</B> node in the project tree to show a list of groups in the <B>Sound Set</B> tab.<br> The list is split and displayed in upper and lower sections in the <B>Sound Set</B> tab.<br> The upper part of this split tab is called the group list and the lower part the group item list.<br> 15 </p> 16 <h2>The Role of Groups</h2> 17 <p>Items for the same sound set are registered in a group. The items registered here are called <I>group items</I>.<br> 18 </p> 19 <p>When the application loads waveform data and other data from the sound archive into memory, the programmer can gather all the items required for a particular scene and load them as a group.<br> 20 </p> 21 <p>The sound designer can make better use of memory by classifying items according to scenes and the timing at which they are needed and then efficiently registering them into different groups.<br> 22 </p> 23 <h2>Group List and Group Item List</h2> 24 <p>The group list is used to create groups. The group item list displays a list of items currently registered in the selected group.</p> 25 <h2>Creating and Adding Groups</h2> 26 <p>To create or add a group, select the list region in the <B>Sound Set</B> tab and then select <B>Project</B> → <B>Add Item</B> → <B>Group...</B>.</p> 27 <p>It is possible to create a new group or to add a group using the shortcut menu that appears by right-clicking the group list.</p> 28 <h2>Registering Items in Groups</h2> 29 <p>The group item list is used to register items to a group.</p> 30 <p>From the group list, select the group with which you want to register the item and then select <B>Project</B> → <B>Add Item</B> → <B>Group Item...</B>.</p> 31 <p>An item can also be registered to a group by dragging the item to the group item list from the sound list or the Search Result window.</p> 32 <h2>Elements Defining a Group List</h2> 33 <p>This section describes the meaning of each of the elements that define a group list.</p> 34 <h3>Name</h3> 35 <p>Specifies the group name.<br> There are restrictions on the characters that can be used in a name. The following characters can be used.<br> - The first character must be a single-byte letter or an underscore. [a-zA-Z_]<br>- Other characters must be single-byte alphanumeric or an underscore. [a-zA-Z0-9_]</p> 36 <h3>Data size</h3> 37 <p>The group list data size indicates the size when the group is loaded into the sound heap.</p> 38 <p>The data size display is updated automatically when conversion is executed.</p> 39 <p><strong>The group data size is displayed, but its value cannot be edited.</strong></p> 40 <h3>Output Method</h3> 41 <p>Sets the method for outputting the sound data registered in group items to sound archives.</p> 42 <ul> 43 <li>Embed<br> Embeds sound data in a group.<br> The advantage of this is that the number of accesses will decrease. The disadvantage is that it may lead to redundant data. Embedding is appropriate in three main scenarios, namely if a lot of space is available in the ROM, if you want to reduce the number of accesses, or if you have extra space in RAM.</li> 44 <li>Link<br> Includes the sound data within the sound archive without including it within the group.<br> The advantage of this is that no data redundancy will occur. The disadvantage is that the number of accesses will increase.<br> Linking is appropriate for two main scenarios, namely if you want to conserve space in RAM or ROM, or if random access to the media is fast.</li> 45 <li>Don't output<br> Won't output the group file. It won't be included in the sound binary archive file either.<br> This can be used as a virtual folder to store items that are included in other groups.</li> 46 </ul> 47 <h2>Elements Defining a Group Item List</h2> 48 <p>This section describes the meaning of each of the elements that define a group item list.</p> 49 <h3>Name</h3> 50 <p>Displays the names of the items registered in the group.<br> The drop-down menu can be used to change other items in the sound list.</p> 51 <h3>Sound Set</h3> 52 <p>Displays the name of the sound set that contains the item.</p> 53 <p></p> 54 <h3>Register Related Items</h3> 55 <p>Specifies how related waveform archives should be loaded when the given item is loaded.</p> 56 <p>By default, when a sequence sound, wave sound, or bank is loaded, any related waveform archives will also be loaded at the same time. The "Register Related Items" drop-down menu lets you specify that certain items or combinations of items (for example, "SEQ/SEQSET and BANK only" or "WARC only") should be loaded individually.</p> 57<p><strong>If the "Waveform Archive" setting for a wave sound set or a bank is set to either "Automatic (Shared)" or "Automatic (Individual)," only "ALL" can be selected.</strong></p> 58 <h2>Supplemental Information on Group Operations</h2> 59 <h3>Relation to Files</h3> 60 <p>When items such as banks and sequences are registered to a group, what actually is being registered are the files which those items reference. Note that when snd library loads a group into the sound heap, what is being loaded are individual files.</p> 61 <br> 62 <p>For example, consider a sequence sound that references a text sequence file.</p> 63 <p>This text sequence file (which the sequence sound uses as its reference file) can describe multiple sequences.</p> 64 <p>If such a sequence sound (that is, one that references a text sequence file containing multiple sequences) is loaded into the sound heap as part of a group, all of the sequences described in the text sequence file are loaded, and even sequence sounds that are not registered with that particular group but that reference the same text sequence file can be played.</p> 65 <br> 66 <p>Multiple items that reference the same file can be registered in the same group. When that group is loaded, duplicate content is not loaded.</p> 67 <br> 68 <p><strong>Wave sound sets can be edited in the Sound Set window without their reference files. However, if this is done, each wave sound set is handled internally as a separate file.</strong></p> 69 <h3><a name="GROUP_WARC"></a>Relation Between Waveform Archive Automatic (Shared, Separate) Setting and Method of Group Output</h3> 70<p>Here we explain by way of example the relationship between the <B>Waveform Archive</B> of banks and wave sound sets and the <B>Output Method</B> for groups.</p> 71<p>To simplify the explanation, we concentrate on the relation between banks and groups. By substituting <I>wave sounds set</I> for <I>bank</I>, this same explanation can be read to understand the relation between wave sounds sets and groups.</p> 72 73<h4><a name="GROUP(LINK)_BANK(SHARE)"></a><B><I>Link</I></B> Group and <B><I>Automatic (Shared)</I></B> Bank</h4> 74<p>First we explain the behavior of the <I><B>Link</B></I> group.</p> 75<p>In the example below, three <B><I>Automatic (Shared)</I></B> banks are registered to a <B><I>Link</I></B> group.</p> 76<table class="explain" border="1"> 77 <THEAD> 78 <tr> 79 <td>Group -- Output Method</td> 80 <td>Bank -- Waveform Archive</td> 81 </tr> 82 </THEAD> 83 <TBODY> 84 <tr> 85 <td rowspan="3">GROUP_0 [Link]</td> 86 <td>BANK_0 [Automatic (Shared)]</td> 87 </tr> 88 <tr> 89 <td>BANK_1 [Automatic (Shared)]</td> 90 </tr> 91 <tr> 92 <td>BANK_2 [Automatic (Shared)]</td> 93 </tr> 94 </TBODY> 95</table> 96<p>A separate waveform archive is implicitly created automatically for each of the banks, BANK_0 ～ BANK_2. <br> Even if the same waveform is referenced among the banks BANK_0 ～ BANK_2, it is not shared but rather placed redundantly in ROM. A single collective waveform archive is not created for the group, and the duplicate waveforms in the waveform archive are not collected together. </p> 97<p>If you want waveforms to be shared, you need to either use <a href="#GROUP(EMBEDDED)_BANK(SHARE)"><B><I>Embed</I></B> Group and <B><I>Automatic (Shared)</I></B></a> or explicitly specify the bank's waveform archive as shown below.:</p> 98 99<h4><a name="EXPRESSLY_WARC"></a>Explicitly Specifying Bank's Waveform Archive</h4> 100 101<table class="explain" border="1"> 102 <THEAD> 103 <tr> 104 <td>Group -- Output Method</td> 105 <td>Bank -- Waveform Archive</td> 106 </tr> 107 </THEAD> 108 <TBODY> 109 <tr> 110 <td rowspan="3">GROUP_0<br>[Embed or Link]</td> 111 <td>BANK_0 - WARC_0</td> 112 </tr> 113 <tr> 114 <td>BANK_1 - WARC_0</td> 115 </tr> 116 <tr> 117 <td>BANK_2 - WARC_0</td> 118 </tr> 119 </TBODY> 120</table> 121 122<p>In the above configuration, WARC_0 contains the waveforms of banks BANK_0 ～ BANK_2 without any duplicates (i.e., one waveform is shared by multiple banks).</p> 123<p>The <B>Load Individually</B> flag for waveform archives can be set either on or off.</p> 124 125<h4><a name="GROUP(LINK)_BANK(SHARE)"></a><B><I>Link</I></B>Group and <B><I>Automatic (Separate)</I></B> Bank</h4> 126<table class="explain" border="1"> 127 <THEAD> 128 <tr> 129 <td>Group -- Output Method</td> 130 <td>Bank -- Waveform Archive</td> 131 </tr> 132 </THEAD> 133 <TBODY> 134 <tr> 135 <td rowspan="3">GROUP_0 [Link]</td> 136 <td>BANK_0 [Automatic (Separate)]</td> 137 </tr> 138 <tr> 139 <td>BANK_1 [Automatic (Separate)]</td> 140 </tr> 141 <tr> 142 <td>BANK_2 [Automatic (Separate)]</td> 143 </tr> 144 </TBODY> 145</table> 146 147<p>A separate waveform archive is implicitly created automatically for each of the banks, BANK_0 ～ BANK_2, just as was the case for <a href="#GROUP(LINK)_BANK(SHARE)"><B><I>Link</I></B>Group and <B><I>Automatic (Shared)</I></B> Bank</a>. The waveforms shared by banks are not collected together into a single waveform archive.</p> 148<p>In other words, regardless of whether the banks registered to a <B><I>Link</I></B> group are <B>Automatic (Shared)</B> or <B>Automatic (Separate)</B>, in either case a waveform archive is created for each individual bank, and duplicated waveforms are not shared inside a group.</p> 149 150<h4><a name="BANK(INDIVIDUAL)_MERIT"></a>Uses for <B>Automatic (Separate)</B> Banks</h4> 151<p>Although it may seem at first glance like there are no good uses for <B>Automatic (Separate)</B> banks, the following configuration yields a benefit:</p> 152 153<table class="explain" border="1"> 154 <THEAD> 155 <tr> 156 <td>Group -- Output Method</td> 157 <td>Bank -- Waveform Archive</td> 158 </tr> 159 </THEAD> 160 <TBODY> 161 <tr> 162 <td>GROUP_1 [Embed or Link]</td> 163 <td>BANK_0 [Automatic (Separate)]</td> 164 </tr> 165 <tr> 166 <td>GROUP_2 [Link]</td> 167 <td>BANK_0 [Automatic (Separate)]</td> 168 </tr> 169 </TBODY> 170</table> 171 172<p>With this configuration, only one kind of waveform archive is automatically created for BANK_0 and you can economize on ROM size.</p> 173<p>However, if GROUP_1 and GROUP_2 are both [Embed] then the waveform archive for BANK_1 will be created in two locations in ROM.</p> 174 175 176<h4><a name="GROUP(LINK)_BANK(SHARE)"></a><B><I>Embed</I></B>Group and <B><I>Automatic (Shared)</I></B> Bank</h4> 177<table class="explain" border="1"> 178 <THEAD> 179 <tr> 180 <td>Group -- Output Method</td> 181 <td>Bank -- Waveform Archive</td> 182 </tr> 183 </THEAD> 184 <TBODY> 185 <tr> 186 <td rowspan="3">GROUP_0 [Embed]</td> 187 <td>BANK_0 [Automatic (Shared)]</td> 188 </tr> 189 <tr> 190 <td>BANK_1 [Automatic (Shared)]</td> 191 </tr> 192 <tr> 193 <td>BANK_2 [Automatic (Shared)]</td> 194 </tr> 195 </TBODY> 196</table> 197 198<p>In this case, the waveforms are collected together and a single waveform archive is created for banks BANK_0 ～ BANK_2. This waveform archive is referenced by three banks and contains no redundant waveforms (i.e., a single waveform is shared by multiple banks).</p> 199<p>Compared to the <a href="#EXPRESSLY_WARC">explicit specification of waveform archives</a>, this configuration has the merit of not going out of the way to create waveform archives. But on the downside, the waveforms can only be shared inside the group. There is also a downside to adding the following to the above configuration:</p> 200 201<table class="explain" border="1"> 202 <THEAD> 203 <tr> 204 <td>Group -- Output Method</td> 205 <td>Bank -- Waveform Archive</td> 206 </tr> 207 </THEAD> 208 <TBODY> 209 <tr> 210 <td rowspan="2">GROUP_1 [Embed]</td> 211 <td>BANK_0 [Automatic (Shared)]</td> 212 </tr> 213 <tr> 214 <td>BANK_3 [Automatic (Shared)]</td> 215 </tr> 216 </TBODY> 217</table> 218 219<p>In this case, the [Embed] groups GROUP_0 and GROUP_1 both contain BANK_0, and the waveform archives of GROUP_0 and GROUP_1 both contain waveforms that are referenced by BANK_0 (placed in duplicate locations in ROM), so the size of ROM becomes larger.</p> 220 221<h4><a name="GROUP(LINK)_BANK(SHARE)"></a><B><I>Embed</I></B>Group and <B><I>Automatic (Separate)</I></B> Bank</h4> 222<table class="explain" border="1"> 223 <THEAD> 224 <tr> 225 <td>Group -- Output Method</td> 226 <td>Bank -- Waveform Archive</td> 227 </tr> 228 </THEAD> 229 <TBODY> 230 <tr> 231 <td rowspan="3">GROUP_0 [Embed]</td> 232 <td>BANK_0 [Automatic (Separate)]</td> 233 </tr> 234 <tr> 235 <td>BANK_1 [Automatic (Separate)]</td> 236 </tr> 237 <tr> 238 <td>BANK_2 [Automatic (Separate)]</td> 239 </tr> 240 </TBODY> 241</table> 242 243<p>In this case, a separate waveform archive is implicitly created automatically for each of the banks, BANK_0 ～ BANK_2. </p> 244<p>This configuration has merit when it is used in the way mentioned above in <a href="#BANK(INDIVIDUAL)_MERIT">Uses for Automatic (Separate) Banks</a>.</p> 245 246 247<hr><p>CONFIDENTIAL</p></body> 248 249</html> 250