← 返回首页
WebGL2RenderingContext: invalidateSubFramebuffer() method - Web APIs | MDN
HTML

HTML: Markup language

HTML reference HTML guides Markup languages
CSS

CSS: Styling language

CSS reference CSS guides Layout cookbook
JavaScriptJS

JavaScript: Scripting language

JS reference JS guides
Web APIs

Web APIs: Programming interfaces

Web API reference Web API guides
All

All web technology

Technologies Topics
Learn

Learn web development

Frontend developer course Learn HTML Learn CSS Learn JavaScript
Tools

Discover our tools

About

Get to know MDN better

Blog
Toggle sidebar
  1. Web
  2. Web APIs
  3. WebGL2RenderingContext
  4. invalidateSubFramebuffer()
Theme
  • OS default
  • Light
  • Dark
English (US)
Remember language Learn more

WebGL2RenderingContext: invalidateSubFramebuffer() method

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2021.

Note: This feature is available in Web Workers.

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

In this article

Syntax

js
invalidateSubFramebuffer(target, attachments, x, y, width, height)

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.

x

A GLint specifying the left origin of the pixel rectangle to invalidate.

y

A GLint specifying the bottom origin of the pixel rectangle to invalidate.

width

A GLsizei specifying the width of the pixel rectangle to invalidate.

height

A GLsizei specifying the height of the pixel rectangle to invalidate.

Return value

None (undefined).

Examples

js
gl.invalidateSubFramebuffer( gl.READ_FRAMEBUFFER, [gl.COLOR_ATTACHMENT0, gl.COLOR_ATTACHMENT1], 0, 0, 256, 256, );

Specifications

Specification
WebGL 2.0 Specification
# 4.7.4

Browser compatibility

Enable JavaScript to view this browser compatibility table.

See also

Help improve MDN

Was this page helpful to you?
Yes No
Learn how to contribute

This page was last modified on Jun 23, 2025 by MDN contributors.

View this page on GitHub • Report a problem with this content
  1. WebGL: 2D and 3D graphics for the web
  2. WebGL2RenderingContext
  3. Instance properties
    1. drawingBufferColorSpace
    2. unpackColorSpace
  4. Instance methods
    1. beginQuery()
    2. beginTransformFeedback()
    3. bindBufferBase()
    4. bindBufferRange()
    5. bindSampler()
    6. bindTransformFeedback()
    7. bindVertexArray()
    8. blitFramebuffer()
    9. bufferData()
    10. bufferSubData()
    11. clearBuffer[fiuv]()
    12. clientWaitSync()
    13. compressedTexImage3D()
    14. compressedTexSubImage3D()
    15. copyBufferSubData()
    16. copyTexSubImage3D()
    17. createQuery()
    18. createSampler()
    19. createTransformFeedback()
    20. createVertexArray()
    21. deleteQuery()
    22. deleteSampler()
    23. deleteSync()
    24. deleteTransformFeedback()
    25. deleteVertexArray()
    26. drawArraysInstanced()
    27. drawBuffers()
    28. drawElementsInstanced()
    29. drawRangeElements()
    30. endQuery()
    31. endTransformFeedback()
    32. fenceSync()
    33. framebufferTextureLayer()
    34. getActiveUniformBlockName()
    35. getActiveUniformBlockParameter()
    36. getActiveUniforms()
    37. getBufferSubData()
    38. getFragDataLocation()
    39. getIndexedParameter()
    40. getInternalformatParameter()
    41. getQuery()
    42. getQueryParameter()
    43. getSamplerParameter()
    44. getSyncParameter()
    45. getTransformFeedbackVarying()
    46. getUniformBlockIndex()
    47. getUniformIndices()
    48. invalidateFramebuffer()
    49. invalidateSubFramebuffer()
    50. isQuery()
    51. isSampler()
    52. isSync()
    53. isTransformFeedback()
    54. isVertexArray()
    55. pauseTransformFeedback()
    56. readBuffer()
    57. renderbufferStorageMultisample()
    58. resumeTransformFeedback()
    59. samplerParameter[if]()
    60. texImage3D()
    61. texStorage2D()
    62. texStorage3D()
    63. texSubImage3D()
    64. transformFeedbackVaryings()
    65. uniform[1234][uif][v]()
    66. uniformBlockBinding()
    67. uniformMatrix[234]x[234]fv()
    68. vertexAttribDivisor()
    69. vertexAttribI4[u]i[v]()
    70. vertexAttribIPointer()
    71. waitSync()
  5. Related pages for WebGL
    1. ANGLE_instanced_arrays
    2. EXT_blend_minmax
    3. EXT_color_buffer_half_float
    4. EXT_disjoint_timer_query
    5. EXT_frag_depth
    6. EXT_sRGB
    7. EXT_shader_texture_lod
    8. EXT_texture_filter_anisotropic
    9. OES_draw_buffers_indexed
    10. OES_element_index_uint
    11. OES_standard_derivatives
    12. OES_texture_float
    13. OES_texture_float_linear
    14. OES_texture_half_float
    15. OES_texture_half_float_linear
    16. OES_vertex_array_object
    17. WEBGL_color_buffer_float
    18. WEBGL_compressed_texture_etc1
    19. WEBGL_compressed_texture_pvrtc
    20. WEBGL_compressed_texture_s3tc
    21. WEBGL_compressed_texture_s3tc_srgb
    22. WEBGL_debug_renderer_info
    23. WEBGL_debug_shaders
    24. WEBGL_depth_texture
    25. WEBGL_draw_buffers
    26. WEBGL_lose_context
    27. WebGLActiveInfo
    28. WebGLBuffer
    29. WebGLContextEvent
    30. WebGLFramebuffer
    31. WebGLObject
    32. WebGLProgram
    33. WebGLQuery
    34. WebGLRenderbuffer
    35. WebGLRenderingContext
    36. WebGLSampler
    37. WebGLShader
    38. WebGLShaderPrecisionFormat
    39. WebGLSync
    40. WebGLTexture
    41. WebGLTransformFeedback
    42. WebGLUniformLocation
    43. WebGLVertexArrayObject
  6. Guides
    1. WebGL constants
    2. WebGL types
    3. WebGL model view projection
    4. WebGL best practices
    5. WebGL by example
    6. A basic 2D WebGL animation example
    7. Compressed texture formats
    8. Data in WebGL
    9. Matrix math for the web
    10. Using WebGL extensions
  7. Tutorial
    1. WebGL tutorial
    2. Getting started with WebGL
    3. Adding 2D content to a WebGL context
    4. Using shaders to apply color in WebGL
    5. Animating objects with WebGL
    6. Creating 3D objects using WebGL
    7. Using textures in WebGL
    8. Lighting in WebGL
    9. Animating textures in WebGL

Your blueprint for a better internet.

MDN Contribute Developers

Visit Mozilla Corporation’s not-for-profit parent, the Mozilla Foundation.
Portions of this content are ©1998–2026 by individual mozilla.org contributors. Content available under a Creative Commons license.