WebGL2RenderingContext.invalidateFramebuffer()

The WebGL2RenderingContext.invalidateFramebuffer() method of the WebGL 2 API invalidates the contents of attachments in a framebuffer.

Syntax

void gl.invalidateFramebuffer(target, attachments);

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 to render an image.
  • gl.DRAW_FRAMEBUFFER: Equivalent to gl.FRAMEBUFFER.
  • gl.READ_FRAMEBUFFER: Used as a source for reading operations.
attachments

An Array of GLenum specifying the attachment points to invalidate. Possible values:

  • gl.COLOR_ATTACHMENT{0-15}: Invalidates one of the framebuffer's color buffers.
  • gl.DEPTH_ATTACHMENT: Invalidates the framebuffer's depth buffer.
  • gl.STENCIL_ATTACHMENT: Invalidates the framebuffer's stencil buffer.
  • gl.DEPTH_STENCIL_ATTACHMENT: Invalidates both the framebuffer's depth and stencil buffer.

Return value

None.

Examples

gl.invalidateFramebuffer(gl.READ_FRAMEBUFFER,
                         [gl.COLOR_ATTACHMENT0, gl.COLOR_ATTACHMENT1]);

Specifications

Specification
WebGL 2.0 Specification
# 3.7.4

Browser compatibility

BCD tables only load in the browser

See also