Baseline Widely available
Note: This feature is available in Web Workers.
The WebGLRenderingContext.bindTexture()
method of the WebGL API binds a given WebGLTexture
to a target (binding point).
bindTexture(target, texture)
Parameters
target
A GLenum
specifying the binding point (target). Possible values:
gl.TEXTURE_2D
A two-dimensional texture.
gl.TEXTURE_CUBE_MAP
A cube-mapped texture.
When using a WebGL 2 context, the following values are available additionally:
gl.TEXTURE_3D
A three-dimensional texture.
gl.TEXTURE_2D_ARRAY
A two-dimensional array texture.
texture
A WebGLTexture
object to bind. If null
is passed, the currently bound texture for the specified target is unbound.
None (undefined
).
A gl.INVALID_ENUM
error is thrown if target
is not gl.TEXTURE_2D
, gl.TEXTURE_CUBE_MAP
, gl.TEXTURE_3D
, or gl.TEXTURE_2D_ARRAY
.
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_2D
gl.bindTexture(gl.TEXTURE_2D, null);
Getting current bindings
To check the current texture binding, query the gl.TEXTURE_BINDING_2D
or gl.TEXTURE_BINDING_CUBE_MAP
constants.
gl.getParameter(gl.TEXTURE_BINDING_2D);
Specifications Browser compatibility See also
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4