# 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