WebGL2RenderingContext: Methode compressedTexImage3D()
Baseline
Widely available
*
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2021.
* Some parts of this feature may have varying levels of support.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die compressedTexImage3D()
-Methode des WebGL2RenderingContext
-Interfaces der WebGL API spezifiziert ein dreidimensionales Texturbild in einem komprimierten Format.
Syntax
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)
Parameter
target
-
Ein
GLenum
, der den Bindungspunkt (target) der aktiven komprimierten Textur spezifiziert. Mögliche Werte:gl.TEXTURE_3D
: Eine dreidimensionale Textur.gl.TEXTURE_2D_ARRAY
: Eine zweidimensionale Array-Textur.
level
-
Ein
GLint
, der das Detaillierungsniveau angibt. Level 0 ist das Basisbildniveau und Level n ist das n-te Mipmap-Reduktionsniveau. internalformat
-
Ein
GLenum
, der das komprimierte Bildformat angibt. Eine Liste der möglichen Werte finden Sie unterWebGLRenderingContext.compressedTexImage2D()
. width
-
Ein
GLsizei
, der die Breite der Textur in Texeln angibt. height
-
Ein
GLsizei
, der die Höhe der Textur in Texeln angibt. depth
-
Ein
GLsizei
, der die Tiefe der Textur/ die Anzahl der Texturen in einemTEXTURE_2D_ARRAY
angibt. border
-
Ein
GLint
, der die Breite des Randes angibt. Muss 0 sein.
Die Texturquelle kann auf zwei Arten bereitgestellt werden: aus einem ArrayBuffer
(möglicherweise gemeinsam genutzt) unter Verwendung von srcData
, srcOffset
und srcLengthOverride
; oder aus gl.PIXEL_UNPACK_BUFFER
unter Verwendung von imageSize
und offset
.
srcData
-
Ein
TypedArray
oderDataView
, das die komprimierten Texturdaten enthält. srcOffset
Optional-
Ein Integer, der den Index von
srcData
angibt, ab dem gelesen werden soll. Standardmäßig0
. srcLengthOverride
Optional-
Ein Integer, der die Anzahl der in
srcData
zu lesenden Elemente angibt. StandardmäßigsrcData.length - srcOffset
. imageSize
-
Ein
GLsizei
, der die Größe der Bilddaten in Bytes angibt. offset
-
Ein
GLintptr
, der die Anfangsadresse im Puffer angibt, der angl.PIXEL_UNPACK_BUFFER
gebunden ist.
Rückgabewert
Keiner (undefined
).
Spezifikationen
Specification |
---|
WebGL 2.0 Specification> # 3.7.6> |
Browser-Kompatibilität
Loading…
Siehe auch
- Verwendung von WebGL-Erweiterungen
WebGLRenderingContext.getExtension()
WebGL2RenderingContext.compressedTexSubImage3D()
WebGLRenderingContext.compressedTexSubImage2D()
WebGLRenderingContext.compressedTexImage2D()
WEBGL_compressed_texture_s3tc
WEBGL_compressed_texture_s3tc_srgb
WEBGL_compressed_texture_etc
WEBGL_compressed_texture_pvrtc
WEBGL_compressed_texture_etc1
WEBGL_compressed_texture_astc
EXT_texture_compression_bptc
EXT_texture_compression_rgtc