WebGL2RenderingContext: blitFramebuffer() 方法

Baseline 已廣泛支援

此功能已成熟,並可在多種裝置和瀏覽器版本上執行。自 2021 年 9 月起,所有瀏覽器均已支援此功能。

注意:此功能在 Web Workers 中可用。

WebGL2RenderingContext.blitFramebuffer() 方法是 WebGL 2 API 的一部分,用於將畫素塊從讀取幀緩衝(read framebuffer)傳輸到繪製幀緩衝(draw framebuffer)。讀取和繪製幀緩衝使用 WebGLRenderingContext.bindFramebuffer() 繫結。

語法

js
blitFramebuffer(srcX0, srcY0, srcX1, srcY1,
                dstX0, dstY0, dstX1, dstY1,
                mask, filter)

引數

srcX0, srcY0, srcX1, srcY1

一個指定源矩形邊界的 GLint

dstX0, dstY0, dstX1, dstY1

一個指定目標矩形邊界的 GLint

mask

一個指定要複製的緩衝區的位掩碼的 GLbitfield。可能的值

  • gl.COLOR_BUFFER_BIT
  • gl.DEPTH_BUFFER_BIT
  • gl.STENCIL_BUFFER_BIT
filter

一個指定當影像被拉伸時要應用的插值的 GLenum。可能的值

  • gl.NEAREST
  • gl.LINEAR

返回值

無(undefined)。

示例

js
gl.blitFramebuffer(
  0,
  0,
  canvas.width,
  canvas.height,
  0,
  0,
  canvas.width,
  canvas.height,
  gl.COLOR_BUFFER_BIT,
  gl.NEAREST,
);

規範

規範
WebGL 2.0 規範
# 3.7.4

瀏覽器相容性

另見