1 <!DOCTYPE html PUBLIC
"-//W3C//DTD XHTML 1.0 Transitional//EN" "xhtml1-transitional.dtd">
2 <!-- saved from url=(0013)about:internet -->
3 <?xml-stylesheet type=
"text/xsl" href=
"mathml.xsl"?><html xmlns=
"http://www.w3.org/1999/xhtml" xmlns:
pref=
"http://www.w3.org/2002/Math/preference" pref:
renderer=
"mathplayer-dl"><head><meta http-equiv=
"Content-Type" content=
"text/html; charset=UTF-8" /><title>glClientActiveTexture
</title><meta name=
"generator" content=
"DocBook XSL Stylesheets V1.73.2" /></head><body><div class=
"refentry" lang=
"en" xml:
lang=
"en"><a id=
"glClientActiveTexture"></a><div class=
"titlepage"></div><div class=
"refnamediv"><h2>Name
</h2><p>glClientActiveTexture — select active texture unit
</p></div><div class=
"refsynopsisdiv"><h2>C Specification
</h2><div class=
"funcsynopsis"><table border=
"0" summary=
"Function synopsis" cellspacing=
"0" cellpadding=
"0"><tr><td><code class=
"funcdef">void
<b class=
"fsfunc">glClientActiveTexture
</b>(
</code></td><td>GLenum
</td><td><var class=
"pdparam">texture
</var><code>)
</code>;
</td></tr></table></div></div><div class=
"refsect1" lang=
"en" xml:
lang=
"en"><a id=
"parameters"></a><h2>Parameters
</h2><div class=
"variablelist"><dl><dt><span class=
"term"><em class=
"parameter"><code>texture
</code></em></span></dt><dd><p>
4 Specifies which texture unit to make active. The number
5 of texture units is implementation dependent, but must be at least
6 two.
<em class=
"parameter"><code>texture
</code></em> must be one of
7 <code class=
"constant">GL_TEXTURE
</code><mml:math xmlns:
mml=
"http://www.w3.org/1998/Math/MathML" overflow=
"scroll"><mml:mi mathvariant=
"italic">i
</mml:mi></mml:math>,
8 where i ranges from
0 to the value of
<code class=
"constant">GL_MAX_TEXTURE_COORDS
</code> -
1, which is an
9 implementation-dependent value. The initial value is
10 <code class=
"constant">GL_TEXTURE0
</code>.
11 </p></dd></dl></div></div><div class=
"refsect1" lang=
"en" xml:
lang=
"en"><a id=
"description"></a><h2>Description
</h2><p>
12 <code class=
"function">glClientActiveTexture
</code> selects the vertex array client state parameters to be modified by
13 <a class=
"citerefentry" href=
"glTexCoordPointer.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glTexCoordPointer
</span></span></a>, and enabled or disabled with
14 <a class=
"citerefentry" href=
"glEnableClientState.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glEnableClientState
</span></span></a> or
<a class=
"citerefentry" href=
"glDisableClientState.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glDisableClientState
</span></span></a>, respectively,
15 when called with a parameter of
<code class=
"constant">GL_TEXTURE_COORD_ARRAY
</code>.
16 </p></div><div class=
"refsect1" lang=
"en" xml:
lang=
"en"><a id=
"notes"></a><h2>Notes
</h2><p>
17 <code class=
"function">glClientActiveTexture
</code> is supported only if the GL version is
1.3 or greater, or
18 <code class=
"code">ARB_multitexture
</code> is included in the string returned by
19 <a class=
"citerefentry" href=
"glGetString.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glGetString
</span></span></a> when called with the argument
<code class=
"constant">GL_EXTENSIONS
</code>.
20 </p></div><div class=
"refsect1" lang=
"en" xml:
lang=
"en"><a id=
"errors"></a><h2>Errors
</h2><p>
21 <code class=
"constant">GL_INVALID_ENUM
</code> is generated if
<em class=
"parameter"><code>texture
</code></em> is not one of
22 <code class=
"constant">GL_TEXTURE
</code><mml:math xmlns:
mml=
"http://www.w3.org/1998/Math/MathML" overflow=
"scroll"><mml:mi mathvariant=
"italic">i
</mml:mi></mml:math>,
24 i ranges from
0 to the value of
<code class=
"constant">GL_MAX_TEXTURE_COORDS
</code> -
1.
25 </p></div><div class=
"refsect1" lang=
"en" xml:
lang=
"en"><a id=
"associatedgets"></a><h2>Associated Gets
</h2><p>
26 <a class=
"citerefentry" href=
"glGet.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glGet
</span></span></a> with argument
<code class=
"constant">GL_CLIENT_ACTIVE_TEXTURE
</code> or
<code class=
"constant">GL_MAX_TEXTURE_COORDS
</code>
27 </p></div><div class=
"refsect1" lang=
"en" xml:
lang=
"en"><a id=
"seealso"></a><h2>See Also
</h2><p>
28 <a class=
"citerefentry" href=
"glActiveTexture.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glActiveTexture
</span></span></a>,
29 <a class=
"citerefentry" href=
"glDisableClientState.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glDisableClientState
</span></span></a>,
30 <a class=
"citerefentry" href=
"glEnableClientState.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glEnableClientState
</span></span></a>,
31 <a class=
"citerefentry" href=
"glMultiTexCoord.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glMultiTexCoord
</span></span></a>,
32 <a class=
"citerefentry" href=
"glTexCoordPointer.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glTexCoordPointer
</span></span></a>
33 </p></div><div class=
"refsect1" lang=
"en" xml:
lang=
"en"><a id=
"Copyright"></a><h2>Copyright
</h2><p>
34 Copyright
<span class=
"trademark"></span>©
1991-
2006
35 Silicon Graphics, Inc. This document is licensed under the SGI
36 Free Software B License. For details, see
37 <a class=
"ulink" href=
"http://oss.sgi.com/projects/FreeB/" target=
"_top">http://oss.sgi.com/projects/FreeB/
</a>.
38 </p></div></div></body></html>