ctr_make_ex_banner

Table of Contents

  1. Introduction
  2. How to Use
  3. EBSF
  4. List of characters that can be specified as comments
  5. Revision History

Introduction

ctr_make_ex_banner is a tool to create ExBanner.
.bin files are created based on the content in files called EBSF.

How to Use

What's Required

You need the following files to create extended banner data.

Commands

ctr_make_ex_banner32.exe SPECFILE

SPECFILE must be specified.

Options

Currently, there are no options.

EBSF

This file defines the settings for the binary file of the created extended banner data.
It must be coded and saved in Unicode (UTF-16LE with BOM).
Notepad in Microsoft Windows 2000, Windows XP, Windows Vista, and Windows 7 supports Unicode. Select Unicode from the Encoding drop-down list when saving the file.

Parameters

The delimiter between parameter specifications and values is a colon (:). If the same parameter occurs more than once, the one coming last is used.

Format

Parameter specifications must come at the beginning of each line.
All characters after a "#" are treated as a comment.
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 (""). Likewise, if you want to include quotation marks or sharps (#), surround them with quotation marks ("""/"#").

Format

The EBSF file format is shown below.

TexWidth:     #Specifies the width of Texture.
TexHeight:     #Specifies the height of Texture.
TexFormat:    #Specifies the GL format texture format. Use the values defined in NW4C and not numerical values.

LimitYear:    #Indicates the valid term for this extended banner. When the term expires, the extended banner is invalid.
LimitMonth:   #Set the year in limityear, the month in limitmonth, and the day in limitdate.
LimitDate:    #

Common_Text: #Sets the COMMON text.
EUR_EN_Text: #Sets the EUR_EN text.
EUR_FR_Text: #Sets the EUR_FR text.
EUR_GE_Text: #Sets the EUR_GE text.
EUR_IT_Text: #Sets the EUR_IT text.
EUR_SP_Text: #Sets the EUR_SP text.
EUR_DU_Text: #Sets the EUR_DU text.
EUR_PO_Text: #Sets the EUR_PO text.
EUR_RU_Text: #Sets the EUR_RU text.
JPN_JP_Text: #Sets the JPN_JP text.
USA_EN_Text: #Sets the USA_EN text.
USA_FR_Text: #Sets the USA_FR text.
USA_SP_Text: #Sets the USA_SP text.
USA_PO_Text: #Sets the USA_PO text.

# If there is one or more XX_YYY_text, then there is no limit on the number.
# For example, if EUR_EN_Text and EUR_FR_Text are both written,
# then the final output file will be the two EUR_EN.bin and EUR_FR.bin files.
# Note: The final output file is the text before _text with .bin appended.

TextureName:          #Sets the name of the texture.
TextureDataFileName:  #Specifies the filename for the texture binary data.

Set the values using the following format:

Specifying Elements

Elements are specified as follows.

Key Name: Value

Notes

The following are sample settings for each of these items.
Item Description Comments
TexWidth Set using decimal notated numbers. Values that can be specified are 8 - 1024, in multiples of 2.
TexHeight Set using decimal notated numbers. Values that can be specified are 8 - 1024, in multiples of 2.
TexFormat The following values can be set.

RGBA8: 4 bytes per pixel, where each of RGBA is 8 bits.
RGB8: 3 bytes per pixel, where each of RGB is 8 bits.
RGB8: 2 bytes per pixel, where each of RGB is 5 bits and A is 1 bit.
RGB565: 2 bytes per pixel, where R, G, and B are 5, 6, and 5 bits, respectively.
RGBA4: 2 bytes per pixel, where R, G, B, and A are 4 bits each.
LA8: 2 bytes per pixel, where Alpha and Luminance are 8 bits each.
HILO8: 2 bytes per pixel, where X and Y are 8 bits each.
L8: 1 byte per pixel, where Luminance is 8 bits.
A8: 1 byte per pixel, where Alpha is 8 bits.
LA4: 1 byte per pixel, where Alpha and Luminance are 4 bits each.
L4: 4 bits per pixel, where Luminance is 4 bits.
A8: 4 bits per pixel, where Alpha is 4 bits.
ETC1: Compressed format corresponding to 4 bits per pixel.
ETC1A4: Compressed format corresponding to 8 bits per pixel.
LimitYear Set using decimal notated numbers. Specify using the western calendar.
The range of values that can be specified is from 2000 to 2099.
LimitMonth Set using decimal notated numbers. The range of values that can be specified is from 1 to 12.
LimitDate Set using decimal notated numbers. The range of values that can be specified is from 1 to 31.
However, do not use dates not on the calendar.
Common_Text Text that is displayed in bottom portion of the upper screen when an banner is displayed.
Carriage returns are not permitted.
Specify this with 255 characters or less.
XXX_YY_Text Specify this with 255 characters or less.
TextureName Specifies the name of the texture.
Keep the name to 16 or fewer ASCII characters.
TextureDataFileName Place in the same level as the folder where ctr_exmakebanner32.exe is located.
If not in the same level, it will not run unless the path is set correctly.

List of characters that can be used in comments

The following 7374 characters can be used in comments in the Japanese, American, European, and Australian regions.
(Some characters may not be displayed correctly, depending on the browser environment.)

In addition to these, the single-byte space (Space 0x0020), double-byte space (IDEOGRAPHIC SPACE 0x3000),
and the non-breaking space (NO-BREAK SPACE 0x00a0) can be used.

Revision History

2010/10/13
Integrated language and region names with makebanner.
2010/10/8
Initial version.

CONFIDENTIAL