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>C Specification</h2> 17 18<dl> 19 <dd><pre><CODE>#include <revolution/gx.h></CODE></pre></dd> 20 <dd><pre><CODE>void GXSetTexCoordCylWrap(</CODE><CODE><a href="../Enumerated_Types/GXTexCoordID.html">GXTexCoordID</a></CODE><CODE> texcoord, 21 GXBool s_enable, 22 GXBool t_enable);</CODE></pre></dd> 23</dl><h2>Arguments</h2> 24<TABLE border="1" cellpadding="3" cellspacing="0.1"> 25 <tr> 26<TD width="120" bgcolor="#ffffe8"><em><strong><CODE>texcoord</font></strong></em></TD> 27<TD width="520">Describes which texture coordinate <A href="../Enumerated_Types/GXTexCoordID.html"><CODE><EM><STRONG>ID</STRONG></EM></CODE></A> is changed. Accepted values are: <code>GX_TEXCOORD0</code>, <code>GX_TEXCOORD1</code>, <code>GX_TEXCOORD2</code>, ..., <code>GX_TEXCOORD7</code></TD> 28 </tr> 29 <tr> 30<TD width="120" bgcolor="#ffffe8"><em><strong><CODE>s_enable</font></strong></em></TD> 31<TD width="520">Enables cylindrical wrapping if GX_TRUE is set. Disables cylindrical wrapping if GX_FALSE is set</TD> 32 </tr> 33 <tr> 34<TD width="120" bgcolor="#ffffe8"><em><strong><CODE>t_enable</font></strong></em></TD> 35<TD width="520">Enables cylindrical wrapping if GX_TRUE is set. Disables cylindrical wrapping if GX_FALSE is set.</TD> 36 </tr> 37</TABLE> 38<h2>Return Values</h2> 39 40<p>None.</p> 41<H2>Description</H2> 42<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's assume that the <EM>S</EM> coordinate goes around the cylinder and the <EM>T</EM> component follows the length of the cylinder. Cylindrical wrapping allows a primitive to cross the S=1.0/S=0.0 boundary 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. GXInit turns off cylindrical wrapping by default.</P> 43<P><BR><B>Note:</B> 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> 44 45<h2>See Also</h2> 46<H2>Revision History</H2> 47<P>2006/03/01 Initial version</P><hr> 48<P>CONFIDENTIAL</p> 49</BODY> 50</HTML>