Web 图形与 3D / 系统课时

启用深度缓冲处理物体遮挡

启用深度缓冲处理物体遮挡

当两个物体在屏幕上重叠时,最后提交绘制的物体不一定离相机最近。本课用红蓝三角形对照深度测试的开关效果,配置比较函数与每帧清除操作,并学会根据画面和 WebGL 状态定位遮挡错误。

学习目标

  • 解释深度缓冲存储什么,以及 LESS 怎样判定片元是否可见。
  • 在 WebGL 2 中配置 DEPTH_TEST、depthFunc 和深度清除。
  • 复现启用与关闭深度测试的差异,排查常见遮挡异常。

深度值如何决定遮挡

深度缓冲为屏幕上的采样位置保存已有片元的深度。启用 gl.DEPTH_TEST 后,新片元须通过深度比较才可能写入颜色;在允许深度写入时,通过的片元还会更新缓冲中的深度值。绘制命令的提交顺序不直接决定谁挡住谁。

本例使用默认深度范围 0~1,并令顶点的 gl_Position.w=1,因此深度为 d=(zndc+1)/2d=(z_{ndc}+1)/2。红色三角形的裁剪空间 z 为 -0.5,对应深度 0.25;蓝色三角形的 z 为 +0.5,对应深度 0.75。数值越小越靠近观察端。

将深度缓冲清为 1.0,再先画红色、后画蓝色:gl.depthFunc(gl.LESS) 会拒绝重叠处的蓝色片元,因为 0.75 并不小于已有的 0.25。关闭深度测试后,后画的蓝色直接覆盖相同像素处的红色。

深度测试开启与关闭时两组三角形的遮挡对比

用两个画布复现开关差异

下面的完整 index.html 不依赖第三方库。两个画布使用相同的顶点与绘制顺序,仅切换 gl.enable(gl.DEPTH_TEST) 和 gl.disable(gl.DEPTH_TEST);显式请求深度缓冲,并在绘制前把颜色和深度缓冲一起清除。将文件保存后用支持 WebGL 2 的浏览器打开。

html
<!doctype html>
<html lang="zh-CN">
<head>
  <meta charset="utf-8">
  <title>WebGL 2 深度测试</title>
  <style>
    body { font: 16px system-ui; margin: 24px; }
    .views { display: flex; flex-wrap: wrap; gap: 16px; }
    canvas { width: 360px; height: 240px; border: 1px solid #cbd5e1; }
  </style>
</head>
<body>
  <div class="views">
    <section><h2>开启深度测试</h2><canvas width="360" height="240" data-mode="on"></canvas></section>
    <section><h2>关闭深度测试</h2><canvas width="360" height="240" data-mode="off"></canvas></section>
  </div>
  <script>
    const vs = `#version 300 es
layout(location = 0) in vec3 aPosition;
void main() { gl_Position = vec4(aPosition, 1.0); }`;
    const fs = `#version 300 es
precision mediump float;
uniform vec3 uColor;
out vec4 fragColor;
void main() { fragColor = vec4(uColor, 1.0); }`;

    function compile(gl, type, source) {
      const shader = gl.createShader(type);
      gl.shaderSource(shader, source);
      gl.compileShader(shader);
      if (!gl.getShaderParameter(shader, gl.COMPILE_STATUS)) {
        throw new Error(gl.getShaderInfoLog(shader));
      }
      return shader;
    }

    function makeProgram(gl) {
      const program = gl.createProgram();
      const vertexShader = compile(gl, gl.VERTEX_SHADER, vs);
      const fragmentShader = compile(gl, gl.FRAGMENT_SHADER, fs);
      gl.attachShader(program, vertexShader);
      gl.attachShader(program, fragmentShader);
      gl.linkProgram(program);
      if (!gl.getProgramParameter(program, gl.LINK_STATUS)) {
        throw new Error(gl.getProgramInfoLog(program));
      }
      gl.deleteShader(vertexShader);
      gl.deleteShader(fragmentShader);
      return program;
    }

    const vertices = new Float32Array([
      // 近处红色:先绘制,z = -0.5
      -0.78, -0.66, -0.5,   0.32, -0.66, -0.5,  -0.23, 0.72, -0.5,
      // 远处蓝色:后绘制,z = +0.5
      -0.48, -0.66,  0.5,   0.62, -0.66,  0.5,   0.07, 0.72,  0.5
    ]);

    for (const canvas of document.querySelectorAll("canvas")) {
      const gl = canvas.getContext("webgl2", { depth: true, antialias: false });
      if (!gl) {
        canvas.insertAdjacentText("afterend", "当前浏览器不支持 WebGL 2");
        continue;
      }
      const program = makeProgram(gl);
      const vao = gl.createVertexArray();
      gl.bindVertexArray(vao);
      const vbo = gl.createBuffer();
      gl.bindBuffer(gl.ARRAY_BUFFER, vbo);
      gl.bufferData(gl.ARRAY_BUFFER, vertices, gl.STATIC_DRAW);
      gl.enableVertexAttribArray(0);
      gl.vertexAttribPointer(0, 3, gl.FLOAT, false, 0, 0);
      gl.useProgram(program);
      const color = gl.getUniformLocation(program, "uColor");

      // 默认深度测试关闭;比较规则设为“更近才通过”。
      if (canvas.dataset.mode === "on") gl.enable(gl.DEPTH_TEST);
      else gl.disable(gl.DEPTH_TEST);
      gl.depthFunc(gl.LESS);
      gl.depthMask(true);
      gl.clearDepth(1.0);
      gl.viewport(0, 0, canvas.width, canvas.height);
      gl.clearColor(0.96, 0.97, 0.99, 1.0);
      gl.clear(gl.COLOR_BUFFER_BIT | gl.DEPTH_BUFFER_BIT);

      // 固定顺序:先近红、后远蓝;只改变测试开关。
      gl.uniform3f(color, 0.90, 0.25, 0.23);
      gl.drawArrays(gl.TRIANGLES, 0, 3);
      gl.uniform3f(color, 0.16, 0.47, 0.85);
      gl.drawArrays(gl.TRIANGLES, 3, 3);

      console.log(`${canvas.dataset.mode}: test=${gl.isEnabled(gl.DEPTH_TEST)}, less=${gl.getParameter(gl.DEPTH_FUNC) === gl.LESS}, bits=${gl.getParameter(gl.DEPTH_BITS) > 0}`);
    }
  </script>
</body>
</html>

预期结果:左侧画布的重叠区域为红色,右侧画布的同一区域为蓝色;两边未重叠的部分仍能看到各自的颜色。打开浏览器开发者工具的 Console,正常取得深度附件时可看到:

text
on: test=true, less=true, bits=true
off: test=false, less=true, bits=true

bits=true 仅表示当前默认帧缓冲有非零位数的深度缓冲;具体位数取决于浏览器及图形环境,不应硬编码为 24。若返回 false,先检查上下文是否创建成功、是否请求 depth: true,以及正在绘制的帧缓冲是否具有深度附件。

逐帧设置与深度状态的职责

gl.enable(gl.DEPTH_TEST) 决定是否比较深度,gl.depthFunc(gl.LESS) 决定怎样比较,gl.depthMask(true) 决定通过测试的片元能否写入深度,gl.clearDepth(1.0) 只设置下一次清除使用的深度值。真正清掉上一帧深度的是 gl.clear(gl.DEPTH_BUFFER_BIT),通常和颜色清除放在一起。

对于每帧重新绘制的不透明 3D 场景,按示例顺序设置视口、清除颜色和深度,再提交网格。不要在两个相互遮挡的不透明网格之间清除深度,否则先绘制网格留下的遮挡信息会丢失。如果切换到自建 Framebuffer,还必须检查它是否绑定了深度渲染缓冲或深度纹理;默认画布上的深度设置不会自动替自建 Framebuffer 添加附件。

根据画面异常定位原因

现象 首先检查 修正与验证
后绘蓝色总盖住近处红色 gl.isEnabled(gl.DEPTH_TEST) 是否为 true 开启测试后重叠处应变为红色
开启测试后两个三角形都消失 gl.DEPTH_FUNC 是否误设为 GREATER,深度是否清为 1.0 恢复 LESS 与清除值 1.0;否则通常无法通过“更大”比较
下一帧物体莫名缺失 是否每帧清除深度,清除前 depthMask 是否为 true 恢复深度写入并每帧清除,排除旧深度残留
三维场景近远颠倒 顶点着色器输出的 gl_Position 与投影矩阵 检查裁剪空间的 z/w,不要靠交换绘制顺序掩盖错误
几乎共面的表面交替闪烁 两层深度值过近,发生 z-fighting 拉开几何面;确需叠加时评估 POLYGON_OFFSET_FILL

最后做一次反证:把示例中两组 uniform3f 和 drawArrays 调用按组互换,让蓝色先绘、红色后绘。启用深度测试时,重叠区域仍应为近处红色;关闭测试时则会随绘制顺序改为红色。这个实验可以区分真正的深度遮挡和单纯的“后画覆盖”。

对半透明对象还需要单独处理混合与排序:常见做法是先画不透明物体,再对透明物体保持深度测试、关闭深度写入并按需要排序;深度缓冲本身不会自动完成透明度合成。

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

目录与阅读设置

阅读设置

17

记录一个想法

启用深度缓冲处理物体遮挡

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

登录哪都通