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 绑定离屏纹理视图和采样器。
<!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。
python3 -m http.server 8000预期输出(监听地址会因系统而不同):
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 与线性颜色空间的转换。以后也可在第二遍改用多点采样实现边缘检测。