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 适配器。

html
<!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 缓冲区已经足够;需要同时保存前后两帧状态或避免覆盖仍需读取的旧数据时,再考虑双缓冲。

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

目录与阅读设置

阅读设置

17

记录一个想法

将粒子数据直接作为绘制输入

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

登录哪都通