WebGL2RenderingContext: framebufferTextureLayer() 方法

Baseline 已廣泛支援

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

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

WebGL2RenderingContext.framebufferTextureLayer() 方法屬於 WebGL 2 API,它將紋理的單個圖層附加到幀緩衝區。

此方法類似於 WebGLRenderingContext.framebufferTexture2D(),但只將紋理級別中給定的單個圖層附加到附件點。

語法

js
framebufferTextureLayer(target, attachment, texture, level, layer)

引數

目標

一個 GLenum,指定繫結點(目標)。可能的值

  • gl.FRAMEBUFFER: 用於渲染影像的顏色、Alpha、深度和模板緩衝區的集合緩衝區資料儲存。
  • gl.DRAW_FRAMEBUFFER: 等同於 gl.FRAMEBUFFER
  • gl.READ_FRAMEBUFFER: 用作讀取操作的源。
attachment

一個 GLenum,指定 texture 的附件點。可能的值

  • gl.COLOR_ATTACHMENT{0-15}: 將紋理附加到幀緩衝區的顏色緩衝區之一。
  • gl.DEPTH_ATTACHMENT: 將紋理附加到幀緩衝區的深度緩衝區。
  • gl.STENCIL_ATTACHMENT: 將紋理附加到幀緩衝區的模板緩衝區。
  • gl.DEPTH_STENCIL_ATTACHMENT: 深度和模板緩衝區。
texture

一個 WebGLTexture 物件,包含要附加的影像。

level

一個 GLint,指定要附加的紋理影像的 mipmap 級別。

layer

一個 GLint,指定要附加的紋理影像的圖層。

返回值

無(undefined)。

示例

js
gl.framebufferTextureLayer(gl.FRAMEBUFFER, gl.COLOR_ATTACHMENT0, texture, 0, 8);

規範

規範
WebGL 2.0 規範
# 3.7.4

瀏覽器相容性

另見