WebGLRenderingContext.bindTexture()
The WebGLRenderingContext.bindTexture()
method of the WebGL API binds a given
WebGLTexture
to a target (binding point).
Syntax
void gl.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.
Return value
None.
Exceptions
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
.
Examples
Binding a texture
var canvas = document.getElementById('canvas');
var gl = canvas.getContext('webgl');
var texture = gl.createTexture();
gl.bindTexture(gl.TEXTURE_2D, texture);
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
Specification |
---|
WebGL Specification # 5.14.8 |
WebGL 2.0 Specification # 3.7.1 |
Browser compatibility
BCD tables only load in the browser