Web 图形与 3D / 系统课时

配置深度缓冲处理遮挡

配置深度缓冲处理遮挡

本课用两个相互重叠的三角形配置 WebGPU 深度缓冲:先绘制近处的橙色三角形,再绘制远处的青绿色三角形。完成后,重叠区域仍会显示近处颜色,你还可以通过修改深度比较规则验证遮挡确实由深度测试决定。

学习目标

  • 创建与画布尺寸一致的 depth24plus 深度纹理,并挂载到渲染通道。
  • 为图形管线开启深度测试和写入,理解 less 比较规则。
  • 用绘制顺序和深度值的对照实验检查遮挡是否正确。

深度值如何决定遮挡

如果只有颜色附件,后绘制的片元通常会覆盖先前的颜色;这无法表达三维场景的远近。深度附件则为每个像素保存当前通过测试的深度。以下示例的顶点直接位于裁剪空间且 w=1,因此顶点的 z 就是归一化深度:0 靠近观察者,1 远离观察者。

我们把橙色三角形设为 z=0.2,青绿色三角形设为 z=0.7。每帧先将深度清为 1.0,并使用 depthCompare: 'less':橙色通过测试并写入 0.2;之后青绿色即使在重叠位置提交得更晚,也因为 0.7 < 0.2 不成立而不能覆盖橙色。未重叠的区域仍会正常显示青绿色。

两个三角形重叠时的逐像素深度比较

创建深度纹理并提交绘制

在支持 WebGPU 的浏览器中,打开一个 HTTPS 页面或本机 localhost 页面,将下面完整的 JavaScript 粘贴到开发者工具的 Console 执行。代码会创建 640×360 画布,无须已有项目。示例用 vertex_index 在着色器里生成顶点,避免无关的网格加载代码。深度设置分布在三个位置:纹理使用 depth24plus 和 RENDER_ATTACHMENT;管线设置深度写入与比较;渲染通道通过 depthStencilAttachment 绑定并清空深度。

js
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.createElement("canvas");
  canvas.width = 640;
  canvas.height = 360;
  canvas.style.cssText = "display:block;width:640px;height:360px;margin:16px auto;border:1px solid #ccd5dd";
  document.body.prepend(canvas);
  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: `
    struct VertexOut {
      @builtin(position) position: vec4f,
      @location(0) color: vec3f,
    };
    @vertex fn vs(@builtin(vertex_index) i: u32) -> VertexOut {
      let positions = array<vec3f, 6>(
        vec3f(-0.60, -0.55, 0.2),
        vec3f( 0.65, -0.55, 0.2),
        vec3f( 0.00,  0.75, 0.2),
        vec3f(-0.15, -0.75, 0.7),
        vec3f( 0.92, -0.50, 0.7),
        vec3f( 0.35,  0.90, 0.7)
      );
      var out: VertexOut;
      out.position = vec4f(positions[i], 1.0);
      out.color = vec3f(0.08, 0.60, 0.63);
      if (i < 3u) { out.color = vec3f(0.95, 0.47, 0.25); }
      return out;
    }
    @fragment fn fs(@location(0) color: vec3f) -> @location(0) vec4f {
      return vec4f(color, 1.0);
    }
  ` });

  const depthTexture = device.createTexture({
    size: [canvas.width, canvas.height],
    format: "depth24plus",
    usage: GPUTextureUsage.RENDER_ATTACHMENT
  });
  const pipeline = device.createRenderPipeline({
    layout: "auto",
    vertex: { module: shader, entryPoint: "vs" },
    fragment: { module: shader, entryPoint: "fs", targets: [{ format }] },
    primitive: { topology: "triangle-list" },
    depthStencil: {
      format: "depth24plus",
      depthWriteEnabled: true,
      depthCompare: "less"
    }
  });

  const encoder = device.createCommandEncoder();
  const pass = encoder.beginRenderPass({
    colorAttachments: [{
      view: context.getCurrentTexture().createView(),
      clearValue: { r: 1, g: 1, b: 1, a: 1 },
      loadOp: "clear", storeOp: "store"
    }],
    depthStencilAttachment: {
      view: depthTexture.createView(),
      depthClearValue: 1.0,
      depthLoadOp: "clear",
      depthStoreOp: "store"
    }
  });
  pass.setPipeline(pipeline);
  // 先画 z=0.2 的近处,再画 z=0.7 的远处。
  pass.draw(3, 1, 0);
  pass.draw(3, 1, 3);
  pass.end();
  device.queue.submit([encoder.finish()]);
  console.log("已提交带深度测试的两个三角形");
}

main().catch(console.error);

预期输出(Console):

text
已提交带深度测试的两个三角形

预期页面效果:白底画布中,橙色三角形占据重叠区域前景,青绿色三角形只在右侧和其他未被遮挡的位置显示。深度附件不会直接显示成灰度图,它是在片元测试时参与判定的 GPU 纹理。

验证比较规则与绘制顺序

先保持 depthCompare: 'less',观察橙色前景。随后只将比较规则改为 depthCompare: 'always',重新执行代码:由于所有片元都通过,后绘制的青绿色会盖住重叠区域的橙色。恢复为 less 后,橙色应重新位于前景。每次执行都会在页面顶部新增一个画布,比较最新画布即可。

再交换两条 pass.draw 的顺序:先调用 pass.draw(3, 1, 3),再调用 pass.draw(3, 1, 0)。启用 less 时重叠区域仍应保持橙色;第三个参数 firstVertex 控制读取的起始顶点索引。

处理尺寸变化与常见失败

深度纹理尺寸必须与当前颜色附件的渲染区域兼容,且与颜色附件使用相同的采样数。示例固定在 640×360、单采样场景;实际应用若修改了 canvas.width 或 canvas.height,需要销毁旧深度纹理并按新绘图缓冲尺寸创建新纹理,否则可能出现附件尺寸不匹配或渲染不完整。

如果深度测试似乎无效,按顺序检查:管线与深度纹理的 format 是否同为 depth24plus;RenderPass 是否确实绑定深度视图;每帧是否使用 depthLoadOp: 'clear' 和 depthClearValue: 1.0;顶点在透视除法后的深度是否位于 WebGPU 的 [0,1] 范围。不要直接套用旧 OpenGL 的 [-1,1] 深度范围。

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

目录与阅读设置

阅读设置

17

记录一个想法

配置深度缓冲处理遮挡

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

登录哪都通