Light | Dark

# docs.GL

OpenGL 4

# glBindTextureUnit

## Name

glBindTextureUnit — bind an existing texture object to the specified texture unit

## C Specification

`void glBindTextureUnit(` | GLuint unit,
| GLuint texture`)`;

## Parameters

`unit`

  Specifies the texture unit, to which the texture object should be bound to.

`texture`

  Specifies the name of a texture.

## Description

`glBindTextureUnit` binds an existing texture object to the texture unit numbered `unit`.

`texture` must be zero or the name of an existing texture object. When `texture` is the name of an existing texture object, that object is bound to the target, in the corresponding texture unit, that was specified when the object was created. When `texture` is zero, each of the targets enumerated at the beginning of this section is reset to its default texture for the corresponding texture image unit.

## Associated Gets

glGet with argument `GL_TEXTURE_BINDING_1D`, `GL_TEXTURE_BINDING_2D`, `GL_TEXTURE_BINDING_3D`, `GL_TEXTURE_BINDING_1D_ARRAY`, `GL_TEXTURE_BINDING_2D_ARRAY`, `GL_TEXTURE_BINDING_RECTANGLE`, `GL_TEXTURE_BINDING_BUFFER`, `GL_TEXTURE_BINDING_CUBE_MAP`, `GL_TEXTURE_BINDING_CUBE_MAP_ARRAY`, `GL_TEXTURE_BINDING_2D_MULTISAMPLE` or `GL_TEXTURE_BINDING_2D_MULTISAMPLE_ARRAY`.

## Errors

`GL_INVALID_OPERATION` error is generated if `texture` is not zero or the name of an existing texture object.

## Version Support

| OpenGL Version
--- | ---
Function / Feature Name | 2.0 | 2.1 | 3.0 | 3.1 | 3.2 | 3.3 | 4.0 | 4.1 | 4.2 | 4.3 | 4.4 | 4.5
`glBindTextureUnit` | - | - | - | - | - | - | - | - | - | - | - | ✔

## See Also

glDeleteTextures, glGenTextures, glGet, glGetTexParameter, glIsTexture, glTexImage1D, glTexImage2D, glTexImage2DMultisample, glTexImage3D, glTexImage3DMultisample, glTexBuffer, glTexParameter

## Copyright

Copyright © 2014 Khronos Group. This material may be distributed subject to the terms and conditions set forth in the Open Publication License, v 1.0, 8 June 1999. https://opencontent.org/openpub/.

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