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 绑定并清空深度。
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):
已提交带深度测试的两个三角形预期页面效果:白底画布中,橙色三角形占据重叠区域前景,青绿色三角形只在右侧和其他未被遮挡的位置显示。深度附件不会直接显示成灰度图,它是在片元测试时参与判定的 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] 深度范围。