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="IBM WebSphere Studio Homepage Builder Version 8.0.0.0 for Windows">
7<META http-equiv="Content-Style-Type" content="text/css">
8<title>G3*_TexImageParam</title>
9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
10</head>
11
12<body>
13
14<h1 align="left">G3*_TexImageParam <img src="../../image/NTR.gif"align="middle"><img src="../../image/TWL.gif" align="middle"></H1>
15<H2>Syntax</H2>
16
17<dl>
18  <dd>
19<PRE><CODE>#include &lt;nitro/gx/g3imm.h&gt;
20#include &lt;nitro/gx/g3b.h&gt;
21#include &lt;nitro/gx/g3c.h&gt;</CODE><BR><BR><CODE>void G3_TexImageParam(<BR>    GXTexFmt texFmt,<BR>    GXTexGen texGen,<BR>    GXTexSizeS s,<BR>    GXTexSizeT t,<BR>    GXTexRepeat repeat,<BR>    GXTexFlip flip,<BR>    GXTexPlttColor0 pltt0,
22    u32 addr
23);</CODE><BR>
24// Below are APIs for creating the display list (command list):
25<CODE>void G3B_TexImageParam(<A href="../gx/GXDLInfo.html">GXDLInfo</A>* info, ...);</CODE><BR><CODE>void G3C_TexImageParam(<A href="../gx/GXDLInfo.html">GXDLInfo</A>* info, ...);</CODE><BR><CODE>void G3BS_TexImageParam(<A href="../gx/GXDLInfo.html">GXDLInfo</A>* info, ...);</CODE><BR><CODE>void G3CS_TexImageParam(<A href="../gx/GXDLInfo.html">GXDLInfo</A>* info, ...);</CODE></PRE></dd>
26</dl><h2>Arguments</h2>
27
28<table border="1" width="100%">
29  <tr>
30    <td width="13%"><em><strong><font face="Courier New">info</font></strong></em></td>
31    <td width="87%">Command List Information.</td>
32  </tr>
33  <tr>
34    <td width="13%"><em><strong><font face="Courier New">texFmt</font></strong></em></td>
35    <td width="87%">Texture Format</td>
36  </tr>
37    <TR>
38      <TD><em><strong><font face="Courier New">texGen</font></strong></em></TD>
39      <TD>Texture coordinate conversion mode</TD>
40    </TR>
41    <TR>
42      <TD><em><strong><font face="Courier New">s</font></strong></em></TD>
43      <TD>Texture size <code>s</code></TD>
44    </TR>
45    <TR>
46      <TD><em><strong><font face="Courier New">t</font></strong></em></TD>
47      <TD>Texture size <code>t</code></TD>
48    </TR>
49    <TR>
50      <TD><em><strong><font face="Courier New">repeat</font></strong></em></TD>
51      <TD>Repeat settings</TD>
52    </TR>
53    <TR>
54      <TD><em><strong><font face="Courier New">flip</font></strong></em></TD>
55      <TD>Flip settings (valid only when <code>repeat</code> is enabled.)</TD>
56    </TR>
57    <TR>
58      <TD><em><strong><font face="Courier New">pltt0</font></strong></em></TD>
59      <TD>Flag for selecting whether to use color 0 in the palette or use it as a transparent color</TD>
60    </TR>
61    <TR>
62      <TD><em><strong><font face="Courier New">addr</font></strong></em></TD>
63      <TD>Specifies the start offset address of the texture in the texture slot.</TD>
64    </TR>
65  </table>
66<h2>Return Values</h2>
67<p>None.</p>
68<H2>Description</H2>
69<P>Specifies texture parameters. <CODE><A href="G3_TexImageParam.html" target="_self">G3*_TexImageParam</A></CODE> commands are normally issued before <CODE><A href="G3_Begin.html" target="_self">G3*_Begin</A></CODE>, but they can also be issued between <CODE><A href="G3_Begin.html" target="_self">G3*_Begin</A></CODE> and <CODE><A href="G3_End.html" target="_self">G3*_End</A></CODE>. In this case, a different texture parameter can be set for each polygon between <CODE><A href="G3_Begin.html" target="_self">G3*_Begin</A></CODE> and <CODE><A href="G3_End.html" target="_self">G3*_End</A></CODE>.
70</P>
71<TABLE border="1">
72  <TBODY>
73    <TR>
74      <TD width="30%"><CODE>GX_TEXFMT_NONE</CODE></TD>
75      <TD width="70%">No texture</TD>
76    </TR>
77    <TR>
78      <TD><CODE>GX_TEXFMT_A3I5</CODE></TD>
79      <TD>Translucent texture (3-bit alpha, 5-bit palette color number)</TD>
80    </TR>
81    <TR>
82      <TD><CODE>GX_TEXFMT_PLTT4</CODE></TD>
83      <TD>4-color palette texture</TD>
84    </TR>
85    <TR>
86      <TD><CODE>GX_TEXFMT_PLTT16</CODE></TD>
87      <TD>16-color palette texture</TD>
88    </TR>
89    <TR>
90      <TD><CODE>GX_TEXFMT_PLTT256</CODE></TD>
91      <TD>256-color palette texture</TD>
92    </TR>
93    <TR>
94      <TD><CODE>GX_TEXFMT_COMP4x4</CODE></TD>
95      <TD>4x4 text compressed texture</TD>
96    </TR>
97    <TR>
98      <TD><CODE>GX_TEXFMT_A5I3</CODE></TD>
99      <TD>Translucent texture (5-bit alpha,  3-bit palette color number)</TD>
100    </TR>
101    <TR>
102      <TD><CODE>GX_TEXFMT_DIRECT</CODE></TD>
103      <TD>Direct texture</TD>
104    </TR>
105  </TBODY>
106</TABLE>
107<P></P>
108<TABLE border="1">
109  <TBODY>
110    <TR>
111      <TD width="30%"><CODE>GX_TEXGEN_NONE</CODE></TD>
112      <TD width="70%">No texture coordinate conversion  xyxyxy</TD>
113    </TR>
114    <TR>
115      <TD><CODE>GX_TEXGEN_TEXCOORD</CODE></TD>
116      <TD>TexCoord source</TD>
117    </TR>
118    <TR>
119      <TD><CODE>GX_TEXGEN_NORMAL</CODE></TD>
120      <TD>Normal source</TD>
121    </TR>
122    <TR>
123      <TD><CODE>GX_TEXGEN_VERTEX</CODE></TD>
124      <TD>Vertex source</TD>
125    </TR>
126  </TBODY>
127</TABLE>
128<P></P>
129<TABLE border="1">
130  <TBODY>
131    <TR>
132      <TD width="30%"><CODE>GX_TEXSIZE_S8</CODE></TD>
133      <TD width="70%">8 texels along S-axis</TD>
134    </TR>
135    <TR>
136      <TD><CODE>GX_TEXSIZE_S16</CODE></TD>
137      <TD>16 texels along S-axis</TD>
138    </TR>
139    <TR>
140      <TD><CODE>GX_TEXSIZE_S32</CODE></TD>
141      <TD>32 texels along S-axis</TD>
142    </TR>
143    <TR>
144      <TD><CODE>GX_TEXSIZE_S64</CODE></TD>
145      <TD>64 texels along S-axis</TD>
146    </TR>
147    <TR>
148      <TD><CODE>GX_TEXSIZE_S128</CODE></TD>
149      <TD>128 texels along S-axis</TD>
150    </TR>
151    <TR>
152      <TD><CODE>GX_TEXSIZE_S256</CODE></TD>
153      <TD>256 texels along S-axis</TD>
154    </TR>
155    <TR>
156      <TD><CODE>GX_TEXSIZE_S512</CODE></TD>
157      <TD>512 texels along S-axis</TD>
158    </TR>
159    <TR>
160      <TD><CODE>GX_TEXSIZE_S1024</CODE></TD>
161      <TD>1024 texels along S-axis</TD>
162    </TR>
163  </TBODY>
164</TABLE>
165<P></P>
166<TABLE border="1">
167  <TBODY>
168    <TR>
169      <TD width="30%"><CODE>GX_TEXSIZE_T8</CODE></TD>
170      <TD width="70%">8 texels along T-axis</TD>
171    </TR>
172    <TR>
173      <TD><CODE>GX_TEXSIZE_T16</CODE></TD>
174      <TD>16 texels along T-axis</TD>
175    </TR>
176    <TR>
177      <TD><CODE>GX_TEXSIZE_T32</CODE></TD>
178      <TD>32 texels along T-axis</TD>
179    </TR>
180    <TR>
181      <TD><CODE>GX_TEXSIZE_T64</CODE></TD>
182      <TD>64 texels along T-axis</TD>
183    </TR>
184    <TR>
185      <TD><CODE>GX_TEXSIZE_T128</CODE></TD>
186      <TD>128 texels along T-axis</TD>
187    </TR>
188    <TR>
189      <TD><CODE>GX_TEXSIZE_T256</CODE></TD>
190      <TD>256 texels along T-axis</TD>
191    </TR>
192    <TR>
193      <TD><CODE>GX_TEXSIZE_T512</CODE></TD>
194      <TD>512 texels along T-axis</TD>
195    </TR>
196    <TR>
197      <TD><CODE>GX_TEXSIZE_T1024</CODE></TD>
198      <TD>1024 texels along T-axis</TD>
199    </TR>
200  </TBODY>
201</TABLE>
202<P></P>
203<TABLE border="1">
204  <TBODY>
205    <TR>
206      <TD width="30%"><CODE>GX_TEXREPEAT_NONE</CODE></TD>
207      <TD width="70%">No repeat</TD>
208    </TR>
209    <TR>
210      <TD><CODE>GX_TEXREPEAT_S</CODE></TD>
211      <TD>Repeat along S-axis</TD>
212    </TR>
213    <TR>
214      <TD><CODE>GX_TEXREPEAT_T</CODE></TD>
215      <TD>Repeat along T-axis</TD>
216    </TR>
217    <TR>
218      <TD><CODE>GX_TEXREPEAT_ST</CODE></TD>
219      <TD>Repeat along both S- and T-axes</TD>
220    </TR>
221  </TBODY>
222</TABLE>
223<P></P>
224<TABLE border="1">
225  <TBODY>
226    <TR>
227      <TD width="30%"><CODE>GX_TEXFLIP_NONE</CODE></TD>
228      <TD width="70%">No flip</TD>
229    </TR>
230    <TR>
231      <TD><CODE>GX_TEXFLIP_S</CODE></TD>
232      <TD>Flip along S-axis</TD>
233    </TR>
234    <TR>
235      <TD><CODE>GX_TEXFLIP_T</CODE></TD>
236      <TD>Flip along T-axis</TD>
237    </TR>
238    <TR>
239      <TD><CODE>GX_TEXFLIP_ST</CODE></TD>
240      <TD>Flip along both S- and T-axes</TD>
241    </TR>
242  </TBODY>
243</TABLE>
244<P></P>
245<TABLE border="1">
246  <TBODY>
247    <TR>
248      <TD width="30%"><CODE>GX_TEXPLTTCOLOR0_TRNS</CODE></TD>
249      <TD width="70%">Regard <code>Color0</code> as transparent</TD>
250    </TR>
251    <TR>
252      <TD><CODE>GX_TEXPLTTCOLOR0_USE</CODE></TD>
253      <TD>Enable palette color 0 set value</TD>
254    </TR>
255  </TBODY>
256</TABLE>
257<P>The following is the type definition for the list types.</P>
258<PRE><CODE>typedef enum
259{
260    GX_TEXFMT_NONE = 0,
261    GX_TEXFMT_A3I5 = 1,
262    GX_TEXFMT_PLTT4 = 2,
263    GX_TEXFMT_PLTT16 = 3,
264    GX_TEXFMT_PLTT256 = 4,
265    GX_TEXFMT_COMP4x4 = 5,
266    GX_TEXFMT_A513 = 6,
267    GX_TEXFMT_DIRECT = 7
268}
269GXTexFmt;
270
271#define GX_TEXFMT_ALPHA ((GXTexFmt)GX_TEXFMT_A5I3) // Obsolete name
272
273typedef enum
274{
275    GX_TEXGEN_NONE = 0,
276    GX_TEXGEN_TEXCOORD = 1,
277    GX_TEXGEN_NORMAL = 2,
278    GX_TEXGEN_VERTEX = 3
279}
280GXTexGen;
281
282typedef enum
283{
284    GX_TEXSIZE_S8 = 0,
285    GX_TEXSIZE_S16 = 1,
286    GX_TEXSIZE_S32 = 2,
287    GX_TEXSIZE_S64 = 3,
288    GX_TEXSIZE_S128 = 4,
289    GX_TEXSIZE_S256 = 5,
290    GX_TEXSIZE_S512 = 6,
291    GX_TEXSIZE_S1024 = 7
292}
293GXTexSizeS;
294
295typedef enum
296{
297    GX_TEXSIZE_T8 = 0,
298    GX_TEXSIZE_T16 = 1,
299    GX_TEXSIZE_T32 = 2,
300    GX_TEXSIZE_T64 = 3,
301    GX_TEXSIZE_T128 = 4,
302    GX_TEXSIZE_T256 = 5,
303    GX_TEXSIZE_T512 = 6,
304    GX_TEXSIZE_T1024 = 7
305}
306GXTexSizeT;
307
308typedef enum
309{
310    GX_TEXREPEAT_NONE = 0,
311    GX_TEXREPEAT_S = 1,
312    GX_TEXREPEAT_T = 2,
313    GX_TEXREPEAT_ST = 3
314}
315GXTexRepeat;
316
317typedef enum
318{
319    GX_TEXFLIP_NONE = 0,
320    GX_TEXFLIP_S = 1,
321    GX_TEXFLIP_T = 2,
322    GX_TEXFLIP_ST = 3
323}
324GXTexFlip;
325
326typedef enum
327{
328    GX_TEXPLTTCOLOR0_USE = 0,
329    GX_TEXPLTTCOLOR0_TRNS = 1
330}
331GXTexPlttColor0;</code></PRE>
332
333<h2>See Also</h2>
334<P><a href="G3_TexPlttBase.html"><code>G3*_TexPlttBase</a></code>, <code><a href="G3_TexCoord.html">G3*_TexCoord</a></code></P>
335<H2>Revision History</H2>
336<P>2004/01/19 Initial version.</P>
337<hr><p>CONFIDENTIAL</p></body>
338</html>
339