1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 2<HTML> 3<HEAD> 4<META http-equiv="Content-Type" content="text/html; charset=windows-1252"> 5<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 7.0.0.0 for Windows"> 6<META http-equiv="Content-Style-Type" content="text/css"> 7<TITLE>makebanner.TWL</TITLE> 8<LINK rel="stylesheet" href="../css/nitro.css" type="text/css"> 9<STYLE type="text/css"> 10<!-- 11.sample_source{ 12 background-color : #e8e8e8; 13} 14H3{ 15 color : teal; 16} 17.command_list{ 18 margin-bottom : 16pt; 19} 20.command_desc{ 21 } 22.command_item{ 23 margin-top : 16pt; 24 background-color : #e8e8e8; 25} 26.blockquoted_table { 27 border : 1px; 28 width : 80%; 29} 30TD,TH{ 31 border-color : #c0d8d8; 32 padding : 1pt 4pt 1pt 4pt; 33 border-width : 1px; 34 border-style : solid; 35} 36--> 37</STYLE> 38</HEAD> 39<BODY> 40<H1 align="left">makebanner.TWL <IMG src="../image/TWL.gif" align="middle"></H1> 41<H2>Description</H2> 42<P><FONT color=#ff0000>This command is for TWL ROMs. See <A href="makebanner.html"><CODE>makebanner</CODE></A> for details on NITRO ROMs.</FONT></P> 43<P>The <CODE>makebanner.TWL</CODE> tool creates banner files. Banner files contain a variety of information. This includes the image that identifies an application and is displayed in the launcher when TWL and Nintendo DS/DS Lite systems start.</P> 44<P> The banner file contains image data and game title information for each language. It is created based on the description in the banner specification file (BSF). Once the banner file is created, <A href="makerom.html"><CODE>makerom.TWL</CODE></A> is used to write it to the application ROM image.</P> 45 46<P>Banner files for use with TWL ROMs can contain, in addition to the NITRO ROM banner file (NTR banner), animation that consists of 8 images. If a banner file contains animation data, the TWL launcher displays the animation; if it does not contain animation data, the launcher displays the NTR banner. If a banner was created in the same manner as with <CODE><A href="makebanner.html">makebanner</A></CODE>, no animation data is created, only the NTR banner.</P> 47<P>Create banners containing animation data by taking an animation file created in NITRO-CHARACTER, converting it with <A href="bannercvtr.html"><CODE>bannercvtr</CODE></A>, and using the resulting data in <CODE>makebanner.TWL</CODE>. In this case, the 0th frame of the animation data is set as the NTR banner. You can also use an option to change which animation frame is used. If you create a HYBRID ROM with a banner containing animation data, the NTR banner is displayed when it is started on a DS/DS Lite system, and the animation banner is displayed when it is started on a TWL system. 48</P> 49<H2>Using the Tool</H2> 50<H3>Start Command</H3> 51<PRE><CODE>% makebanner.TWL [-d] [-N ICON_BASENAME] [-A ANIMEFILE] [-i IMAGE_INDEX] 52[-j PALETTE_INDEX] [-s] SPECFILE [BANNERFILE]</CODE></PRE> 53<P> This function links files according to the description in the banner specification file (<code>SPECFILE</code>, which is described below). It creates a file named <code>BANNERFILE</code>. Using <code>BANNERFILE</code> is optional and may be omitted. If you omit it, a file of the same name as that specified by <code>SPECFILE</code> with the extension BNR is created.</P> 54<P> The <CODE>-A</CODE> option specifies a file output from <A href="bannercvtr.html"><CODE>bannercvtr</CODE></A>. This option is required if an animation file is not specified in <CODE>SPECFILE</CODE>.</P> 55<P> The <CODE>-i</CODE> option specifies the image index to use when exporting a NTR banner from a file output from <CODE><A href="bannercvtr.html">bannercvtr</A></CODE>. If not specified, this is 0.</P> 56<P> The <CODE>-j</CODE> option specifies the palette index to use when exporting a NTR banner from a file output from <CODE><A href="bannercvtr.html">bannercvtr</A></CODE>. If not specified, this is 0.</P> 57<P> The <CODE>-s</CODE> option outputs a <CODE><A href="../na/subBanner/about_subBanner.html">sub-banner file</A></CODE>.</P> 58<P> The <CODE>-N</CODE> option allows you to specify, from the command line, an icon file to use when exporting a static image banner. It attaches NBFC and NBFP to the base names specified by <code>ICON_BASENAME</code>, turning the resulting files into an image file and image parameter file, respectively. This overwrites the values specified by <code>ImageFile:</code>and <code>PlttFile:</code>Values specified by parameter are overwritten. This cannot be specified at the same time as the <CODE>-A</CODE> option.</P> 59<P> The <code>-d</code> option is for displaying messages when debugging <CODE>makebanner.TWL</CODE>. This is usually not necessary.</P> 60<H3>Banner Specification File Format</H3> 61<P> The banner specification file is a text file that specifies an image data file and the game title in each language. It must be described and saved in Unicode (UTF-16LE with BOM). Notepad in MS Windows 2000/XP supports Unicode. Select <B>Unicode</B> from the <B>Encoding </B> drop-down box when saving the file.</P> 62<H3>Parameters</H3> 63<P> The delimiter between parameter specifications and values is a colon (<code>:</code>).</P> 64<H4>Image file parameters</H4> 65<BLOCKQUOTE> 66<DL class="command_list"> 67<DT class="command_item"><CODE>AnimeFile: </CODE>[Name of file output from <A><CODE>bannercvtr</CODE></A>]</I> 68<DD class="command_desc">Specifies the file output from <A href="bannercvtr.html"><CODE>bannercvtr</CODE></A>.<BR>For more details, see the <CODE><A href="bannercvtr.html">bannercvtr</A></CODE> reference manual. 69<DT class="command_item"><CODE>AnimeImageIndex:</CODE><I>[image index]</I> 70<DD class="command_desc"><CODE>AnimeFile:</CODE>Specifies the image index to use for the NTR banner when exporting a NTR banner from the animation file specified in the <CODE>AnimeFile</CODE> parameter. 71<DT class="command_item"><CODE>AnimePlttIndex:</CODE><I>[palette index]</I> 72<DD class="command_desc"><CODE>AnimeFile:</CODE>Specifies the palette index to use for the NTR banner when exporting a NTR banner from the animation file specified in the <CODE>AnimeFile</CODE> parameter. 73<DT class="command_item"><CODE>AnimeFile:</CODE><I>[filename output from <A href="bannercvtr.html"><CODE>bannercvtr</CODE></A>]</I> 74<DD class="command_desc">Specifies the file output from <A href="bannercvtr.html"><CODE>bannercvtr</CODE></A>.<BR> For more details, see the <A href="bannercvtr.html"><CODE>bannercvtr</CODE></A> reference manual. 75<DT class="command_item"><CODE>ImageFile:</CODE></CODE><I>[Image's image filename]</I> 76<DD class="command_desc">Specifies a binary image, 32x32 x 16 colors.<br />Store character data using one-dimensional mapping.<br />The first 512 bytes are written to the banner file. 77<DT class="command_item"><CODE>PlttFile:</CODE></CODE><I>[Image's palette filename]</I> 78<DD class="command_desc">Specifies a binary image palette.<br />The first 32 bytes are written to the banner file. 79</DL> 80</BLOCKQUOTE> 81<P><CODE>ImageFile</CODE></CODE>, <CODE>PlttFile:</CODE>The <CODE>ImageFile</CODE> and <CODE>PlttFile</CODE> parameters are used when creating NTR banners. <BR>When creating an animated banner, use the <CODE>AnimeFile:</CODE>, <CODE>AnimeImageIndex:</CODE>, and <CODE>AnimePlttIndex:</CODE> parameters.</P> 82<P>When creating an NTR banner using the <CODE>ImageFile:</CODE> and <CODE>PlttFile:</CODE> parameters,<BR> create image and palette binary data from the image file using <CODE><A href="ntexconv.html">ntexconv</A> (-no -bg -bgb -bgnc)</CODE>, etc.</P> 83<P>The <code>-N</code> option allows you to specify image file parameters from the command line.</P> 84<H4>Version Parameters</H4> 85<BLOCKQUOTE> 86<DL class="command_list"> 87<DT class="command_item"><CODE>Version:</CODE><I>[banner version]</I> 88<DD class="command_desc">Specifies the banner version.<BR>For TWL, always specify <CODE>'3'</CODE>. If not specified, it is set to <CODE>3</CODE>. 89</DL> 90</BLOCKQUOTE> 91<H4>Language Parameters</H4> 92<BLOCKQUOTE> 93<DL class="command_list"> 94<DT class="command_item"><CODE>JP:</CODE><I>[Japanese Game Title Name]</I> <BR><CODE>EN:</CODE></CODE><I>[English game title name]</I> <BR><CODE>FR:</CODE><I>[French Game Title Name]</I> <BR><CODE>GE:</CODE><I>[German Game Title Name]</I> <BR><CODE>IT:</CODE><I>[Italian Game Title Name]</I> <BR><CODE>SP:</CODE><I>[Spanish Game Title Name]</I> <BR><CODE>CN:</CODE></CODE><I>[Chinese Game Title Name]</I><BR><CODE>HN:</CODE><I>[Korean Game Title Name]</I><BR> 95<DD class="command_desc">Describes the game title name in each language. The maximum is three rows, 128 characters (including carriage returns). A string must be specified in the first line. If a line begins with a space or a tab, it is considered a continuation of the previous line. All content between a blank line and the next language parameter is destroyed. If you want to leave line 1 or 2 blank, and write something in line 3, place content in the form of quotation marks (<code>""</code>) in the line you want to leave blank. Always store in the banner files in the following order: Japanese, English, French, German, Italian, Spanish, Chinese, Korean. As in the banner specification file, the save format is UTF-16LE (without BOM). <BR> 96<DT class="command_item"><CODE>JP:</CODE></CODE><I>[Chinese Game Title Name]</I><BR> <CODE>EN: </CODE><I>[Chinese Game Title Name]</I><BR><CODE>FR: </CODE><I>[Chinese Game Title Name]</I><BR> <CODE>GE: </CODE><I>[Chinese Game Title Name]</I><BR> <CODE>IT: </CODE><I>[Chinese Game Title Name]</I><BR> <CODE>SP: </CODE><I>[Chinese Game Title Name]</I><BR> <CODE>CN: </CODE><I>[Chinese game title name]</I><BR> <CODE>HN:</CODE><I>[Chinese Game Title Name]</I><BR> 97<DD class="command_desc">For applications destined for China, specify a Chinese banner in addition to the standard banner, as shown above.<BR>At this time, describe all Game Titles in Chinese. 98<DT class="command_item"><CODE>JP:</CODE></CODE><I>[English Game Title Name]</I><BR> <CODE>EN: </CODE><I>[English game title name]</I> <BR><CODE>FR:</CODE></CODE><I>[English Game Title Name]</I><BR> <CODE>GE: </CODE><I>[English Game Title Name]</I><BR> <CODE>IT: </CODE><I>[English Game Title Name]</I><BR> <CODE>SP: </CODE><I>[English Game Title Name]</I><BR> <CODE>CN: </CODE><I>[English Game Title Name]</I><BR> <CODE>HN:</CODE><I>[Korean game title name]</I> 99<DD class="command_desc">For applications destined for Korea, specify a Korean banner in addition to the application banner for China, as shown above.<BR>At this time, describe all game title names in English, except for those for Korean. 100</DL> 101For more about the characters and encoding that can be used for regions other than China and Korea, see the separate document, <A href="bannerfont.rtf">About DS Banners</A>. However, your editor must be capable of displaying with UTF-16LE encoding. 102</BLOCKQUOTE> 103<H3>Format</H3> 104<P> Parameter specification must be at the beginning of the name line. Lines beginning with <code>#</code> are treated as comments. With the exception of the spaces at the beginning of a line, all spaces are included in the string. If you want to include leading spaces, surround them with quotation marks (<code>""</code>). Likewise, if you want to include quotation marks, surround them with quotation marks (<code>"""</code>).</P> 105<BLOCKQUOTE> 106<PRE class="sample_source"><code>#BSF --- Banner Spec File 107 108Version: 3 109 110JP: TWL 111"にほんご" <FONT color="#ff0000" face="Arial"><EM>("Japanese" in Japanese)</EM></FONT> 112EN: Twl1 113English 114FR: Twl2 115GE: Twl3 116IT: Twl4 117SP: "Twl5" 118CN: Twl6 119HN: Twl7 120</CODE></PRE> 121</BLOCKQUOTE> 122<H3>Warnings</H3> 123<P>The following warning is displayed if the specified game title cannot be displayed correctly by the launcher when starting the TWL or DS/DS Lite handheld device.</P> 124<P>The following warning is displayed if characters that cannot be displayed by the launcher have been set.</P> 125<BLOCKQUOTE> 126<PRE class="sample_source"><CODE>Warning:!!!! JP in line 1 127Warning:!!!! Game title includes undisplayable characters. 128</CODE></PRE> 129</BLOCKQUOTE> 130<P>If Japanese kanji has been set, the following warning is output. Kanji cannot be specified in the banner of Japan-bound applications.</P> 131<BLOCKQUOTE> 132<PRE class="sample_source"><CODE>Warning:!!!! JP in line 3 133Warning:!!!! Game title includes Chinese characters. 134</CODE></PRE> 135</BLOCKQUOTE> 136<P>The following warning is displayed if the game title cannot be displayed properly because the width of the game title is greater than the launcher display area.<BR>Check the displayable size of the TWL or DS/DS Lite handheld device. In the following example, the title for a TWL handheld device is 1 pixel too wide.</P> 137<BLOCKQUOTE> 138<PRE class="sample_source"><CODE>Warning:!!!! EN in line 1 139Warning:!!!! Game title exceeds TWL menu size(240 pixel) by 1 pixel. 140</CODE></PRE> 141</BLOCKQUOTE> 142<H2>Location</H2> 143<P><CODE>$TwlSDK/tools/bin/makebanner.TWL.exe</CODE></P> 144<H2>See Also</H2> 145<P><A href="about_Banner.html">Banner Overview</A><BR> <A href="bannercvtr.html"><CODE>bannercvtr</CODE></A><BR> <A href="makerom.html"><CODE>makerom.TWL</CODE></A></P> 146<H2>Revision History</H2> 147<P>2008/11/27 Revised game titles in examples and added a warning regarding use of kanji.<BR> 2008/11/05 Revised the description of the <CODE>-N</CODE> option<BR> 2008/10/20 Added a warning about the width of game titles.<BR> 2008/10/17 Changed the link for the documents regarding DS banners.<BR> 2008/09/12 Initial version.</P> 148<hr><p>CONFIDENTIAL</p></body> 149</HTML> 150
