WebGL2RenderingContext:copyTexSubImage3D() 方法

基线 广泛可用

此功能已得到良好确立,并且可在许多设备和浏览器版本上运行。自以下时间起,它已在浏览器中可用 2021 年 9 月.

WebGL2RenderingContext.copyTexSubImage3D() 方法是 WebGL API 的一部分,它将当前 WebGLFramebuffer 中的像素复制到现有的 3D 纹理子图像中。

语法

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

参数

target

一个 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,指定纹理的宽度。

height

一个 GLsizei,指定纹理的高度。

返回值

无 (undefined).

示例

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

规范

规范
WebGL 2.0 规范
# 3.7.6

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅