1<html>
2<head>
3<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
4<meta http-equiv="Content-Style-Type" content="text/css">
5<title>ctr_BannerModelConverter</title>
6<style type="text/css">
7<!--
8body {
9/*
10    font-size       : 10pt;
11*/
12    font-weight     : normal;
13    color           : #000000;
14    margin          : 8px;
15}
16
17div {
18    width           : 98%;
19    white-space     : nowrap;
20}
21
22div.title {
23    text-align      : left;
24    font-weight     : bold;
25/*
26    font-size       : 16pt;
27*/
28    font-size       : 150%;
29    color           : #202020;
30    border-style    : double;
31    border-width    : 8px;
32    /* タイトルを囲む枠線の色を指定 */
33    border-color    : #FF6600;
34
35    /* RVLプラットフォーム系列 */
36/*
37    border-color    : #34beed;
38*/
39
40    /* TWLプラットフォーム系列 */
41/*
42    border-color    : #ff458f;
43*/
44
45    margin          : 4px;
46    padding         : 4px;
47}
48H1 {
49  font-size		: 150%;
50  font-family		: Arial;
51  border-bottom-width	: 5px;
52  border-bottom-style	: solid;
53  border-bottom-color	: #FF6600;
54  padding-bottom		: 1px;
55  margin-bottom		: 20px;
56  letter-spacing		: normal;
57  font-weight		: bold;
58}
59
60h2 {
61    font-weight     : bold;
62/*
63    font-size       : 16pt;
64*/
65    font-size       : 150%;
66    border-style    : none none solid double;
67    border-width    : 0px 0px 2px 8px;
68    /* 見出しの線の色を指定 */
69    border-color    : #FF6600;
70
71    /* RVLプラットフォーム系列 */
72/*
73    border-color    : #34beed;
74*/
75
76    /* TWLプラットフォーム系列 */
77/*
78    border-color    : #ff458f;
79*/
80
81    margin-left     : 2px;
82    padding-left    : 4px;
83}
84CODE {
85  font-family		: "Courier New", monospace;
86  position		: normal;
87  left			: 12px;
88  font-size		: 10pt;
89}
90table {
91  margin-top        : 2pt;
92  margin-bottom     : 2pt;
93  margin-left       : 0pt;
94  margin-right      : 0pt;
95  padding-left      : 0pt;
96  padding-right     : 0pt;
97  position          : relative;
98  left              : 12px;
99  font-family       : Arial;
100  font-size         : 10pt;
101  border-style      : none none none none;
102}
103td,th {
104  padding           : 2pt;
105  border-width      : 2pt;
106  border-style      : none none none none;
107  font-style        : normal;
108  text-align        : left;
109}
110td {
111  background        : #e8f4f4;
112  font-weight       : normal;
113}
114th {
115  background        : #c0d8d8;
116  font-weight       : bold;
117}
118
119p {
120    margin-left     : 4px;
121}
122p.code {
123  font-family		: "Courier New", monospace;
124  position		: normal;
125  left			: 12px;
126  font-size		: 10pt;
127  background            : #e8f4f4;
128}
129
130    .style1
131    {
132        color: #800000;
133        font-weight: bold;
134    }
135
136    .style2
137    {
138        font-size: xx-small;
139    }
140
141-->
142</style>
143
144</head>
145<body>
146<a name="top"></a> <!-- ※注意事項 --> <!--  ・(任意)となっているものは、記載が無くても問題ありません。 --> <!--  ・各項目についてる(必須)や(任意)は、作成後に削除してください。 --> <!--  ・各項目内の書き方は、パッケージごとに自由で問題ありませんが、同じパッケージ内で違いがでないようにしてください。 --> <!--  ・タグはすべて小文字、終了タグを持たないものは「/>」で閉じてください。--> <!--  ・HTMLコードのインデントは、各種社内コード規約と同様にスペース4文字か4文字幅のタブになるようにしてください-->
147
148<h1><CODE>ctr_BannerModelConverter</CODE></h1>
149
150<h1>Table of Contents</h1>
151<ol>
152<li><a href="#intro">Introduction</a></li>
153<li><a href="#usage">How to Use</a></li>
154<li><a href="#summary">Banner Overview</a></li>
155<li><a href="#input">Input Directory Structure</a></li>
156<li><a href="#restrict">File Restrictions</a></li>
157<li><a href="#history">Revision History</a></li>
158</ol>
159
160
161
162<h2><a name="intro">Introduction</a></h2>
163<P>The <CODE>ctr_BannerModelConverter</CODE> tool is used to create <CODE>cbmd</CODE> (Ctr Binary banner MoDel) files.<BR><CODE>Cbmd</CODE> files are created based on the specified folder structure.</P>
164<P>The resulting <CODE>cbmd</CODE> file can be used as a <CODE>makebanner bsf</CODE>. </P>
165<P class="style1">The Creative Studio for CTR data converter is used internally.<br />Conversion must occur in an environment where NW4C that is supported by the HOME Menu is installed.</P>
166
167<h2><a name="usage">How to Use</a></h2>
168<h3>What's Required</h3>
169<p>You need the following files to create a <CODE>cbmd</CODE> file:</p>
170<li>Intermediate files output by NW4C CreativeStudio.</li>
171</ul>
172
173<h3>Command</h3>
174
175
176<p class="code">
177% ctr_BannerModelConverter DIRECTORYNAME [Output]
178</p>
179
180<p class="first_ja">The <CODE>DIRECTORYNAME</CODE> specification is required. All other options are optional.</p>
181
182<h4 >Options</h4>
183
184
185<div class="table">
186<table border="1">
187<thead>
188<tr>
189<th align="center">Options</th>
190<th align="center">Description</th>
191</tr>
192</thead>
193<tbody>
194<tr>
195<td align="center">DIRECTORYNAME </td>
196<td align="center">Specifies the input directory name. Be sure to use the specified directory structure (described later).</td>
197</tr>
198<tr>
199<td align="center">Output</td>
200<td align="center">Specifies the file to output. If omitted, a file with the <CODE>cbmd</CODE> extension added to the originally input filename is output.</td>
201</tr>
202</tbody>
203</table>
204</div>
205
206<h2><a name="summary">Banner Overview</a></h2>
207
208<p>A banner is model data displayed in the upper screen when an application is selected.<BR>Banners are used to show a line-up of miniature target applications on the menu.</p>
209    <p>
210<img alt="banner" src="banner1.png" style="width: 400px; height: 240px" /></p>
211
212
213<h2><a name="input">Input Directory Structure</a></h2>
214
215<p>Banner model data can be divided into one of two main categories: Model data common to all languages, and data especially intended for each separate region and language combination. <BR>Make sure to use a directory structure as given below. Specify the Banner folder at the top in <CODE>DIRECTORYNAME</CODE> on the command line.</p>
216
217
218<p class="code">
219Banner ━┳━ COMMON ━┳━ COMMON.cmdl<br /> ┃       ┣━ COMMON.cskla<br /> ┃       ┣━ COMMON.cmata<br /> ┃       ┣━ COMMON.cenv<br /> ┃       ┣━ COMMON.clts<br /> ┃       ┗━ Textures ━┓<br /> ┃                ┣━ COMMON1.ctex<br /> ┃                ┣━ COMMON2.ctex<br /> ┃                ┣━ COMMON3.ctex<br /> ┃                ┗━ COMMON4.ctex<br /> ┣━ JPN_JP ━┳━ JPN_JP.cmdl<br /> ┃       ┣━ JPN_JP.cskla<br /> ┃       ┣━ JPN_JP.cmata<br /> ┃       ┣━ JPN_JP.cenv<br /> ┃       ┣━ JPN_JP.clts<br /> ┃       ┗━ Textures ━┓<br /> ┃                ┣━ JPN_JP1.ctex<br /> ┃                ┣━ COMMON1.ctex<br /> ┃                ┣━ …<br /> ┃                ┣━ …<br /> ┣━ …<br /> ┣━ …</p>
220
221<p>The COMMON folder is a required item. The other folders can contain any content, but an empty folder must be prepared.<br /> Filenames cannot be changed, and be sure to set the file in the COMMON folder to COMMON.cmdl, etc.</p>
222
223<div class="table">
224<table border="1">
225<thead>
226<tr>
227<th align="center">Name</th>
228<th align="center">
229Region</th>
230<th align="center">
231Language</th>
232</thead>
233<tbody>
234<tr>
235<td align="center">COMMON</td>
236<td align="center">All regions</td>
237<td align="center">All Languages</td>
238</tr>
239<tr>
240<td align="center">EUR_EN </td>
241<td align="center">Europe</td>
242<td align="center">British English </td>
243
244</tr>
245<tr>
246<td align="center">EUR_FR</td>
247<td align="center">Europe</td>
248<td align="center">French</td>
249</tr>
250<tr>
251<td align="center">EUR_GE</td>
252<td align="center">Europe</td>
253<td align="center">German</td>
254
255</tr>
256<tr>
257<td align="center">EUR_IT</td>
258<td align="center">Europe</td>
259<td align="center">Italian</td>
260
261</tr>
262<tr>
263<td align="center">EUR_DU</td>
264<td align="center">Europe</td>
265<td align="center">Dutch</td>
266
267</tr>
268<tr>
269<td align="center">EUR_PO</td>
270<td align="center">Europe</td>
271<td align="center">Portuguese</td>
272
273</tr>
274<tr>
275<td align="center">EUR_RU</td>
276<td align="center">Europe</td>
277<td align="center">Russian</td>
278
279</tr>
280<tr>
281<td align="center">EUR_SP</td>
282<td align="center">Europe</td>
283<td align="center">Spanish</td>
284
285</tr>
286<tr>
287<td align="center">JPN_JP </td>
288<td align="center">Japan</td>
289<td align="center">Japanese</td>
290
291</tr>
292<tr>
293<td align="center">USA_EN </td>
294<td align="center">The Americas</td>
295<td align="center">North American English</td>
296
297</tr>
298<tr>
299<td align="center">USA_FR </td>
300<td align="center">The Americas</td>
301<td align="center">French (Canada)</td>
302
303</tr>
304<tr>
305<td align="center">USA_SP </td>
306<td align="center">The Americas</td>
307<td align="center">Spanish (Latin America)</td>
308
309</tr>
310<tr>
311<td align="center">USA_PO </td>
312<td align="center">The Americas</td>
313<td align="center">Portuguese (Brazil)</td>
314
315</tr>
316</tbody>
317</table>
318</div>
319
320<h2><a name="restrict">File Restrictions</a></h2>
321
322<p>The following restrictions apply to banner model data.</p>
323
324<p class="style1">Note: These restrictions are provisional. These specifications are subject to change in the future.</p>
325
326<h3>Camera restrictions</h3>
327
328<p>
329The camera is fixed. Adjustment by applications is impossible.
330</p>
331
332<div class="table">
333    <table border="1">
334        <tr style="BACKGROUND: #eee">
335            <th>
336Camera position x, y, z</th>
337            <th>
338Look-at point  x, y, z</th>
339            <th>
340Angles of view (fovy)</th>
341            <th>
342near/far</th>
343            <th>
344Depth Level<span class="style2">※</span></th>
345            <th>
346Factor<span class="style2">※</span></th>
347        </tr>
348        <tr style="BACKGROUND: #fff">
349            <td>
350                0.0/1.0/44.786 4.786
351            </td>
352            <td>
353                0.0/1.0/0.0</td>
354            <td>
355                30</td>
356            <td>
357                -</td>
358            <td>
359                38</td>
360            <td>
361          1.0</td>
362        </tr>
363    </table>
364 </div>
365
366<p>
367<B>Note:</B> These are the <CODE>depthLevel</CODE> and <CODE>factor</CODE> values used by the <CODE>ulcd::CalculateMatrices</CODE> function.
368
369<h3>Restrictions on model Y-axis rotation</h3>
370
371    <p>
372Models rotate once in 600 frames (10 seconds at 60 fps) at constant velocity to the left when you are facing the screen. - Rotation accelerates if the user blows into the microphone.</p>
373    <p>
374<B>Note:</B> Use billboard settings for nodes you do not want to be rotated.<BR><B>Note:</B> Although these nodes do not normally turn if rotated to the right at constant speed for 600f, they will rotate if the user blows into the microphone. </p>
375
376<h3>Restrictions on intermediate files</h3>
377
378<p>There are restrictions on data by design and to prevent skipped frames.<BR><B>Note:</B> Data that violates these restrictions generates an error during conversion. (Not implemented)<BR>Even if the data is within the restrictions, the data size must be reduced if skipped frames occur.</p>
379<div class="table">
380<table border="1">
381<thead>
382<tr>
383<th align="center">Extension</th>
384<th align="center">
385◎: Required<br />○: Optional<br />×: Not supported</th>
386<th align="center">Data restrictions on [Data common to all languages] + [Data for a single language] </th>
387</tr>
388</thead>
389<tbody>
390<tr>
391<td align="center">cmdl</td><td align="center">◎</td>
392<td align="center">Number of polygons (3000 or less)<BR>Number of bones (5 or less)<BR>Number of materials (5 or less)<br />Layer configurations (1, 2, 3, or 4 layers; Note: limited to one cycle)<BR>[Stencil testing is disabled] Used for masking with an ellipse.</td>
393</tr>
394<tr>
395<td align="center">ctex </td>
396<td align="center">○ </td>
397<td align="center">There is no limit on the number of textures as long as the size does not exceed the limit.</td>
398</tr>
399<tr>
400<td align="center">cskla </td>
401<td align="center">○ </td>
402<td align="center">Create a 600f looped animation.</td>
403</tr>
404<tr>
405<td align="center">cmata </td>
406<td align="center">○ </td>
407<td align="center">Create a 600f looped animation.</td>
408</tr>
409<tr>
410<td align="center">cenv </td>
411<td align="center">○ </td>
412<td align="center">Number of lights (3 or less)<BR>Number of cameras (3 or less)<BR>Number of fogs (1 or less)</td>
413</tr>
414<tr>
415<td align="center">clts </td>
416<td align="center">○ </td>
417<td align="center">Number of tables (3 or less)</td>
418</tr>
419<tr>
420<td align="center">cptl </td>
421<td align="center">×</td>
422<td align="center">Particles are not supported.</td>
423</tr>
424<tr>
425<td align="center">csdr </td>
426<td align="center">×</td>
427<td align="center">User shaders are not supported. (The default shader is used.)</td>
428</tr>
429<tr>
430<td align="center">clgt </td>
431<td align="center">×</td>
432<td align="center">Store lights in <CODE>cenv</CODE>. Animation is not supported.</td>
433</tr>
434<tr>
435<td align="center">ccam </td>
436<td align="center">×</td>
437<td align="center">Store projection cameras in <CODE>cenv</CODE>. Animation is not supported.</td>
438</tr>
439<tr>
440<td align="center">cres </td>
441<td align="center">×</td>
442<td align="center">Merged files are not supported to support localization needs to switch resources. </td>
443</tr>
444</tbody>
445</table>
446</div>
447
448<h3>Sound File Restrictions</h3>
449
450<p>The sound file must be three seconds or less.<br/>There are no other restrictions.
451    </p>
452
453<h3>Restrictions on data size</h3>
454
455<p>The following restrictions have been placed on data size after conversion.<BR><B>Note:</B> Data that violates these restrictions generates an error during conversion. (Not implemented)
456    </p>
457
458<div class="table">
459<table border="1">
460<thead>
461<tr>
462<th align="center">Data capacity restrictions on [Data common to all languages] + [Data for a single language]</th>
463<th align="center">Data capacity restrictions on [Data common to all languages] + [All data for a single language]<br/>
464 (Binary file, including sound, (*.bnr) data capacity restrictions)</th>
465</tr>
466</thead>
467<tbody>
468<tr>
469<td align="center">[256KB] for [size after compression]<br />
470 [512KB] for [size before compression]</td>
471<td align="center">1MB after compression</td>
472</tr>
473</tbody>
474</table>
475</div>
476
477</p>
478
479<h2><a name="history">Revision History</a></h2>
480    <dl class="history">
481      <dt>2010/10/09</dt>
482<dd>Supplemented the restrictions for sound files and data capacity.<br />
483      <dt>2010/09/28</dt>
484<dd>Initial version.<br />
485      </dd>
486    </dl>
487<hr><p>CONFIDENTIAL</p></body>
488</html>
489