WebGL2RenderingContext: bufferSubData() Methode

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨September 2021⁩.

* Some parts of this feature may have varying levels of support.

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

Die WebGL2RenderingContext.bufferSubData()-Methode der WebGL API aktualisiert einen Teil des Datenspeichers eines Pufferobjekts.

Syntax

bufferSubData(target, dstByteOffset, srcData)
bufferSubData(target, dstByteOffset, srcData, srcOffset)
bufferSubData(target, dstByteOffset, srcData, srcOffset, length)

Parameter

target

Ein GLenum, der den Bindepunkt (Ziel) angibt. Mögliche Werte:

gl.ARRAY_BUFFER: Puffer, der Vertex-Attribute enthält, wie z.B. Vertex-Koordinaten, Texturkoordinatendaten oder Vertex-Farbwerte.
gl.ELEMENT_ARRAY_BUFFER: Puffer, der für Elementindizes verwendet wird.
gl.COPY_READ_BUFFER: Puffer für das Kopieren von einem Pufferobjekt zu einem anderen.
gl.COPY_WRITE_BUFFER: Puffer für das Kopieren von einem Pufferobjekt zu einem anderen.
gl.TRANSFORM_FEEDBACK_BUFFER: Puffer für Transform-Feedback-Operationen.
gl.UNIFORM_BUFFER: Puffer, der für die Speicherung von Uniform-Blöcken verwendet wird.
gl.PIXEL_PACK_BUFFER: Puffer, der für Pixelübertragungsoperationen verwendet wird.
gl.PIXEL_UNPACK_BUFFER: Puffer, der für Pixelübertragungsoperationen verwendet wird.

dstByteOffset

Ein GLintptr, der einen Versatz in Bytes angibt, an dem der Datenaustausch beginnen wird.

srcData Optional

Ein TypedArray oder ein DataView, das einen ArrayBuffer oder SharedArrayBuffer ansieht, der in den Datenspeicher kopiert wird.

srcOffset Optional

Ein GLuint, der den Elementindexversatz angibt, ab dem der Puffer gelesen werden soll.

length Optional

Ein GLuint mit der Voreinstellung 0, wobei 0 bedeutet, dass bufferSubData die Länge berechnen soll.

Rückgabewert

Keiner (undefined).

Ausnahmen

Ein gl.INVALID_VALUE-Fehler wird ausgelöst, wenn die Daten über das Ende des Puffers hinaus geschrieben würden oder wenn data null ist.
Ein gl.INVALID_ENUM-Fehler wird ausgelöst, wenn target nicht einer der erlaubten Enums ist.

Spezifikationen

Specification
WebGL Specification # 5.14.5

Browser-Kompatibilität

Siehe auch

Help improve MDN

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden