Web 图形与 3D / 系统课时

用 WGSL 生成三角形顶点

用 WGSL 生成三角形顶点

不用创建顶点缓冲区,也能让 WebGPU 在画布上绘制三角形。方法是让 WGSL 顶点着色器利用内置的 vertex_index 依次取出三个坐标,并将其写入裁剪空间位置。完成后,你将得到一个可以在浏览器直接运行的最小绘制示例。

学习目标

  • 说明 @builtin(vertex_index) 与 @builtin(position) 分别提供什么数据。
  • 使用 draw(3) 和 WGSL 坐标数组生成三角形,不绑定顶点缓冲区。
  • 在本地启动页面,并根据三角形位置验证顶点坐标。

顶点索引如何映射到坐标

使用 triangle-list 图元拓扑时,每三个顶点组装为一个三角形。非索引绘制 pass.draw(3) 的默认起始顶点为 0,因此顶点着色器依次获得 vertex_index 值 0、1、2。它是 GPU 提供的 u32 内置输入,不需要由 JavaScript 手动传入。

vertex_index WGSL 中的二维坐标 画面位置
0 (-0.65, -0.60) 左下
1 (0.65, -0.60) 右下
2 (0.00, 0.70) 上方

@builtin(position) 是顶点阶段必须提供的裁剪空间位置。示例返回 vec4f(x, y, 0.0, 1.0):z=0 位于 WebGPU 的有效深度范围内,w=1 使透视除法后的坐标仍为原来的 x、y。归一化设备坐标中,左右边界为 x=-1 与 x=1,上下边界为 y=-1 与 y=1。

顶点索引到三角形位置的空间映射

编写最小可运行网页

将下面内容保存为 index.html。它包含 WebGPU 初始化、顶点与片元着色器、渲染管线和一次绘制提交。顶点坐标只存在于 WGSL 的固定数组中:管线没有声明 vertex.buffers,编码器也不调用 setVertexBuffer()。片元着色器只负责给三角形涂青绿色。

html
<!doctype html>
<html lang="zh-CN">
<head><meta charset="utf-8"><title>WGSL 三角形</title></head>
<body>
<canvas id="scene" width="640" height="400"></canvas>
<script type="module">
const canvas = document.querySelector("#scene");
if (!navigator.gpu) throw new Error("需要支持 WebGPU 的安全上下文");
const adapter = await navigator.gpu.requestAdapter();
if (!adapter) throw new Error("找不到可用的 GPU 适配器");
const device = await adapter.requestDevice();
const context = canvas.getContext("webgpu");
if (!context) throw new Error("无法获取 WebGPU 画布上下文");
const format = navigator.gpu.getPreferredCanvasFormat();
context.configure({ device, format, alphaMode: "opaque" });

const shaderModule = device.createShaderModule({
  code: `
@vertex
fn vs(@builtin(vertex_index) i: u32) -> @builtin(position) vec4f {
  let positions = array<vec2f, 3>(
    vec2f(-0.65, -0.60),
    vec2f( 0.65, -0.60),
    vec2f( 0.00,  0.70)
  );
  // w=1:透视除法不改变输入的 x、y。
  return vec4f(positions[i], 0.0, 1.0);
}

@fragment
fn fs() -> @location(0) vec4f {
  return vec4f(0.10, 0.80, 0.70, 1.0);
}
`
});

const pipeline = device.createRenderPipeline({
  layout: "auto",
  vertex: { module: shaderModule, entryPoint: "vs" },
  fragment: { module: shaderModule, entryPoint: "fs", targets: [{ format }] },
  primitive: { topology: "triangle-list" }
});
const encoder = device.createCommandEncoder();
const pass = encoder.beginRenderPass({
  colorAttachments: [{
    // 当前画布纹理是本次渲染的颜色附件。
    view: context.getCurrentTexture().createView(),
    clearValue: { r: 0.05, g: 0.08, b: 0.14, a: 1 },
    loadOp: "clear",
    storeOp: "store"
  }]
});
pass.setPipeline(pipeline);
pass.draw(3); // 对应三个顶点索引:0、1、2。
pass.end();
device.queue.submit([encoder.finish()]);
</script>
</body>
</html>

预期结果:页面显示宽 640、高 400 像素的深蓝色画布,中间有一个青绿色实心三角形;不会因为缺少顶点缓冲区而报错。此示例只提交一次绘制命令,不会持续播放动画,也不会主动打印控制台日志。

启动服务并验证坐标

前置条件是支持 WebGPU 的现代浏览器和 Python 3。打开终端并切换到存放 index.html 的目录,执行:

bash
python -m http.server 8000

预期结果:服务器监听本机 8000 端口,终端出现以 Serving HTTP on 开头的提示(绑定地址因系统而异)。在浏览器打开 http://localhost:8000/ 就能看到三角形;本机 localhost 属于可用于 WebGPU 的可信上下文。若系统用 python3 命名 Python 3,可将命令里的 python 替换为 python3。

验证着色器是否真的使用了数组中的坐标:把第三个位置改为 vec2f(0.00, 0.90) 并刷新。画布高 400 像素,归一化 Y 坐标增加 0.20,三角形顶点应向上移动约 40 像素,而底边不变。

画面异常时检查什么

  1. navigator.gpu 不存在:确认使用 http://localhost:8000/ 或 HTTPS,而非依赖直接打开 file://;再检查浏览器版本与 WebGPU 支持情况。
  2. 画布有底色却没有三角形:按浏览器开发者工具的 Console 查看着色器或管线验证错误,核对 @vertex、@builtin(position)、入口名 vs 和 pass.draw(3)。
  3. 位置异常或被裁剪:检查 vec4f 的 z 是否仍在 [0,1] 范围、w 是否为 1.0,以及三个二维坐标是否落在可视范围内。不要把 draw(3) 改为超过数组长度的顶点数量而不同时修改着色器。

此做法适合首个三角形、全屏三角形等顶点数量很少且位置固定的图形;若顶点数据需要频繁从 CPU 更新,或网格包含大量顶点,就应改用顶点缓冲区。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 WGSL 生成三角形顶点

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

登录哪都通