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