Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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

js
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 unter WebGLRenderingContext.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 einem TEXTURE_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 oder DataView, das die komprimierten Texturdaten enthält.

srcOffset Optional

Ein Integer, der den Index von srcData angibt, ab dem gelesen werden soll. Standardmäßig 0.

srcLengthOverride Optional

Ein Integer, der die Anzahl der in srcData zu lesenden Elemente angibt. Standardmäßig srcData.length - srcOffset.

imageSize

Ein GLsizei, der die Größe der Bilddaten in Bytes angibt.

offset

Ein GLintptr, der die Anfangsadresse im Puffer angibt, der an gl.PIXEL_UNPACK_BUFFER gebunden ist.

Rückgabewert

Keiner (undefined).

Spezifikationen

Specification
WebGL 2.0 Specification
# 3.7.6

Browser-Kompatibilität

Siehe auch