glBindTextureUnit

From OpenGL Reference
Jump to navigation Jump to search

Bind an existing texture object to the specified texture unit .

C Specification[edit]

void glBindTextureUnit( GLuint unit, GLuint texture );


Parameters[edit]

unit - Specifies the texture unit, to which the texture object should be bound to.
texture - Specifies the name of a texture.


Description[edit]

 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[edit]

 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[edit]

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


Version Support[edit]

 glBindTextureUnit  4.5+

See Also[edit]

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


Copyright[edit]

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. http://opencontent.org/openpub/.