WebGL2RenderingContext: invalidateFramebuffer() method

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

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

Syntax

invalidateFramebuffer(target, attachments)

Parameters

• target

  • : A {{domxref("WebGL_API/Types", "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 {{jsxref("Array")}} of {{domxref("WebGL_API/Types", "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 ({{jsxref("undefined")}}).

Examples

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

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

• {{domxref("WebGL2RenderingContext.invalidateSubFramebuffer()")}}