WebGL2RenderingContext: compressedTexImage3D() 方法

Baseline 广泛可用 *

此功能已成熟，并可在多种设备和浏览器版本上运行。自 2021 年 9 月起，所有浏览器均已支持此功能。

* 此特性的某些部分可能存在不同级别的支持。

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

WebGL2RenderingContext 接口的 compressedTexImage3D() 方法，用于以压缩格式指定三维纹理图像。

语法

compressedTexImage3D(target, level, internalformat, width, height, depth, border, imageSize, offset)

compressedTexImage3D(target, level, internalformat, width, height, depth, border, srcData)
compressedTexImage3D(target, level, internalformat, width, height, depth, border, srcData, srcOffset)
compressedTexImage3D(target, level, internalformat, width, height, depth, border, srcData, srcOffset, srcLengthOverride)

参数

目标

一个 GLenum，指定活动压缩纹理的绑定点（目标）。可能的值

gl.TEXTURE_3D：三维纹理。
gl.TEXTURE_2D_ARRAY：二维数组纹理。

level

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

internalformat

一个 GLenum，指定压缩图像格式。可能值的列表，请参阅 WebGLRenderingContext.compressedTexImage2D()。

width

一个 GLsizei，指定纹理的宽度（以 texel 为单位）。

height

一个 GLsizei，指定纹理的高度（以 texel 为单位）。

depth

一个 GLsizei，指定纹理的深度/TEXTURE_2D_ARRAY 中纹理的数量。

border

一个 GLint，指定边框的宽度。必须为 0。

纹理源可以通过两种方式提供：使用 srcData、srcOffset 和 srcLengthOverride 从 ArrayBuffer（可能已共享）提供；或者使用 imageSize 和 offset 从 gl.PIXEL_UNPACK_BUFFER 提供。

srcData: 一个包含压缩纹理数据的 TypedArray 或 DataView。
srcOffset 可选: 一个指定从 `srcData` 开始读取的索引的整数。默认为 `0`。
srcLengthOverride 可选: 一个整数，指定 srcData 中要读取的元素数量。默认为 srcData.length - srcOffset。
imageSize: 一个 GLsizei，指定图像数据的大小（以字节为单位）。
offset: 一个 GLintptr，指定绑定到 `gl.PIXEL_UNPACK_BUFFER` 的缓冲区中的起始地址。

返回值

无（undefined）。

规范

规范
WebGL 2.0 规范 # 3.7.6

浏览器兼容性

另见

帮助改进 MDN

了解如何贡献

此页面最后修改于 2025年8月27日，由 MDN 贡献者。

在 GitHub 上查看此页面 • 报告此内容的疑问