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 的安全上下文。

html
<!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 帧耗时;如果锯齿来自纹理内部或着色器计算,单纯提高采样数往往收效有限。

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

目录与阅读设置

阅读设置

17

记录一个想法

开启 MSAA 改善边缘锯齿

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

登录哪都通