就业培训     下载中心     Wiki     联络
登录   注册
  1. 首页
  2. Web API
  3. WebGL2RenderingContext
  4. WebGL2RenderingContext.getBufferSubData()

在此页

这是 实验性技术
检查 浏览器兼容性表格 要小心谨慎在生产中使用这之前。

WebGL2RenderingContext.getBufferSubData() 方法在 WebGL 2 API reads data from a buffer binding point and writes them to an ArrayBuffer or SharedArrayBuffer .

句法 

void gl.getBufferSubData(target, srcByteOffset, ArrayBufferView dstData, optional dstOffset, optional length);

参数

target
A GLenum 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
GLintptr specifying the byte offset from which to start reading from the buffer.
dstData
ArrayBuffer or SharedArrayBuffer to which to write the buffer data.
srcOffset 可选
GLuint specifying the element index offset where to start reading the buffer.
length 可选
GLuint defaulting to 0.

返回值

None.

异常

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.

范例 

var buffer = gl.createBuffer();
gl.bindBuffer(gl.ARRAY_BUFFER, buffer);
gl.bufferData(gl.ARRAY_BUFFER, new Float32Array(vertices), gl.STATIC_DRAW);
var arrBuffer = new ArrayBuffer(vertices.length * Float32Array.BYTES_PER_ELEMENT);
gl.getBufferSubData(gl.ARRAY_BUFFER, 0, arrBuffer);

规范

规范 状态 注释
WebGL 2.0
The definition of 'getBufferSubData' in that specification. 		编者草案 初始定义。

浏览器兼容性

更新 GitHub 上的兼容性数据
桌面 移动
Chrome Edge Firefox Internet Explorer Opera Safari Android webview Chrome for Android Firefox for Android Opera for Android Safari on iOS Samsung Internet
getBufferSubData Chrome 56 Edge 79 Firefox 51 IE No Opera Yes Safari No WebView Android 58 Chrome Android 58 Firefox Android 51 Opera Android Yes Safari iOS No Samsung Internet Android 7.0
SharedArrayBuffer as a parameter Chrome 60 Edge 79 Firefox 79 IE No Opera 47 Safari No WebView Android 60 Chrome Android 60 Firefox Android ? Opera Android 44 Safari iOS No Samsung Internet Android 8.0

图例

完整支持

完整支持

不支持

不支持

兼容性未知 ?

兼容性未知

另请参阅

元数据

  • 最后修改：
  1. WebGL API
  2. WebGL2RenderingContext
  3. 方法
    1. beginQuery()
    2. beginTransformFeedback()
    3. bindBufferBase()
    4. bindBufferRange()
    5. bindSampler()
    6. bindTransformFeedback()
    7. bindVertexArray()
    8. blitFramebuffer()
    9. clearBuffer[fiuv]()
    10. clientWaitSync()
    11. compressedTexSubImage3D()
    12. copyBufferSubData()
    13. copyTexSubImage3D()
    14. createQuery()
    15. createSampler()
    16. createTransformFeedback()
    17. createVertexArray()
    18. deleteQuery()
    19. deleteSampler()
    20. deleteSync()
    21. deleteTransformFeedback()
    22. deleteVertexArray()
    23. drawArraysInstanced()
    24. drawBuffers()
    25. drawElementsInstanced()
    26. drawRangeElements()
    27. endQuery()
    28. endTransformFeedback()
    29. fenceSync()
    30. framebufferTextureLayer()
    31. getActiveUniformBlockName()
    32. getActiveUniformBlockParameter()
    33. getActiveUniforms()
    34. getBufferSubData()
    35. getFragDataLocation()
    36. getIndexedParameter()
    37. getInternalformatParameter()
    38. getQuery()
    39. getQueryParameter()
    40. getSamplerParameter()
    41. getSyncParameter()
    42. getTransformFeedbackVarying()
    43. getUniformBlockIndex()
    44. getUniformIndices()
    45. invalidateFramebuffer()
    46. invalidateSubFramebuffer()
    47. isQuery()
    48. isSampler()
    49. isSync()
    50. isTransformFeedback()
    51. isVertexArray()
    52. pauseTransformFeedback()
    53. readBuffer()
    54. renderbufferStorageMultisample()
    55. resumeTransformFeedback()
    56. samplerParameter[if]()
    57. texImage3D()
    58. texStorage2D()
    59. texStorage3D()
    60. texSubImage3D()
    61. transformFeedbackVaryings()
    62. uniform[1234][uif][v]()
    63. uniformBlockBinding()
    64. uniformMatrix[234]x[234]fv()
    65. vertexAttribDivisor()
    66. vertexAttribI4[u]i[v]()
    67. vertexAttribIPointer()
    68. waitSync()
  4. 继承：
    1. WebGLRenderingContext
  5. WebGL 相关页面
    1. ANGLE_instanced_arrays
    2. EXT_blend_minmax
    3. EXT_color_buffer_half_float
    4. EXT_disjoint_timer_query
    5. EXT_frag_depth
    6. EXT_sRGB
    7. EXT_shader_texture_lod
    8. EXT_texture_filter_anisotropic
    9. OES_element_index_uint
    10. OES_standard_derivatives
    11. OES_texture_float
    12. OES_texture_float_linear
    13. OES_texture_half_float
    14. OES_texture_half_float_linear
    15. OES_vertex_array_object
    16. WEBGL_color_buffer_float
    17. WEBGL_compressed_texture_atc
    18. WEBGL_compressed_texture_etc1
    19. WEBGL_compressed_texture_pvrtc
    20. WEBGL_compressed_texture_s3tc
    21. WEBGL_compressed_texture_s3tc_srgb
    22. WEBGL_debug_renderer_info
    23. WEBGL_debug_shaders
    24. WEBGL_depth_texture
    25. WEBGL_draw_buffers
    26. WEBGL_lose_context
    27. WebGLActiveInfo
    28. WebGLBuffer
    29. WebGLContextEvent
    30. WebGLFramebuffer
    31. WebGLObject
    32. WebGLProgram
    33. WebGLQuery
    34. WebGLRenderbuffer
    35. WebGLRenderingContext
    36. WebGLSampler
    37. WebGLShader
    38. WebGLShaderPrecisionFormat
    39. WebGLSync
    40. WebGLTexture
    41. WebGLTransformFeedback
    42. WebGLUniformLocation
    43. WebGLVertexArrayObject