addbanner

Description

The addbanner tool checks exactly how a banner file created by the makebanner or makebanner.TWL tool will be displayed on the launcher screen of a TWL or DS/DS Lite unit.
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.

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.
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 TwlNmenu.

As the name indicates, addbanner 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 makerom or makerom.TWL tool.

Using the Tool

Start Command

% addbanner [-t VIEWER_TEMPLATE] BANNERFILE [VIEWER]

Outputs an executable ROM file with the filename in VIEWER. This file is used to display the banner file specified by BANNERFILE to the screen on the DS, DS Lite, or TWL system. VIEWER can be omitted. When VIEWER is omitted, this uses a filename with .srl as the extension part of the filename specified by BANNERFILE.

addbanner uses the BannerViewerTemplate.srl in the same directory as addbanner.exe for the template ROM file that becomes the VIEWER creation source file. addbanner replaces the banner file of the template ROM file with the file specified by BANNERFILE, and is only output with the name specified by VIEWER.

The -t option changes the template ROM file responsible for VIEWER creation. This is usually not necessary.

How to Use the Generated VIEWER

NTR is displayed for Platform: on screens for the DS/DS Lite in the case of an NTR banner, and TWL is displayed in the case of TWL banners.
An illegal banner will cause "Banner is invalid." to be displayed.

Button Content
Up/Down Buttons Changes the language.
A Button Switches the upper and lower screens.

Location

$TwlSDK/tools/bin/addbanner.exe
$TwlSDK/tools/bin/BannerViewerTemplate.srl

See Also

Banner Overview
makebanner
makebanner.TWL

Revision History

2008/11/11 Official support for the TWL launcher screen.
2008/09/24 Made revisions in line with TWL banner support.
2008/09/16 Added information about TWL banner.
2004/09/21 Initial version.


CONFIDENTIAL