Back to Content

WebGLRenderingContext: bindRenderbuffer() method

files/en-us/web/api/webglrenderingcontext/bindrenderbuffer/index.md

latest1.5 KB
Original Source

{{APIRef("WebGL")}}{{AvailableInWorkers}}

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

Syntax

js-nolint
bindRenderbuffer(target, renderbuffer)

Parameters

  • target

    • : A {{domxref("WebGL_API/Types", "GLenum")}} specifying the binding point (target). Possible values:
      • gl.RENDERBUFFER
        • : Buffer data storage for single images in a renderable internal format.
  • renderbuffer

    • : A {{domxref("WebGLRenderbuffer")}} object to bind.

Return value

None ({{jsxref("undefined")}}).

Exceptions

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

Examples

Binding a renderbuffer

js
const canvas = document.getElementById("canvas");
const gl = canvas.getContext("webgl");
const renderbuffer = gl.createRenderbuffer();

gl.bindRenderbuffer(gl.RENDERBUFFER, renderbuffer);

Getting current bindings

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

js
gl.getParameter(gl.RENDERBUFFER_BINDING);

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

  • {{domxref("WebGLRenderingContext.createRenderbuffer()")}}
  • {{domxref("WebGLRenderingContext.deleteRenderbuffer()")}}
  • {{domxref("WebGLRenderingContext.isRenderbuffer()")}}
  • Other buffers: {{domxref("WebGLBuffer")}}, {{domxref("WebGLFramebuffer")}}