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<H2>C Specification</H2> 13<DL> 14 <DD> 15<PRE><CODE>#include <revolution/gx.h></CODE></PRE> 16 <DD> 17<PRE><CODE>void 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);</CODE></PRE> 22</DL> 23<H2>Arguments</H2> 24<TABLE border="1" cellpadding="3" cellspacing="0.1"> 25 <TBODY> 26 <TR> 27<TD width="120" valign="top" bgcolor="#ffffe8"><EM><STRONG><CODE>tev_stage</FONT></STRONG></EM></TD> 28<TD width="520">TEV stage to be set <BR>Accepted values are: <CODE>GX_TEVSTAGE0</CODE>, <CODE>GX_TEVSTAGE1</CODE>, <CODE>GX_TEVSTAGE2</CODE> through <CODE>GX_TEVSTAGE15</CODE>.</TD> 29 </TR> 30 <TR> 31<TD width="120" valign="top" bgcolor="#ffffe8"><EM><STRONG><CODE>ind_stage</CODE></STRONG></EM></TD> 32<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> 33 </TR> 34 <TR> 35<TD width="120" valign="top" bgcolor="#ffffe8"><EM><STRONG><CODE>signed_offsets</CODE></STRONG></EM></TD> 36<TD width="520">specifies whether 8-bit offset is signed and biased (<CODE>GX_TRUE</CODE>) or unsigned (<CODE>GX_FALSE</CODE>)</TD> 37 </TR> 38 <TR> 39<TD width="120" valign="top" bgcolor="#ffffe8"><EM><STRONG><CODE>replace_mode</CODE></STRONG></EM></TD> 40<TD width="520">specifies whether offset will replace the regular texture coordinates (<CODE>GX_TRUE</CODE>) or be added to them (<CODE>GX_FALSE</CODE>)</TD> 41 </TR> 42 <TR> 43<TD width="120" valign="top" bgcolor="#ffffe8"><EM><STRONG><CODE>matrix_sel</CODE></STRONG></EM></TD> 44<TD width="520">specifies the indirect matrix and scale value for the offset <BR>Accepted values are:<BR> 45 <TABLE border="1" width="500" cellspacing="0.1"> 46 <TBODY> 47 <TR> 48<TD width="150" bgcolor="#C0C0C0">Name</TD> 49<TD width="350" bgcolor="#C0C0C0">Indirect Matrix and Scale Value Used</TD> 50 </TR> 51 <TR> 52<TD width="150"><CODE>GX_ITM_0</CODE></TD> 53<TD width="350">indirect matrix 0 and matrix scale value 0</TD> 54 </TR> 55 <TR> 56<TD width="150"><CODE>GX_ITM_1</CODE></TD> 57<TD width="350">indirect matrix 1 and matrix scale value 1</TD> 58 </TR> 59 <TR> 60<TD width="150"><CODE>GX_ITM_2</CODE></TD> 61<TD width="350">indirect matrix 2 and matrix scale value 2</TD> 62 </TR> 63 </TBODY> 64 </TABLE> 65 </TD> 66 </TR> 67 </TBODY> 68</TABLE> 69<H2>Return Values</H2> 70<P>None.</P> 71<H2>Description</H2> 72<P>This function 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. <B>Signed</B> means <B>biased</B>; if <code>signed_offsets</CODE> 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> 73<p>For users who want to learn more, the following indicates operations equivalent to this function by using <code><a href="GXSetTevIndirect.html">GXSetTevIndirect</a></code>.</p> 74<BLOCKQUOTE><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></BLOCKQUOTE> 75<H2>See Also</H2> 76<P><A href="GXSetTevIndirect.html"><CODE>GXSetTevIndirect</CODE></A></P> 77<H2>Revision History</H2> 78<P>03/01/2006 Initial version.</P> 79</BODY> 80</HTML>