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