Web 图形与 3D / 系统课时

使用存储纹理批量处理像素

使用存储纹理批量处理像素

本课把逐像素颜色计算放到 GPU:创建一张 500×300 的存储纹理,让二维计算调用分别写入对应像素,再用全屏三角形将计算结果显示到 Canvas。完成后可以直接看到红色随横坐标、绿色随纵坐标变化的渐变图,并学会避免越界写入和通道间读写冲突。

学习目标

  • 正确创建同时支持计算写入和渲染采样的 rgba8unorm 纹理。
  • 把 global_invocation_id.xy 映射到二维像素坐标,并处理不足整组的边缘。
  • 串联 Compute Pass 与 Render Pass,在浏览器中验证像素输出。

存储纹理的格式与用途

普通采样纹理主要由着色器读取;存储纹理允许计算着色器用 textureStore 按整数坐标写入纹素。这里选择 rgba8unorm,每个通道 8 位,写入的浮点 RGBA 值通常取 0~1,并量化到 8 位精度。写入侧在 WGSL 中声明 texture_storage_2d<rgba8unorm, write>。

创建纹理时同时指定 GPUTextureUsage.STORAGE_BINDING | GPUTextureUsage.TEXTURE_BINDING:前者允许计算管线写入,后者允许显示管线将它当 texture_2d<f32> 采样。不能因为画布通常使用 bgra8unorm,就直接把画布交换链纹理当存储纹理写入;该格式的存储绑定需要可选设备特性,而且画布纹理还涉及自身配置的用途。独立建立一张 rgba8unorm 中间纹理更直接。相关用途与格式限制可查阅 MDN 纹理创建文档。

二维线程怎样连接到显示通道

设纹理宽 500、高 300,每组安排 @workgroup_size(8, 8),就要派发 ceil(500/8)=63 列、ceil(300/8)=38 行工作组,总共 153216 次调用。其中只有 150000 个像素有效,余下 3216 次调用通过边界检查退出。

计算着色器按二维索引写入存储纹理,显示通道再采样该纹理

计算通道中,global_invocation_id.xy 是全局像素坐标;只有 x < 500 且 y < 300 才调用 textureStore。显示通道改用采样纹理声明与 textureSample,通过全屏三角形的 UV 坐标取色。两次 Pass 按顺序编码进同一个命令缓冲区,WebGPU 负责跨通道的资源同步,无须把像素读回 CPU。

在浏览器中运行完整示例

在支持 WebGPU 的浏览器中打开 HTTPS 页面或 http://localhost 页面,按 F12 打开开发者工具的 Console,将下列完整 JavaScript 粘贴执行。脚本会创建自己的画布,不需要着色器文件或图片素材。

js
async function runStorageTextureDemo() {
  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 canvas = document.createElement("canvas");
  canvas.width = 500;
  canvas.height = 300;
  document.body.appendChild(canvas);
  const context = canvas.getContext("webgpu");
  const canvasFormat = navigator.gpu.getPreferredCanvasFormat();
  context.configure({ device, format: canvasFormat, alphaMode: "opaque" });

  // 计算通道写入,渲染通道采样;不直接写交换链纹理。
  const texture = device.createTexture({
    size: [canvas.width, canvas.height],
    format: "rgba8unorm",
    usage: GPUTextureUsage.STORAGE_BINDING | GPUTextureUsage.TEXTURE_BINDING,
  });
  const view = texture.createView();

  const computeCode = `
    @group(0) @binding(0) var dst: texture_storage_2d<rgba8unorm, write>;

    @compute @workgroup_size(8, 8)
    fn cs(@builtin(global_invocation_id) gid: vec3u) {
      let dim = textureDimensions(dst);
      // 工作组向上取整,多出的调用不可写到纹理外。
      if (gid.x >= dim.x || gid.y >= dim.y) { return; }
      let r = f32(gid.x) / f32(dim.x - 1u);
      let g = f32(gid.y) / f32(dim.y - 1u);
      textureStore(dst, vec2i(gid.xy), vec4f(r, g, 0.25, 1.0));
    }
  `;
  const renderCode = `
    struct VertexOut {
      @builtin(position) position: vec4f,
      @location(0) uv: vec2f,
    };

    @vertex fn vs(@builtin(vertex_index) i: u32) -> VertexOut {
      let corners = array<vec2f, 3>(
        vec2f(-1.0, -1.0), vec2f(3.0, -1.0), vec2f(-1.0, 3.0)
      );
      let p = corners[i];
      var out: VertexOut;
      out.position = vec4f(p, 0.0, 1.0);
      out.uv = vec2f((p.x + 1.0) * 0.5, (1.0 - p.y) * 0.5);
      return out;
    }

    @group(0) @binding(0) var src: texture_2d<f32>;
    @group(0) @binding(1) var srcSampler: sampler;

    @fragment fn fs(input: VertexOut) -> @location(0) vec4f {
      return textureSample(src, srcSampler, input.uv);
    }
  `;

  const computePipeline = device.createComputePipeline({
    layout: "auto",
    compute: {
      module: device.createShaderModule({ code: computeCode }),
      entryPoint: "cs",
    },
  });
  const renderModule = device.createShaderModule({ code: renderCode });
  const renderPipeline = device.createRenderPipeline({
    layout: "auto",
    vertex: { module: renderModule, entryPoint: "vs" },
    fragment: {
      module: renderModule,
      entryPoint: "fs",
      targets: [{ format: canvasFormat }],
    },
    primitive: { topology: "triangle-list" },
  });

  // 同一视图分别绑定到两个管线的不同资源接口。
  const computeGroup = device.createBindGroup({
    layout: computePipeline.getBindGroupLayout(0),
    entries: [{ binding: 0, resource: view }],
  });
  const renderGroup = device.createBindGroup({
    layout: renderPipeline.getBindGroupLayout(0),
    entries: [
      { binding: 0, resource: view },
      { binding: 1, resource: device.createSampler({
        magFilter: "nearest", minFilter: "nearest",
      }) },
    ],
  });

  const encoder = device.createCommandEncoder();
  const computePass = encoder.beginComputePass();
  computePass.setPipeline(computePipeline);
  computePass.setBindGroup(0, computeGroup);
  // ceil 确保右侧和底部不遗漏像素。
  const groupsX = Math.ceil(canvas.width / 8);
  const groupsY = Math.ceil(canvas.height / 8);
  computePass.dispatchWorkgroups(groupsX, groupsY);
  computePass.end();

  const renderPass = encoder.beginRenderPass({
    colorAttachments: [{
      view: context.getCurrentTexture().createView(),
      loadOp: "clear",
      clearValue: { r: 0, g: 0, b: 0, a: 1 },
      storeOp: "store",
    }],
  });
  renderPass.setPipeline(renderPipeline);
  renderPass.setBindGroup(0, renderGroup);
  renderPass.draw(3);
  renderPass.end();

  device.queue.submit([encoder.finish()]);
  await device.queue.onSubmittedWorkDone();
  console.log(`完成:${canvas.width}×${canvas.height};工作组 ${groupsX}×${groupsY}`);
}
runStorageTextureDemo().catch(console.error);

预期输出:

text
完成:500×300;工作组 63×38

画布应显示连续渐变:左上角偏暗蓝,右上角偏红,左下角偏绿,右下角偏黄绿。纹理在 GPU 内完成写入和采样;onSubmittedWorkDone() 只等待提交完成,不会将纹理内容复制到 JavaScript 内存。

验证边界与排查错误

可以把画布尺寸改为 505×305 后重新执行,日志应自动变成 完成:505×305;工作组 64×39。因为 64×8=512、39×8=312,边界外的调用仍会被跳过,图像右侧和底部不应出现黑边。若出现异常,先检查 groupsX、groupsY 与 textureDimensions 的值是否对应。

  • 纹理格式不匹配:texture_storage_2d<rgba8unorm, write> 必须对应实际 rgba8unorm 纹理,不能把着色器声明改成 bgra8unorm 却不调整设备特性和创建参数。
  • 纹理用途不足:缺少 STORAGE_BINDING 会导致计算绑定失败;缺少 TEXTURE_BINDING 会导致渲染采样绑定失败。
  • 结果空白或边缘异常:检查工作组数量是否向上取整、是否先结束 Compute Pass 再开始 Render Pass,以及输出像素坐标是否受 textureDimensions 限制。
  • 无法请求设备:确认页面是安全上下文、浏览器和图形后端支持 WebGPU,并查看 Console 中的验证错误。

实际做模糊、阈值分割或颜色反转时,可以再增加一张只读输入纹理:计算着色器用 textureLoad 读取输入、处理后写入本课的输出存储纹理,显示通道仍直接采样输出纹理。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用存储纹理批量处理像素

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

登录哪都通