WebGL2RenderingContext: texStorage3D()-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.texStorage3D()-Methode der WebGL API legt alle Ebenen einer dreidimensionalen Textur oder einer zweidimensionalen Array-Textur fest.

Syntax

texStorage3D(target, levels, internalformat, width, height, depth)

Parameter

target

Ein GLenum, der den Bindepunkt (das 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 die Anzahl der Texturebenen angibt.

internalformat

Ein GLenum, der das Format des Texturspeichers angibt. Mögliche Werte:

gl.R8
gl.R16F
gl.R32F
gl.R8UI
gl.RG8
gl.RG16F
gl.RG32F
gl.RGUI
gl.RGB8
gl.SRGB8
gl.RGB565
gl.R11F_G11F_B10F
gl.RGB9_E5
gl.RGB16F
gl.RGB32F
gl.RGB8UI
gl.RGBA8
gl.SRGB_ALPHA8
gl.RGB5_A1
gl.RGBA4444
gl.RGBA16F
gl.RGBA32F
gl.RGBA8UI

Zusätzlich sind, wenn die WEBGL_compressed_texture_etc-Erweiterung unterstützt wird, auch die folgenden Werte möglich:

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

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.

Rückgabewert

Keiner (undefined).

Beispiele

gl.texStorage3D(gl.TEXTURE_3D, 1, gl.RGB8, 256, 256, 256);

Spezifikationen

Specification
WebGL 2.0 Specification # 3.7.6

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch

WebGLRenderingContext.compressedTexImage2D()