This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
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 togl.FRAMEBUFFER
.gl.READ_FRAMEBUFFER
: Used as a source for reading operations.
attachments
- An
Array
ofGLenum
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 | Status | Comment |
---|---|---|
WebGL 2.0 The definition of 'invalidateFramebuffer' in that specification. |
Editor's Draft | Initial definition for WebGL. |
OpenGL ES 3.0 The definition of 'glInvalidateFramebuffer' in that specification. |
Standard | Man page of the (similar) OpenGL API. |
Browser compatibility
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Feature | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
Basic support | 56 | No | 51 | No | 43 | No |
Feature | Android webview | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
---|---|---|---|---|---|---|---|
Basic support | 58 | 58 | No | 51 | No | 43 | No |