WebGL2RenderingContext: compressedTexSubImage3D()-Methode
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.
Hinweis: Dieses Feature ist verfügbar in Web Workers.
Die WebGL2RenderingContext.compressedTexSubImage3D()
-Methode der WebGL API legt ein dreidimensionales Unterrechteck für ein Texturbild im komprimierten Format fest.
Syntax
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)
Parameter
target
-
Ein
GLenum
, der den Bindungspunkt (Ziel) der aktiven Textur angibt. Mögliche Werte:gl.TEXTURE_3D
: Eine dreidimensionale Textur.gl.TEXTURE_2D_ARRAY
: Eine zweidimensionale Array-Textur.
level
-
Ein
GLint
, das die Detailebene angibt. Ebene 0 ist die Basisebene des Bildes und Ebene n ist die n-te Mipmap-Reduktionsstufe. xoffset
-
Ein
GLint
, das den x-Versatz innerhalb des komprimierten Texturbildes angibt. yoffset
-
Ein
GLint
, das den y-Versatz innerhalb des komprimierten Texturbildes angibt. zoffset
-
Ein
GLint
, das den z-Versatz innerhalb des komprimierten Texturbildes angibt. width
-
Ein
GLsizei
, das die Breite der Textur angibt. height
-
Ein
GLsizei
, das die Höhe der Textur angibt. depth
-
Ein
GLsizei
, das die Tiefe der Textur angibt. format
-
Ein
GLenum
, das das Format des komprimierten Bildes angibt. Mögliche Werte: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
-
Ein
GLint
, das die Anzahl der Bytes angibt, die aus dem Puffer gelesen werden sollen, der angl.PIXEL_UNPACK_BUFFER
gebunden ist. offset
-
Ein
GLint
, das den Versatz in Bytes angibt, ab dem aus dem Puffer gelesen werden soll, der angl.PIXEL_UNPACK_BUFFER
gebunden ist. srcData
-
Ein
TypedArray
oder einDataView
-Objekt, das als Datenspeicher für die komprimierten Bilddaten im Speicher verwendet wird.
Rückgabewert
Keiner (undefined
).
Beispiele
gl.compressedTexSubImage3D(
gl.TEXTURE_3D,
0,
0,
0,
512,
512,
512,
gl.COMPRESSED_R11_EAC,
textureData,
);
Spezifikationen
Specification |
---|
WebGL 2.0 Specification # 3.7.6 |
Browser-Kompatibilität
BCD tables only load in the browser