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>Sub-Banners: 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">Sub-Banners: Overview</H1>
42
43<H2>Description</H2>
44<P>
45The TWL launcher displays application banners, but also displays separate banners, called &quot;sub-banners,&quot; in addition to those specified in <A href="../../tools/makerom.html">ROM specification file</A>.<BR>A NAND application can overwrite sub-banners, which makes it possible to implement a banner image that changes as the game progresses. However, you cannot change the game title in the banner.
46</P>
47<P>
48If a sub-banner exits, the launcher gives priority to it and displays it. Otherwise, the launcher displays the normal banner. This has the same behavior in the Software Management screen in System Settings.
49</P>
50<P>
51Because a sub-banner is a NAND file, once set, it is saved in that state, even if the power is turned off, and is always displayed unless it is unset.
52</P>
53<P>
54To create a sub-banner file, prepare a BSF file set with graphic data output by <A href="../../tools/bannercvtr.html"><CODE>bannercvtr</CODE></A>, graphic data output by <A href="../../tools/ntexconv.html"><CODE>ntexconv</CODE></A> and a banner comment. In <CODE><A href="../../tools/makebannerTWL.html">makebanner.TWL</A></CODE>, you can create a sub-banner by specifying the <CODE>-s</CODE> option.<BR>For information on creating an ordinary banner, see <A href="../../tools/about_Banner.html">Banner: Overview</A>.
55</P>
56<P>
57Only NAND applications can use sub-banners. Card applications cannot use them.
58</P>
59<H2>Implementation in Applications</H2>
60<P>Sub-banners can be used if <CODE>TRUE</CODE> is specified for <CODE>SubBannerFile</CODE> of the RSF file in the <A href="../../tools/makerom.html">ROM specification file</A>.
61<BLOCKQUOTE>
62<PRE class="sample_source"><CODE>   #  ROM SPEC FILE
63
64AppendProperty
65{
66    ....
67    #
68    # Enable SubBannerFile
69    SubBannerFile    TRUE
70}</CODE></PRE>
71</BLOCKQUOTE>
72<P>
73Use <A href="../../na/subBanner/NA_SaveSubBanner.html"><CODE>NA_SaveSubBanner</CODE></A> to display a sub-banner. If <A href="../../na/subBanner/NA_SaveSubBanner.html"><CODE>NA_SaveSubBanner</CODE></A> is successful, a sub-banner is displayed. Use <A href="../../na/subBanner/NA_DeleteSubBanner.html"><CODE>NA_DeleteSubBanner</CODE></A> to hide a sub-banner.
74</P>
75<P>
76You can dynamically create sub-banners in a program. Edit the <CODE>anime</CODE> member of the <A href="../../na/subBanner/NASubBanner.html"><CODE>NASubBanner</CODE></A> structure. Use <A href="../../na/subBanner/NA_MakeSubBannerHeader.html"><CODE>NA_MakeSubBannerHeader</CODE></A> to set the <CODE>header</CODE> member. See <A href="../../na/subBanner/NASubBanner.html"><CODE>NASubBanner</CODE></A> for information on the sub-banner structure.
77</P>
78<P>
79Use <A href="../../na/subBanner/NA_LoadSubBanner.html"><CODE>NA_LoadSubBanner</CODE></A> to get the sub-banner that is currently set.
80</P>
81<H2>See Also</H2>
82<P><A href="../list_na.html#subBanner">NA Function List: Sub-Banners</A><BR> <A href="../../demos/nandApp/nandAppdemos.html">NAND Application Sample Demo</A><BR> <A href="../../tools/about_Banner.html">Banner: Overview</A></P>
83
84<H2>Revision History</H2>
85<P>
862009/03/10 Corrected method to create sub-banner.<BR> 2008/10/30 Mentioned that this can be overwritten by NAND applications.<BR> 2008/09/26 Added information about the Software Management screen.<BR> 2008/09/25 Added links to the RSF and banner overview.<BR> 2008/09/16 Initial version.
87</P>
88<hr><p>CONFIDENTIAL</p></body>
89</HTML>
90