Web 图形与 3D / 系统课时
上传顶点并绘制第一个三角形
上传顶点并绘制第一个三角形
本课用一个不依赖图形框架的 HTML 文件,把三个顶点上传到 WebGL 2 缓冲区,让 GPU 在画布上绘制蓝色三角形。完成后,你还能核对顶点坐标、属性读取、着色器输出与屏幕像素之间的对应关系。
学习目标
- 使用
Float32Array、ARRAY_BUFFER和bufferData上传三个顶点。 - 配置顶点属性与着色器,并使用
drawArrays绘制一个三角形。 - 根据画面与浏览器控制台判断绘制流程是否正确。
运行一个完整的三角形页面
新建 triangle.html,将以下内容完整保存后用支持 WebGL 2 的 Chrome、Firefox 或 Edge 打开。示例使用内联着色器,不需要依赖库或加载外部文件。
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<title>WebGL 2 三角形</title>
</head>
<body>
<canvas id="scene" width="480" height="480"></canvas>
<script>
const canvas = document.querySelector("#scene");
const gl = canvas.getContext("webgl2");
if (!gl) throw new Error("当前浏览器无法创建 WebGL 2 上下文");
const vertexSource = `#version 300 es
in vec2 a_position;
void main() {
gl_Position = vec4(a_position, 0.0, 1.0);
}`;
const fragmentSource = `#version 300 es
precision highp float;
out vec4 outColor;
void main() {
outColor = vec4(0.12, 0.48, 0.90, 1.0);
}`;
function compileShader(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)) {
const message = gl.getShaderInfoLog(shader);
gl.deleteShader(shader);
throw new Error(message || "着色器编译失败");
}
return shader;
}
const vs = compileShader(gl.VERTEX_SHADER, vertexSource);
const fs = compileShader(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);
// 三个顶点,每个顶点由 x、y 两个 32 位浮点数表示
const vertices = new Float32Array([
-0.65, -0.55,
0.65, -0.55,
0.00, 0.70
]);
const buffer = gl.createBuffer();
if (!buffer) throw new Error("创建顶点缓冲区失败");
const vao = gl.createVertexArray();
if (!vao) throw new Error("创建顶点数组对象失败");
gl.bindVertexArray(vao);
gl.bindBuffer(gl.ARRAY_BUFFER, buffer);
gl.bufferData(gl.ARRAY_BUFFER, vertices, gl.STATIC_DRAW);
// VAO 记录 a_position 从哪个缓冲区、按什么格式读取
const location = gl.getAttribLocation(program, "a_position");
if (location < 0) throw new Error("找不到 a_position 属性");
gl.vertexAttribPointer(location, 2, gl.FLOAT, false, 0, 0);
gl.enableVertexAttribArray(location);
// 清除背景后,用三个顶点组成一个 TRIANGLES 图元
gl.viewport(0, 0, gl.drawingBufferWidth, gl.drawingBufferHeight);
gl.clearColor(0.96, 0.97, 1.0, 1.0);
gl.clear(gl.COLOR_BUFFER_BIT);
gl.useProgram(program);
gl.bindVertexArray(vao);
gl.drawArrays(gl.TRIANGLES, 0, 3);
</script>
</body>
</html>预期结果:出现一块 480×480 的浅色画布,中间是顶点朝上、底边水平的蓝色三角形。浏览器开发者工具的 Console 中不应出现编译、链接或上下文创建异常。
顶点缓冲与属性读取
vertices 包含 6 个 float32 数值,共 24 字节,按每两个数为一组构成三个顶点。gl.bufferData(gl.ARRAY_BUFFER, vertices, gl.STATIC_DRAW) 将数据写入当前绑定的 GPU 缓冲区;STATIC_DRAW 是预期少量修改、多次绘制的使用提示,不代表数据永远不可更新。
gl.vertexAttribPointer(location, 2, gl.FLOAT, false, 0, 0) 的 2 表示每个顶点读取两个浮点数;两个 0 分别表示紧密排列的默认步长和从字节偏移 0 开始。enableVertexAttribArray 则打开该属性的数据数组读取。先绑定 vao 再设置属性,之后绑定这个 VAO 就能恢复对应的属性配置。
这三个位置直接写入裁剪空间,顶点着色器将其扩展为 (x, y, 0, 1)。由于 w=1,透视除法后归一化设备坐标(NDC)的 x、y 不变。以 480×480 画布为例:
| 顶点 | NDC 坐标 | 约对应的画布像素(左上角为原点) |
|---|---|---|
| 左下 | (-0.65, -0.55) | (84, 372) |
| 右下 | (0.65, -0.55) | (396, 372) |
| 上方 | (0, 0.70) | (240, 72) |
着色器如何形成可见像素
gl.drawArrays(gl.TRIANGLES, 0, 3) 从属性数组的第 0 个顶点开始读取 3 个顶点,并把它们组装成一个三角形。顶点着色器为各顶点写出 gl_Position;GPU 随后进行图元装配与光栅化,为三角形覆盖的像素生成片元;片元着色器再将 outColor 写为蓝色。gl.clearColor 设置的是未被三角形覆盖区域的背景颜色。

这里的 gl.useProgram(program) 指定绘制使用的着色器程序,gl.bindVertexArray(vao) 指定顶点属性来源,gl.drawArrays 才真正提交图元绘制调用。缺少其中任一关键状态,都可能只看到清屏背景。
验证结果与定位空白画布
先把 gl.drawArrays 的最后一个参数从 3 临时改为 2:由于 TRIANGLES 每三个顶点才构成一个完整三角形,画布将只剩浅色背景。改回 3 后图形应恢复。再把上方顶点的 0.70 改成 0.30,可观察三角形高度变小,以确认缓冲区内容确实决定几何形状。
如果原样运行仍没有图形,按顺序检查:浏览器 Console 是否报告 webgl2 上下文创建失败;着色器源代码第一行是否为 #version 300 es;顶点属性名称是否与 a_position 完全一致;绘制前是否已执行 useProgram、绑定 VAO、设置视口并清屏。着色器编译和程序链接报错应优先根据示例抛出的日志修复,而不是反复调整顶点坐标。
至此,三个顶点的数据上传、属性解码、顶点定位、片元着色和画布显示形成了可运行的最小绘制链路。