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

View in English Always switch to English

WebGL2RenderingContext: bufferData()-Methode

Baseline
Weitgehend verfügbar
*

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

* Einige Teile dieser Funktion werden möglicherweise unterschiedlich gut unterstützt.

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

Die Methode WebGL2RenderingContext.bufferData() der WebGL-API erstellt und initialisiert den Datenspeicher eines Buffer-Objekts.

Syntax

js
bufferData(target, size, usage)
bufferData(target, srcData, usage)
bufferData(target, srcData, usage, srcOffset)
bufferData(target, srcData, usage, srcOffset, length)

Parameter

target

Ein GLenum, der den Bindungspunkt (Target) angibt. Mögliche Werte:

gl.ARRAY_BUFFER

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

gl.ELEMENT_ARRAY_BUFFER

Buffer für Elementindizes.

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übertragungsoperationen.

gl.PIXEL_UNPACK_BUFFER

Buffer für Pixelübertragungsoperationen.

size Optional

Ein GLsizeiptr, der die Größe des Datenspeichers des Buffer-Objekts in Byte festlegt. Entweder size oder srcData muss angegeben werden. Der Datenspeicher wird mit Nullen initialisiert.

srcData Optional

Ein TypedArray oder eine DataView, das bzw. die eine Sicht auf einen ArrayBuffer oder SharedArrayBuffer bereitstellt. Die Daten werden in den Datenspeicher kopiert. Entweder size oder srcData muss angegeben werden.

usage

Ein GLenum, der das vorgesehene Nutzungsmuster des Datenspeichers zu Optimierungszwecken angibt. Mögliche Werte:

gl.STATIC_DRAW

Der Inhalt soll von der Anwendung einmal festgelegt und vielfach als Quelle für WebGL-Zeichenbefehle und Befehle zur Bilddefinition verwendet werden.

gl.DYNAMIC_DRAW

Der Inhalt soll von der Anwendung wiederholt neu festgelegt und vielfach als Quelle für WebGL-Zeichenbefehle und Befehle zur Bilddefinition verwendet werden.

gl.STREAM_DRAW

Der Inhalt soll von der Anwendung einmal festgelegt und höchstens einige Male als Quelle für WebGL-Zeichenbefehle und Befehle zur Bilddefinition verwendet werden.

gl.STATIC_READ

Der Inhalt soll einmal durch das Lesen von Daten aus WebGL festgelegt und von der Anwendung vielfach abgefragt werden.

gl.DYNAMIC_READ

Der Inhalt soll wiederholt durch das Lesen von Daten aus WebGL neu festgelegt und von der Anwendung vielfach abgefragt werden.

gl.STREAM_READ

Der Inhalt soll einmal durch das Lesen von Daten aus WebGL festgelegt und von der Anwendung höchstens einige Male abgefragt werden.

gl.STATIC_COPY

Der Inhalt soll einmal durch das Lesen von Daten aus WebGL festgelegt und vielfach als Quelle für WebGL-Zeichenbefehle und Befehle zur Bilddefinition verwendet werden.

gl.DYNAMIC_COPY

Der Inhalt soll wiederholt durch das Lesen von Daten aus WebGL neu festgelegt und vielfach als Quelle für WebGL-Zeichenbefehle und Befehle zur Bilddefinition verwendet werden.

gl.STREAM_COPY

Der Inhalt soll einmal durch das Lesen von Daten aus WebGL festgelegt und höchstens einige Male als Quelle für WebGL-Zeichenbefehle und Befehle zur Bilddefinition verwendet werden.

srcOffset Optional

Ein GLuint, der den Elementindex angibt, ab dem der Buffer gelesen wird. Nur zulässig, wenn srcData angegeben ist.

length Optional

Ein GLuint mit dem Standardwert 0. Nur zulässig, wenn srcOffset angegeben ist.

Rückgabewert

Keiner (undefined).

Ausnahmen

  • Ein gl.OUT_OF_MEMORY-Fehler wird ausgelöst, wenn der Kontext keinen Datenspeicher mit der angegebenen size erstellen kann.
  • Ein gl.INVALID_VALUE-Fehler wird ausgelöst, wenn size negativ ist.
  • Ein gl.INVALID_ENUM-Fehler wird ausgelöst, wenn target oder usage keiner der zulässigen Enum-Werte ist.

Spezifikationen

Spezifikation
WebGL Specification
# 5.14.5

Browser-Kompatibilität

Siehe auch