Web 图形与 3D / 系统课时

串联两次 Pass 处理整屏图像

串联两次 Pass 处理整屏图像

直接把场景绘到画布后,后处理无法方便地再次读取场景颜色。这里先将彩色场景写入离屏纹理,再通过第二次 Render Pass 采样并转换为灰度,最后呈现到画布。完成后可用颜色切换和窗口缩放验证整条数据链。

学习目标

  • 创建兼具渲染目标与采样输入用途的离屏纹理。
  • 用第二次 Render Pass 的全屏三角形读取纹理并计算灰度。
  • 检查通道执行顺序、资源绑定和画布尺寸变化。

让两次 Pass 形成明确的数据依赖

第一遍渲染把彩色场景输出到离屏 GPUTexture,而不是 context.getCurrentTexture()。因为它既是颜色附件,又要在下一遍被片元着色器读取,所以 usage 必须同时包含 GPUTextureUsage.RENDER_ATTACHMENT 与 GPUTextureUsage.TEXTURE_BINDING,并用 storeOp: "store" 保留结果。

第二遍绘制一个覆盖视口的三角形,利用插值后的 UV 调用 textureSample,把灰度颜色写入画布的当前纹理。两次 Pass 在同一个 GPUCommandEncoder 中依次开始、结束,再统一 submit;不需要在 JavaScript 中把像素读回 CPU。纹理用途定义可查阅 MDN:GPUTexture.usage。

两次渲染通道通过离屏纹理传递颜色并输出灰度图像

编写可运行的灰度后处理页面

下面的 index.html 不依赖图片素材:第一遍使用 WGSL 绘制彩色渐变与圆形,第二遍按 0.2126R + 0.7152G + 0.0722B 计算灰度。两个管线使用相同的画布格式;第二个管线通过 BindGroup 绑定离屏纹理视图和采样器。

html
<!doctype html>
<html lang="zh-CN">
<meta charset="utf-8">
<title>WebGPU 双 Pass 灰度后处理</title>
<style>
  body { margin: 0; min-height: 100vh; display: grid; place-content: center; background: #eef2f5; }
  canvas { display: block; width: min(94vw, 960px); aspect-ratio: 16 / 9; }
  #status { font: 14px sans-serif; color: #334155; margin-top: 12px; }
</style>
<canvas id="view"></canvas>
<div id="status">正在初始化 WebGPU…</div>
<script type="module">
async function main() {
  if (!navigator.gpu) throw new Error("当前浏览器不支持 WebGPU");
  const adapter = await navigator.gpu.requestAdapter();
  if (!adapter) throw new Error("没有可用的 GPUAdapter");
  const device = await adapter.requestDevice();
  const canvas = document.querySelector("#view");
  const context = canvas.getContext("webgpu");
  if (!context) throw new Error("无法获取 WebGPU 画布上下文");
  const format = navigator.gpu.getPreferredCanvasFormat();
  context.configure({ device, format, alphaMode: "opaque" });

  const module = device.createShaderModule({ code: `
struct VSOut {
  @builtin(position) position: vec4f,
  @location(0) uv: vec2f,
};

@vertex
fn vs(@builtin(vertex_index) i: u32) -> VSOut {
  // 超大三角形覆盖整个屏幕,翻转 Y 使纹理 UV 从上往下增加
  var p = array<vec2f, 3>(
    vec2f(-1.0, -1.0), vec2f(3.0, -1.0), vec2f(-1.0, 3.0)
  );
  var out: VSOut;
  out.position = vec4f(p[i], 0.0, 1.0);
  out.uv = vec2f((p[i].x + 1.0) * 0.5, (1.0 - p[i].y) * 0.5);
  return out;
}

@fragment
fn scene(input: VSOut) -> @location(0) vec4f {
  let uv = input.uv;
  if (distance(uv, vec2f(0.5, 0.5)) < 0.24) {
    return vec4f(1.0, 0.3, 0.1, 1.0);
  }
  return vec4f(uv.x, uv.y, 1.0 - uv.x, 1.0);
}

@group(0) @binding(0) var source: texture_2d<f32>;
@group(0) @binding(1) var linearSampler: sampler;

@fragment
fn grayscale(input: VSOut) -> @location(0) vec4f {
  let sampled = textureSample(source, linearSampler, input.uv);
  let lum = dot(sampled.rgb, vec3f(0.2126, 0.7152, 0.0722));
  return vec4f(vec3f(lum), 1.0);
}
` });

  // 两条管线复用顶点阶段,只有第二条会读取采样纹理
  const scenePipeline = device.createRenderPipeline({
    layout: "auto",
    vertex: { module, entryPoint: "vs" },
    fragment: { module, entryPoint: "scene", targets: [{ format }] },
    primitive: { topology: "triangle-list" },
  });
  const postPipeline = device.createRenderPipeline({
    layout: "auto",
    vertex: { module, entryPoint: "vs" },
    fragment: { module, entryPoint: "grayscale", targets: [{ format }] },
    primitive: { topology: "triangle-list" },
  });
  const sampler = device.createSampler({ magFilter: "linear", minFilter: "linear" });
  let offscreen, postGroup;

  function render() {
    const dpr = Math.min(window.devicePixelRatio || 1, 2);
    const width = Math.max(1, Math.floor(canvas.clientWidth * dpr));
    const height = Math.max(1, Math.floor(canvas.clientHeight * dpr));

    if (!offscreen || canvas.width !== width || canvas.height !== height) {
      canvas.width = width;
      canvas.height = height;
      offscreen?.destroy();
      // 尺寸变化后,离屏纹理和引用它的绑定组必须同时更新
      offscreen = device.createTexture({
        size: [width, height],
        format,
        usage: GPUTextureUsage.RENDER_ATTACHMENT | GPUTextureUsage.TEXTURE_BINDING,
      });
      postGroup = device.createBindGroup({
        layout: postPipeline.getBindGroupLayout(0),
        entries: [
          { binding: 0, resource: offscreen.createView() },
          { binding: 1, resource: sampler },
        ],
      });
    }

    const encoder = device.createCommandEncoder();
    const first = encoder.beginRenderPass({
      colorAttachments: [{
        view: offscreen.createView(),
        clearValue: { r: 0, g: 0, b: 0, a: 1 },
        loadOp: "clear",
        storeOp: "store",
      }],
    });
    first.setPipeline(scenePipeline);
    first.draw(3);
    first.end();

    // 第一遍结束后,第二遍才能把它的颜色纹理当成采样输入
    const second = encoder.beginRenderPass({
      colorAttachments: [{
        view: context.getCurrentTexture().createView(),
        clearValue: { r: 0, g: 0, b: 0, a: 1 },
        loadOp: "clear",
        storeOp: "store",
      }],
    });
    second.setPipeline(postPipeline);
    second.setBindGroup(0, postGroup);
    second.draw(3);
    second.end();
    device.queue.submit([encoder.finish()]);
  }

  window.addEventListener("resize", render);
  render();
  document.querySelector("#status").textContent = "双 Pass 灰度后处理已绘制";
}
main().catch((error) => {
  document.querySelector("#status").textContent = error.message;
  console.error(error);
});
</script>
</html>

预期结果:画布出现黑白渐变背景和居中的灰色圆形,不显示第一遍的原始彩色结果;状态文字为“双 Pass 灰度后处理已绘制”。

启动页面并验证两遍确实串联

将代码保存为 index.html。在该文件所在目录运行 Python 3 的静态服务器;通过 localhost 访问可满足 WebGPU 的安全上下文要求,但浏览器与 GPU 仍须支持 WebGPU。

bash
python3 -m http.server 8000

预期输出(监听地址会因系统而不同):

text
Serving HTTP on <ADDRESS> port 8000 ...

浏览器打开 http://localhost:8000,应看到灰度图。把 grayscale 里的 return vec4f(vec3f(lum), 1.0); 临时改为 return sampled; 并刷新,应恢复彩色;再改回即可确认灰度处理只发生在第二遍。改变窗口宽度后图案仍填满画布,因为示例会同步重建离屏纹理与 BindGroup。

排查附件和采样冲突

现象 常见原因 直接修正
纹理绑定出现验证错误 创建离屏纹理时遗漏 TEXTURE_BINDING 同时设置 RENDER_ATTACHMENT 与 TEXTURE_BINDING
画面只有清屏色 第一遍未 draw(3)、未 store 或第二遍未绑定纹理 检查两次 draw(3)、storeOp: "store" 和 setBindGroup(0, postGroup)
调整尺寸后花屏或异常拉伸 离屏纹理尺寸仍为旧值,BindGroup 引用旧视图 按 canvas.width、canvas.height 重建纹理和绑定组
同一遍出现附件读写冲突 把同一个纹理同时作为颜色附件和采样输入 拆成先写后读的两个 Pass,分别结束后再提交

本例的关键验收是:第一遍只生成颜色,第二遍只读取上一遍结果并输出到画布。灰度公式直接加权所采样的 RGB;需要严格色彩管理时还须明确 sRGB 与线性颜色空间的转换。以后也可在第二遍改用多点采样实现边缘检测。

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

目录与阅读设置

阅读设置

17

记录一个想法

串联两次 Pass 处理整屏图像

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

登录哪都通