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