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>GXSetTevIndirect</TITLE>
9</HEAD>
10<BODY>
11<H1 align="left">GXSetTevIndirect</H1>
12<H2>C Specification</H2>
13<DL>
14  <DD>
15  <PRE><CODE>#include &lt;revolution/gx.h&gt;</CODE></PRE>
16  <DD>
17  <PRE><CODE>void GXSetTevIndirect (<A href="../Enumerated_Types/GXTevStageID.html">GXTevStageID</A> tev_stage,
18                       <A href="../Enumerated_Types/GXIndTexStageID.html">GXIndTexStageID</A> ind_stage,
19                       <A href="../Enumerated_Types/GXIndTexFormat.html">GXIndTexFormat</A> format,
20                       <A href="../Enumerated_Types/GXIndTexBiasSel.html">GXIndTexBiasSel</A> bias_sel,
21                       <A href="../Enumerated_Types/GXIndTexMtxID.html">GXIndTexMtxID</A> matrix_sel,
22                       <A href="../Enumerated_Types/GXIndTexWrap.html">GXIndTexWrap</A> wrap_s,
23                       <A href="../Enumerated_Types/GXIndTexWrap.html">GXIndTexWrap</A> wrap_t,
24                       <A href="../Enumerated_Types/GXBool.html">GXBool</A> add_prev,
25                       <A href="../Enumerated_Types/GXBool.html">GXBool</A> utc_lod,
26                       <A href="../Enumerated_Types/GXIndTexAlphaSel.html">GXIndTexAlphaSel</A> alpha_sel);</CODE></PRE>
27</DL>
28<H2>Arguments</H2>
29<TABLE border="1" cellpadding="3" cellspacing="0.1">
30  <TBODY>
31    <TR>
32<TD width="120" valign="top" bgcolor="#ffffe8"><EM><STRONG><CODE>tev_stage</CODE></STRONG></EM></TD>
33<TD width="520">TEV stage to be set <BR>Accepted values are:<BR><code>GX_TEVSTAGE0</code>, <code>GX_TEVSTAGE1</code>, <code>GX_TEVSTAGE2</code> through <code>GX_TEVSTAGE15</code>.</TD>
34    </TR>
35    <TR>
36<TD width="120" valign="top" bgcolor="#ffffe8"><EM><STRONG><CODE>ind_stage</code></STRONG></EM></TD>
37<TD width="520">The indirect stage results used with this TEV stage. <BR>Accepted values are:<BR><code>GX_INDTEXSTAGE0</code>, <code>GX_INDTEXSTAGE1</code>, <code>GX_INDTEXSTAGE2</code> and <code>GX_INDTEXSTAGE3</code>.</TD>
38    </TR>
39    <TR>
40<TD width="120" valign="top" bgcolor="#ffffe8"><EM><STRONG><CODE>format</FONT></STRONG></EM></TD>
41<TD width="520">Indicates how many bits to extract from the indirect result color for use in indirect offsets and the indirect bump alpha. <BR>Accepted values are:<BR>
42      <TABLE border="1" width="500" cellspacing="0.1">
43
44          <tr>
45<TD width="150" bgcolor="#C0C0C0">Name</TD>
46<TD width="350" bgcolor="#C0C0C0">Indirect Offset Data and Bump Alpha</TD>
47          </tr>
48          <tr>
49<TD width="150"><code>GX_ITF_8</code></TD>
50<TD width="350">Use all 8 bits as indirect offset data. The same data (upper 5 bits) is duplicated to bump alpha.</TD>
51          </tr>
52          <tr>
53<TD width="150"><code>GX_ITF_5</code></TD>
54<TD width="350">Use the lower 5 bits as indirect offset data. The remaining 3 bits are bump alpha.</TD>
55          </tr>
56          <tr>
57<TD width="150"><code>GX_ITF_4</code></TD>
58<TD width="350">Use the lower 4 bits as indirect offset data. The remaining 4 bits are bump alpha.</TD>
59          </tr>
60          <tr>
61<TD width="150"><code>GX_ITF_3</code></TD>
62<TD width="350">Use the lower 3 bits as indirect offset data. The remaining 5 bits are bump alpha.</TD>
63          </tr>
64
65      </TABLE>
66      </TD>
67    </TR>
68    <TR>
69<TD width="120" valign="top" bgcolor="#ffffe8"><EM><STRONG><CODE>bias_sel</FONT></STRONG></EM></TD>
70<TD width="520">Indicates whether a bias is applied to each component of the indirect offset. <BR>Accepted values are:<BR>
71      <TABLE border="1" width="500" cellspacing="0.1">
72
73          <tr>
74<TD width="150" bgcolor="#C0C0C0">Name</TD>
75<TD width="350" bgcolor="#C0C0C0">Bias-applied Components</TD>
76          </tr>
77          <tr>
78<TD width="150"><code>GX_ITB_NONE</code></TD>
79<TD width="350">none</TD>
80          </tr>
81          <tr>
82<TD width="150"><code>GX_ITB_S</code></TD>
83<TD width="350">S component only</TD>
84          </tr>
85          <tr>
86<TD width="150"><code>GX_ITB_T</code></TD>
87<TD width="350">T component only</TD>
88          </tr>
89          <tr>
90<TD width="150"><code>GX_ITB_U</code></TD>
91<TD width="350">U component only</TD>
92          </tr>
93          <tr>
94<TD width="150"><code>GX_ITB_ST</code></TD>
95<TD width="350">S and T components</TD>
96          </tr>
97          <tr>
98<TD width="150"><code>GX_ITB_SU</code></TD>
99<TD width="350">S and U components</TD>
100          </tr>
101          <tr>
102<TD width="150"><code>GX_ITB_TU</code></TD>
103<TD width="350">T and U components</TD>
104          </tr>
105          <tr>
106<TD width="150"><code>GX_ITB_STU</code></TD>
107<TD width="350">all S/T/U components</TD>
108          </tr>
109
110      </TABLE>
111The bias is -128 for the <CODE>GX_ITF_8</CODE> format, +1 for other formats.</TD>
112    </TR>
113    <TR>
114<TD width="120" valign="top" bgcolor="#ffffe8"><EM><STRONG><CODE>matrix_sel</code></STRONG></EM></TD>
115<TD width="520">Indicates which indirect matrix and scale value to use to multiply the offsets. <BR>Accepted values are:<BR>
116      <TABLE border="1" width="500" cellspacing="0.1">
117
118          <tr>
119<TD width="150" bgcolor="#C0C0C0">Name</TD>
120<TD width="350" bgcolor="#C0C0C0">Indirect Matrix and Scale Value Used</TD>
121          </tr>
122          <tr>
123<TD width="150"><code>GX_ITM_OFF</code></TD>
124<TD width="350">zero matrix</TD>
125          </tr>
126          <tr>
127<TD width="150"><code>GX_ITM_0</code></TD>
128<TD width="350">indirect matrix 0 and matrix scale value 0</TD>
129          </tr>
130          <tr>
131<TD width="150"><code>GX_ITM_1</code></TD>
132<TD width="350">indirect matrix 1 and matrix scale value 1</TD>
133          </tr>
134          <tr>
135<TD width="150"><code>GX_ITM_2</code></TD>
136<TD width="350">indirect matrix 2 and matrix scale value 2</TD>
137          </tr>
138          <tr>
139<TD width="150"><code>GX_ITM_S0</code></TD>
140<TD width="350">dynamic S matrix and matrix scale value 0</TD>
141          </tr>
142          <tr>
143<TD width="150"><code>GX_ITM_S1</code></TD>
144<TD width="350">dynamic S matrix and matrix scale value 1</TD>
145          </tr>
146          <tr>
147<TD width="150"><code>GX_ITM_S2</code></TD>
148<TD width="350">dynamic S matrix and matrix scale value 2</TD>
149          </tr>
150          <tr>
151<TD width="150"><code>GX_ITM_T0</code></TD>
152<TD width="350">dynamic T matrix and matrix scale value 0</TD>
153          </tr>
154          <tr>
155<TD width="150"><code>GX_ITM_T1</code></TD>
156<TD width="350">dynamic T matrix and matrix scale value 1</TD>
157          </tr>
158          <tr>
159<TD width="150"><code>GX_ITM_T2</code></TD>
160<TD width="350">dynamic T matrix and matrix scale value 2</TD>
161          </tr>
162
163      </TABLE>
164      </TD>
165    </TR>
166    <TR>
167<TD width="120" valign="top" bgcolor="#ffffe8"><EM><STRONG><CODE>wrap_s</code></STRONG></EM></TD>
168<TD width="520">indicates the wrapping factor to use with S components of regular texture coordinates <BR>Accepted values are:<BR>
169      <TABLE border="1" width="500" cellspacing="0.1">
170
171          <tr>
172<TD width="150" bgcolor="#C0C0C0">Name</TD>
173<TD width="350" bgcolor="#C0C0C0">Wrap Value</TD>
174          </tr>
175          <tr>
176<TD width="150"><code>GX_ITW_OFF</code></TD>
177<TD width="350">no wrapping</TD>
178          </tr>
179          <tr>
180<TD width="150"><code>GX_ITW_256</code></TD>
181<TD width="350">wraps at 256</TD>
182          </tr>
183          <tr>
184<TD width="150"><code>GX_ITW_128</code></TD>
185<TD width="350">wraps at 128</TD>
186          </tr>
187          <tr>
188<TD width="150"><code>GX_ITW_64</code></TD>
189<TD width="350">wraps at 64</TD>
190          </tr>
191          <tr>
192<TD width="150"><code>GX_ITW_32</code></TD>
193<TD width="350">wraps at 32</TD>
194          </tr>
195          <tr>
196<TD width="150"><code>GX_ITW_16</code></TD>
197<TD width="350">wraps at 16</TD>
198          </tr>
199          <tr>
200<TD width="150"><code>GX_ITW_0</code></TD>
201<TD width="350">zeroes the output coordinates</TD>
202          </tr>
203
204      </TABLE>
205      </TD>
206    </TR>
207    <TR>
208<TD width="120" valign="top" bgcolor="#ffffe8"><EM><STRONG><CODE>wrap_t</code></STRONG></EM></TD>
209<TD width="520">Indicates the wrapping factor to use with the T component of regular texture coordinates. <BR>Accepted values are similar to those for <CODE>wrap_s</CODE>.</TD>
210    </TR>
211    <TR>
212<TD width="120" valign="top" bgcolor="#ffffe8"><EM><STRONG><CODE>add_prev</code></STRONG></EM></TD>
213<TD width="520">Specifies whether the texture coordinate results from the previous TEV stage should be added.</TD>
214    </TR>
215    <TR>
216<TD width="120" valign="top" bgcolor="#ffffe8"><EM><STRONG><CODE>utc_lod</code></STRONG></EM></TD>
217<TD width="520">Indicates whether to use the unmodified (<CODE>GX_TRUE</CODE>) or modified (<CODE>GX_FALSE</CODE>) texture coordinates for mipmap LOD calculations.</TD>
218    </TR>
219    <TR>
220<TD width="120" valign="top" bgcolor="#ffffe8"><EM><STRONG><CODE>alpha_sel</code></STRONG></EM></TD>
221<TD width="520">Indicates which offset component will supply the indirect bump alpha, if any. <BR>Accepted values are:<BR>
222      <TABLE border="1" width="500" cellspacing="0.1">
223
224          <tr>
225<TD width="150" bgcolor="#C0C0C0">Name</TD>
226<TD width="350" bgcolor="#C0C0C0">Bump Alpha Source</TD>
227          </tr>
228          <tr>
229<TD width="150"><code>GX_ITBA_OFF</code></TD>
230<TD width="350">no bump alpha</TD>
231          </tr>
232          <tr>
233<TD width="150"><code>GX_ITBA_S</code></TD>
234<TD width="350">S component supplies bump alpha</TD>
235          </tr>
236          <tr>
237<TD width="150"><code>GX_ITBA_T</code></TD>
238<TD width="350">T component supplies bump alpha</TD>
239          </tr>
240          <tr>
241<TD width="150"><code>GX_ITBA_U</code></TD>
242<TD width="350">U component supplies bump alpha</TD>
243          </tr>
244
245      </TABLE>
246      </TD>
247    </TR>
248  </TBODY>
249</TABLE>
250<H2>Return Values</H2>
251<P>None.</P>
252<H2>Description</H2>
253<P>This is a general-purpose function used to control how results from an indirect lookup will be used to modify a given regular TEV stage lookup.</P>
254
255
256<H2>See Also</H2>
257<P><A href="GXSetTevDirect.html"><CODE>GXSetTevDirect</CODE></A><br> <A href="GXSetTevIndBumpST.html"><CODE>GXSetTevIndBumpST</CODE></A><br> <A href="GXSetTevIndBumpXYZ.html"><CODE>GXSetTevIndBumpXYZ</CODE></A><br> <A href="GXSetTevIndTile.html"><CODE>GXSetTevIndTile</CODE></A><br> <A href="GXSetTevIndWarp.html"><CODE>GXSetTevIndWarp</CODE></A></P>
258<H2>Revision History</H2>
259<P>2006/03/01 Initial version.</P>
260<hr>
261<P>CONFIDENTIAL</p>
262</BODY>
263</HTML>