1991-2006
Silicon Graphics, Inc.
glClientActiveTexture
3G

# glClientActiveTexture

select active texture unit

## C Specification

                    void glClientActiveTexture
                    GLenum texture

## Parameters

`texture`

  Specifies which texture unit to make active. The number of texture units is implementation dependent, but must be at least two. `texture` must be one of `GL_TEXTURE` i, where i ranges from 0 to the value of `GL_MAX_TEXTURE_COORDS` - 1, which is an implementation-dependent value. The initial value is `GL_TEXTURE0`.

## Description

`glClientActiveTexture` selects the vertex array client state parameters to be modified by glTexCoordPointer, and enabled or disabled with glEnableClientState or glDisableClientState, respectively, when called with a parameter of `GL_TEXTURE_COORD_ARRAY`.

## Notes

`glClientActiveTexture` is supported only if the GL version is 1.3 or greater, or `ARB_multitexture` is included in the string returned by glGetString when called with the argument `GL_EXTENSIONS`.

## Errors

`GL_INVALID_ENUM` is generated if `texture` is not one of `GL_TEXTURE` i, where i ranges from 0 to the value of `GL_MAX_TEXTURE_COORDS` - 1.

## Associated Gets

glGet with argument `GL_CLIENT_ACTIVE_TEXTURE` or `GL_MAX_TEXTURE_COORDS`

## See Also

glActiveTexture, glDisableClientState, glEnableClientState, glMultiTexCoord, glTexCoordPointer

## Copyright

Copyright 1991-2006 Silicon Graphics, Inc. This document is licensed under the SGI Free Software B License. For details, see http://oss.sgi.com/projects/FreeB/.