1991-2006
Silicon Graphics, Inc.
glActiveTexture
3G
glActiveTexture
select active texture unit
C Specification
void glActiveTexture
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_TEXTUREi,
where
i ranges from 0 to the larger of (GL_MAX_TEXTURE_COORDS - 1)
and (GL_MAX_COMBINED_TEXTURE_IMAGE_UNITS - 1).
The initial value is GL_TEXTURE0.
Description
glActiveTexture selects which texture unit subsequent texture state calls will
affect. The number of texture units an implementation supports is
implementation dependent, but must be at least 2.
Vertex arrays are client-side GL resources, which are selected by the
glClientActiveTexture routine.
Notes
glActiveTexture is only supported if the GL version is 1.3 or greater, or if
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_TEXTUREi,
where i ranges from 0 to the larger of (GL_MAX_TEXTURE_COORDS - 1)
and (GL_MAX_COMBINED_TEXTURE_IMAGE_UNITS - 1).
Associated Gets
glGet with argument GL_ACTIVE_TEXTURE, GL_MAX_TEXTURE_COORDS, or GL_MAX_COMBINED_TEXTURE_IMAGE_UNITS
See Also
glClientActiveTexture,
glMultiTexCoord,
glTexParameter
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/.