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
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.
sizeOptional-
Ein
GLsizeiptr, der die Größe des Datenspeichers des Buffer-Objekts in Byte festlegt. EntwedersizeodersrcDatamuss angegeben werden. Der Datenspeicher wird mit Nullen initialisiert. srcDataOptional-
Ein
TypedArrayoder eineDataView, das bzw. die eine Sicht auf einenArrayBufferoderSharedArrayBufferbereitstellt. Die Daten werden in den Datenspeicher kopiert. EntwedersizeodersrcDatamuss 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.
srcOffsetOptional-
Ein
GLuint, der den Elementindex angibt, ab dem der Buffer gelesen wird. Nur zulässig, wennsrcDataangegeben ist. lengthOptional-
Ein
GLuintmit dem Standardwert 0. Nur zulässig, wennsrcOffsetangegeben ist.
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.
Spezifikationen
| Spezifikation |
|---|
| WebGL Specification> # 5.14.5> |