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 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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
getBufferParameter

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch