WebGL2RenderingContext: texStorage2D()-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.texStorage2D()-Methode der WebGL API legt alle Level der zweidimensionalen Texturspeicherung fest.

Syntax

js
texStorage2D(target, levels, internalformat, width, height)

Parameter

target

Ein GLenum, das den Bindungspunkt (Ziel) der aktiven Textur angibt. Mögliche Werte:

  • gl.TEXTURE_2D: Eine zweidimensionale Textur.
  • gl.TEXTURE_CUBE_MAP: Eine würfelförmige Textur.
levels

Ein GLint, das die Anzahl der Texturebenen angibt.

internalformat

Ein GLenum, der das Speicherformat der Textur angibt. Mögliche Werte:

  • gl.R8
  • gl.R16F
  • gl.R32F
  • gl.R8UI
  • gl.RG8
  • gl.RG16F
  • gl.RG32F
  • gl.RG8UI
  • gl.RGB8
  • gl.SRGB8
  • gl.RGB565
  • gl.R11F_G11F_B10F
  • gl.RGB9_E5
  • gl.RGB16F
  • gl.RGB32F
  • gl.RGB8UI
  • gl.RGBA8
  • gl.SRGB8_ALPHA8
  • gl.RGB5_A1
  • gl.RGBA4
  • gl.RGBA16F
  • gl.RGBA32F
  • gl.RGBA8UI

Anders als OpenGL 3.0 unterstützt WebGL 2 die folgenden ETC2- und EAC-komprimierten Texturformate nicht (siehe Abschnitt 5.37 in der WebGL 2-Spezifikation). Möglicherweise können Sie sie jedoch über die WEBGL_compressed_texture_etc-Erweiterung aktivieren.

  • 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, das die Breite der Textur angibt.

height

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

Rückgabewert

Keiner (undefined).

Beispiele

js
gl.texStorage2D(gl.TEXTURE_2D, 1, gl.RGB8, 256, 256);

Spezifikationen

Specification
WebGL 2.0 Specification
# 3.7.6

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch