WebGLRenderingContext: getBufferParameter() 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: Diese Funktion ist in Web Workers verfügbar.

Die WebGLRenderingContext.getBufferParameter() Methode der WebGL API liefert Informationen über den Buffer.

Syntax

js
getBufferParameter(target, pname)

Parameter

target

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

gl.ARRAY_BUFFER

Puffer enthält Vertex-Attribute, wie z.B. Vertex-Koordinaten, Texturkoordinatendaten oder Vertex-Farbdaten.

gl.ELEMENT_ARRAY_BUFFER

Puffer wird für Element-Indizes verwendet.

Bei Verwendung eines WebGL 2-Kontexts stehen zusätzlich die folgenden Werte zur Verfügung:

gl.COPY_READ_BUFFER

Puffer zum Kopieren von einem Pufferobjekt in ein anderes.

gl.COPY_WRITE_BUFFER

Puffer zum Kopieren von einem Pufferobjekt in ein anderes.

gl.TRANSFORM_FEEDBACK_BUFFER

Puffer für Transform-Feedback-Operationen.

gl.UNIFORM_BUFFER

Puffer, der zum Speichern von Uniform-Blöcken verwendet wird.

gl.PIXEL_PACK_BUFFER

Puffer, der für Pixeltransferoperationen verwendet wird.

gl.PIXEL_UNPACK_BUFFER

Puffer, der für Pixeltransferoperationen verwendet wird.

pname

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

gl.BUFFER_SIZE

Gibt ein GLint zurück, das die Größe des Puffers in Bytes angibt.

gl.BUFFER_USAGE

Gibt ein GLenum zurück, das das Nutzungsmuster des Puffers angibt. Einer der folgenden Werte:

  • gl.STATIC_DRAW
  • gl.DYNAMIC_DRAW
  • gl.STREAM_DRAW

Bei Verwendung eines WebGL 2-Kontexts stehen zusätzlich die folgenden Werte zur Verfügung:

  • gl.STATIC_READ
  • gl.DYNAMIC_READ
  • gl.STREAM_READ
  • gl.STATIC_COPY
  • gl.DYNAMIC_COPY
  • gl.STREAM_COPY

Rückgabewert

Hängt von der angeforderten Information ab (wie durch pname angegeben). Entweder ein GLint oder ein GLenum.

Beispiele

js
gl.getBufferParameter(gl.ARRAY_BUFFER, gl.BUFFER_SIZE);

Spezifikationen

Specification
WebGL Specification
# 5.14.5
WebGL 2.0 Specification
# 3.7.3

Browser-Kompatibilität

Siehe auch