WebGL2RenderingContext: copyTexSubImage3D() 方法

Baseline 已廣泛支援

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

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

WebGL2RenderingContext 介面的 copyTexSubImage3D() 方法,屬於 WebGL API,可以將當前 WebGLFramebuffer 的畫素複製到一個 3D 紋理子影像中。

語法

js
copyTexSubImage3D(target, level, xoffset, yoffset, zoffset, x, y, width, height)

引數

目標

一個 GLenum,指定活動紋理的繫結點(目標)。可能的值有:

  • gl.TEXTURE_3D:三維紋理。
  • gl.TEXTURE_2D_ARRAY:二維陣列紋理。
level

一個 GLint,指定細節級別。級別 0 是基本影像級別,級別 n 是第 n 個 mipmap 縮減級別。

xoffset

一個 GLint,指定紋理影像中的 x 偏移量。

yoffset

一個 GLint,指定紋理影像中的 y 偏移量。

zoffset

一個 GLint,指定紋理影像中的 z 偏移量。

x

一個 GLint,指定開始複製的左下角 x 座標。

y

一個 GLint,指定開始複製的左下角 y 座標。

width

一個 GLsizei,指定紋理的寬度(以 texel 為單位)。

height

一個 GLsizei,指定紋理的高度(以 texel 為單位)。

返回值

無(undefined)。

示例

js
gl.copyTexSubImage3D(gl.TEXTURE_3D, 0, 0, 0, 0, 0, 0, 16, 16);

規範

規範
WebGL 2.0 規範
# 3.7.6

瀏覽器相容性

另見