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 Bindungspunkt (Ziel) angibt. Mögliche Werte:gl.ARRAY_BUFFER-
Puffer, der Vertex-Attribute enthält, wie z. B. Vertex-Koordinaten, Texturkoordinatendaten oder Vertex-Farbdaten.
gl.ELEMENT_ARRAY_BUFFER-
Puffer, der für Elementindizes verwendet wird.
gl.COPY_READ_BUFFER-
Puffer zum Kopieren von einem Pufferobjekt zu einem anderen.
gl.COPY_WRITE_BUFFER-
Puffer zum Kopieren von einem Pufferobjekt zu einem anderen.
gl.TRANSFORM_FEEDBACK_BUFFER-
Puffer für Transform-Feedback-Operationen.
gl.UNIFORM_BUFFER-
Puffer, der zum Speichern von Uniform-Blöcken verwendet wird.
gl.PIXEL_PACK_BUFFER-
Puffer, der für Pixeltransfer-Operationen verwendet wird.
gl.PIXEL_UNPACK_BUFFER-
Puffer, der für Pixeltransfer-Operationen verwendet wird.
dstByteOffset-
Ein
GLintptr, der einen Offset in Bytes angibt, an dem der Datenaustausch beginnen soll. srcData-
Ein
TypedArrayoder einDataView, das einArrayBufferoderSharedArrayBufferbetrachtet, das in den Datenspeicher kopiert wird. srcOffsetOptional-
Ein
GLuint, der den Elementindex-Offset angibt, ab dem der Puffer gelesen werden soll. lengthOptional-
Ein
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 |