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>Banner: Overview</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 41<H1 align="left">Banner: Overview</H1> 42 43<H2>Description</H2> 44<P>This is an overview of the banner files that are displayed at the launcher screen of the TWL or Nintendo DS/DS Lite systems.</P> 45 46<P>TWL banners that are displayed on TWL systems are in the same format as NTR banners that are displayed on Nintendo DS/DS Lite systems, except that they add animation data. As a result, if a TWL banner is displayed on a Nintendo DS/DS Lite system or in DS Download Play, it appears as a static image just like an NTR banner. On TWL systems, however, animations are displayed for TWL banners. 47</P> 48 49<P>For downloadable software (or "user NAND applications"), another type of banner called a "sub-banner" can be displayed. For more about sub-banners, see <A href="../na/subBanner/about_subBanner.html">Sub-Banner Overview</A>.</P> 50 51<H2>Banner Format</H2> 52<P>NTR banners and TWL banners have different formats, as shown below.</P> 53 54<P>NTR Banners 55<TABLE border="1" width="100%"> 56<TR><TD width="200">Banner Comment</TD><TD width="800">Game Title for Each Language</TD></TR> 57<TR><TD width="200">Banner Icon Bitmap</TD><TD width="800">One 32x32-pixel image</TD></TR> 58<TR><TD width="200">Color Palette for Banner Icon</TD><TD width="800">16-color, 1 set</TD></TR> 59</TABLE></P> 60 61<P>TWL Banners 62<TABLE> 63<TR><TD width="200">NTR Banners</TD><TD width="800">Same as above</TD></TR> 64<TR><TD width="200">Bitmaps for Animation</TD><TD width="800">Eight 32x32-pixel images</TD></TR> 65<TR><TD width="200">Color Palette for Animation</TD><TD width="800">16-color, 1 set</TD></TR> 66<TR><TD width="200">Animation Control Data</TD><TD width="800">Managed by 64 data elements for controlling 1-255 frames</TD></TR> 67</TABLE></P> 68<P>TWL banners contain NTR banners. This internal NTR banner is displayed on a Nintendo DS/DS Lite system, and the animation is displayed on a TWL system.</P> 69<H2>How to Create</H2> 70<P>There are three ways to create banner files. However, if you want to create banners specifically for Nintendo DS software (<I>not</I> TWL-enhanced or TWL-exclusive software), you should use the third method (<CODE>ntexconv</CODE> / static image).</P> 71<P><IMG src="about_Banner.gif" border="0"></P> 72<P> 73<H3>1. Using NITRO-CHARACTER</H3> 74<P>For information on how to create cell animation data (<CODE>*.nce</CODE>) for TWL banners using NITRO-CHARACTER, see <A href="bannerNitroCharacter.html">Banner Creation Procedure Using NITRO-CHARACTER</A>. 75</P> 76 77<P>Use <A href="bannercvtr.html"><CODE>bannercvtr</CODE></A> to convert NCE files that were created using NITRO-CHARACTER.</P> 78<P>To create the TWL banner, use <A href="makebannerTWL.html"><CODE>makebanner.TWL</CODE></A> to convert the data output by <A href="bannercvtr.html"><CODE>bannercvtr</CODE></A> along with a BSF file that sets the banner comments.</P> 79<H3>2. Using ntexconv (Animation)</H3> 80<P>Create up to eight 16-color 32x32-pixel bitmaps. Use <A href="ntexconv.html"><CODE>ntexconv</CODE></A> to convert these bitmaps. Create an XML file that lists the converted data and the content of the animation, and then convert this XML file with <A href="bannercvtr.html"><CODE>bannercvtr</CODE></A>. 81</P> 82<P>To create the TWL banner, use <A href="makebannerTWL.html"><CODE>makebanner.TWL</CODE></A> to convert the data output by <A href="bannercvtr.html"><CODE>bannercvtr</CODE></A> along with a BSF file that sets the banner comments.</P> 83<P>See <A href="bannercvtr.html"><CODE>bannercvtr</CODE></A> for details about how to write the XML file.</P> 84<H3>3. Using ntexconv (Still Image)</H3> 85<P>Use this method to create NTR banners or TWL banners that are not animated.</P> 86<P>Create a single 16-color 32x32-pixel bitmap. Convert the bitmap using <A href="ntexconv.html"><CODE>ntexconv</CODE></A>.</P> 87<P>To create the banner file, use <A href="makebanner.html"><CODE>makebanner</CODE></A> or <A href="makebannerTWL.html"><CODE>makebanner.TWL</CODE></A> (for Nintendo DS software and TWL-enhanced software, respectively) to convert both the data output by <A href="ntexconv.html"><CODE>ntexconv</CODE></A> and the BSF file that sets the banner comments. 88 89</P> 90 91<H2>Implementation in Applications</H2> 92<P>Specify the banner you have created in a <A href="makerom.html">ROM Specification File</A> (<CODE>.rsf</CODE>). The specified banner is set for the SRL file that was created by the <A href="makerom.html"><CODE>makerom</CODE> or <CODE>makerom.TWL</CODE></A> tool.</P> 93<BLOCKQUOTE> 94<PRE class="sample_source"><CODE> # ROM SPEC FILE 95 96Property 97{ 98 .... 99 # 100 # BANNER FILE: generated from Banner Spec File 101 # 102 BannerFile banner.bnr 103}</CODE></PRE> 104</BLOCKQUOTE> 105<P>See <A href="makerom.html"><CODE>makerom</CODE> / <CODE>makerom.TWL</CODE></A> for details.</P> 106<H2>Samples</H2> 107The following samples illustrate each of these banner creation methods. 108<H3>1. Using NITRO-CHARACTER</H3> 109<P><CODE>$TwlSDK/build/demos.TWL/tips/TWLBanner_anim1</CODE></P> 110<H3>2. Using ntexconv (Animation)</H3> 111<P><CODE>$TwlSDK/build/demos.TWL/tips/TWLBanner_anim2</CODE></P> 112<H3>3. Using ntexconv (Still Image)</H3> 113<P>Creating NTR Banners</P> 114<P><CODE>$TwlSDK/build/demos/tips/NTRBanner</CODE></P> 115<P>Creating TWL Banners</P> 116<P><CODE>$TwlSDK/build/demos.TWL/tips/TWLBanner_image</CODE></P> 117 118<H2>Verification Procedure</H2> 119<P>Both <A href="makebannerTWL.html"><CODE>makebanner.TWL</CODE></A> and <A href="makebanner.html"><CODE>makebanner</CODE></A> check the banner's game title to ensure that characters can be displayed and that the character width stays within the display frame of the Nintendo DS, DS Lite, or DSi system. Specifications for the display of game titles are set forth in the programming guidelines. If a warning is displayed, be sure to correct the problem. 120</P> 121<P>Banners can be checked without use of a card by using the <A href="addbanner.html"><CODE>addbanner</CODE></A> tool.<BR>However, this is supported only for displaying card applications. See the following procedures for displaying user NAND applications, which vary slightly. The following procedures do not use <A href="addbanner.html"><CODE>addbanner</CODE></A>.</P> 122 123<H3>Nintendo DS Software</H3> 124<H4>Displaying on a Nintendo DS/DS Lite System</H4> 125<P>Burn the ROM on a flash card, insert the card into a Nintendo DS/DS Lite system, and check the banner display.<BR>After running a ROM in IS-NITRO-DEBUGGER, you can also check it using <B>Tools</B> → <B>Game Banner</B>. 126</P> 127<H4>Displaying on a TWL System</H4> 128<P>Burn the ROM on a flash card, insert the card into a TWL system or IS-TWL-DEBUGGER, and check the game title display.<BR>Although a flash-card application cannot be started by a commercial TWL system, it is possible to check the banner.</P> 129<H3>TWL-Enhanced Software (on Game Card)</H3> 130<H4>Displaying on a Nintendo DS/DS Lite System</H4> 131<P>Burn the ROM on a flash card, insert the card into a Nintendo DS/DS Lite system, and check the banner display.<BR> 132</P> 133<H4>Displaying on a TWL System</H4> 134<P>Burn the ROM on a flash card, insert the card into a TWL system used for development or into IS-TWL-DEBUGGER hardware, and check the banner display.<BR>The banner cannot be confirmed by inserting the card into a commercial TWL system.</P> 135<H3>TWL-Exclusive Software (on Game Card)</H3> 136<H4>Displaying on a TWL System</H4> 137<P>Burn the ROM on a flash card, insert the card into a TWL system used for development or into IS-TWL-DEBUGGER hardware, and check the banner display.<BR>The banner cannot be confirmed by inserting the card into a commercial TWL system.</P> 138<H3>User NAND Applications</H3> 139<P>Use <A href="../romfiles/TwlNmenu.html"><CODE>TwlNmenu</CODE></A> to import a TAD file to a TWL system used for development or to the IS-TWL-DEBUGGER hardware. Then check the banner display.</P> 140 141<P>You can also check the banner display on the Software Management screen under <B>System Settings</B>.<BR>Icons on the Software Management screen are displayed in the same way as they are by the launcher, but there are limits to the number of banner-comment characters that can be displayed.<BR>Note that if the number of characters exceeds the limit, the excess is displayed as "<CODE>...</CODE>".</P> 142 143<P>The following shows the number of characters that are displayed for banner comments in the DS and TWL launchers. 144<TABLE> 145<TR><TH width="200"></TH><TH width="200">DS Launcher</TH><TH width="200">TWL Launcher</TH><TH width="200">TWL Software Management Screen</TH></TR> 146<TR><TH width="200">Width of Area</TH><TD width="200">140 px</TD><TD width="200">240 px</TD><TD width="200">202 px</TD></TR> 147<TR><TH width="200">Maximum number of <I>W</I>'s</TH><TD width="200">23</TD><TD width="200">17</TD><TD width="200">16</TD></TR> 148<TR><TH width="200">Maximum number of <I>M</I>'s</TH><TD width="200">23</TD><TD width="200">20</TD><TD width="200">19</TD></TR> 149<TR><TH width="200">Maximum number of <I>w</I>'s</TH><TD width="200">23</TD><TD width="200">20</TD><TD width="200">19</TD></TR> 150<TR><TH width="200">Maximum number of <I>i</I>'s</TH><TD width="200">69</TD><TD width="200">80</TD><TD width="200">64</TD></TR> 151</TABLE></P> 152<H2>See Also</H2> 153<P><A href="ntexconv.html"><CODE>ntexconv</CODE></A><BR> <A href="bannercvtr.html"><CODE>bannercvtr</CODE></A><BR> <A href="makebannerTWL.html"><CODE>makebanner.TWL</CODE></A><BR> <A href="makebanner.html"><CODE>makebanner</CODE></A><BR> <A href="addbanner.html"><CODE>addbanner</CODE></A><BR> <A href="../na/subBanner/about_subBanner.html">Sub-Banner Overview</A><BR> <A href="../demos/tips/tipsdemos.html">Miscellaneous Sample Demos: Tips</A><BR> <A href="bannerNitroCharacter.html">Banner Creation Procedure Using NITRO-CHARACTER</A></P> 154 155<H2>Revision History</H2> 156<P> 1572009/03/27 Revised a figure. Fixed typos and removed parts with old content. <BR>2009/03/10 Revised information on the color palette for TWL banners and explained how to check the banner using IS-NITRO-DEBUGGER. <BR>2008/11/28 Moved <B>Using NITRO-CHARACTER</B> to another page. <BR>2008/11/11 Made revisions in accordance with <CODE>addbanner</CODE> TWL support. <BR>2008/10/20 Changed the maximum number of characters. Added confirmation methods.<BR> 2008/09/29 Added a build sample.<BR> 2008/09/26 Added information about the Software Management screen.<BR> 2008/09/25 Initial version. 158</P> 159<hr><p>CONFIDENTIAL</p></body> 160</HTML> 161
