WebGLRenderingContext.bindFramebuffer()

The WebGLRenderingContext.bindFramebuffer() method of the WebGL API binds a given WebGLFramebuffer to a target.

Syntax

bindFramebuffer(target, framebuffer)

Parameters

target

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

gl.FRAMEBUFFER: Collection buffer data storage of color, alpha, depth and stencil buffers used as both a destination for drawing and as a source for reading (see below).
When using a WebGL 2 context, the following values are available additionally:
- gl.DRAW_FRAMEBUFFER: Used as a destination for drawing operations such as gl.draw*, gl.clear* and gl.blitFramebuffer.
- gl.READ_FRAMEBUFFER: Used as a source for reading operations such as gl.readPixels and gl.blitFramebuffer

framebuffer

A WebGLFramebuffer object to bind. If framebuffer is null, then the canvas (which has no WebGLFramebuffer object) is bound.

Return value

None.

Exceptions

A gl.INVALID_ENUM error is thrown if target is not gl.FRAMEBUFFER, gl.DRAW_FRAMEBUFFER, or gl.READ_FRAMEBUFFER.

Examples

Binding a frame buffer

var canvas = document.getElementById('canvas');
var gl = canvas.getContext('webgl');
var framebuffer = gl.createFramebuffer();

gl.bindFramebuffer(gl.FRAMEBUFFER, framebuffer);

Getting current bindings

To check the current frame buffer binding, query the FRAMEBUFFER_BINDING constant.

gl.getParameter(gl.FRAMEBUFFER_BINDING);

Specifications

Specification
WebGL Specification # 5.14.6
WebGL 2.0 Specification # 3.7.1

Browser compatibility

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox for Android	Opera Android	Safari on IOS	Samsung Internet
`bindFramebuffer`	9	12	4	11	12	5.1	4.4.3	25	4	12	8	1.5
`WebGL2`	56	79	51	No	43	No	58	58	51	43	No	7.0

Name	Web APIs
Version
Badge
Last Updated	2022-04-27T09:33:08Z