WebGLRenderingContext: getRenderbufferParameter()-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.getRenderbufferParameter()-Methode der WebGL API gibt Informationen über das Renderbuffer zurück.

Syntax

js
getRenderbufferParameter(target, pname)

Parameter

target

Ein GLenum, der das Zielrenderbuffer-Objekt spezifiziert. Mögliche Werte:

gl.RENDERBUFFER

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

pname

Ein GLenum, das die abzufragende Information festlegt. Mögliche Werte:

gl.RENDERBUFFER_WIDTH

Gibt einen GLint zurück, der die Breite des Bildes des aktuell gebundenen Renderbuffers angibt.

gl.RENDERBUFFER_HEIGHT

Gibt einen GLint zurück, der die Höhe des Bildes des aktuell gebundenen Renderbuffers angibt.

gl.RENDERBUFFER_INTERNAL_FORMAT

Gibt einen GLenum zurück, der das interne Format des aktuell gebundenen Renderbuffers angibt. Der Standard ist gl.RGBA4. Mögliche Rückgabewerte:

  • gl.RGBA4: 4 rote Bits, 4 grüne Bits, 4 blaue Bits, 4 Alpha-Bits.
  • gl.RGB565: 5 rote Bits, 6 grüne Bits, 5 blaue Bits.
  • gl.RGB5_A1: 5 rote Bits, 5 grüne Bits, 5 blaue Bits, 1 Alpha-Bit.
  • gl.DEPTH_COMPONENT16: 16 Tiefen-Bits.
  • gl.STENCIL_INDEX8: 8 Stencil-Bits.
gl.RENDERBUFFER_GREEN_SIZE

Gibt einen GLint zurück, der die Auflösungsgröße (in Bits) für die grüne Farbe ist.

gl.RENDERBUFFER_BLUE_SIZE

Gibt einen GLint zurück, der die Auflösungsgröße (in Bits) für die blaue Farbe ist.

gl.RENDERBUFFER_RED_SIZE

Gibt einen GLint zurück, der die Auflösungsgröße (in Bits) für die rote Farbe ist.

gl.RENDERBUFFER_ALPHA_SIZE

Gibt einen GLint zurück, der die Auflösungsgröße (in Bits) für den Alpha-Kanal ist.

gl.RENDERBUFFER_DEPTH_SIZE

Gibt einen GLint zurück, der die Auflösungsgröße (in Bits) für den Tiefen-Kanal ist.

gl.RENDERBUFFER_STENCIL_SIZE

Gibt einen GLint zurück, der die Auflösungsgröße (in Bits) für den Stencil-Kanal ist.

Bei Verwendung eines WebGL 2 Kontexts steht zusätzlich der folgende Wert zur Verfügung:

gl.RENDERBUFFER_SAMPLES

Gibt einen GLint zurück, der die Anzahl der Samples des Bildes des aktuell gebundenen Renderbuffers angibt.

Rückgabewert

Hängt von den angeforderten Informationen ab (wie mit pname spezifiziert). Entweder ein GLint oder ein GLenum.

Beispiele

js
gl.getRenderbufferParameter(gl.RENDERBUFFER, gl.RENDERBUFFER_WIDTH);

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