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<title>ctr_FontConverterConsole</title> 7 <style type="text/css"> 8 <!-- 9 body { 10 /* 11 font-size : 10pt; 12 */ 13 font-weight : normal; 14 color : #000000; 15 margin : 8px; 16 } 17 18 div { 19 width : 98%; 20 white-space : nowrap; 21 } 22 23 div.title { 24 text-align : left; 25 font-weight : bold; 26 /* 27 font-size : 16pt; 28 */ 29 font-size : 150%; 30 color : #202020; 31 border-style : double; 32 border-width : 8px; 33 /* タイトルを囲む枠線の色を指定 */ 34 border-color : #CD202C; 35 36 /* RVLプラットフォーム系列 */ 37 /* 38 border-color : #34beed; 39 */ 40 41 /* TWLプラットフォーム系列 */ 42 /* 43 border-color : #ff458f; 44 */ 45 46 margin : 4px; 47 padding : 4px; 48 } 49 H1 { 50 font-size : 150%; 51 font-family : Arial; 52 border-bottom-width : 5px; 53 border-bottom-style : solid; 54 border-bottom-color : #CD202C; 55 padding-bottom : 1px; 56 margin-bottom : 20px; 57 letter-spacing : normal; 58 font-weight : bold; 59 } 60 61 h2 { 62 font-weight : bold; 63 /* 64 font-size : 16pt; 65 */ 66 font-size : 150%; 67 border-style : none none solid double; 68 border-width : 0px 0px 2px 8px; 69 /* 見出しの線の色を指定 */ 70 border-color : #CD202C; 71 72 /* RVLプラットフォーム系列 */ 73 /* 74 border-color : #34beed; 75 */ 76 77 /* TWLプラットフォーム系列 */ 78 /* 79 border-color : #ff458f; 80 */ 81 82 margin-left : 2px; 83 padding-left : 4px; 84 } 85 CODE { 86 font-family : "Courier New", monospace; 87 position : normal; 88 left : 12px; 89 font-size : 10pt; 90 } 91 table { 92 margin-top : 2pt; 93 margin-bottom : 2pt; 94 margin-left : 0pt; 95 margin-right : 0pt; 96 padding-left : 0pt; 97 padding-right : 0pt; 98 position : relative; 99 left : 12px; 100 font-family : Arial; 101 font-size : 10pt; 102 border-style : none none none none; 103 } 104 td,th { 105 padding : 2pt; 106 border-width : 2pt; 107 border-style : none none none none; 108 font-style : normal; 109 text-align : left; 110 } 111 td { 112 background : #e8f4f4; 113 font-weight : normal; 114 } 115 th { 116 background : #c0d8d8; 117 font-weight : bold; 118 } 119 120 p { 121 margin-left : 4px; 122 } 123 p.code { 124 font-family : "Courier New", monospace; 125 position : normal; 126 left : 12px; 127 font-size : 10pt; 128 background : #e8f4f4; 129 } 130 131 --> 132 </style> 133 134 </head> 135 <body> 136<h1><CODE>ctr_FontConverterConsole</CODE></h1> 137<h2>Description</h2> 138 <p> 139The <CODE>ctr_FontConverterConsole</CODE> tool can be used to display any font installed on a PC as text on CTR. 140 </p> 141 <p> 142<CODE>ctr_FontConverterConsole</CODE> is a command line version of <CODE>ctr_FontConverter</CODE> (hereafter referred to as the "GUI version"). Other than differences in the interface, functionality is equivalent to the GUI version. This tool is intended for use in Makefiles and batchfiles. 143 </p> 144<h2>Font Licenses</h2> 145 <p> 146<CODE>ctr_FontConverterConsole</CODE> can convert any font installed on a PC for use on the CTR. However, a user license may be required to use such fonts in game software that will be sold. Acquire the appropriate licenses for each game application. <CODE>ctr_FontConverterConsole</CODE> and the CTR SDK do not include font licenses of any kind. 147 </p> 148<h2>Using the Tool</h2> 149<h3>Commands</h3> 150 151 <p class="code"> 152ctr_FontConverterConsole.exe -i <input format> <input option> -o <output format> <output option> [-f <character filter file path>] 153 </p> 154 <p> 155As shown in , <CODE>-i</CODE>, <CODE>-o</CODE>, and <CODE>-f</CODE> are used to specify input, output, and filter options, respectively. 156 </p> 157 <p> 158<input option> and <output option> change based on the specifications for <input format> and <output format>, respectively. These elements are discussed in subsequent sections. 159 </p> 160 <p> 161Enclose elements that contain spaces between words with quotation marks ("). (Example "parameter with spaces".) Quotation marks cannot be used inside of quotation marks. 162 </p> 163 164<h4>Input options</h4> 165 <p> 166Use the following options with <input option> according to the <input format>. 167 </p> 168 169<h5>Input: Image (-i image)</h5> 170 <p> 171 <table class="table"><tbody> 172 <tr> 173<th>Options</th><th>Omittability</th><th>Comments</th> 174 </tr> 175 <tr> 176<td><CODE>-if <image file path></CODE></td><td>Impossible</td><td></td> 177 </tr> 178 <tr> 179<td><CODE>-io <letter order file path></CODE></td><td>Impossible</td><td></td> 180 </tr> 181 <tr> 182<td><CODE>-ic <color format></CODE></td><td>Impossible</td> 183 <td> 184Specify one of the following for <color format>: A4, A8, LA4, LA8, RGB565, RGB5A1, RGBA4, RGB8, or RGBA8. 185 </td> 186 </tr> 187 <tr> 188<td>-ia</td><td>Possible</td> 189 <td> 190Executes linear interpolation countermeasure processing if specified. 191 </td> 192 </tr> 193 </tbody></table> 194 </p> 195 <p> 196<B>Example:</B> 197 </p> 198 <p class="code"> 199-i image -if font.bmp -io xlor/cp1252.xlor -ic LA8 200 </p> 201 <p> 202As shown above, the BMP file <CODE>font.bmp</CODE> is read as input according to the letter order file <CODE>xlor/cp1252.xlor</CODE>. The BMP color is interpreted using the LA8 format. 203 </p> 204 205<h5>Input: bcfnt (-i bcfnt)</h5> 206 <p> 207 <table class="table"><tbody> 208 <tr> 209<th>Options</th><th>Omittability</th><th>Comments</th> 210 </tr> 211 <tr> 212<td><CODE>-if <font file path></CODE></td><td>Impossible</td> 213 <td> 214Specifies a <CODE>bcfnt</CODE> or <CODE>bcfna</CODE> file. 215 </td> 216 </tr> 217 </tbody></table> 218 </p> 219 <p> 220<B>Example:</B> 221 </p> 222 <p class="code"> 223-i bcfnt -if font.bcfnt 224 </p> 225 <p> 226Accepts the <CODE>bcfnt</CODE> file named <CODE>font.bcfnt</CODE> as input. 227 </p> 228 229<h5>Input: Windows Font (-i win)</h5> 230 <p> 231 <table class="table"><tbody> 232 <tr> 233<th>Options</th><th>Omittability</th><th>Comments</th> 234 </tr> 235 <tr> 236<td><CODE>-in <font name></CODE></td><td>Impossible</td><td></td> 237 </tr> 238 <tr> 239<td><CODE>-is <font size></CODE></td><td>Impossible</td> 240 <td> 241The conversion source font size in pixel units. 242 </td> 243 </tr> 244 <tr> 245<td><CODE>-isw <average witdh></CODE></td><td>Possible</td> 246 <td> 247Specifies the average width in pixels. The aspect ratio can be changed by making this specification. 248 </td> 249 </tr> 250 <tr> 251<td><CODE>-ic <number of gradations></CODE></td><td>Impossible</td> 252 <td> 253Specify any one of A1 through LA6 given below for <number of gradations>. A8 or LA8 format results when the texture format used to output the <CODE>bcfnt</CODE> is 64 levels. A4 or LA4 results in all other cases.<br/> 254 <table> 255 <tbody> 256<tr><th>Alpha</th><th>2 levels</th><th>16 levels</th><th>64 levels</th></tr> 257<tr><td>Alpha only</td><td>A1</td><td>A4</td><td>A6</td></tr> 258<tr><td>Brightness and alpha</td><td>LA1</td><td>LA4</td><td>LA6</td></tr> 259 </tbody> 260 </table> 261 </td> 262 </tr> 263 <tr> 264<td>-ia</td><td>Possible</td> 265 <td> 266Output using software anti-aliasing if specified. 267 </td> 268 </tr> 269 <tr> 270<td><CODE>-it <character width></CODE></td><td>Possible</td> 271 <td> 272Specify one of the following for <character width>. If omitted, <CODE>char</CODE> is assumed.<BR> 273 <table> 274 <tbody> 275<tr><th>Character Width</th><th>Description</th></tr> 276<tr><td><CODE>glyph</CODE></td><td>Uses the glyph width as the character width.</td></tr> 277 <tr> 278<td><CODE>keepsp</CODE></td> 279 <td> 280The character width specified for the font is used for spaces, while the glyph width is used as the character width in all other cases. 281 </td> 282 </tr> 283<tr><td><CODE>char</CODE></td><td>Uses the character width specified for the font.</td></tr> 284<tr><td><CODE>fixed</CODE></td><td>Uses the same width for all characters.</td></tr> 285 </tbody> 286 </table> 287 </td> 288 </tr> 289 <tr> 290<td><CODE>-iw <monospace width></CODE></td><td>Possible/Impossible</td> 291 <td> 292Required when <CODE>-it</CODE> fixed is specified. Invalid in all other cases. 293 </td> 294 </tr> 295 </tbody></table> 296 </p> 297 <p> 298<B>Example:</B> 299 </p> 300 <p class="code"> 301-i win -in "MS Gothic" -is 16 -ic A6 -it glyph 302 </p> 303 <p> 304Data is loaded using Windows MS Gothic font with a size of 16 pixels and 64 gradations alpha only (=A6). The glyph width is used for the character width. 305 </p> 306 307<h4>Output options</h4> 308 <p> 309The following options can be used with <CODE><output option></CODE>, according to the <CODE><output format></CODE>. 310 </p> 311 312<h5>Output: Image (-o image)</h5> 313 <p> 314 <table class="table"><tbody> 315 <tr> 316<th>Options</th><th>Omittability</th><th>Comments</th> 317 </tr> 318 <tr> 319<td><CODE>-of <image file path></CODE></td><td>Impossible</td> 320 <td> 321Unlike the GUI version, the command line version does nothing if the image format and file extension do not match. Output is made using the specified file name. 322 </td> 323 </tr> 324 <tr> 325<td><CODE>-oo <letter order file path></CODE></td><td>Impossible</td><td></td> 326 </tr> 327 <tr> 328<td><CODE>-oi <image format></CODE></td><td>Possible</td> 329 <td> 330Specifies the image file format to be output. Specify one of the following for <CODE><image format></CODE>. If omitted, <CODE>ext</CODE> is assumed. 331 <table> 332 <tbody> 333<tr><th>Image format</th><th>Description</th></tr> 334<tr><td><CODE>ext</CODE></td><td>Determines the format based on the image file extension.</td></tr> 335<tr><td><CODE>bmp</CODE></td><td>Ouput is made in BMP format.</td></tr> 336<tr><td><CODE>tga</CODE></td><td>Ouput is made in TGA format.</td></tr> 337 </tbody> 338 </table> 339 </td> 340 </tr> 341 <tr> 342<td><CODE>-og</CODE></td><td>Possible</td> 343 <td> 344No grid if specified. 345 </td> 346 </tr> 347 <tr> 348<td><CODE>-ow <cell width></CODE></td><td>Possible</td> 349 <td> 350The default specifies a width sufficient for output. Cannot be specified concurrently with <CODE>-or</CODE> or <CODE>-ob</CODE>. 351 </td> 352 </tr> 353 <tr> 354<td><CODE>-oh <cell height></CODE></td><td>Possible</td> 355 <td> 356The default specifies a height sufficient for output. Cannot be specified concurrently with <CODE>-or</CODE> or <CODE>-ob</CODE>. 357 </td> 358 </tr> 359 <tr> 360<td><CODE>-ol <cell left margin width></CODE></td><td>Possible</td> 361 <td> 362The default is 0. 363 </td> 364 </tr> 365 <tr> 366<td><CODE>-or <cell right margin width></CODE></td><td>Possible</td> 367 <td> 368The default specifies the same value as <CODE>-ol</CODE>. Cannot be specified concurrently with <CODE>-ow</CODE> or <CODE>-oh</CODE>. 369 </td> 370 </tr> 371 <tr> 372<td><CODE>-ot <cell top margin width></CODE></td><td>Possible</td> 373 <td> 374The default is 0. 375 </td> 376 </tr> 377 <tr> 378<td><CODE>-ob <cell bottom margin width></CODE></td><td>Possible</td> 379 <td> 380If omitted, the same value as specified for <CODE>-ot</CODE> is assumed. Cannot be specified concurrently with <CODE>-ow</CODE> or <CODE>-oh</CODE>. 381 </td> 382 </tr> 383 <tr> 384<td><CODE>-ocg <grid color></CODE></td><td>Possible</td> 385 <td> 386Specifies the color as a 6-digit hexadecimal. Treated as 000000 if omitted. 387 </td> 388 </tr> 389 <tr> 390<td><CODE>-ocm <margin color></CODE></td><td>Possible</td> 391 <td> 392Specifies the color as a 6-digit hexadecimal. Treated as 99AA99 if omitted. 393 </td> 394 </tr> 395 <tr> 396<td><CODE>-ocw <width line color></CODE></td><td>Possible</td> 397 <td> 398Specifies the color as a 6-digit hexadecimal. Treated as FF0000 if omitted. 399 </td> 400 </tr> 401 <tr> 402<td>-ocn <null color></td><td>Possible</td> 403 <td> 404Specifies the color as a 6-digit hexadecimal. Treated as FF7F7F if omitted. 405 </td> 406 </tr> 407 </tbody></table> 408 </p> 409 <p> 410<B>Example:</B> 411 </p> 412 <p class="code"> 413-o image -of font.bmp -oo xlor/cp1252.xlor -og -ol 1 -ot 3 414 </p> 415 <p> 416The above specifications apply a 1-pixel margin to the left and right, and a 3-pixel margin to the top and bottom of each cell according to the letter order file <CODE>xlor/cp1252.cxlor</CODE>, then outputs the image to <CODE>font.bmp</CODE> without a grid. 417 </p> 418 419<h5>Output: bcfnt (-o bcfnt)</h5> 420 <p> 421 <table class="table"><tbody> 422 <tr> 423<th>Options</th><th>Omittability</th><th>Comments</th> 424 </tr> 425 <tr> 426<td><CODE>-oe <character code></CODE></td><td>Possible</td> 427 <td> 428Specify one of the following for <CODE><character code></CODE>. If omitted, unicode is assumed.<BR> 429 <table> 430 <tbody> 431<tr><th>Character Codes</th><th>Description</th></tr> 432<tr><td><CODE>unicode</CODE></td><td>Specifies Unicode.</td></tr> 433<tr><td><CODE>sjis</CODE></td><td>Specifies ShiftJIS.</td></tr> 434<tr><td><CODE>cp1252</CODE></td><td>Specifies a CP1252.</td></tr> 435 </tbody> 436 </table> 437 </td> 438 </tr> 439 <tr> 440<td><CODE>-op <glyph group file></CODE></td><td>Possible</td> 441 <td> 442No grouping (no compression) if omitted. 443 </td> 444 </tr> 445 <tr> 446<td><CODE>-os <sheet size></CODE></td><td>Possible</td> 447 <td> 448Specifies the sheet size as a number of pixels in units of 1000's of pixels. A power of two greater than or equal to 16, and less than or equal to 1024 must be specified for <CODE><sheet size></CODE>. Sheet size is determined automatically if omitted. 449 </td> 450 </tr> 451 <tr> 452<td><CODE>-oa <alternate character></CODE></td><td>Possible</td> 453 <td> 454The default is based on the input. 455 </td> 456 </tr> 457 <tr> 458<td><CODE>-oh <line feed width></CODE></td><td>Possible</td> 459 <td> 460The default is based on the input. 461 </td> 462 </tr> 463 <tr> 464<td><CODE>-ol <default left space></CODE></td><td>Possible</td> 465 <td> 466The default is based on the input. 467 </td> 468 </tr> 469 <tr> 470<td><CODE>-ow <default glyph width></CODE></td><td>Possible</td> 471 <td> 472The default is based on the input. 473 </td> 474 </tr> 475 <tr> 476<td><CODE>-or <default right space></CODE></td><td>Possible</td> 477 <td> 478The default is based on the input. 479 </td> 480 </tr> 481 </tbody></table> 482 </p> 483 <p> 484<B>Example:</B> 485 </p> 486 <p class="code"> 487-o bcfnt -of font.bcfnt -os 256 -oe sjis -oa ? 488 </p> 489 <p> 490Outputs data to <CODE>font.bcfnt</CODE> using a sheet size of 256K pixels, Shift_JIS encoding and ’?’ as the alternate character. 491 </p> 492 493<h2>Revision History</h2> 494 <dl class="history"> 495 <dt>2010/09/14</dt> 496<dd>Initial version.</dd> 497 </dl> 498 <hr><p>CONFIDENTIAL</p></body> 499</html>
