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>GXSetTevIndWarp</TITLE> 9</HEAD> 10<BODY> 11<H1 align="left">GXSetTevIndWarp</H1> 12 13<H2>Syntax</H2> 14<dl><dd><pre class="construction"> 15#include <revolution/gx.h> 16 17void GXSetTevIndWarp( <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/GXBool.html">GXBool</A> signed_offsets, 20 <A href="../Enumerated_Types/GXBool.html">GXBool</A> replace_mode, 21 <A href="../Enumerated_Types/GXIndTexMtxID.html">GXIndTexMtxID</A> matrix_sel); 22</pre></dd></dl> 23 24<H2>Arguments</H2> 25<TABLE class="arguments" border="1" > 26 <TBODY> 27 <TR> 28 <TH>tev_stage</TH> 29 <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> 30 </TR> 31 <TR> 32 <TH>ind_stage</TH> 33 <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> 34 </TR> 35 <TR> 36<TH>signed_offsets</TH> 37<TD>Whether the 8-bit offset is signed and biased (<CODE>GX_TRUE</CODE>) or unsigned (<CODE>GX_FALSE</CODE>).</TD> 38 </TR> 39 <TR> 40<TH>replace_mode</TH> 41<TD>Whether the offset will replace the regular texture coordinates (<CODE>GX_TRUE</CODE>) or be added to them (<CODE>GX_FALSE</CODE>).</TD> 42 </TR> 43 <TR> 44<TH>matrix_sel</TH> 45<TD>Indirect matrix and scale value for the offset. Accepted values are:<BR> 46 <TABLE class="arguments" border="1" > 47 <TBODY> 48 <TR> 49 <TD bgcolor="#C0C0C0">Name</TD> 50 <TD bgcolor="#C0C0C0">Indirect Matrix and Scale Value Used</TD> 51 </TR> 52 <TR> 53 <TH>GX_ITM_0</TH> 54 <TD>Indirect matrix 0 and matrix scale value 0.</TD> 55 </TR> 56 <TR> 57 <TH>GX_ITM_1</TH> 58 <TD>Indirect matrix 1 and matrix scale value 1.</TD> 59 </TR> 60 <TR> 61 <TH>GX_ITM_2</TH> 62 <TD>Indirect matrix 2 and matrix scale value 2.</TD> 63 </TR> 64 </TBODY> 65 </TABLE> 66 </TD> 67 </TR> 68 </TBODY> 69</TABLE> 70 71<H2>Return Values</H2> 72<P>None.</P> 73 74<H2>Description</H2> 75<P>Allows an indirect map to warp or distort the texture coordinates used with a regular TEV stage lookup. The indirect map must have 8-bit offsets, which may be signed or unsigned. "Signed" means "biased." If <SPAN class="argument">signed_offsets</SPAN> is <CODE>GX_TRUE</CODE>, 128 is subtracted from the values looked up from the indirect map. The indirect results can either modify or completely replace the regular texture coordinates. The indirect matrix and scale can be used to modify the indirect offsets.</P> 76<p>For users who want to learn more, the following code sample uses the <a href="GXSetTevIndirect.html"><CODE>GXSetTevIndirect</CODE></a> function to perform operations equivalent to this function.</p> 77<DL><DD><code>{<br> GXSetTevIndirect(<br> tev_stage, // tev stage<br> ind_stage, // indirect stage<br> GX_ITF_8, // format<br> (signed_offset) ? GX_ITB_STU : GX_ITB_NONE, // bias<br> (replace_mode) ? GX_ITW_0 : GX_ITW_OFF, // matrix select<br> wrap, // wrap direct S<br> wrap, // wrap direct T<br> FALSE, // add prev stage output?<br> FALSE, // use unmodified TC for LOD?<br> GX_ITBA_OFF // bump alpha select<br> );<br> }<br> <br></code></DD></DL> 78 79<H2>See Also</H2> 80<P class="reference"> 81<A href="GXSetTevIndirect.html">GXSetTevIndirect</A> 82</P> 83 84<H2>Revision History</H2> 85<P> 862006/03/01 Initial version. 87</P> 88 89<hr><p>CONFIDENTIAL</p></body> 90</HTML>