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 上檢視此頁面 • 報告此內容的疑問