WebGL2RenderingContext: Methode copyBufferSubData()
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.
Hinweis: Dieses Feature ist verfügbar in Web Workers.
Die WebGL2RenderingContext.copyBufferSubData()
Methode der
WebGL 2 API kopiert einen Teil der Daten eines
Buffers in einen anderen Buffer.
Syntax
copyBufferSubData(readTarget, writeTarget, readOffset, writeOffset, size)
Parameter
readTarget
,writeTarget
-
Ein
GLenum
, der den Bindungspunkt (Ziel) angibt, von dessen Datenspeicher gelesen oder geschrieben werden soll. Mögliche Werte:-
gl.ARRAY_BUFFER
: Buffer, der Vertex-Attribute enthält, wie z. B. Vertex-Koordinaten, Texturkoordinatendaten oder Vertex-Farbendaten. gl.ELEMENT_ARRAY_BUFFER
: Buffer, der für Element-Indizes verwendet wird.-
gl.COPY_READ_BUFFER
: Buffer zum Kopieren von einem Pufferobjekt zu einem anderen (speziell für Kopiervorgänge bereitgestellt). -
gl.COPY_WRITE_BUFFER
: Buffer zum Kopieren von einem Pufferobjekt zu einem anderen (speziell für Kopiervorgänge bereitgestellt). -
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-Transfer-Operationen.gl.PIXEL_UNPACK_BUFFER
: Buffer für Pixel-Transfer-Operationen.
-
readOffset
,writeOffset
-
Ein
GLintptr
, der den Byte-Offset angibt, ab dem mit dem Lesen oder Schreiben im Buffer begonnen werden soll. size
-
Ein
GLsizei
in Bytes, der die Größe der Daten angibt, die vonreadTarget
zuwriteTarget
kopiert werden sollen.
Rückgabewert
Keine (undefined
).
Beispiele
const srcBuffer = gl.createBuffer();
const dstBuffer = gl.createBuffer();
const data = new Float32Array(vertices);
const length = vertices.length * 4;
gl.bindBuffer(gl.ARRAY_BUFFER, srcBuffer);
gl.bufferData(gl.ARRAY_BUFFER, data, gl.STATIC_DRAW);
gl.bindBuffer(gl.COPY_READ_BUFFER, srcBuffer);
gl.bindBuffer(gl.ARRAY_BUFFER, dstBuffer);
gl.bufferData(gl.ARRAY_BUFFER, new Float32Array(length), gl.STATIC_DRAW);
gl.copyBufferSubData(gl.COPY_READ_BUFFER, gl.ARRAY_BUFFER, 0, 0, length);
Spezifikationen
Specification |
---|
WebGL 2.0 Specification # 3.7.3 |
Browser-Kompatibilität
BCD tables only load in the browser