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="Microsoft FrontPage 5.0"> 7<META http-equiv="Content-Style-Type" content="text/css"> 8<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css"> 9<title>GXSetTexCoordCylWrap</title> 10</head> 11 12<body> 13 14<h1 align="left">GXSetTexCoordCylWrap</h1> 15 16<h2>Syntax</h2> 17<dl><dd><pre class="construction"> 18#include <revolution/gx.h> 19 20void GXSetTexCoordCylWrap(<a href="../Enumerated_Types/GXTexCoordID.html">GXTexCoordID</a> texcoord, 21 GXBool s_enable, 22 GXBool t_enable); 23</pre></dd></dl> 24 25<h2>Arguments</h2> 26<TABLE class="arguments" border="1" > 27 <tr> 28<TH>texcoord</TH> 29<TD>Describes which texture coordinate <A href="../Enumerated_Types/GXTexCoordID.html">ID</A> is to be changed. Accepted values are: <code>GX_TEXCOORD0</code>, <code>GX_TEXCOORD1</code>, <code>GX_TEXCOORD2</code> through <code>GX_TEXCOORD7</code>.</TD> 30 </tr> 31 <tr> 32<TH>s_enable</TH> 33<TD>Enables cylindrical wrapping if <CODE>GX_TRUE</CODE> is set. Disables cylindrical wrapping if <CODE>GX_FALSE</CODE> is set.</TD> 34 </tr> 35 <tr> 36<TH>t_enable</TH> 37<TD>Enables cylindrical wrapping if <CODE>GX_TRUE</CODE> is set. Disables cylindrical wrapping if <CODE>GX_FALSE</CODE> is set.</TD> 38 </tr> 39</TABLE> 40 41<h2>Return Values</h2> 42<p>None.</p> 43 44<H2>Description</H2> 45<P>This function allows one to enable cylindrical texture coordinate wrapping for the components of a given texture coordinate. Imagine wrapping a texture around a cylinder. Let us assume that the S coordinate goes around the cylinder and the T component follows the length of the cylinder. Cylindrical wrapping can cross the <CODE>S=1.0</CODE> and <CODE>S=0.0</CODE> boundaries and still display the texture properly. Interpolating from 0.9 to 0.1 is done by assuming that the interpolation value really is from -0.9 up to 0.1, not 0.9 down to 0.1. This interpolation adjustment is only performed if the "spread" between the minimum value and the current value is >= 0.5. If the spread is smaller than 0.5, regular (unadjusted) interpolation takes place. Turning off cylindrical wrapping disables the adjustment. By default, the <CODE>GXInit</CODE> function turns off cylindrical wrapping.</P> 46<P>Note: Cylindrical texture coordinate wrapping may not work properly when a primitive is clipped. "Clipping" infers clipping with the near or far planes, or clipping outside the guard band. Primitives clipped inside the guard band are not a problem, since they are in fact scissored and not clipped.</P> 47 48<h2>See Also</h2> 49<p>None.</p> 50 51<H2>Revision History</H2> 52<P> 532006/03/01 Initial version.<br> 54</P> 55 56<hr><p>CONFIDENTIAL</p></body> 57</html>