大网数据广告活动
Web 标准与前端开发

WebGL2RenderingContext: getBufferSubData() method

· 52CE 我爱测

The **`WebGL2RenderingContext.getBufferSubData()`** method of the WebGL 2 API reads data from a buffer binding point and writes them to an ArrayBuffer or SharedArrayBuffer.

WebGL

The WebGL2RenderingContext.getBufferSubData() method of the WebGL 2 API reads data from a buffer binding point and writes them to an ArrayBuffer or SharedArrayBuffer.

Syntax

getBufferSubData(target, srcByteOffset, dstData)
getBufferSubData(target, srcByteOffset, dstData, dstOffset)
getBufferSubData(target, srcByteOffset, dstData, dstOffset, length)

Parameters

  • target

    • : A WebGL_API/Types specifying the binding point (target). Possible values:
      • gl.ARRAY_BUFFER
        • : Buffer containing vertex attributes, such as vertex 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.
  • srcByteOffset

    • : A WebGL_API/Types specifying the byte offset from which to start reading from the buffer.
  • dstData

    • : A TypedArray or a DataView object to copy the data to. If dstData is a DataView then dstOffset and length are interpreted in bytes, otherwise dstData's element type is used.
  • dstOffset

    • : A WebGL_API/Types specifying the element index offset to start writing in dstData.
  • length

    • : A WebGL_API/Types specifying the number of elements to copy. If this is 0 or not specified, getBufferSubData will copy until the end of dstData.

Return value

None (undefined).

Exceptions

An INVALID_VALUE error is generated if:

  • offset + returnedData.byteLength would extend beyond the end of the buffer
  • returnedData is null
  • offset is less than zero.

An INVALID_OPERATION error is generated if:

  • zero is bound to target
  • target is TRANSFORM_FEEDBACK_BUFFER, and any transform feedback object is currently active.

Examples

const buffer = gl.createBuffer();
gl.bindBuffer(gl.ARRAY_BUFFER, buffer);
gl.bufferData(gl.ARRAY_BUFFER, new Float32Array(vertices), gl.STATIC_DRAW);

const arrBuffer = new ArrayBuffer(
  vertices.length * Float32Array.BYTES_PER_ELEMENT,
);
gl.getBufferSubData(gl.ARRAY_BUFFER, 0, new Float32Array(arrBuffer));

Specifications

Browser compatibility

See also

  • WebGLRenderingContext.bufferData()
  • WebGLRenderingContext.bufferSubData()
  • WebGLRenderingContext.getBufferParameter()
  • WebGL2RenderingContext.copyBufferSubData()

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。