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>GXSetTexCoordScaleManually</title>
10</head>
11
12<body>
13
14<h1 align="left">GXSetTexCoordScaleManually</h1>
15
16<h2>C Specification</h2>
17
18<dl>
19<dd><pre><CODE>#include &lt;revolution/gx.h&gt;</CODE></pre></dd>
20<dd><pre><CODE>void GXSetTexCoordScaleManually(</CODE><CODE><a href="../Enumerated_Types/GXTexCoordID.html">GXTexCoordID</a></CODE><CODE> texcoord, GXBool enable,
21u16 ss, u16 ts);</CODE></pre></dd>
22</dl>
23
24<h2>Arguments</h2>
25<TABLE border="1" cellpadding="3" cellspacing="0.1">
26  <tr>
27<TD width="120" bgcolor="#ffffe8"><em><strong><CODE>texcoord</font></strong></em></TD>
28<TD width="520">Describes the changed texture coordinate ID. <BR>Accepted values are: <code>GX_TEXCOORD0</code>, <code>GX_TEXCOORD1</code>, <code>GX_TEXCOORD2</code> through <code>GX_TEXCOORD7</code>.</TD>
29    </tr>
30  <tr>
31<TD width="120" bgcolor="#ffffe8"><em><strong><CODE>enable</font></strong></em></TD>
32<TD width="520">Scale is set manually if <CODE>GX_TRUE</CODE> is set. Scale is set automatically if <CODE>GX_FALSE</CODE> is set (<CODE>ss</CODE> and <CODE>ts</CODE> are ignored).</TD>
33    </tr>
34  <tr>
35<TD width="120" bgcolor="#ffffe8"><em><strong><CODE>ss</font></strong></em></TD>
36<TD width="520">Manually sets scale value for calculating the S component (width) of the coordinate.</TD>
37    </tr>
38  <tr>
39<TD width="120" bgcolor="#ffffe8"><em><strong><CODE>ts</font></strong></em></TD>
40<TD width="520">Manually sets scale value for calculating the T component (height) of the coordinate.</TD>
41    </tr>
42</TABLE>
43<h2>Return Values</h2>
44
45<p>None.</p>
46<H2>Description</H2>
47<P>This function lets you manually assign the scale values that are used for a given <code>texcoord</code>, overwriting the automatic scale values for texture coordinates.&nbsp;Setting the <code>enable</code> argument to <CODE>GX_TRUE</CODE> yields this behavior.&nbsp;The given <code>texcoord</code> retains these manual scale values until this function is called again.&nbsp;This function is also used to return a given texture coordinate back to normal, automatic scaling (by setting <code>enable</code> to <CODE>GX_FALSE</CODE>).</P>
48<P>A texture coordinate is scaled after being calculated by the relevant texgen and before the actual texture lookup.&nbsp;Normally, the scale value is set by <code><a href="../Tev/GXSetTevOrder.html">GXSetTevOrder</a></code> according to the texture map associated with the texcoord. However, there are certain cases where a different scale value is desirable. One such case is when using indirect tile textures (see <code><a href="../Indirect/GXSetTevIndTile.html">GXSetTevIndTile</a></code>).</P>
49<P><B>NB:</B> In addition to the texture coordinate scale, GX also automatically sets the texture coordinate range bias mode by default. If you configure a texture coordinate to be scaled manually, the associated range bias is no longer automatically set by GX. Resultantly, you have to call <a href="GXSetTexCoordBias.html"><code>GXSetTexCoordBias</code></a> to set the proper bias mode. These two functions should always be called together.</P>
50
51<h2>See Also</h2>
52<P><A href="GXSetTexCoordBias.html"><CODE>GXSetTexCoordBias</CODE></A></P>
53<H2>Revision History</H2>
54<P>03/01/2006 Initial version.</P></body>
55</html>