WebGL2RenderingContext: bufferSubData() method

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.

Note: This feature is available inWeb Workers.

TheWebGL2RenderingContext.bufferSubData() method of theWebGL API updates a subset of a bufferobject's data store.

Syntax

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

Parameters

target

AGLenum specifying the binding point (target). Possible values:

gl.ARRAY_BUFFER: Buffer containing vertex attributes, such asvertex coordinates, texture coordinate data, or vertex color data.
gl.ELEMENT_ARRAY_BUFFER: Buffer used for element indices.
gl.COPY_READ_BUFFER: Buffer for copying from one buffer object to another.
gl.COPY_WRITE_BUFFER: Buffer for copying from one buffer object to another.
gl.TRANSFORM_FEEDBACK_BUFFER: Buffer for transform feedback operations.
gl.UNIFORM_BUFFER: Buffer used for storing uniform blocks.
gl.PIXEL_PACK_BUFFER: Buffer used for pixel transfer operations.
gl.PIXEL_UNPACK_BUFFER: Buffer used for pixel transfer operations.

dstByteOffset

AGLintptr specifying an offset in bytes where the data replacementwill start.

srcDataOptional

ATypedArray or aDataView that views anArrayBuffer orSharedArrayBufferthat will be copied into the data store.

srcOffsetOptional

AGLuint specifying the element index offset where to start readingthe buffer.

lengthOptional

AGLuint defaulting to 0, where 0 meansbufferSubData should calculate the length.

Return value

None (undefined).

Exceptions

Agl.INVALID_VALUE error is thrown if the data would be written pastthe end of the buffer or ifdata isnull.
Agl.INVALID_ENUM error is thrown iftarget is not one ofthe allowed enums.