Web 图形与 3D / 系统课时
用 VBO 保存位置和颜色属性
用 VBO 保存位置和颜色属性
用一个可运行的 WebGL 2 三角形示例,把位置和 RGB 颜色写入同一份 Float32Array,上传到顶点缓冲区对象(VBO),再让两个着色器输入分别读取各自的字段。完成后,你会得到红、绿、蓝三个顶点之间平滑过渡的三角形,并能检查字节步长与偏移量是否正确。
学习目标
- 创建并绑定 VBO,通过
bufferData上传顶点数据。 - 使用
vertexAttribPointer正确设置位置和颜色的读取规则。 - 区分交错布局与分离布局,定位常见的属性错位问题。
先确定一个顶点占多少字节
本例采用交错布局:每个顶点连续存放 3 个位置分量 x、y、z 和 3 个颜色分量 r、g、b。位置直接作为裁剪空间坐标使用,z=0;颜色分量取值为 0~1。三个顶点一共包含 3 × 6 = 18 个 float32,每个占 4 字节,因此 VBO 上传数据总量为 72 字节。
vertexAttribPointer(index, size, type, normalized, stride, offset) 中,stride 是从一个顶点的同类属性走到下一个顶点同类属性的字节距离;offset 是当前属性在缓冲区起始处的字节偏移,不是浮点数下标。
| 着色器属性 | size |
stride |
offset |
|---|---|---|---|
aPosition(位置) |
3 | 24 字节 | 0 字节 |
aColor(颜色) |
3 | 24 字节 | 12 字节 |

上传缓冲区并绘制三角形
把下面代码保存为 index.html,使用支持 WebGL 2 的浏览器打开;按 F12 打开开发者工具的 Console 查看输出。示例用 WebGL 2 的 #version 300 es 着色器和显式属性位置 0、1,因此不依赖属性名称的自动分配顺序。
<!doctype html>
<html lang="zh-CN">
<head><meta charset="utf-8"><title>WebGL 2 VBO 示例</title></head>
<body>
<canvas id="view" width="640" height="360"></canvas>
<script>
const canvas = document.getElementById("view");
const gl = canvas.getContext("webgl2");
if (!gl) throw new Error("当前环境无法创建 WebGL 2 上下文");
const vertexSource = `#version 300 es
layout(location = 0) in vec3 aPosition;
layout(location = 1) in vec3 aColor;
out vec3 vColor;
void main() {
gl_Position = vec4(aPosition, 1.0);
vColor = aColor;
}`;
const fragmentSource = `#version 300 es
precision highp float;
in vec3 vColor;
out vec4 outColor;
void main() {
outColor = vec4(vColor, 1.0);
}`;
function compile(type, source) {
const shader = gl.createShader(type);
if (!shader) throw new Error("无法创建着色器");
gl.shaderSource(shader, source);
gl.compileShader(shader);
if (!gl.getShaderParameter(shader, gl.COMPILE_STATUS)) {
throw new Error(gl.getShaderInfoLog(shader) || "着色器编译失败");
}
return shader;
}
const vs = compile(gl.VERTEX_SHADER, vertexSource);
const fs = compile(gl.FRAGMENT_SHADER, fragmentSource);
const program = gl.createProgram();
if (!program) throw new Error("无法创建程序");
gl.attachShader(program, vs);
gl.attachShader(program, fs);
gl.linkProgram(program);
if (!gl.getProgramParameter(program, gl.LINK_STATUS)) {
throw new Error(gl.getProgramInfoLog(program) || "程序链接失败");
}
gl.deleteShader(vs);
gl.deleteShader(fs);
// 每行是一个顶点:位置 xyz,随后是颜色 rgb。
const vertices = new Float32Array([
-0.65, -0.60, 0, 1, 0, 0,
0.65, -0.60, 0, 0, 1, 0,
0.00, 0.70, 0, 0, 0, 1
]);
const vao = gl.createVertexArray();
const vbo = gl.createBuffer();
if (!vao || !vbo) throw new Error("无法创建 VAO 或 VBO");
gl.bindVertexArray(vao);
gl.bindBuffer(gl.ARRAY_BUFFER, vbo);
gl.bufferData(gl.ARRAY_BUFFER, vertices, gl.STATIC_DRAW);
// 步长与偏移量均以字节为单位;VAO 记录两项属性配置。
const stride = 6 * Float32Array.BYTES_PER_ELEMENT;
gl.vertexAttribPointer(0, 3, gl.FLOAT, false, stride, 0);
gl.enableVertexAttribArray(0);
gl.vertexAttribPointer(1, 3, gl.FLOAT, false, stride,
3 * Float32Array.BYTES_PER_ELEMENT);
gl.enableVertexAttribArray(1);
gl.bindVertexArray(null);
gl.viewport(0, 0, gl.drawingBufferWidth, gl.drawingBufferHeight);
gl.clearColor(1, 1, 1, 1);
gl.clear(gl.COLOR_BUFFER_BIT);
gl.useProgram(program);
gl.bindVertexArray(vao);
gl.drawArrays(gl.TRIANGLES, 0, 3);
console.log(`上传字节数=${vertices.byteLength},步长=${stride}`);
</script>
</body>
</html>预期结果:白色画布上出现一个三角形,左下角红色、右下角绿色、上方蓝色,内部颜色平滑过渡。Console 输出:
上传字节数=72,步长=24这里 gl.STATIC_DRAW 表示数据预计很少修改,是上传用途提示,不是“禁止以后更新”的限制。gl.vertexAttribPointer 会把调用时绑定的 ARRAY_BUFFER 关联到相应属性;VAO 保存属性启用状态、格式以及缓冲区关联。绘制前重新绑定 VAO,即可复用这些设置。
交错布局与分离布局怎么选
交错布局将一个顶点用到的位置、颜色相邻存放,适合本例这种一起上传、一起绘制的数据。另一种分离布局是在一个位置 VBO 中连续存放所有 xyz,在另一个颜色 VBO 中连续存放所有 rgb。本例拆分后,每个缓冲区各有 3 × 3 × 4 = 36 字节。
| 对比项 | 交错布局 | 分离布局 |
|---|---|---|
| VBO 数量 | 1 个 | 2 个 |
| 位置属性 | stride=24, offset=0 |
stride=0, offset=0 |
| 颜色属性 | stride=24, offset=12 |
stride=0, offset=0 |
| 典型选择 | 位置和颜色一起更新 | 颜色频繁改变、位置保持不变 |
分离布局设置属性时,要在配置位置属性前绑定位置 VBO,在配置颜色属性前绑定颜色 VBO;stride=0 表示按该属性类型和分量数紧密排列,并非不移动读取位置。两种布局的图形结果相同,区别在存储组织和更新粒度。
按字节检查属性错位
如果画面出现单色三角形、顶点位置异常或完全空白,先核对数据本身,再检查属性读取设置:
- 确认
vertices.length为 18、vertices.byteLength为 72;位置与颜色每组各 3 个浮点数。 - 核对
size=3、type=gl.FLOAT;交错布局的两个属性都必须使用 24 字节步长。 - 核对颜色
offset=12而不是3;stride和offset都以字节计,错误值可能造成对齐错误或读到其他字段。 - 确认属性
0、1都调用了enableVertexAttribArray,并在绘制前绑定已经配置好的 VAO;未启用颜色属性时,着色器读取的是常量属性值,无法得到三个顶点的 RGB 渐变。 - 若屏幕仍为空白,检查 Console 是否报着色器编译或程序链接错误,并确认调用顺序为上传数据、配置属性、使用程序、绑定 VAO、绘制。
用上述三顶点的 72 字节数据和 24/12 字节配置作为基准,可以先排除缓冲区布局错误,再处理后续更复杂的纹理坐标、法线或索引网格。