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>
48The launcher will give priority to a sub-banner and display it, if it exists. Otherwise, it will display the normal banner. This has the same behavior in the software management screen in system settings. Because a sub-banner is a NAND file, once set, it will be saved in that state, even if the power is turned off, and always be displayed unless it is unset.
49</P>
50<P>
51For information on creating sub-banner files, see <A href="../../tools/about_Banner.html">Banner: Overview</A>. You can create a sub-banner file by specifying the <CODE>-s</CODE> option to <A href="../../tools/makebannerTWL.html"><CODE>makebanner.TWL</CODE></A>.
52</P>
53<P>
54Sub-banners can only be used by NAND applications. They cannot be used by card applications.
55</P>
56<H2>Implementation in Applications</H2>
57<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>.
58<BLOCKQUOTE>
59<PRE class="sample_source"><CODE>   #  ROM SPEC FILE
60
61AppendProperty
62{
63    ....
64    #
65    # Enable SubBannerFile
66    SubBannerFile    TRUE
67}</CODE></PRE>
68</BLOCKQUOTE>
69<P>
70Use <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 will be displayed thereafter. Use <A href="../../na/subBanner/NA_DeleteSubBanner.html"><CODE>NA_DeleteSubBanner</CODE></A>, on the other hand, to hide a sub-banner.
71</P>
72<P>
73You 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.
74</P>
75<P>
76Use <A href="../../na/subBanner/NA_LoadSubBanner.html"><CODE>NA_LoadSubBanner</CODE></A> to get the sub-banner that is currently set.
77</P>
78<H2>See Also</H2>
79<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>
80
81<H2>Revision History</H2>
82<P>
832008/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 ROM specification file and Banner: Overview. <BR>2008/09/16 Initial version.
84</P>
85<hr><p>CONFIDENTIAL</p></body>
86</HTML>
87