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: Diese Funktion ist in Web Workers verfügbar.

Die WebGL2RenderingContext.compressedTexSubImage3D()-Methode der WebGL API spezifiziert ein dreidimensionales Unterrechteck für eine komprimierte Texturbild-Darstellung.

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, der den Detaillierungsgrad spezifiziert. Level 0 ist das Basisbildniveau und Level n ist der n-te Mipmap-Reduktionslevel.

xoffset

Ein GLint, der den x-Offset innerhalb des komprimierten Texturbildes angibt.

yoffset

Ein GLint, der den y-Offset innerhalb des komprimierten Texturbildes angibt.

zoffset

Ein GLint, der den z-Offset innerhalb des komprimierten Texturbildes angibt.

width

Ein GLsizei, der die Breite der Textur angibt.

height

Ein GLsizei, der die Höhe der Textur angibt.

depth

Ein GLsizei, der die Tiefe der Textur angibt.

format

Ein GLenum, der das komprimierte Bildformat spezifiziert. 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, der die Anzahl der Bytes angibt, die aus dem Puffer gelesen werden sollen, der an gl.PIXEL_UNPACK_BUFFER gebunden ist.

offset

Ein GLint, der den Offset in Bytes angibt, ab welchem aus dem Puffer gelesen wird, der an gl.PIXEL_UNPACK_BUFFER gebunden ist.

srcData

Ein TypedArray oder ein DataView-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