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: Dieses Feature ist verfügbar in Web Workers.

Die WebGLRenderingContext.getBufferParameter()-Methode der WebGL API gibt Informationen über den Puffer zurück.

Syntax

js
getBufferParameter(target, pname)

Parameter

target

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

gl.ARRAY_BUFFER

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

gl.ELEMENT_ARRAY_BUFFER

Puffer, der für Elementindizes verwendet wird.

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

gl.COPY_READ_BUFFER

Puffer für das Kopieren von einem Pufferobjekt zu einem anderen.

gl.COPY_WRITE_BUFFER

Puffer für das Kopieren von einem Pufferobjekt zu einem anderen.

gl.TRANSFORM_FEEDBACK_BUFFER

Puffer für Transform-Feedback-Operationen.

gl.UNIFORM_BUFFER

Puffer, der zur Speicherung von Uniform-Blöcken verwendet wird.

gl.PIXEL_PACK_BUFFER

Puffer, der für Pixelübertragungsoperationen verwendet wird.

gl.PIXEL_UNPACK_BUFFER

Puffer, der für Pixelübertragungsoperationen verwendet wird.

pname

Ein GLenum, der die abzufragenden Informationen angibt. 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 die Nutzungsmuster des Puffers angibt. Einer der folgenden Werte:

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

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

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

Rückgabewert

Hängt von den angeforderten Informationen ab (wie mit pname spezifiziert). 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

BCD tables only load in the browser

Siehe auch