Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

WebGLRenderingContext: bindBuffer()-Methode

Baseline
Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die Methode WebGLRenderingContext.bindBuffer() der WebGL-API bindet einen angegebenen WebGLBuffer an ein Ziel.

Syntax

js
bindBuffer(target, buffer)

Parameter

target

Ein GLenum, das den Bindungspunkt (das Ziel) angibt. Mögliche Werte:

gl.ARRAY_BUFFER

Puffer mit Vertex-Attributen wie Vertex-Koordinaten, Texturkoordinaten oder Vertex-Farbdaten.

gl.ELEMENT_ARRAY_BUFFER

Puffer für Elementindizes.

Bei Verwendung eines WebGL-2-Kontexts sind zusätzlich folgende Werte verfügbar:

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 zum Speichern von Uniform-Blöcken.

gl.PIXEL_PACK_BUFFER

Puffer für Pixelübertragungsoperationen.

gl.PIXEL_UNPACK_BUFFER

Puffer für Pixelübertragungsoperationen.

buffer

Ein WebGLBuffer, der gebunden werden soll, oder null, um das derzeit an das angegebene Ziel gebundene Objekt zu lösen.

Rückgabewert

Keiner (undefined).

Ausnahmen

Ein WebGLBuffer kann nur an ein einziges Ziel gebunden werden. Der Versuch, den Puffer an ein anderes Ziel zu binden, löst einen INVALID_OPERATION-Fehler aus; die aktuelle Pufferbindung bleibt unverändert.

Ein WebGLBuffer, der mit deleteBuffer zum Löschen markiert wurde, kann nicht (erneut) gebunden werden. Ein entsprechender Versuch erzeugt einen INVALID_OPERATION-Fehler; die aktuelle Bindung bleibt unverändert.

Beispiele

Einen Puffer an ein Ziel binden

js
const canvas = document.getElementById("canvas");
const gl = canvas.getContext("webgl");
const buffer = gl.createBuffer();

gl.bindBuffer(gl.ARRAY_BUFFER, buffer);

Aktuelle Bindungen abrufen

Um die aktuellen Pufferbindungen zu überprüfen, fragen Sie die Konstanten ARRAY_BUFFER_BINDING und ELEMENT_ARRAY_BUFFER_BINDING ab.

js
gl.getParameter(gl.ARRAY_BUFFER_BINDING);
gl.getParameter(gl.ELEMENT_ARRAY_BUFFER_BINDING);

Spezifikationen

Spezifikation
WebGL Specification
# 5.14.5
WebGL 2.0 Specification
# 4.7.1

Browser-Kompatibilität

Siehe auch