WebGLRenderingContext: Methode bufferData()
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.bufferData() der WebGL-API erstellt und initialisiert den Datenspeicher eines Buffer-Objekts.
Syntax
bufferData(target, size, usage)
bufferData(target, srcData, usage)
Parameter
target-
Ein
GLenum, das den Bindungspunkt (das Ziel) angibt. Mögliche Werte:gl.ARRAY_BUFFER-
Buffer mit Vertex-Attributen, beispielsweise Vertex-Koordinaten, Texturkoordinaten oder Vertex-Farbdaten.
gl.ELEMENT_ARRAY_BUFFER-
Buffer für Elementindizes.
Bei Verwendung eines WebGL-2-Kontexts sind zusätzlich folgende Werte verfügbar:
gl.COPY_READ_BUFFER-
Buffer zum Kopieren von einem Buffer-Objekt in ein anderes.
gl.COPY_WRITE_BUFFER-
Buffer zum Kopieren von einem Buffer-Objekt in ein anderes.
gl.TRANSFORM_FEEDBACK_BUFFER-
Buffer für Transform-Feedback-Operationen.
gl.UNIFORM_BUFFER-
Buffer zum Speichern von Uniform-Blöcken.
gl.PIXEL_PACK_BUFFER-
Buffer für Pixelübertragungen.
gl.PIXEL_UNPACK_BUFFER-
Buffer für Pixelübertragungen.
size-
Ein
GLsizeiptr, das die Größe des Datenspeichers des Buffer-Objekts in Byte festlegt. Der Datenspeicher wird mit Nullen initialisiert. srcDataOptional-
Ein
TypedArrayoder eineDataViewmit einer Ansicht auf einenArrayBufferoderSharedArrayBuffer, dessen Daten in den Datenspeicher kopiert werden. usage-
Ein
GLenum, das das vorgesehene Nutzungsmuster des Datenspeichers für Optimierungszwecke angibt. Mögliche Werte:gl.STATIC_DRAW-
Der Inhalt wird von der Anwendung einmal festgelegt und häufig als Quelle für WebGL-Zeichenbefehle und Befehle zur Bildspezifikation verwendet.
gl.DYNAMIC_DRAW-
Der Inhalt wird von der Anwendung wiederholt neu festgelegt und häufig als Quelle für WebGL-Zeichenbefehle und Befehle zur Bildspezifikation verwendet.
gl.STREAM_DRAW-
Der Inhalt wird von der Anwendung einmal festgelegt und höchstens einige Male als Quelle für WebGL-Zeichenbefehle und Befehle zur Bildspezifikation verwendet.
Bei Verwendung eines WebGL-2-Kontexts sind zusätzlich folgende Werte verfügbar:
gl.STATIC_READ-
Der Inhalt wird einmal durch das Lesen von Daten aus WebGL festgelegt und häufig von der Anwendung abgefragt.
gl.DYNAMIC_READ-
Der Inhalt wird wiederholt durch das Lesen von Daten aus WebGL neu festgelegt und häufig von der Anwendung abgefragt.
gl.STREAM_READ-
Der Inhalt wird einmal durch das Lesen von Daten aus WebGL festgelegt und höchstens einige Male von der Anwendung abgefragt.
gl.STATIC_COPY-
Der Inhalt wird einmal durch das Lesen von Daten aus WebGL festgelegt und häufig als Quelle für WebGL-Zeichenbefehle und Befehle zur Bildspezifikation verwendet.
gl.DYNAMIC_COPY-
Der Inhalt wird wiederholt durch das Lesen von Daten aus WebGL neu festgelegt und häufig als Quelle für WebGL-Zeichenbefehle und Befehle zur Bildspezifikation verwendet.
gl.STREAM_COPY-
Der Inhalt wird einmal durch das Lesen von Daten aus WebGL festgelegt und höchstens einige Male als Quelle für WebGL-Zeichenbefehle und Befehle zur Bildspezifikation verwendet.
Rückgabewert
Keiner (undefined).
Ausnahmen
- Ein
gl.OUT_OF_MEMORY-Fehler wird ausgelöst, wenn der Kontext keinen Datenspeicher mit der angegebenensizeerstellen kann. - Ein
gl.INVALID_VALUE-Fehler wird ausgelöst, wennsizenegativ ist. - Ein
gl.INVALID_ENUM-Fehler wird ausgelöst, wenntargetoderusagekeiner der zulässigen Enum-Werte ist.
Beispiele
>bufferData verwenden
const canvas = document.getElementById("canvas");
const gl = canvas.getContext("webgl");
const buffer = gl.createBuffer();
gl.bindBuffer(gl.ARRAY_BUFFER, buffer);
gl.bufferData(gl.ARRAY_BUFFER, 1024, gl.STATIC_DRAW);
Buffer-Informationen abrufen
Um die aktuelle Nutzung und Größe des Buffers zu überprüfen, verwenden Sie die Methode WebGLRenderingContext.getBufferParameter().
gl.getBufferParameter(gl.ARRAY_BUFFER, gl.BUFFER_SIZE);
gl.getBufferParameter(gl.ARRAY_BUFFER, gl.BUFFER_USAGE);
Größe eines Typed Arrays ermitteln
So berechnen Sie den Parameter size für ein Typed Array.
const dataArray = new Float32Array([1, 2, 3, 4]);
const sizeInBytes = dataArray.length * dataArray.BYTES_PER_ELEMENT;
Spezifikationen
| Spezifikation |
|---|
| WebGL Specification> # 5.14.5> |