Web 图形与 3D / 系统课时
启用深度缓冲处理物体遮挡
启用深度缓冲处理物体遮挡
当两个物体在屏幕上重叠时,最后提交绘制的物体不一定离相机最近。本课用红蓝三角形对照深度测试的开关效果,配置比较函数与每帧清除操作,并学会根据画面和 WebGL 状态定位遮挡错误。
学习目标
- 解释深度缓冲存储什么,以及
LESS怎样判定片元是否可见。 - 在 WebGL 2 中配置
DEPTH_TEST、depthFunc和深度清除。 - 复现启用与关闭深度测试的差异,排查常见遮挡异常。
深度值如何决定遮挡
深度缓冲为屏幕上的采样位置保存已有片元的深度。启用 gl.DEPTH_TEST 后,新片元须通过深度比较才可能写入颜色;在允许深度写入时,通过的片元还会更新缓冲中的深度值。绘制命令的提交顺序不直接决定谁挡住谁。
本例使用默认深度范围 0~1,并令顶点的 gl_Position.w=1,因此深度为 。红色三角形的裁剪空间 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 的浏览器打开。
<!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,正常取得深度附件时可看到:
on: test=true, less=true, bits=true
off: test=false, less=true, bits=truebits=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 调用按组互换,让蓝色先绘、红色后绘。启用深度测试时,重叠区域仍应为近处红色;关闭测试时则会随绘制顺序改为红色。这个实验可以区分真正的深度遮挡和单纯的“后画覆盖”。
对半透明对象还需要单独处理混合与排序:常见做法是先画不透明物体,再对透明物体保持深度测试、关闭深度写入并按需要排序;深度缓冲本身不会自动完成透明度合成。