WebGLRenderingContext: bindBuffer() 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.
The WebGLRenderingContext.bindBuffer() method of the WebGL API binds a given
WebGLBuffer to a target.
Syntax
bindBuffer(target, buffer)
Parameters
target-
A
GLenumspecifying the binding point (target). Possible values:gl.ARRAY_BUFFER-
Buffer containing vertex attributes, such as vertex coordinates, texture coordinate data, or vertex color data.
gl.ELEMENT_ARRAY_BUFFER-
Buffer used for element indices.
When using a WebGL 2 context, the following values are available additionally:
gl.COPY_READ_BUFFER-
Buffer for copying from one buffer object to another.
gl.COPY_WRITE_BUFFER-
Buffer for copying from one buffer object to another.
gl.TRANSFORM_FEEDBACK_BUFFER-
Buffer for transform feedback operations.
gl.UNIFORM_BUFFER-
Buffer used for storing uniform blocks.
gl.PIXEL_PACK_BUFFER-
Buffer used for pixel transfer operations.
gl.PIXEL_UNPACK_BUFFER-
Buffer used for pixel transfer operations.
buffer-
A
WebGLBufferto bind.
Return value
None (undefined).
Exceptions
Only one target can be bound to a given WebGLBuffer. An attempt to bind
the buffer to another target will throw an INVALID_OPERATION error and the
current buffer binding will remain the same.
A WebGLBuffer which has been marked for deletion with
deleteBuffer cannot be
(re-)bound. An attempt to do so will generate an INVALID_OPERATION error,
and the current binding will remain untouched.
Examples
Binding a buffer to a target
const canvas = document.getElementById("canvas");
const gl = canvas.getContext("webgl");
const buffer = gl.createBuffer();
gl.bindBuffer(gl.ARRAY_BUFFER, buffer);
Getting current bindings
To check the current buffer bindings, query the ARRAY_BUFFER_BINDING
and ELEMENT_ARRAY_BUFFER_BINDING constants.
gl.getParameter(gl.ARRAY_BUFFER_BINDING);
gl.getParameter(gl.ELEMENT_ARRAY_BUFFER_BINDING);
Specifications
| Specification |
|---|
| WebGL Specification # 5.14.5 |
| WebGL 2.0 Specification # 3.7.1 |
Browser compatibility
BCD tables only load in the browser