WebGLRenderingContext: bindTexture() method
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Note: This feature is available inWeb Workers.
TheWebGLRenderingContext.bindTexture() method of theWebGL API binds a givenWebGLTexture to a target (binding point).
Syntax
bindTexture(target, texture)Parameters
targetA
GLenumspecifying the binding point (target). Possible values:gl.TEXTURE_2DA two-dimensional texture.
gl.TEXTURE_CUBE_MAPA cube-mapped texture.
When using aWebGL 2 context, the following values are available additionally:
gl.TEXTURE_3DA three-dimensional texture.
gl.TEXTURE_2D_ARRAYA two-dimensional array texture.
textureA
WebGLTextureobject to bind.Ifnullis passed, the currently bound texture for the specified target is unbound.
Return value
None (undefined).
Exceptions
Agl.INVALID_ENUM error is thrown iftarget is notgl.TEXTURE_2D,gl.TEXTURE_CUBE_MAP,gl.TEXTURE_3D, orgl.TEXTURE_2D_ARRAY.
Examples
Binding a texture
const canvas = document.getElementById("canvas");const gl = canvas.getContext("webgl");const texture = gl.createTexture();gl.bindTexture(gl.TEXTURE_2D, texture);Unbinding a texture
// Unbind any texture currently bound to TEXTURE_2Dgl.bindTexture(gl.TEXTURE_2D, null);Getting current bindings
To check the current texture binding, query thegl.TEXTURE_BINDING_2D orgl.TEXTURE_BINDING_CUBE_MAP constants.
gl.getParameter(gl.TEXTURE_BINDING_2D);Specifications
| Specification |
|---|
| WebGL Specification # 5.14.8 |
| WebGL 2.0 Specification # 3.7.1 |