Light | Dark

# docs.GL

OpenGL 4
OpenGL 3
OpenGL 2
OpenGL ES 3
OpenGL ES 2

# glActiveTexture

## Name

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_TEXTURE` i, 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_TEXTURE` i, 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`

## Tutorials

open.gl - Textures Objects and Parameters

## 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 https://web.archive.org/web/20171022161616/http://oss.sgi.com/projects/FreeB/.

Think you can improve this page? Edit this page on GitHub.