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 | Status | Comment |
---|---|---|
WebGL 1.0 The definition of 'bindTexture' in that specification. |
Recommendation | Initial definition for WebGL. |
OpenGL ES 2.0 The definition of 'glBindTexture' in that specification. |
Standard | Man page of the (similar) OpenGL ES 2.0 API. |
WebGL 2.0 The definition of 'bindTexture' in that specification. |
Editor's Draft | Updated definition for WebGL 2. Adds: gl.TEXTURE_3D and gl.TEXTURE_2D_ARRAY |
OpenGL ES 3.0 The definition of 'glBindTexture' in that specification. |
Standard | Man page of the (similar) OpenGL ES 3.0 API. |
Browser compatibility
BCD tables only load in the browser
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.