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-wrap</TITLE>
9</HEAD>
10<BODY>
11<H1 align="left">tex-wrap</H1>
12
13<H2>Description</H2>
14<P>This program tests texture wrap modes. There are nine texture panels, and all combinations (three modes for S, T directions) are displayed at once. The user can change the scale of each texture coordinate and filter mode (near/linear).</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%">Always <CODE>GX_TF_RGB5A3</CODE>.</TD>
36    </TR>
37    <TR>
38<TD width="25%"><SPAN class="argument">Wrap mode (s, t).</SPAN></TD>
39<TD width="45%"><STRONG><CODE>GX_CLAMP</CODE>, <CODE>GX_REPEAT</CODE>, <CODE>GX_MIRROR</CODE></STRONG></TD>
40    </TR>
41    <TR>
42<TD width="25%"><SPAN class="argument">Mipmap</SPAN></TD>
43<TD width="45%"><CODE>GX_TRUE</CODE> / <CODE>GX_FALSE</CODE></TD>
44    </TR>
45    <TR>
46<TD width="30%" rowspan="8"><A href="../../../gx/Texture/GXInitTexObjLOD.html"><CODE><CODE>GXInitTexObjLOD</CODE></CODE></A></TD>
47<TD width="25%"><SPAN class="argument">minification filter</SPAN></TD>
48<TD width="45%"><CODE>GX_NEAR</CODE>, <CODE>GX_LINEAR</CODE>, <CODE>GX_NEAR_MIP_LIN</CODE>,&nbsp; <CODE>GX_LIN_MIP_LIN</CODE></TD>
49    </TR>
50    <TR>
51<TD width="25%"><SPAN class="argument">Magnification filter</SPAN></TD>
52<TD width="45%"><CODE>GX_NEAR</CODE>, <CODE>GX_LINEAR</CODE></TD>
53    </TR>
54    <TR>
55<TD width="25%"><SPAN class="argument">Minimum LOD</SPAN></TD>
56<TD width="45%">Always 0 (depends on tpl file).</TD>
57    </TR>
58    <TR>
59<TD width="25%"><SPAN class="argument">Max LOD</SPAN></TD>
60<TD width="45%">Existing values (depends on tpl file).</TD>
61    </TR>
62    <TR>
63<TD width="25%"><SPAN class="argument">LOD bias</SPAN></TD>
64<TD width="45%">Always 0 (depends on tpl file).</TD>
65    </TR>
66    <TR>
67<TD width="25%"><SPAN class="argument">Bias clamp</SPAN></TD>
68<TD width="45%">Always <CODE>GX_FALSE</CODE>.</TD>
69    </TR>
70    <TR>
71<TD width="25%"><SPAN class="argument">Edge LOD enable</SPAN></TD>
72<TD width="45%">Always <CODE>GX_FALSE</CODE> (depends on tpl file).</TD>
73    </TR>
74    <TR>
75<TD width="25%"><SPAN class="argument">Anisotropic filter</SPAN></TD>
76<TD width="45%">Always <CODE>GX_ANISO_1</CODE>.</TD>
77    </TR>
78    <TR>
79<TD width="30%"><A href="../../../gx/Texture/GXLoadTexObj.html"><CODE><CODE>GXLoadTexObj</CODE></CODE></A></TD>
80<TD width="25%"><SPAN class="argument">Destination texture name.</SPAN></TD>
81<TD width="45%">Always <CODE>GX_TEXMAP0</CODE>.</TD>
82    </TR>
83    <TR>
84<TD width="30%" rowspan="2"><A href="../../../gx/Tev/GXSetTevOp.html"><CODE>GXSetTevOp</CODE></A></TD>
85<TD width="25%"><SPAN class="argument">TEV stage ID.</SPAN></TD>
86<TD width="45%">Always <CODE>GX_TEVSTAGE0</CODE>.</TD>
87    </TR>
88    <TR>
89<TD width="25%"><SPAN class="argument">Operation mode</SPAN></TD>
90<TD width="45%">Always <CODE>GX_REPLACE</CODE>.</TD>
91    </TR>
92  </TBODY>
93</TABLE>
94
95<H2>Using the Demo</H2>
96<P>START exits the test.</P>
97<P>The Control Stick changes the scale of each s, t texture coordinate.</P>
98<P>The A Button changes the texture.</P>
99<P>The B Button changes filter mode (Near / Linear).</P>
100<P>The X Button resets texture coordinates.</P>
101
102<H2>Snapshot</H2>
103<P>Arrow texture is displayed.</P>
104<P>(s coordinate) Left: <code>GX_REPEAT</code>, Center: <code>GX_CLAMP</code>, Right: <CODE>GX_MIRROR</CODE><BR>(T coordinate) Top: <code>GX_REPEAT</code>, Center: <code>GX_CLAMP</code>, Bottom:<CODE>GX_MIRROR</CODE></P>
105<P><IMG src="./images/tex-wrap-0.jpg" alt="tex-wrap-0.jpg (47056 bytes)" width="640" height="448"></P>
106
107<P>A test color pattern is displayed with a linear filter applied. The border will be gray only when <CODE>GX_REPEAT</CODE> is specified.</P>
108<P><IMG src="./images/tex-wrap-1.jpg" alt="tex-wrap-1.jpg (34027 bytes)" width="640" height="448"></P>
109
110<H2>Data Files Required</H2>
111<P><CODE>$REVOLUTION_SDK_ROOT/dvddata/gxTests/tex-03.tpl</CODE></P>
112
113<H2>Revision History</H2>
114<P>
1152006/03/01 Initial version.<br>
116</P>
117
118<hr><p>CONFIDENTIAL</p></body>
119</HTML>