Web 图形与 3D / 系统课时
将粒子数据直接作为绘制输入
将粒子数据直接作为绘制输入
本课让计算着色器更新的粒子位置直接进入绘制管线,不经过 CPU 回读,也不创建第二份绘制数据。完成后,你会得到一个可运行的 WebGPU 示例:200 个小三角形在画布上持续移动,共用一块 GPU 缓冲区。
学习目标
- 为同一
GPUBuffer正确组合STORAGE、VERTEX和COPY_DST用途。 - 对齐 WGSL 粒子布局与渲染管线的顶点属性、实例步进。
- 在每帧按计算通道、渲染通道的顺序提交命令并验证画面。
对齐共享缓冲区的布局与用途
只存二维位置时,每个粒子使用两个 32 位浮点数,即 vec2f,占 8 字节。200 个粒子需要 1600 字节。GPU 缓冲区使用 STORAGE | VERTEX | COPY_DST:计算着色器负责写入,绘制阶段负责读取,queue.writeBuffer() 负责初次上传。用途必须在创建时声明,不能事后添加。

渲染管线将该缓冲区解释为 float32x2 属性,arrayStride: 8,stepMode: "instance"。这样每个粒子提供一个三角形中心,三角形的三个局部顶点由着色器生成。调用 draw(3, 200),即可画出 200 个实例,而不用把位置复制或展开成 600 条顶点记录。
编写完整的计算与绘制示例
将下面代码保存为 index.html。通过本地 HTTP 服务或 HTTPS 打开页面,例如在文件所在目录运行 python3 -m http.server 8000,然后访问 http://localhost:8000。需要支持 WebGPU 的浏览器及可用的 GPU 适配器。
<!doctype html>
<html lang="zh-CN">
<meta charset="utf-8">
<title>WebGPU 粒子直绘</title>
<canvas id="screen" width="800" height="450"
style="max-width:100%;border:1px solid #aab7c4"></canvas>
<script type="module">
async function main() {
if (!navigator.gpu) throw new Error("当前环境不支持 WebGPU");
const adapter = await navigator.gpu.requestAdapter();
if (!adapter) throw new Error("未找到 WebGPU 适配器");
const device = await adapter.requestDevice();
const canvas = document.querySelector("#screen");
const context = canvas.getContext("webgpu");
if (!context) throw new Error("无法创建 WebGPU 画布上下文");
const format = navigator.gpu.getPreferredCanvasFormat();
context.configure({ device, format, alphaMode: "opaque" });
const count = 200;
const initial = new Float32Array(count * 2);
for (let i = 0; i < count; i++) {
initial[i * 2] = -0.9 + (i % 20) * 0.095;
initial[i * 2 + 1] = -0.8 + Math.floor(i / 20) * 0.17;
}
// 同一 GPUBuffer:计算写入、顶点读取、CPU 首次上传
const particles = device.createBuffer({
size: initial.byteLength,
usage: GPUBufferUsage.STORAGE |
GPUBufferUsage.VERTEX |
GPUBufferUsage.COPY_DST,
});
device.queue.writeBuffer(particles, 0, initial);
const shader = device.createShaderModule({
code: `
@group(0) @binding(0)
var<storage, read_write> positions: array<vec2f>;
@compute @workgroup_size(64)
fn update(@builtin(global_invocation_id) id: vec3u) {
// 向上取整派发后,跳过超出粒子数量的调用
if (id.x >= arrayLength(&positions)) { return; }
let p = positions[id.x];
var y = p.y + 0.004;
if (y > 1.0) { y = -1.0; }
positions[id.x] = vec2f(p.x, y);
}
@vertex
fn vs(@builtin(vertex_index) index: u32,
@location(0) center: vec2f) -> @builtin(position) vec4f {
// 每个实例读取一个中心点,三次顶点调用组成小三角形
let offsets = array<vec2f, 3>(
vec2f(-0.012, -0.015),
vec2f(0.012, -0.015),
vec2f(0.0, 0.018)
);
return vec4f(center + offsets[index], 0.0, 1.0);
}
@fragment
fn fs() -> @location(0) vec4f {
return vec4f(0.04, 0.65, 0.58, 1.0);
}
`,
});
const computePipeline = device.createComputePipeline({
layout: "auto",
compute: { module: shader, entryPoint: "update" },
});
const renderPipeline = device.createRenderPipeline({
layout: "auto",
vertex: {
module: shader,
entryPoint: "vs",
buffers: [{
arrayStride: 8,
stepMode: "instance",
attributes: [{
shaderLocation: 0,
offset: 0,
format: "float32x2",
}],
}],
},
fragment: {
module: shader,
entryPoint: "fs",
targets: [{ format }],
},
primitive: { topology: "triangle-list" },
});
const bindGroup = device.createBindGroup({
layout: computePipeline.getBindGroupLayout(0),
entries: [{ binding: 0, resource: { buffer: particles } }],
});
function frame() {
const encoder = device.createCommandEncoder();
// 先完成计算通道的编码,再编码使用同一缓冲区的渲染
const compute = encoder.beginComputePass();
compute.setPipeline(computePipeline);
compute.setBindGroup(0, bindGroup);
compute.dispatchWorkgroups(Math.ceil(count / 64));
compute.end();
const render = encoder.beginRenderPass({
colorAttachments: [{
view: context.getCurrentTexture().createView(),
clearValue: { r: 1, g: 1, b: 1, a: 1 },
loadOp: "clear",
storeOp: "store",
}],
});
render.setPipeline(renderPipeline);
render.setVertexBuffer(0, particles);
render.draw(3, count);
render.end();
device.queue.submit([encoder.finish()]);
requestAnimationFrame(frame);
}
requestAnimationFrame(frame);
}
main().catch(error => {
console.error(error);
document.body.insertAdjacentText("beforeend", error.message);
});
</script>预期结果:页面出现 20 列、10 行青绿色小三角形,它们持续向上移动,越过顶部后从底部重新出现;每帧白色背景被清空并重新绘制。位置分布固定,实际运动速度随帧率变化。
验证计算结果确实被直接绘制
本例每帧派发 ceil(200 / 64) = 4 个工作组,总计 256 次调用;其中 56 次被 arrayLength(&positions) 的边界检查跳过。之后调用 setVertexBuffer(0, particles),将刚写入的同一个缓冲区对象绑定为绘制输入。两段通道在同一命令编码器中按顺序记录,WebGPU 负责处理通道之间的资源使用同步,无须 CPU 等待或手写 GPU 内存屏障。
可以用两项小改动确认行为:暂时注释 compute.dispatchWorkgroups(...),画面中的三角形应停止移动;恢复后再次移动。若移除缓冲区的 VERTEX 用途,setVertexBuffer() 的使用将违反校验规则;若移除 STORAGE,计算管线的存储绑定将违反校验规则。验证完成后恢复全部用途标志。
对这种先计算、后绘制的单帧数据链路,一份 STORAGE | VERTEX 缓冲区已经足够;需要同时保存前后两帧状态或避免覆盖仍需读取的旧数据时,再考虑双缓冲。