WebGLRenderingContext.bindRenderbuffer

The WebGLRenderingContext.bindRenderbuffer() method of the WebGL API binds a given WebGLRenderbuffer to a target, which must be gl.RENDERBUFFER.

Syntax

void gl.bindRenderbuffer(target, renderbuffer);

Parameters

target

A GLenum specifying the binding point (target). Possible values:

• gl.RENDERBUFFER: Buffer data storage for single images in a renderable internal format.

renderbuffer

A WebGLRenderbuffer object to bind.

Return value

None.

Errors thrown

A gl.INVALID_ENUM error is thrown if target is not gl.RENDERBUFFER.

Examples

Binding a renderbuffer

var canvas = document.getElementById('canvas');
var gl = canvas.getContext('webgl');
var renderbuffer = gl.createRenderbuffer();

gl.bindRenderbuffer(gl.RENDERBUFFER, renderbuffer);

Getting current bindings

To check the current renderbuffer binding, query the RENDERBUFFER_BINDING constant.

gl.getParameter(gl.RENDERBUFFER_BINDING);

Specifications

Specification	Status	Comment
WebGL 1.0 The definition of 'bindRenderbuffer' in that specification.	Recommendation	Initial definition.
OpenGL ES 2.0 The definition of 'glBindRenderbuffer' in that specification.	Standard	Man page of the OpenGL API.

Browser compatibility

See also

• WebGLRenderingContext.createRenderbuffer()
• WebGLRenderingContext.deleteRenderbuffer()
• WebGLRenderingContext.isRenderbuffer()
• Other buffers: WebGLBuffer, WebGLFramebuffer