在此页

• 句法
• 范例
• 规范
• 浏览器兼容性
• 另请参阅
• 相关话题

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

WebGL2RenderingContext.copyBufferSubData() 方法在 WebGL 2 API copies part of the data of a buffer to another buffer.

句法

void gl.copyBufferSubData(readTarget, writeTarget, readOffset, writeOffset, size);
					

参数

readTarget
writeTarget

A GLenum specifying the binding point (target) from whose data store should be read or written. 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 (provided specifically for copy operations).
• gl.COPY_WRITE_BUFFER : Buffer for copying from one buffer object to another (provided specifically for copy operations).
• 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.

readOffset
writeOffset

GLintptr specifying the byte offset from which to start reading from or writing to the buffer.

size

GLsizei in bytes specifying the size of the data to be copied from readTarget to writeTarget .

返回值

None.

范例

var srcBuffer = gl.createBuffer();
var dstBuffer = gl.createBuffer();
var data = new Float32Array(vertices);
var 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);
					

规范

规范	状态	注释
WebGL 2.0 The definition of 'copyBufferSubData' in that specification.	编者草案	Initial definition for WebGL.
OpenGL ES 3.0 The definition of 'glCopyBufferSubData' in that specification.	标准	Man page of the (similar) OpenGL API.

浏览器兼容性

The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.

更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
copyBufferSubData	Chrome 56	Edge 79	Firefox 51	IE No	Opera 43	Safari No	WebView Android 58	Chrome Android 58	Firefox Android 51	Opera Android 43	Safari iOS No	Samsung Internet Android 7.0

图例

完整支持

完整支持

不支持

不支持

另请参阅

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

元数据

• 最后修改： 2019 年 3 月 23 日

相关话题

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