GLAPI/glActiveTexture

From OpenGL.org
Jump to: navigation, search
glActiveTexture
Core in version 4.4
Core since version 1.3

glActiveTexture: select active texture unit

Function Definition

 void glActiveTexture(GLenum texture​);
texture
Specifies which texture unit to make active. The number of texture units is implementation dependent, but must be at least 96 (80 in GL 4.2, 48 in GL 3.3). texture​ must be one of GL_TEXTUREi, where i ranges from 0 (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 96 (80 in GL 4.2, 48 in GL 3.3).

Errors

GL_INVALID_ENUM​ is generated if texture​ is not one of GL_TEXTUREi, where i ranges from 0 to (GL_MAX_COMBINED_TEXTURE_IMAGE_UNITS​ - 1).

Associated Gets

glGet with argument GL_ACTIVE_TEXTURE​, or GL_MAX_COMBINED_TEXTURE_IMAGE_UNITS​.

See Also

glBindTexture, glCompressedTexImage1D, glCompressedTexImage2D, glCompressedTexImage3D, glCompressedTexSubImage1D, glCompressedTexSubImage2D, glCompressedTexSubImage3D, glCopyTexImage1D, glCopyTexImage2D, glCopyTexSubImage1D, glCopyTexSubImage2D, glCopyTexSubImage3D, glGetTexImage, glGetTexLevelParameter, glGetTexParameter, glGetCompressedTexImage, glGenerateMipmap, glTexBuffer, glTexBufferRange, glTexImage1D, glTexImage2D, glTexImage2DMultisample, glTexImage3D, glTexImage3DMultisample, glTexStorage1D, glTexStorage2D, glTexStorage3D, glTexSubImage1D, glTexSubImage2D, glTexSubImage3D, 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/.