WebGL2RenderingContext: compressedTexSubImage3D() 方法

基线 广泛可用

此功能已成熟，可在许多设备和浏览器版本上运行。它自 2021 年 9 月.

报告反馈

语法

WebGL2RenderingContext.compressedTexSubImage3D() 是 WebGL API 的一种方法，用于指定纹理图像的压缩格式的三维子矩形。
compressedTexSubImage3D(target, level, xoffset, yoffset, zoffset, width, height, depth, format, imageSize, offset)

compressedTexSubImage3D(target, level, xoffset, yoffset, zoffset, width, height, depth, format, srcData)
compressedTexSubImage3D(target, level, xoffset, yoffset, zoffset, width, height, depth, format, srcData, srcOffset)
compressedTexSubImage3D(target, level, xoffset, yoffset, zoffset, width, height, depth, format, srcData, srcOffset, srcLengthOverride)

js

参数

target

  • 一个 GLenum，指定活动纹理的绑定点（目标）。可能的取值
  • gl.TEXTURE_3D: 三维纹理。
gl.TEXTURE_2D_ARRAY: 二维数组纹理。

level

一个 GLint，指定细节级别。级别 0 是基础图像级别，级别 n 是第 n 个 mipmap 缩减级别。

xoffset

一个 GLint，指定压缩纹理图像内的 x 偏移量。

yoffset

一个 GLint，指定压缩纹理图像内的 y 偏移量。

zoffset

一个 GLint，指定压缩纹理图像内的 z 偏移量。

width

一个 GLsizei，指定纹理的宽度。

height

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

depth

一个 GLsizei，指定纹理的深度。

format

  • 一个 GLenum，指定压缩图像格式。可能的取值
  • gl.COMPRESSED_R11_EAC
  • gl.COMPRESSED_SIGNED_R11_EAC
  • gl.COMPRESSED_RG11_EAC
  • gl.COMPRESSED_SIGNED_RG11_EAC
  • gl.COMPRESSED_RGB8_ETC2
  • gl.COMPRESSED_RGBA8_ETC2_EAC
  • gl.COMPRESSED_SRGB8_ETC2
  • gl.COMPRESSED_SRGB8_ALPHA8_ETC2_EAC
  • gl.COMPRESSED_RGB8_PUNCHTHROUGH_ALPHA1_ETC2
gl.COMPRESSED_SRGB8_PUNCHTHROUGH_ALPHA1_ETC2

imageSize

一个 GLint，指定从绑定到 gl.PIXEL_UNPACK_BUFFER 的缓冲区中读取的字节数。

offset

一个 GLint，指定从绑定到 gl.PIXEL_UNPACK_BUFFER 的缓冲区中读取的偏移量（以字节为单位）。

srcData

一个 TypedArray 或一个 DataView 对象，用作内存中压缩图像数据的存储。

返回值

示例

WebGL2RenderingContext.compressedTexSubImage3D() 是 WebGL API 的一种方法，用于指定纹理图像的压缩格式的三维子矩形。
gl.compressedTexSubImage3D(
  gl.TEXTURE_3D,
  0,
  0,
  0,
  512,
  512,
  512,
  gl.COMPRESSED_R11_EAC,
  textureData,
);

规范

无（undefined）。
规范
# 3.7.6

浏览器兼容性

WebGL 2.0 规范

另请参阅