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

js
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 an gl.PIXEL_UNPACK_BUFFER gebunden ist.

offset

Ein GLint, das den Versatz in Bytes angibt, ab dem aus dem Puffer gelesen werden soll, 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

js
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

Siehe auch