Web 图形与 3D / 系统课时
开启 MSAA 改善边缘锯齿
开启 MSAA 改善边缘锯齿
本课用一个可切换的 WebGPU 三角形演示普通渲染与 4x MSAA 的差异。你将创建多重采样颜色纹理、配置渲染管线,并用 resolveTarget 把结果写入画布,同时掌握接入深度缓冲和多通道渲染时必须保持一致的参数。
学习目标
- 解释 MSAA 如何改善三角形边缘,以及它不能解决的锯齿类型。
- 正确匹配管线采样数、颜色附件和
resolveTarget。 - 对比 1x 与 4x 画面,并排查采样数或尺寸不匹配的问题。
几何边缘为何出现台阶
普通渲染的颜色附件每像素只有一个采样点。斜边穿过像素时,采样点不是位于三角形内,就是位于三角形外,边缘便呈现明暗跳变。4x MSAA 为每个像素保留四个覆盖采样位置:例如四个位置中有两个被三角形覆盖,解析后的边缘像素可呈现介于前景与背景之间的颜色。
MSAA 并不是把画面宽高各扩大四倍,也通常不会让片元着色器每像素执行四次。它主要细化几何覆盖率,再将多重采样颜色解析为单采样结果。着色器内部的高频图案、闪烁的纹理和透明材质边缘,仍可能需要 Mipmap、纹理过滤或其他抗锯齿手段。

创建可切换的渲染示例
将下面内容保存为 msaa.html。示例固定绘图缓冲区为 320×180 像素,却把画布显示为 640×360 CSS 像素,并使用 image-rendering: pixelated,方便观察边缘每个像素的变化。使用支持 WebGPU 的浏览器,在本地静态服务中访问页面;例如于该文件目录执行 python3 -m http.server 8000,再打开 http://localhost:8000/msaa.html。localhost 属于允许使用 WebGPU 的安全上下文。
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<title>MSAA 对比</title>
<style>
body { font: 16px/1.5 system-ui; margin: 24px; }
canvas { display: block; width: 640px; height: 360px;
image-rendering: pixelated; }
</style>
</head>
<body>
<label><input id="enable" type="checkbox"> 开启 4x MSAA</label>
<canvas id="scene" width="320" height="180"></canvas>
<p id="status"></p>
<script type="module">
const canvas = document.querySelector("#scene");
const enable = document.querySelector("#enable");
const status = document.querySelector("#status");
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 context = canvas.getContext("webgpu");
if (!context) throw new Error("无法获取 WebGPU 上下文");
const format = navigator.gpu.getPreferredCanvasFormat();
context.configure({ device, format, alphaMode: "opaque" });
const shader = device.createShaderModule({
code: `
@vertex
fn vertexMain(@builtin(vertex_index) i: u32)
-> @builtin(position) vec4f {
let points = array<vec2f, 3>(
vec2f(-0.95, -0.88),
vec2f( 0.92, -0.71),
vec2f(-0.11, 0.89)
);
return vec4f(points[i], 0.0, 1.0);
}
@fragment
fn fragmentMain() -> @location(0) vec4f {
return vec4f(0.16, 0.83, 0.72, 1.0);
}
`
});
// 管线的采样数必须与实际绘制的颜色附件一致。
const createPipeline = (count) => device.createRenderPipeline({
layout: "auto",
vertex: { module: shader, entryPoint: "vertexMain" },
fragment: {
module: shader,
entryPoint: "fragmentMain",
targets: [{ format }]
},
primitive: { topology: "triangle-list" },
multisample: { count }
});
const plainPipeline = createPipeline(1);
const msaaPipeline = createPipeline(4);
// 多采样纹理只做渲染附件,最终画布仍为单采样。
const msaaTexture = device.createTexture({
size: [canvas.width, canvas.height],
format,
sampleCount: 4,
usage: GPUTextureUsage.RENDER_ATTACHMENT
});
function render() {
const useMSAA = enable.checked;
const canvasView = context.getCurrentTexture().createView();
const encoder = device.createCommandEncoder();
const pass = encoder.beginRenderPass({
colorAttachments: [{
view: useMSAA ? msaaTexture.createView() : canvasView,
// 只有多采样绘制才需要解析到单采样画布。
...(useMSAA ? { resolveTarget: canvasView } : {}),
loadOp: "clear",
clearValue: { r: 0.07, g: 0.10, b: 0.16, a: 1 },
storeOp: useMSAA ? "discard" : "store"
}]
});
pass.setPipeline(useMSAA ? msaaPipeline : plainPipeline);
pass.draw(3);
pass.end();
device.queue.submit([encoder.finish()]);
status.textContent = useMSAA ? "4x MSAA 已开启" : "单采样(1x)";
}
enable.addEventListener("change", render);
render();
}
main().catch((error) => {
status.textContent = error.message;
console.error(error);
});
</script>
</body>
</html>预期结果:页面显示深色背景上的青绿色斜边三角形。默认状态为“单采样(1x)”,斜边有较明显的像素台阶;勾选后显示“4x MSAA 已开启”,边缘会出现渐变的过渡像素,轮廓更平滑。由于示例只在切换时绘制,未创建逐帧重复分配的纹理。
如何核对采样与解析参数
对照下面四项即可定位多数 MSAA 校验错误:
| 检查项 | 普通 1x | 开启 4x MSAA |
|---|---|---|
multisample.count |
1 |
4 |
渲染颜色附件的 sampleCount |
画布纹理 1 |
msaaTexture 为 4 |
resolveTarget |
不设置 | 当前画布纹理视图(1) |
颜色附件 storeOp |
store |
discard,只保留解析结果 |
resolveTarget 必须与多采样附件具有相同的像素尺寸及纹理格式,但它本身的 sampleCount 必须为 1。因此,不能把 4x 管线直接用于普通画布纹理,也不能直接将 4x 纹理作为 resolveTarget。示例将多采样附件设为 discard,因为已经解析到画布,不需要保存其多采样内容。
如果场景启用了深度测试,深度附件也必须采用与颜色附件相同的采样数。例如 4x 场景的 depth24plus 深度纹理应创建为 sampleCount: 4;切回 1x 时则使用匹配的单采样深度附件,或改用不带深度的管线。
接入现有场景时注意什么
本例的绘图缓冲尺寸固定,因此 msaaTexture 只需创建一次。实际页面调整 canvas.width、canvas.height 或设备像素比后,需检查新画布纹理的实际尺寸;尺寸变化时销毁旧多采样纹理并以新尺寸重建。仅改变 CSS 宽高不会自动使多采样附件尺寸正确。
若后续要在屏幕后处理通道读取颜色,解析目标就不应直接是画布,而应换成单采样中间纹理,设置 GPUTextureUsage.RENDER_ATTACHMENT | GPUTextureUsage.TEXTURE_BINDING;主通道将 4x 结果解析到它,后处理通道通过纹理采样显示到画布。多通道若复用同一多采样附件,通常只在需要输出单采样图像的最后阶段解析,避免不必要的额外工作。
MSAA 会增加颜色和深度附件的存储与带宽开销。判断是否启用时,先在相同分辨率下比较斜线、模型轮廓与 GPU 帧耗时;如果锯齿来自纹理内部或着色器计算,单纯提高采样数往往收效有限。