WebGLRenderingContext：bufferData() 方法
WebGLRenderingContext.bufferData() 方法是 WebGL API 的一部分，用于初始化和创建缓冲区对象的数据存储。
语法
bufferData(target, size, usage)
bufferData(target, srcData, usage)
参数
target-
指定绑定点（目标）的
GLenum。可能的值gl.ARRAY_BUFFER-
包含顶点属性的缓冲区，例如顶点坐标、纹理坐标数据或顶点颜色数据。
gl.ELEMENT_ARRAY_BUFFER-
用于元素索引的缓冲区。
在使用 WebGL 2 上下文 时，以下值也可用
gl.COPY_READ_BUFFER-
用于从一个缓冲区对象复制到另一个缓冲区对象的缓冲区。
gl.COPY_WRITE_BUFFER-
用于从一个缓冲区对象复制到另一个缓冲区对象的缓冲区。
gl.TRANSFORM_FEEDBACK_BUFFER-
用于变换反馈操作的缓冲区。
gl.UNIFORM_BUFFER-
用于存储统一块的缓冲区。
gl.PIXEL_PACK_BUFFER-
用于像素传输操作的缓冲区。
gl.PIXEL_UNPACK_BUFFER-
用于像素传输操作的缓冲区。
size-
一个
GLsizeiptr，设置缓冲区对象数据存储的大小（以字节为单位）。 srcData可选-
一个
ArrayBuffer、SharedArrayBuffer、TypedArray或DataView，它将被复制到数据存储中。如果为null，则仍然创建数据存储，但内容未初始化且未定义。 usage-
一个
GLenum，指定数据存储的预期使用模式，用于优化目的。可能的值gl.STATIC_DRAW-
内容旨在由应用程序指定一次，并多次用作 WebGL 绘制和图像规范命令的源。
gl.DYNAMIC_DRAW-
内容旨在由应用程序重复指定，并多次用作 WebGL 绘制和图像规范命令的源。
gl.STREAM_DRAW-
内容旨在由应用程序指定一次，并最多用作 WebGL 绘制和图像规范命令的源几次。
在使用 WebGL 2 上下文 时，以下值也可用
gl.STATIC_READ-
内容旨在通过读取 WebGL 中的数据指定一次，并由应用程序多次查询。
gl.DYNAMIC_READ-
内容旨在通过重复读取 WebGL 中的数据指定，并由应用程序多次查询。
gl.STREAM_READ-
内容旨在通过读取 WebGL 中的数据指定一次，并最多由应用程序查询几次
gl.STATIC_COPY-
内容旨在通过读取 WebGL 中的数据指定一次，并多次用作 WebGL 绘制和图像规范命令的源。
gl.DYNAMIC_COPY-
内容旨在通过重复读取 WebGL 中的数据指定，并多次用作 WebGL 绘制和图像规范命令的源。
gl.STREAM_COPY-
内容旨在通过读取 WebGL 中的数据指定一次，并最多用作 WebGL 绘制和图像规范命令的源几次。
返回值
无 (undefined)。
异常
- 如果上下文无法使用给定的
size创建数据存储，则会抛出gl.OUT_OF_MEMORY错误。 - 如果
size为负数，则会抛出gl.INVALID_VALUE错误。 - 如果
target或usage不是允许的枚举之一，则会抛出gl.INVALID_ENUM错误。
示例
使用 bufferData
const canvas = document.getElementById("canvas");
const gl = canvas.getContext("webgl");
const buffer = gl.createBuffer();
gl.bindBuffer(gl.ARRAY_BUFFER, buffer);
gl.bufferData(gl.ARRAY_BUFFER, 1024, gl.STATIC_DRAW);
获取缓冲区信息
要检查当前缓冲区的使用情况和缓冲区大小，请使用 WebGLRenderingContext.getBufferParameter() 方法。
gl.getBufferParameter(gl.ARRAY_BUFFER, gl.BUFFER_SIZE);
gl.getBufferParameter(gl.ARRAY_BUFFER, gl.BUFFER_USAGE);
获取类型化数组的大小
计算类型化数组的 size 参数。
const dataArray = new Float32Array([1, 2, 3, 4]);
const sizeInBytes = dataArray.length * dataArray.BYTES_PER_ELEMENT;
规范
| 规范 |
|---|
| WebGL 规范 # 5.14.5 |
浏览器兼容性
BCD 表格仅在启用 JavaScript 的浏览器中加载。