1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html>
3
4<head>
5<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
6<META name="GENERATOR" content="Microsoft FrontPage 5.0">
7<META http-equiv="Content-Style-Type" content="text/css">
8<LINK rel="stylesheet" type="text/css" href="../../../CSS/revolution.css">
9<title>tex-fmt-tpl</title>
10</head>
11
12<body>
13
14<h1 align="left">tex-fmt-tpl</h1>
15
16
17
18<h2>Description</h2>
19
20<p>This program tests various texture formats. It can also test mipmap and odd-sized textures. This test loads TPL files with various formats and displays them sequentially.</p>
21
22<h2>Coverage</h2>
23<TABLE border="1" cellpadding="3" cellspacing="0.1" width="640">
24  <tr>
25<TD width="30%" bgcolor="#C0C0C0"><EM><STRONG>Functions</STRONG></EM></TD>
26<TD width="25%" bgcolor="#C0C0C0"><EM><STRONG>Parameters</STRONG></EM></TD>
27<TD width="45%" bgcolor="#C0C0C0"><EM><STRONG>Description</STRONG></EM></TD>
28  </tr>
29  <tr>
30<TD width="30%" rowspan="5"><a href="../../../gx/Texture/GXInitTexObj.html"><code>GXInitTexObj</code></a></TD>
31<TD width="25%">Pointer to image data.</TD>
32<TD width="45%">Appropriate.</TD>
33  </tr>
34  <tr>
35<TD width="25%">Width  and height</TD>
36<TD width="45%"><strong>Various (includes odd size)</strong></TD>
37  </tr>
38  <tr>
39<TD width="25%">Format</TD>
40<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>
41  </tr>
42  <tr>
43<TD width="25%">Wrap mode (s, t)</TD>
44<TD width="45%">Various (Depends on tpl file)</TD>
45  </tr>
46  <tr>
47<TD width="25%">Mipmap</TD>
48<TD width="45%"><strong><FONT face="Courier New">GX_TRUE</FONT> / <FONT face="Courier New">GX_FALSE</FONT></strong></TD>
49  </tr>
50  <tr>
51<TD width="30%" rowspan="6"><a href="../../../gx/Texture/GXInitTexObjCI.html"><code>GXInitTexObjCI</code></a></TD>
52<TD width="25%">Pointer to image data.</TD>
53<TD width="45%">Appropriate value.</TD>
54  </tr>
55  <tr>
56<TD width="25%">Width  and height</TD>
57<TD width="45%"><strong>Various (includes odd size)</strong></TD>
58  </tr>
59  <tr>
60<TD width="25%">Format</TD>
61<TD width="45%"><strong><FONT face="Courier New">GX_TF_C8</FONT></strong></TD>
62  </tr>
63  <tr>
64<TD width="25%">Wrap mode (s, t)</TD>
65<TD width="45%">Various (Depends on tpl file)</TD>
66  </tr>
67  <tr>
68<TD width="25%">Mipmap</TD>
69<TD width="45%">Always <CODE>GX_FALSE</CODE>.</TD>
70  </tr>
71  <tr>
72<TD width="25%">TLUT name</TD>
73<TD width="45%">Always <code>GX_TLUT0</code></TD>
74  </tr>
75  <tr>
76<TD width="30%"><a href="../../../gx/Texture/GXLoadTexObj.html"><code>GXLoadTexObj</code></a></TD>
77<TD width="25%">Destination texture name.</TD>
78<TD width="45%">Always <CODE>GX_TEXMAP0</CODE>.</TD>
79  </tr>
80  <tr>
81<TD width="30%" rowspan="3"><a href="../../../gx/Texture/GXInitTlutObj.html"><code>GXInitTlutObj</code></a></TD>
82<TD width="25%">Pointer to data.</TD>
83<TD width="45%">Appropriate value.</TD>
84  </tr>
85  <tr>
86<TD width="25%">Format</TD>
87<TD width="45%">Various (Depends on tpl file).</TD>
88  </tr>
89  <tr>
90<TD width="25%">Number of Entries</TD>
91<TD width="45%">Various (Depends on tpl file).</TD>
92  </tr>
93  <tr>
94<TD width="30%"><a href="../../../gx/Texture/GXLoadTlut.html"><code>GXLoadTlut</code></a></TD>
95<TD width="25%">Destination TLUT name</TD>
96<TD width="45%"><FONT face="Courier New">GX_TLUT0</FONT></TD>
97  </tr>
98  <tr>
99<TD width="30%"><a href="../../../gx/Texture/GXInvalidateTexAll.html"><code>GXInvalidateTexAll</code></a></TD>
100<TD width="25%">(No parameter)</TD>
101      <TD width="45%"></TD>
102  </tr>
103  <tr>
104<TD width="30%" rowspan="2"><a href="../../../gx/Tev/GXSetTevOp.html"><code>GXSetTevOp</code></a></TD>
105<TD width="25%">TEV stage ID</TD>
106<TD width="45%">Always <FONT face="Courier New">GX_TEVSTAGE0</FONT>.</TD>
107  </tr>
108  <tr>
109<TD width="25%">Operation mode</TD>
110<TD width="45%"><code>GX_REPLACE</code>, <code>GX_DECAL</code></TD>
111  </tr>
112</TABLE>
113<h2>Operation Method</h2>
114
115<p>The START button exits the test.</p>
116
117<p>The Control Stick rotates the textured box. The C Stick changes the scale of the box.</p>
118
119<p>The B Button toggles the TEV mode (for checking the alpha map),</p>
120
121<p>The A Button resets the scale and angle of the box.</p>
122<P>The L and R Buttons change the TPL file to display. (The following is the list of TPL files that can be previewed.)</P>
123<TABLE border="1" cellspacing="0" width="54%" height="186">
124  <TBODY>
125    <TR>
126<TD width="8%" bgcolor="#C0C0C0" height="19">No.</TD>
127<TD width="13%" bgcolor="#C0C0C0" height="19">Format</TD>
128<TD width="31%" bgcolor="#C0C0C0" height="19">Size</TD>
129<TD width="18%" bgcolor="#C0C0C0" height="19">Mipmap</TD>
130    </TR>
131    <TR>
132      <TD width="8%"><CODE>0</CODE></TD>
133<TD width="13%">I4</TD>
134<TD width="31%">1024 x 512</TD>
135<TD width="18%">N</TD>
136    </TR>
137    <TR>
138      <TD width="8%"><CODE>1</CODE></TD>
139<TD width="13%">I4</TD>
140<TD width="31%">1024 x 512</TD>
141<TD width="18%">Y</TD>
142    </TR>
143    <TR>
144      <TD width="8%"><CODE>2</CODE></TD>
145<TD width="13%">I4</TD>
146<TD width="31%">251 x 257</TD>
147<TD width="18%">N</TD>
148    </TR>
149    <TR>
150      <TD width="8%"><CODE>3</CODE></TD>
151<TD width="13%">I8</TD>
152<TD width="31%">1024 x 512</TD>
153<TD width="18%">N</TD>
154    </TR>
155    <TR>
156      <TD width="8%"><CODE>4</CODE></TD>
157<TD width="13%">I8</TD>
158<TD width="31%">1024 x 512</TD>
159<TD width="18%">Y</TD>
160    </TR>
161    <TR>
162      <TD width="8%"><CODE>5</CODE></TD>
163<TD width="13%">I8</TD>
164<TD width="31%">251 x 257</TD>
165<TD width="18%">N</TD>
166    </TR>
167    <TR>
168      <TD width="8%"><CODE>6</CODE></TD>
169<TD width="13%">IA4</TD>
170<TD width="31%">1024 x 512</TD>
171<TD width="18%">N</TD>
172    </TR>
173    <TR>
174      <TD width="8%"><CODE>7</CODE></TD>
175<TD width="13%">IA4</TD>
176<TD width="31%">1024 x 512</TD>
177<TD width="18%">Y</TD>
178    </TR>
179    <TR>
180      <TD width="8%"><CODE>8</CODE></TD>
181<TD width="13%">IA4</TD>
182<TD width="31%">251 x 257</TD>
183<TD width="18%">N</TD>
184    </TR>
185    <TR>
186      <TD width="8%"><CODE>9</CODE></TD>
187<TD width="13%">IA8</TD>
188<TD width="31%">1024 x 512</TD>
189<TD width="18%">N</TD>
190    </TR>
191    <TR>
192      <TD width="8%"><CODE>10</CODE></TD>
193<TD width="13%">IA8</TD>
194<TD width="31%">1024 x 512</TD>
195<TD width="18%">Y</TD>
196    </TR>
197    <TR>
198      <TD width="8%"><CODE>11</CODE></TD>
199<TD width="13%">IA8</TD>
200<TD width="31%">251 x 257</TD>
201<TD width="18%">N</TD>
202    </TR>
203    <TR>
204      <TD width="8%"><CODE>12</CODE></TD>
205<TD width="13%">RGB565</TD>
206<TD width="31%">1024 x 512</TD>
207<TD width="18%">N</TD>
208    </TR>
209    <TR>
210      <TD width="8%"><CODE>13</CODE></TD>
211<TD width="13%">RGB565</TD>
212<TD width="31%">1024 x 512</TD>
213<TD width="18%">Y</TD>
214    </TR>
215    <TR>
216      <TD width="8%"><CODE>14</CODE></TD>
217<TD width="13%">RGB565</TD>
218<TD width="31%">251 x 257</TD>
219<TD width="18%">N</TD>
220    </TR>
221    <TR>
222      <TD width="8%"><CODE>15</CODE></TD>
223<TD width="13%">RGB5A3</TD>
224<TD width="31%">1024 x 512</TD>
225<TD width="18%">N</TD>
226    </TR>
227    <TR>
228      <TD width="8%"><CODE>16</CODE></TD>
229<TD width="13%">RGB5A3</TD>
230<TD width="31%">1024 x 512</TD>
231<TD width="18%">Y</TD>
232    </TR>
233    <TR>
234      <TD width="8%"><CODE>17</CODE></TD>
235<TD width="13%">RGB5A3</TD>
236<TD width="31%">251 x 257</TD>
237<TD width="18%">N</TD>
238    </TR>
239    <TR>
240      <TD width="8%"><CODE>18</CODE></TD>
241<TD width="13%">RGBA8</TD>
242<TD width="31%">1024 x 512</TD>
243<TD width="18%">N</TD>
244    </TR>
245    <TR>
246      <TD width="8%"><CODE>19</CODE></TD>
247<TD width="13%">RGBA8</TD>
248<TD width="31%">1024 x 512</TD>
249<TD width="18%">Y</TD>
250    </TR>
251    <TR>
252      <TD width="8%"><CODE>20</CODE></TD>
253<TD width="13%">RGBA8</TD>
254<TD width="31%">251 x 257</TD>
255<TD width="18%">N</TD>
256    </TR>
257    <TR>
258      <TD width="8%"><CODE>21</CODE></TD>
259<TD width="13%">Compressed</TD>
260<TD width="31%">1024 x 512</TD>
261<TD width="18%">N</TD>
262    </TR>
263    <TR>
264      <TD width="8%"><CODE>22</CODE></TD>
265<TD width="13%">Compressed</TD>
266<TD width="31%">1024 x 512</TD>
267<TD width="18%">Y</TD>
268    </TR>
269    <TR>
270      <TD width="8%"><CODE>23</CODE></TD>
271<TD width="13%">Compressed</TD>
272<TD width="31%">252 x 256</TD>
273<TD width="18%">N</TD>
274    </TR>
275    <TR>
276      <TD width="8%"><CODE>24</CODE></TD>
277<TD width="13%">C8(RGB565)</TD>
278<TD width="31%">1024 x 512</TD>
279<TD width="18%">N</TD>
280    </TR>
281    <TR>
282      <TD width="8%"><CODE>25</CODE></TD>
283<TD width="13%">C8(RGB5A3)</TD>
284<TD width="31%">1024 x 512</TD>
285<TD width="18%">N</TD>
286    </TR>
287  </TBODY>
288</TABLE>
289<H2>Snapshot</H2>
290<P>I4 format, non mipmap.</P>
291<P><IMG src="./images/tex-fmt-tpl-0.jpg" alt="tex-fmt-tpl-0.jpg (39473 bytes)" width="320" height="240"></p>
292<P>IA4 format, non mipmap.</P>
293<P><IMG src="./images/tex-fmt-tpl-6.jpg" alt="tex-fmt-tpl-16.jpg (33900 bytes)" width="320" height="240"></p>
294
295<p>RGB565 format, mipmap.</p>
296
297<P>
298<IMG src="./images/tex-fmt-tpl-13.jpg" alt="tex-fmt-tpl-13.jpg (32969 bytes)" width="320" height="240"></p>
299
300<p>RGBA8 format, odd sized.</p>
301<P><IMG src="./images/tex-fmt-tpl-20.jpg" alt="tex-fmt-tpl-20.jpg (7165 bytes)" width="320" height="240"></P>
302<h2>Data Files Required</h2>
303
304<p>All <CODE>.tpl</CODE> files under <CODE>$Revolution_SDK_ROOT/dvddata/gxTests/tex-02/.</CODE></p>
305<H2>Revision History</H2>
306<P>2006/03/01 Initial version.</P>
307<hr>
308<P>CONFIDENTIAL</p>
309</BODY>
310</HTML>