WebGLRenderingContext: renderbufferStorage() Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Hinweis: Dieses Feature ist verfügbar in Web Workers.

Die WebGLRenderingContext.renderbufferStorage()-Methode der WebGL API erstellt und initialisiert einen Datenspeicher für ein Renderbuffer-Objekt.

Syntax

js
renderbufferStorage(target, internalFormat, width, height)

Parameter

target

Ein GLenum, der das Ziel-Renderbuffer-Objekt angibt. Mögliche Werte:

gl.RENDERBUFFER

Buffer-Datenspeicher für einzelne Bilder in einem renderbaren internen Format.

internalFormat

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

  • gl.RGBA4: 4 Rot-Bits, 4 Grün-Bits, 4 Blau-Bits, 4 Alpha-Bits.
  • gl.RGB565: 5 Rot-Bits, 6 Grün-Bits, 5 Blau-Bits.
  • gl.RGB5_A1: 5 Rot-Bits, 5 Grün-Bits, 5 Blau-Bits, 1 Alpha-Bit.
  • gl.DEPTH_COMPONENT16: 16 Tiefen-Bits.
  • gl.STENCIL_INDEX8: 8 Stencil-Bits.
  • gl.DEPTH_STENCIL

Bei Verwendung eines WebGL 2 Kontexts sind zusätzlich die folgenden Werte verfügbar:

  • gl.R8
  • gl.R8UI
  • gl.R8I
  • gl.R16UI
  • gl.R16I
  • gl.R32UI
  • gl.R32I
  • gl.RG8
  • gl.RG8UI
  • gl.RG8I
  • gl.RG16UI
  • gl.RG16I
  • gl.RG32UI
  • gl.RG32I
  • gl.RGB8
  • gl.RGBA8
  • gl.SRGB8_ALPHA8 (auch als Erweiterung für WebGL 1 verfügbar, siehe unten)
  • gl.RGB10_A2
  • gl.RGBA8UI
  • gl.RGBA8I
  • gl.RGB10_A2UI
  • gl.RGBA16UI
  • gl.RGBA16I
  • gl.RGBA32I
  • gl.RGBA32UI
  • gl.DEPTH_COMPONENT24
  • gl.DEPTH_COMPONENT32F
  • gl.DEPTH24_STENCIL8
  • gl.DEPTH32F_STENCIL8

Bei Verwendung der WEBGL_color_buffer_float-Erweiterung:

  • ext.RGBA32F_EXT: RGBA 32-Bit Fließkomma-Typ.
  • ext.RGB32F_EXT: RGB 32-Bit Fließkomma-Typ.

Bei Verwendung der EXT_sRGB-Erweiterung:

  • ext.SRGB8_ALPHA8_EXT: 8-Bit sRGB und Alpha.

Bei Verwendung eines WebGL 2 Kontexts und der EXT_color_buffer_float-Erweiterung:

  • gl.R16F
  • gl.RG16F
  • gl.RGBA16F
  • gl.R32F
  • gl.RG32F
  • gl.RGBA32F
  • gl.R11F_G11F_B10F
width

Ein GLsizei, der die Breite des Renderbuffers in Pixeln angibt.

height

Ein GLsizei, der die Höhe des Renderbuffers in Pixeln angibt.

Rückgabewert

Keine (undefined).

Beispiele

js
gl.renderbufferStorage(gl.RENDERBUFFER, gl.RGBA4, 256, 256);

Spezifikationen

Specification
WebGL Specification
# 5.14.7
WebGL 2.0 Specification
# 3.7.5

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch