Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten.Erfahre mehr über dieses Experiment.
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 inWeb Workers verfügbar.
DieWebGL2RenderingContext.bufferSubData()-Methode derWebGL API aktualisiert einen Teil des Datenspeichers eines Pufferobjekts.
In diesem Artikel
Syntax
bufferSubData(target, dstByteOffset, srcData)bufferSubData(target, dstByteOffset, srcData, srcOffset)bufferSubData(target, dstByteOffset, srcData, srcOffset, length)Parameter
targetEin
GLenum, der den Bindungspunkt (Ziel) angibt. Mögliche Werte:gl.ARRAY_BUFFERPuffer, der Vertex-Attribute enthält, wie z. B.Vertex-Koordinaten, Texturkoordinatendaten oder Vertex-Farbdaten.
gl.ELEMENT_ARRAY_BUFFERPuffer, der für Elementindizes verwendet wird.
gl.COPY_READ_BUFFERPuffer zum Kopieren von einem Pufferobjekt zu einem anderen.
gl.COPY_WRITE_BUFFERPuffer zum Kopieren von einem Pufferobjekt zu einem anderen.
gl.TRANSFORM_FEEDBACK_BUFFERPuffer für Transform-Feedback-Operationen.
gl.UNIFORM_BUFFERPuffer, der zum Speichern von Uniform-Blöcken verwendet wird.
gl.PIXEL_PACK_BUFFERPuffer, der für Pixeltransfer-Operationen verwendet wird.
gl.PIXEL_UNPACK_BUFFERPuffer, der für Pixeltransfer-Operationen verwendet wird.
dstByteOffsetEin
GLintptr, der einen Offset in Bytes angibt, an dem der Datenaustausch beginnen soll.srcDataEin
TypedArrayoder einDataView, das einArrayBufferoderSharedArrayBufferbetrachtet,das in den Datenspeicher kopiert wird.srcOffsetOptionalEin
GLuint, der den Elementindex-Offset angibt, ab dem der Puffer gelesen werden soll.lengthOptionalEin
GLuint, der standardmäßig 0 ist, wobei 0 bedeutet, dassbufferSubDatadie Länge berechnen soll.
Rückgabewert
Keiner (undefined).
Ausnahmen
- Ein
gl.INVALID_VALUEFehler wird ausgelöst, wenn die Daten über das Ende des Puffers geschrieben würden oder wenndatanullist. - Ein
gl.INVALID_ENUMFehler wird ausgelöst, wenntargetnicht einer der erlaubten Enums ist.
Spezifikationen
| Specification |
|---|
| WebGL Specification> # 5.14.5> |