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()。片元着色器只负责给三角形涂青绿色。
<!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 的目录,执行:
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 像素,而底边不变。
画面异常时检查什么
navigator.gpu不存在:确认使用http://localhost:8000/或 HTTPS,而非依赖直接打开file://;再检查浏览器版本与 WebGPU 支持情况。- 画布有底色却没有三角形:按浏览器开发者工具的 Console 查看着色器或管线验证错误,核对
@vertex、@builtin(position)、入口名vs和pass.draw(3)。 - 位置异常或被裁剪:检查
vec4f的z是否仍在[0,1]范围、w是否为1.0,以及三个二维坐标是否落在可视范围内。不要把draw(3)改为超过数组长度的顶点数量而不同时修改着色器。
此做法适合首个三角形、全屏三角形等顶点数量很少且位置固定的图形;若顶点数据需要频繁从 CPU 更新,或网格包含大量顶点,就应改用顶点缓冲区。