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>addbanner</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">addbanner <IMG src="../image/NTR.gif" align="middle"><IMG src="../image/TWL.gif" align="middle"></H1>
41<H2>Description</H2>
42<P> The <CODE>addbanner</CODE> tool checks exactly how a banner file created by the <A href="makebanner.html"><CODE>makebanner</CODE></A> or <A href="makebannerTWL.html"><CODE>makebanner.TWL</CODE></A> tool will be displayed on the launcher screen of a TWL or DS/DS Lite unit.<BR>This can be used to check the game titles set for various languages, the banner displayed during DS Single-Card Play, and the animation data in a TWL banner.</P>
43<P> <FONT color=#ff0000>With a TWL or DS/DS Lite unit, the width of the character font and character area differ. Be sure to set a game title that will not extend beyond the borders of either screen.<BR>However, TWL hardware use a card application screen. Be sure to check the display of user NAND applications by importing TAD files to a TWL unit for development or IS-TWL-DEBUGGER using <A href="../romfiles/TwlNmenu.html"><CODE>TwlNmenu</CODE></A>.</P></FONT>
44
45<P>As the name indicates, <CODE>addbanner</CODE> was originally a tool for inserting banner files in ROM files, but it does not need to be used for this purpose now because this is usually done with the <A href="makerom.html"><CODE>makerom</CODE></A> or <A href="makerom.html"><CODE>makerom.TWL</CODE></A> tool.</P>
46
47<H2>Using the Tool</H2>
48<H3>Start Command</H3>
49<P><CODE>% addbanner [-t VIEWER_TEMPLATE] BANNERFILE [VIEWER]</CODE></P>
50<P>Outputs an executable ROM file with the filename in <CODE>VIEWER</CODE>. This file is used to display the banner file specified by <CODE>BANNERFILE</CODE> to the screen on the DS, DS Lite, or TWL system. <CODE>VIEWER</CODE> can be omitted. When <code>VIEWER</code> is omitted, this uses a filename with <CODE>.srl</CODE> as the extension part of the filename specified by <CODE>BANNERFILE</CODE>.</P>
51<P> <CODE>addbanner</CODE> uses the <CODE>BannerViewerTemplate.srl</CODE> in the same directory as <CODE>addbanner.exe</CODE> for the template ROM file that becomes the <CODE>VIEWER</CODE> creation source file. <CODE>addbanner</CODE> replaces the banner file of the template ROM file with the file specified by <CODE>BANNERFILE</CODE>, and is only output with the name specified by <CODE>VIEWER</CODE>.</P>
52<P> The <CODE>-t</CODE> option changes the template ROM file responsible for VIEWER creation. This is usually not necessary.</P>
53<H3>How to Use the Generated VIEWER</H3>
54<P><CODE>NTR</CODE> is displayed for <CODE>Platform:</CODE> on screens for the DS/DS Lite in the case of an NTR banner, and <CODE>TWL</CODE> is displayed in the case of TWL banners.<BR>An illegal banner will cause &quot;<CODE>Banner is invalid.</CODE>&quot; to be displayed.</P>
55
56<P><TABLE border="1">
57  <TBODY>
58    <TR>
59<TH>Button</TH>
60<TH>Content</TH>
61    </TR><TR>
62<TD>Up/Down Buttons</TD>
63<TD>Changes the language.</TD>
64    </TR><TR>
65<TD>A Button</TD>
66<TD>Switches the upper and lower screens.</TD>
67    </TR></P>
68  </TBODY>
69</TABLE>
70<H2>Location</H2>
71<P><CODE>$TwlSDK/tools/bin/addbanner.exe</CODE><BR> <CODE>$TwlSDK/tools/bin/BannerViewerTemplate.srl</CODE></P>
72<H2>See Also</H2>
73<P><A href="about_Banner.html">Banner Overview</A><BR> <A href="makebanner.html"><CODE>makebanner</CODE></A><BR> <A href="makebannerTWL.html"><CODE>makebanner.TWL</CODE></A></P>
74<H2>Revision History</H2>
75<P>2008/11/11 Official support for the TWL launcher screen.<BR> 2008/09/24 Made revisions in line with TWL banner support.<BR> 2008/09/16 Added information about TWL banner.<BR> 2004/09/21 Initial version.</P>
76<hr><p>CONFIDENTIAL</p></body>
77</HTML>