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-tlut</TITLE>
9</HEAD>
10<BODY>
11<H1 align="left">tex-tlut</H1>
12
13<H2>Description</H2>
14<P>This program can test color indexed textures with an arbitrary TLUT size. Appropriate color maps are generated at runtime and loaded into the TLUT. Two textured panels are displayed onscreen. One panel displays all the components of the generated color map and the other panel displays a sample image quantized by the color map. The user can control TLUT size, format, and other parameters to control color map generation.</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="6"><A href="../../../gx/Texture/GXInitTexObjCI.html"><CODE>GXInitTexObjCI</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%"><FONT face="Courier New">GX_TF_C4</FONT>, <FONT face="Courier New">GX_TF_C8</FONT>, <FONT face="Courier New">GX_TF_C14X2</FONT></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="25%">TLUT name</TD>
46<TD width="45%"><STRONG>All self-defined values</STRONG></TD>
47    </TR>
48    <TR>
49<TD width="30%"><A href="../../../gx/Texture/GXLoadTexObj.html"><CODE>GXLoadTexObj</CODE></A></TD>
50<TD width="25%">Destination texture name</TD>
51<TD width="45%">Always <CODE>GX_TEXMAP0</CODE>.</TD>
52    </TR>
53    <TR>
54<TD width="30%" rowspan="3"><A href="../../../gx/Texture/GXInitTlutObj.html"><CODE>GXInitTlutObj</CODE></A></TD>
55<TD width="25%">Pointer to data.</TD>
56<TD width="45%">Appropriate value.</TD>
57    </TR>
58    <TR>
59<TD width="25%">Format</TD>
60<TD width="45%"><FONT face="Courier New">GX_TL_IA8</FONT>, <FONT face="Courier New">GX_TL_RGB565</FONT>, <FONT face="Courier New">GX_TL_RGB5A3</FONT></TD>
61    </TR>
62    <TR>
63<TD width="25%">Number of Entries</TD>
64<TD width="45%">Same as the texture region size.</TD>
65    </TR>
66    <TR>
67<TD width="30%"><A href="../../../gx/Texture/GXLoadTlut.html"><CODE>GXLoadTlut</CODE></A></TD>
68<TD width="25%">Destination TLUT name</TD>
69<TD width="45%"><STRONG>All self-defined values</STRONG></TD>
70    </TR>
71    <TR>
72<TD width="30%" rowspan="2"><A href="../../../gx/Texture/GXInitTlutRegion.html"><CODE>GXInitTlutRegion</CODE></A></TD>
73<TD width="25%">TMEM address</TD>
74<TD width="45%">Appropriate address</TD>
75    </TR>
76    <TR>
77<TD width="25%">Table size</TD>
78<TD width="45%"><FONT face="Courier New">GX_TLUT_16</FONT> - <FONT face="Courier New">GX_TLUT_4K</FONT></TD>
79    </TR>
80    <TR>
81<TD width="30%"><A href="../../../gx/Texture/GXSetTlutRegionCallback.html"><CODE>GXSetTlutRegionCallBack</CODE></A></TD>
82<TD width="25%">Callback Functions</TD>
83<TD width="45%">One function</TD>
84    </TR>
85    <TR>
86<TD width="30%" rowspan="4"><A href="../../../gx/Texture/GXGetTexBufferSize.html"><CODE>GXGetTexBufferSize</CODE></A></TD>
87<TD width="25%">Width  and height</TD>
88<TD width="45%">Power of 2 only</TD>
89    </TR>
90    <TR>
91<TD width="25%">Format</TD>
92<TD width="45%"><FONT face="Courier New">GX_TF_C4</FONT>, <FONT face="Courier New">GX_TF_C8</FONT>, <FONT face="Courier New">GX_TF_C14X2</FONT></TD>
93    </TR>
94    <TR>
95<TD width="25%">Mipmap</TD>
96<TD width="45%">Always <CODE>GX_FALSE</CODE>.</TD>
97    </TR>
98    <TR>
99<TD width="25%">Max LOD</TD>
100<TD width="45%">N/A.</TD>
101    </TR>
102    <TR>
103<TD width="30%" rowspan="2"><A href="../../../gx/Tev/GXSetTevOp.html"><CODE>GXSetTevOp</CODE></A></TD>
104<TD width="25%">TEV stage ID</TD>
105<TD width="45%">Always <FONT face="Courier New">GX_TEVSTAGE0</FONT>.</TD>
106    </TR>
107    <TR>
108<TD width="25%">Operation mode</TD>
109<TD width="45%">Always <CODE>GX_REPLACE</CODE>.</TD>
110    </TR>
111    <TR>
112<TD width="30%"><A href="../../../gx/ColorFormat/GXPackedRGB565.html"><CODE>GXPackedRGB565</CODE></A></TD>
113<TD width="25%">r, g, b</TD>
114<TD width="45%">Various values.</TD>
115    </TR>
116    <TR>
117<TD width="30%"><A href="../../../gx/ColorFormat/GXPackedRGB5A3.html"><CODE>GXPackedRGB5A3</CODE></A></TD>
118<TD width="25%">r, g, b, a</TD>
119<TD width="45%">Various values.</TD>
120    </TR>
121  </TBODY>
122</TABLE>
123<H2>Operation Method</H2>
124<P>START exits the test.</P>
125<P>The L and R Buttons change the number of color entries (= TLUT size.) The number becomes a power of 2 (from 16 through 4096.)</P>
126<P>The A Button changes the format of the TLUT. The color map will also change.</P>
127<P>The Control Stick changes parameters for controlling the color map. The bit size for a color component (R, G, B, I, A) will change.</P>
128<H2>Snapshot</H2>
129<P>C4 texture format. Tlut size = 16, Tlut format = IA8, I2A2 color map.</P>
130<P><IMG src="./images/tex-tlut-0.jpg" alt="tex-tlut-0.jpg (13286 bytes)" width="320" height="240"></P>
131<P>C8 texture format. Tlut size = 256, Tlut format = RGB565, R3G3B2 color map.</P>
132<P><IMG src="./images/tex-tlut-4.jpg" alt="tex-tlut-4.jpg (16249 bytes)" width="320" height="240"></P>
133<P>C14X2 texture format. Tlut size = 4096, Tlut format = RGB5A3, R3G3B3A3 color map.</P>
134<P><IMG src="./images/tex-tlut-8.jpg" alt="tex-tlut-8.jpg (19127 bytes)" width="320" height="240"></P>
135<H2>Data Files Required</H2>
136<P>None.</P>
137<H2>Revision History</H2>
138<P>2006/03/01 Initial version.</P>
139<hr>
140<P>CONFIDENTIAL</p>
141</BODY>
142</HTML>