Web 图形与 3D / 系统课时

配置混合状态绘制透明物体

配置混合状态绘制透明物体

半透明模型只设置片元 Alpha,仍可能出现颜色被覆盖、前后层次错乱或物体忽隐忽现。这里使用两条 WebGPU 绘制管线,组合颜色混合、深度测试与绘制顺序,让两个相互重叠的透明色块呈现可预测的结果。

学习目标

  • 配置非预乘 Alpha 的颜色与 Alpha 通道混合因子。
  • 区分不透明与透明物体的深度写入策略。
  • 运行重叠色块示例,并通过调换绘制顺序定位透明异常。

透明颜色为什么会被覆盖

WebGPU 默认不启用颜色混合。即使片元着色器返回 vec4f(1.0, 0.4, 0.2, 0.5),只要颜色目标没有配置 blend,它仍会直接写入颜色附件,而不是让原有背景透出。

本例采用非预乘 Alpha:着色器输出的 RGB 不提前乘 Alpha。颜色混合使用 src-alpha 与 one-minus-src-alpha,例如红色 Alpha 为 0.5,叠在蓝色背景上时,输出颜色按两者各占 50% 计算。Alpha 通道单独使用 one 与 one-minus-src-alpha,避免把源 Alpha 又乘一次。

深度和颜色要分开处理:不透明物体先绘制、开启深度写入;透明物体后绘制,继续进行 less 深度测试,却关闭自身的深度写入。否则较近的透明片元可能把后绘制的远处透明片元直接剔除。

配置两类绘制管线

同一渲染通道中可以切换不同的 GPURenderPipeline。本例使用 depth24plus 深度纹理,清除值为 1;裁剪空间的深度越小,位置越近。

状态 不透明管线 透明管线
fragment.targets[0].blend 不设置 设置普通 Alpha 混合
depthStencil.depthWriteEnabled true false
depthStencil.depthCompare less less
绘制顺序 先绘制 后绘制,按远到近

透明管线的 blend.color 设置为 srcFactor: "src-alpha"、dstFactor: "one-minus-src-alpha"、operation: "add";blend.alpha 则设置为 srcFactor: "one"、dstFactor: "one-minus-src-alpha"、operation: "add"。这套组合适用于本例的非预乘颜色输出;若纹理或着色器已预乘 Alpha,颜色源因子应改为 one。可在 WebGPU 渲染管线规范 中核对这些枚举值。

不透明和透明对象的深度测试、混合状态与远近绘制顺序

运行半透明重叠示例

在支持 WebGPU 的 Chrome 或 Edge 桌面浏览器中,打开一个 HTTPS 页面或 localhost 页面,在开发者工具 Console 中执行以下完整 JavaScript。代码会添加一块 640 × 360 画布,依次绘制不透明背景、远处青色色块与近处橙色色块。三者的裁剪空间深度分别是 0.85、0.60 和 0.35。

js
(async () => {
  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 = 640;
  canvas.height = 360;
  document.body.append(canvas);
  const context = canvas.getContext("webgpu");
  const format = navigator.gpu.getPreferredCanvasFormat();
  context.configure({ device, format, alphaMode: "opaque" });

  const module = device.createShaderModule({ code: `
    struct VertexOut {
      @builtin(position) position: vec4f,
      @location(0) color: vec4f,
    }
    @vertex fn vs(@location(0) pos: vec3f,
                  @location(1) color: vec4f) -> VertexOut {
      var out: VertexOut;
      out.position = vec4f(pos, 1.0);
      out.color = color;
      return out;
    }
    @fragment fn fs(input: VertexOut) -> @location(0) vec4f {
      return input.color;
    }
  ` });

  const blend = {
    color: {
      operation: "add",
      srcFactor: "src-alpha",
      dstFactor: "one-minus-src-alpha",
    },
    alpha: {
      operation: "add",
      srcFactor: "one",
      dstFactor: "one-minus-src-alpha",
    },
  };
  function pipeline(isTransparent) {
    return device.createRenderPipeline({
      layout: "auto",
      vertex: {
        module, entryPoint: "vs",
        buffers: [{
          arrayStride: 28,
          attributes: [
            { shaderLocation: 0, offset: 0, format: "float32x3" },
            { shaderLocation: 1, offset: 12, format: "float32x4" },
          ],
        }],
      },
      fragment: {
        module, entryPoint: "fs",
        targets: [{ format, ...(isTransparent ? { blend } : {}) }],
      },
      primitive: { topology: "triangle-list" },
      depthStencil: {
        format: "depth24plus",
        depthWriteEnabled: !isTransparent,
        depthCompare: "less",
      },
    });
  }

  // 每个顶点包含位置xyz和未预乘Alpha的rgba,共28字节。
  function quad(x0, y0, x1, y1, z, rgba) {
    const corners = [
      [x0, y0], [x1, y0], [x0, y1],
      [x0, y1], [x1, y0], [x1, y1],
    ];
    const values = new Float32Array(
      corners.flatMap(([x, y]) => [x, y, z, ...rgba])
    );
    const buffer = device.createBuffer({
      size: values.byteLength,
      usage: GPUBufferUsage.VERTEX | GPUBufferUsage.COPY_DST,
    });
    device.queue.writeBuffer(buffer, 0, values);
    return buffer;
  }

  const bg = quad(-1, -1, 1, 1, 0.85, [0.14, 0.20, 0.30, 1]);
  const far = quad(-0.8, -0.5, 0.5, 0.55, 0.60, [0.08, 0.85, 0.78, 0.55]);
  const near = quad(-0.25, -0.7, 0.82, 0.28, 0.35, [1, 0.39, 0.14, 0.55]);

  const opaque = pipeline(false);
  const transparent = pipeline(true);
  const depth = device.createTexture({
    size: [canvas.width, canvas.height],
    format: "depth24plus",
    usage: GPUTextureUsage.RENDER_ATTACHMENT,
  });
  const encoder = device.createCommandEncoder();
  const pass = encoder.beginRenderPass({
    colorAttachments: [{
      view: context.getCurrentTexture().createView(),
      loadOp: "clear",
      clearValue: { r: 0, g: 0, b: 0, a: 1 },
      storeOp: "store",
    }],
    depthStencilAttachment: {
      view: depth.createView(),
      depthLoadOp: "clear",
      depthClearValue: 1,
      depthStoreOp: "store",
    },
  });
  function draw(p, buffer) {
    pass.setPipeline(p);
    pass.setVertexBuffer(0, buffer);
    pass.draw(6);
  }

  // 先让背景写入深度;两层透明物体从远到近混合。
  draw(opaque, bg);
  draw(transparent, far);
  draw(transparent, near);
  pass.end();
  device.queue.submit([encoder.finish()]);
  console.log("WebGPU 透明绘制完成");
})().catch(console.error);

预期输出(控制台):

text
WebGPU 透明绘制完成

页面可见效果:灰蓝背景上有两块半透明矩形;重叠区域同时包含青色和橙色成分,靠近观察者的橙色贡献更明显。此处画布设为 alphaMode: "opaque",因此讨论的是色块之间的 RGB 混合,不涉及页面透出。

验证错误并处理边界

  1. 把 draw(transparent, far) 与 draw(transparent, near) 交换:远处青色会在重叠区域最后参与混合,视觉层次改变。这验证普通 Alpha 混合具有顺序依赖。
  2. 再把透明管线的 depthWriteEnabled 改为 true,并保留“先近后远”的错误顺序:近处色块先写入 0.35,随后远处色块的 0.60 无法通过 less 测试,重叠处青色消失。
  3. 恢复透明深度写入为 false,并按 0.60、0.35 的顺序绘制:两层重新叠色。验证时要区分“没有通过深度测试”和“通过测试但颜色混合次序错误”。

实际项目可先绘制所有不透明几何,再将透明绘制项按相机空间的距离从远到近排序。每帧只需更新透明绘制队列的顺序,不必为了不同 Alpha 值反复重建管线。

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

目录与阅读设置

阅读设置

17

记录一个想法

配置混合状态绘制透明物体

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

登录哪都通