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
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, odernull, 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
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.
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> |