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_makebanner</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    }
134
135    .style2
136    {
137        font-size: xx-small;
138    }
139
140-->
141</style>
142
143</head>
144<body>
145<a name="top"></a> <!-- ※注意事項 --> <!--  ・(任意)となっているものは、記載が無くても問題ありません。 --> <!--  ・各項目についてる(必須)や(任意)は、作成後に削除してください。 --> <!--  ・各項目内の書き方は、パッケージごとに自由で問題ありませんが、同じパッケージ内で違いがでないようにしてください。 --> <!--  ・タグはすべて小文字、終了タグを持たないものは「/>」で閉じてください。--> <!--  ・HTMLコードのインデントは、各種社内コード規約と同様にスペース4文字か4文字幅のタブになるようにしてください-->
146
147<h1>ctr_BannerModelConverter</h1>
148
149<h1>Table of Contents</h1>
150<ol>
151  <li><a href="#intro">Introduction</a></li>
152  <li><a href="#usage">How to Use</a></li>
153  <li><a href="#summary">Banner Overview</a></li>
154  <li><a href="#input">Input Directory Structure</a></li>
155  <li><a href="#restrict">File Restrictions</a></li>
156  <li><a href="#history">Revision History</a></li>
157</ol>
158
159
160
161<h2><a name="intro">Introduction</a></h2>
162<P>The ctr_BannerModelConverter tool is used to create cbmd (Ctr Binary banner MoDel) files.<BR> Cbmd files are created based on the specified folder structure.</P>
163    <P>The resulting cbmd file can be used as a makebanner bsf. </P>
164
165<h2><a name="usage">How to Use</a></h2>
166<h3>What's Required</h3>
167<p>You will need the following files to create a cbmd file:</p>
168<ul>Intermediate files output by NW4C CreativeStudio.</li>
169</ul>
170
171<h3>Command</h3>
172
173
174<p class="code">
175    % ctr_BannerModelConverter DIRECTORYNAME [Output]
176</p>
177
178<p class="first_ja">The DIRECTORYNAME specification is required. All other options are optional.</p>
179
180<h4 >Options</h4>
181
182
183<div class="table">
184<table border="1">
185<thead>
186<tr>
187<th align="center">Options</th>
188<th align="center">Description</th>
189</tr>
190</thead>
191<tbody>
192<tr>
193<td align="center">DIRECTORYNAME </td>
194<td align="center">Specifies the input directory name. Be sure to use the specified directory structure (described later).</td>
195</tr>
196<tr>
197<td align="center">Output</td>
198<td align="center">Specifies the file to output. If omitted, a file with the cbmd extension added to the originally input file name will be output.</td>
199</tr>
200</tbody>
201</table>
202</div>
203
204<h2><a name="summary">Banner Overview</a></h2>
205
206<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>
207    <p>
208        <img alt="banner" src="banner1.png" style="width: 400px; height: 240px" /></p>
209
210
211<h2><a name="input">Input Directory Structure</a></h2>
212
213<p>Banner model data falls into one of two main categories: Model data common to all langauges, 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 DIRECTORYNAME on the command line.</p>
214
215
216<p class="code">
217    Banner ━┳━ 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>
218
219<p>The COMMON folder contains required items. Other folders can contain anything. </p>
220
221<div class="table">
222<table border="1">
223<thead>
224<tr>
225<th align="center">Name</th>
226<th align="center">
227    Regions and Languages</th>
228</thead>
229<tbody>
230<tr>
231<td align="center">COMMON</td>
232<td align="center">Common to all regions and all languages</td>
233</tr>
234<tr>
235<td align="center">EUR_EN </td>
236<td align="center">European region, English language </td>
237</tr>
238<tr>
239<td align="center">EUR_FR</td>
240<td align="center">European region, French language</td>
241</tr>
242<tr>
243<td align="center">EUR_GE</td>
244<td align="center">European region, German language</td>
245</tr>
246<tr>
247<td align="center">EUR_IT</td>
248<td align="center">European region, Italian language</td>
249</tr>
250<tr>
251<td align="center">EUR_DU</td>
252<td align="center">European region, Dutch language</td>
253</tr>
254<tr>
255<td align="center">EUR_PO</td>
256<td align="center">European region, Portuguese language</td>
257</tr>
258<tr>
259<td align="center">EUR_RU</td>
260<td align="center">European region, Russian language</td>
261</tr>
262<tr>
263<td align="center">EUR_SP</td>
264<td align="center">European region, Spanish language</td>
265</tr>
266<tr>
267<td align="center">JPN_JP </td>
268<td align="center">Japanese region, Japanese language</td>
269</tr>
270<tr>
271<td align="center">USA_EN </td>
272<td align="center">North American region, English language</td>
273</tr>
274<tr>
275<td align="center">USA_FR </td>
276<td align="center">North American region, French language</td>
277</tr>
278<tr>
279<td align="center">USA_SP </td>
280<td align="center">North American region, Spanish language</td>
281</tr>
282<tr>
283<td align="center">USA_PO </td>
284<td align="center">North American region, Portuguese language (under review)</td>
285</tr>
286</tbody>
287</table>
288</div>
289
290<h2><a name="restrict">File Restrictions</a></h2>
291
292<p>The following restrictions apply to banner model data.</p>
293
294    <p class="style1">Note: These restrictions are provisional. These specifications are subject to change in the future.</p>
295
296<h3>Camera Restrictions</h3>
297
298<p>
299    The camera is fixed. Adjustment by applications is impossible.<div class="table">
300    <table border="1">
301        <tr style="BACKGROUND: #eee">
302            <th>
303                Camera position x, y, z</th>
304            <th>
305                View point x, y, z</th>
306            <th>
307                View angle (fovy)</th>
308            <th>
309                near/far</th>
310            <th>
311                Depth Level<span class="style2">※</span></th>
312            <th>
313                Factor<span class="style2">※</span></th>
314        </tr>
315        <tr style="BACKGROUND: #fff">
316            <td>
317                0.0/1.0/44.786 4.786
318            </td>
319            <td>
320                0.0/1.0/0.0</td>
321            <td>
322                30</td>
323            <td>
324                -</td>
325            <td>
326                38</td>
327            <td>
328          1.0</td>
329        </tr>
330    </table>
331 </div>
332
333<p>
334    Note: These are the &quot;depthLevel&quot; and &quot;factor&quot; values used by the ulcd::CalculateMatrices function.
335
336<h3>Restrictions on model Y-axis rotation</h3>
337
338    <p>
339        Models move at constant velocity toward the screen and rotate once in 600f (10 seconds at 60 fps) to the left. Models rotate.<BR> - Rotation accelerates if the user blows into the microphone.</p>
340    <p>
341        Note: Use billboard settings for nodes you do not want to be rotated.<BR> Note: Although models 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>
342
343<h3>Restrictions on intermediate files</h3>
344
345<p>There are restrictions on data to ensure that it is processed as intended by specifications.<BR> Note: Data that violates these restrictions generates an error during conversion. (Not implemented)<BR>Even if inside restrictions, data dropped from processing must be reduced.</p>
346<div class="table">
347<table border="1">
348<thead>
349<tr>
350<th align="center">Extension</th>
351<th align="center">
352◎ Required<br /> ○ Doesn't matter<br /> ×Not supported</th>
353<th align="center">① Data restrictions on all languages 【Data common to all languages】+【One data for each language】 </th>
354</tr>
355</thead>
356<tbody>
357<tr>
358<td align="center">cmdl<td align="center">◎</td>
359<td align="center">Number of polygons (3000 or less)<BR>Number of bones (5 or less)<BR>Layer config (1, 2, 3, or 4 layers; Note: limited to one cycle)<BR>Use for masking with an ellipse for which the stencil text is disabled.</td>
360</tr>
361<tr>
362<td align="center">ctex </td>
363<td align="center">○ </td>
364<td align="center">There is no limit on textures as long as there is enough capacity.</td>
365</tr>
366<tr>
367<td align="center">cskla </td>
368<td align="center">○ </td>
369<td align="center">Create a 600f looped animation.</td>
370</tr>
371<tr>
372<td align="center">cmata </td>
373<td align="center">○ </td>
374<td align="center">Create a 600f looped animation.</td>
375</tr>
376<tr>
377<td align="center">cenv </td>
378<td align="center">○ </td>
379<td align="center">Number of lights (3 or less)<BR>Number of camers (3 or less)<BR>Number of fogs (1 or less)</td>
380</tr>
381<tr>
382<td align="center">clts </td>
383<td align="center">○ </td>
384<td align="center">Number of tables (3 or less)</td>
385</tr>
386<tr>
387<td align="center">cptl </td>
388<td align="center">×</td>
389<td align="center">Particles are not supported.</td>
390</tr>
391<tr>
392<td align="center">csdr </td>
393<td align="center">×</td>
394<td align="center">User shaders are not supported. (The default shader is used.)</td>
395</tr>
396<tr>
397<td align="center">clgt </td>
398<td align="center">×</td>
399<td align="center">Store lights in cenv. Animation is not supported.</td>
400</tr>
401<tr>
402<td align="center">ccam </td>
403<td align="center">×</td>
404<td align="center">Store projection camers in cenv. Animation is not supported.</td>
405</tr>
406<tr>
407<td align="center">cres </td>
408<td align="center">×</td>
409<td align="center">Merged files are not supported to support swapping of localized releases. </td>
410</tr>
411</tbody>
412</table>
413</div>
414
415<h3>Restrictions on data capacity</h3>
416
417<p>The following restrictions have been placed on data volume after conversion.<BR> Note: Data that violates these restrictions generates an error during conversion. (Not implemented)
418    </p>
419
420<div class="table">
421<table border="1">
422<thead>
423<tr>
424<th align="center">Data restriction on 【①】+【one of ②】<BR>Data restriction on 【Data common to all languages】+【One data for each languages】</th>
425<th align="center">Data restriction on 【Data common to all languages】+【All data for each language】</th>
426</tr>
427</thead>
428<tbody>
429<tr>
430<td align="center">512KB for a compressed size of 256KB</td>
431<td align="center">1MB for the compressed size</td>
432</tr>
433</tbody>
434</table>
435</div>
436
437</p>
438
439    <h2><a name="history">Revision History</a></h2>
440    <dl class="history">
441      <dt>2010/09/28</dt>
442      <dd>Initial version.<br />
443      </dd>
444    </dl>
445<hr><p>CONFIDENTIAL</p></body>
446</html>
447