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="Microsoft FrontPage 5.0">
6<META http-equiv="Content-Style-Type" content="text/css">
7<LINK rel="stylesheet" type="text/css" href="../../../CSS/revolution.css">
8<TITLE>tex-preload</TITLE>
9</HEAD>
10<BODY>
11<H1 align="left">tex-preload</H1>
12
13<H2>Description</H2>
14<P>This program tests texture preloading. Various textures are mapped on animating cubes. All textures used in this test are preloaded into TMEM, and therefore, never use cache regions.</P>
15
16<H2>Coverage</H2>
17<TABLE border="1" cellpadding="3" cellspacing="0.1" width="640">
18  <TBODY>
19    <TR>
20<TD width="30%" bgcolor="#C0C0C0"><EM><STRONG>Functions</STRONG></EM></TD>
21<TD width="25%" bgcolor="#C0C0C0"><EM><STRONG>Parameters</STRONG></EM></TD>
22<TD width="45%" bgcolor="#C0C0C0"><EM><STRONG>Description</STRONG></EM></TD>
23    </TR>
24    <TR>
25<TD width="30%" rowspan="5"><A href="../../../gx/Texture/GXInitTexObj.html"><CODE>GXInitTexObj</CODE></A></TD>
26<TD width="25%"><SPAN class="argument">Pointer to image data.</SPAN></TD>
27<TD width="45%">Appropriate value.</TD>
28    </TR>
29    <TR>
30<TD width="25%"><SPAN class="argument">Width and height</SPAN></TD>
31<TD width="45%">Power of 2 only.</TD>
32    </TR>
33    <TR>
34<TD width="25%"><SPAN class="argument">Format</SPAN></TD>
35<TD width="45%"><STRONG><CODE>GX_TF_I4</CODE>, <CODE>GX_TF_I8</CODE>, <CODE>GX_TF_IA4</CODE>, <CODE>GX_TF_IA8</CODE>, <CODE>GX_TF_RGB565</CODE>, <CODE>GX_TF_RGB5A3</CODE>, <CODE>GX_TF_RGBA8</CODE>, <CODE>GX_TF_CMPR</CODE></STRONG></TD>
36    </TR>
37    <TR>
38<TD width="25%"><SPAN class="argument">Wrap mode (s, t).</SPAN></TD>
39<TD width="45%">Always <CODE>GX_REPEAT</CODE>.</TD>
40    </TR>
41    <TR>
42<TD width="25%"><SPAN class="argument">Mipmap</SPAN></TD>
43<TD width="45%">Always <CODE>GX_FALSE</CODE>.</TD>
44    </TR>
45    <TR>
46<TD width="30%" rowspan="6"><A href="../../../gx/Texture/GXInitTexObjCI.html"><CODE>GXInitTexObjCI</CODE></A></TD>
47<TD width="25%"><SPAN class="argument">Pointer to image data.</SPAN></TD>
48<TD width="45%">Appropriate value.</TD>
49    </TR>
50    <TR>
51<TD width="25%"><SPAN class="argument">Width and height</SPAN></TD>
52<TD width="45%">Power of 2 only.</TD>
53    </TR>
54    <TR>
55<TD width="25%"><SPAN class="argument">Format</SPAN></TD>
56<TD width="45%"><CODE>GX_TF_C8</CODE></TD>
57    </TR>
58    <TR>
59<TD width="25%"><SPAN class="argument">Wrap mode (s, t).</SPAN></TD>
60<TD width="45%">Always <CODE>GX_REPEAT</CODE>.</TD>
61    </TR>
62    <TR>
63<TD width="25%"><SPAN class="argument">Mipmap</SPAN></TD>
64<TD width="45%">Always <CODE>GX_FALSE</CODE>.</TD>
65    </TR>
66    <TR>
67<TD width="25%"><SPAN class="argument">TLUT name</SPAN></TD>
68<TD width="45%"><CODE>GX_TLUT0</CODE>, <CODE>GX_TLUT1</CODE></TD>
69    </TR>
70    <TR>
71<TD width="30%"><A href="../../../gx/Texture/GXPreLoadEntireTexture.html"><CODE>GXPreLoadEntireTexture</CODE></A></TD>
72<TD width="25%"><SPAN class="argument">Texture region</SPAN></TD>
73<TD width="45%"><STRONG>Appropriate <CODE>GXTexRegion</CODE> object.</STRONG></TD>
74    </TR>
75    <TR>
76<TD width="30%" rowspan="2"><A href="../../../gx/Texture/GXLoadTexObjPreLoaded.html"><CODE>GXLoadTexObjPreLoaded</CODE></A></TD>
77<TD width="25%"><SPAN class="argument">Texture region</SPAN></TD>
78<TD width="45%">The correct region where the texture data is preloaded.</TD>
79    </TR>
80    <TR>
81<TD width="25%"><SPAN class="argument">Destination texture name.</SPAN></TD>
82<TD width="45%"><STRONG><CODE>GX_TEXMAP0</CODE>, <CODE>GX_TEXMAP1</CODE></STRONG></TD>
83    </TR>
84    <TR>
85<TD width="30%" rowspan="2"><A href="../../../gx/Texture/GXInitTexPreLoadRegion.html"><CODE>GXInitTexPreloadRegion</CODE></A></TD>
86<TD width="25%"><SPAN class="argument">TMEM address (even/odd)</SPAN></TD>
87<TD width="45%"><STRONG>Appropriate lower bank address (even)<BR>Appropriate higher bank address (odd)</STRONG><BR> (In the case of CI, the lower bank address is set to both.))</TD>
88    </TR>
89    <TR>
90<TD width="25%"><SPAN class="argument">Texture region size (even/odd)</SPAN></TD>
91<TD width="45%"><strong>Appropriate value</strong>(Same as texture size.)</TD>
92    </TR>
93    <TR>
94<TD width="30%" rowspan="3"><A href="../../../gx/Texture/GXInitTlutObj.html"><CODE>GXInitTlutObj</CODE></A></TD>
95<TD width="25%"><SPAN class="argument">Pointer to data.</SPAN></TD>
96<TD width="45%">Appropriate value.</TD>
97    </TR>
98    <TR>
99<TD width="25%"><SPAN class="argument">Format</SPAN></TD>
100<TD width="45%"><CODE>GX_TL_RGB565</CODE>, <CODE>GX_TL_RGB5A3</CODE></TD>
101    </TR>
102    <TR>
103<TD width="25%"><SPAN class="argument">Number of Entries</SPAN></TD>
104<TD width="45%">Always 256.</TD>
105    </TR>
106    <TR>
107<TD width="30%"><A href="../../../gx/Texture/GXLoadTlut.html"><CODE>GXLoadTlut</CODE></A></TD>
108<TD width="25%"><SPAN class="argument">Destination TLUT name.</SPAN></TD>
109<TD width="45%"><CODE>GX_TLUT0</CODE>, <CODE>GX_TLUT1</CODE></TD>
110    </TR>
111    <TR>
112<TD width="30%" rowspan="4"><A href="../../../gx/Texture/GXGetTexBufferSize.html"><CODE>GXGetTexBufferSize</CODE></A></TD>
113<TD width="25%"><SPAN class="argument">Width and height</SPAN></TD>
114<TD width="45%">Power of 2 only.</TD>
115    </TR>
116    <TR>
117<TD width="25%"><SPAN class="argument">Format</SPAN></TD>
118<TD width="45%"><STRONG><CODE>GX_TF_I4</CODE>, <CODE>GX_TF_I8</CODE>, <CODE>GX_TF_IA4</CODE>, <CODE>GX_TF_IA8</CODE>, <CODE>GX_TF_RGB565</CODE>, <CODE>GX_TF_RGB5A3</CODE>, <CODE>GX_TF_RGBA8</CODE>, <CODE>GX_TF_CMPR</CODE>, <CODE>GX_TF_C8</CODE></STRONG></TD>
119    </TR>
120    <TR>
121<TD width="25%"><SPAN class="argument">Mipmap</SPAN></TD>
122<TD width="45%"><STRONG><CODE>GX_FALSE</CODE> / <CODE>GX_TRUE</CODE></STRONG></TD>
123    </TR>
124    <TR>
125<TD width="25%"><SPAN class="argument">Max LOD</SPAN></TD>
126<TD width="45%"><STRONG>Various values.</STRONG></TD>
127    </TR>
128    <TR>
129<TD width="30%"><A href="../../../gx/Tev/GXSetNumTevStages.html"><CODE><CODE>GXSetNumTevStages</CODE></CODE></A></TD>
130<TD width="25%"><SPAN class="argument">Number of TEV Stages</SPAN></TD>
131      <TD width="45%">2</TD>
132    </TR>
133    <TR>
134<TD width="30%" rowspan="2"><A href="../../../gx/Tev/GXSetTevOp.html"><CODE>GXSetTevOp</CODE></A></TD>
135<TD width="25%"><SPAN class="argument">TEV stage ID.</SPAN></TD>
136<TD width="45%"><CODE>GX_TEVSTAGE0</CODE>, <CODE>GX_TEVSTAGE1</CODE>.</TD>
137    </TR>
138    <TR>
139<TD width="25%"><SPAN class="argument">Operation mode</SPAN></TD>
140<TD width="45%"><CODE>GX_REPLACE</CODE> for stage 0<BR> <CODE>GX_DECAL</CODE> for stage 1</TD>
141    </TR>
142  </TBODY>
143</TABLE>
144
145<H2>Using the Demo</H2>
146<P>START exits the demo.</P>
147<P>While the A Button is pressed, the animation is stopped.</P>
148
149<H2>Snapshot</H2>
150<P><IMG src="./images/tex-preload.jpg" alt="tex-preload.jpg (52789 bytes)" width="640" height="480"></P>
151
152<H2>Data Files Required</H2>
153<P><CODE>$REVOLUTION_SDK_ROOT/dvddata/gxTests/tex-08.tpl</CODE></P>
154
155<H2>Revision History</H2>
156<P>
1572006/03/01 Initial version.<br>
158</P>
159
160<hr><p>CONFIDENTIAL</p></body>
161</HTML>