Web 图形与 3D / 系统课时

上传顶点并绘制第一个三角形

上传顶点并绘制第一个三角形

本课用一个不依赖图形框架的 HTML 文件,把三个顶点上传到 WebGL 2 缓冲区,让 GPU 在画布上绘制蓝色三角形。完成后,你还能核对顶点坐标、属性读取、着色器输出与屏幕像素之间的对应关系。

学习目标

  • 使用 Float32Array、ARRAY_BUFFER 和 bufferData 上传三个顶点。
  • 配置顶点属性与着色器,并使用 drawArrays 绘制一个三角形。
  • 根据画面与浏览器控制台判断绘制流程是否正确。

运行一个完整的三角形页面

新建 triangle.html,将以下内容完整保存后用支持 WebGL 2 的 Chrome、Firefox 或 Edge 打开。示例使用内联着色器,不需要依赖库或加载外部文件。

html
<!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 设置的是未被三角形覆盖区域的背景颜色。

从顶点数组到三角形像素的 WebGL 2 绘制数据流

这里的 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、设置视口并清屏。着色器编译和程序链接报错应优先根据示例抛出的日志修复,而不是反复调整顶点坐标。

至此,三个顶点的数据上传、属性解码、顶点定位、片元着色和画布显示形成了可运行的最小绘制链路。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

上传顶点并绘制第一个三角形

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通