Web 图形与 3D / 系统课时
校验裁剪空间与坐标约定
校验裁剪空间与坐标约定
三维模型突然消失、近处被裁掉,或远处物体反而盖住近处物体时,可以先用已知坐标的测试点核查相机、投影与深度状态。完成这套检查后,你能判断问题发生在坐标变换、裁剪边界还是深度测试,而不必反复猜测矩阵参数。
学习目标
- 说清 WebGPU 裁剪空间、透视除法和 NDC 深度范围的区别。
- 运行数值测试,验证近平面、远平面与屏幕边界。
- 根据显示异常检查矩阵方向、背面剔除和深度附件。
分清裁剪空间与屏幕坐标
以右手视空间、相机朝向 −Z 的约定为例,顶点先从模型空间经过世界、视图与投影变换。采用列向量时,变换顺序为 projection * view * model * vec4f(localPosition, 1.0);CPU 写入矩阵缓冲区的排列方式必须与 WGSL 读取方式一致。
顶点着色器输出的 @builtin(position) 是四维裁剪空间坐标 (x, y, z, w),不是像素坐标。WebGPU 的齐次裁剪范围是 −w ≤ x ≤ w、−w ≤ y ≤ w、0 ≤ z ≤ w。图元会先被裁剪,再进行透视除法,得到 $x_{ndc}=x/w$、$y_{ndc}=y/w$、$z_{ndc}=z/w$。
因此 NDC 的 x、y 都落在 −1~1,z 落在 0~1。本文使用普通深度方向:近平面对应 z=0,远平面对应 z=1;反转 Z 需要不同的投影和深度比较设置。NDC 的 y 向上,而帧缓冲以左上角为原点、y 向下。例如 800×600 的完整视口内,NDC (0, 0.5) 映射到像素位置约 (400, 150)。

这一规则与 WebGPU 坐标规范 一致。旧式 OpenGL 投影常把 NDC 深度映射为 −1~1,不能不加转换就直接移植。
用数值测试验证投影
选定垂直视场角 90°、宽高比 1、近平面 near=0.1、远平面 far=100。下面用列主序的 WebGPU 透视矩阵计算裁剪坐标;它只检查数学约定,不要求本机支持 GPU。将代码保存为 clip-check.mjs,使用 Node.js 18 或更高版本执行 node clip-check.mjs。
const near = 0.1, far = 100, aspect = 1, fovY = Math.PI / 2;
const s = 1 / Math.tan(fovY / 2);
// 列主序;相机朝 -Z,目标 NDC 深度范围为 [0, 1]
const projection = [
s / aspect, 0, 0, 0,
0, s, 0, 0,
0, 0, far / (near - far), -1,
0, 0, far * near / (near - far), 0,
];
function check([x, y, z]) {
const v = [x, y, z, 1];
const [cx, cy, cz, cw] = [0, 1, 2, 3].map(row =>
v.reduce((sum, value, col) => sum + projection[col * 4 + row] * value, 0)
);
// 必须在齐次裁剪空间内判断,不能先除 w 再裁剪
const inside = cw > 0 && -cw <= cx && cx <= cw &&
-cw <= cy && cy <= cw && 0 <= cz && cz <= cw;
return { ndc: [cx / cw, cy / cw, cz / cw], inside };
}
for (const [label, point] of [
["近平面", [0, 0, -0.1]],
["场景内", [0, 0.5, -1]],
["过近", [0, 0, -0.05]],
["远平面", [0, 0, -100]],
["过远", [0, 0, -200]],
["画面外", [2, 0, -1]],
]) {
const { ndc, inside } = check(point);
console.log(`${label}: NDC=(${ndc.map(n => n.toFixed(3)).join(", ")}), 可见=${inside}`);
}预期输出:
近平面: NDC=(0.000, 0.000, 0.000), 可见=true
场景内: NDC=(0.000, 0.500, 0.901), 可见=true
过近: NDC=(0.000, 0.000, -1.001), 可见=false
远平面: NDC=(0.000, 0.000, 1.000), 可见=true
过远: NDC=(0.000, 0.000, 1.001), 可见=false
画面外: NDC=(2.000, 0.000, 0.901), 可见=falsez=-0.05 位于近平面之前,深度为负;z=-200 超过远平面;x=2, z=-1 则超出横向边界。这里的“可见”仅表示单个测试点处于裁剪体内,三角形跨越边界时,仍可能有一部分被保留。
核对深度附件与比较方式
投影矩阵通过测试却仍出现前后遮挡错误时,检查深度纹理、管线和每帧的渲染通道是否采用同一套普通 Z约定。
| 检查项 | 建议设置 | 判断依据 |
|---|---|---|
| 投影参数 | near=0.1、far=100 |
近平面大于 0,远平面大于近平面 |
| 深度纹理 | depth24plus、尺寸匹配画布绘图像素 |
画布改变像素尺寸后须重建深度纹理 |
管线 depthStencil |
depthWriteEnabled: true、depthCompare: "less" |
深度较小的片元通过测试 |
| 通道深度附件 | depthLoadOp: "clear"、depthClearValue: 1.0、depthStoreOp: "store" |
每帧以最远深度初始化,再保存结果 |
以上是 WebGPU API 中的实际字段和值,深度纹理还需以 GPUTextureUsage.RENDER_ATTACHMENT 创建,并将视图绑定到渲染通道的 depthStencilAttachment.view。在这套矩阵下,视空间 z=-1 的深度约为 0.901,z=-2 约为 0.951;二者重叠时,启用 less 后应看到前者。若使用反转 Z,清除值与比较方向都必须随投影一起改变。
按画面症状定位问题
- 整块模型消失: 先检查视空间中心点
(0, 0, -1),其裁剪w应约为 1,NDC 深度约为 0.901。若结果不同,逐项核对相机朝向、矩阵乘法顺序、列主序上传和投影参数。临时把primitive.cullMode设为"none",可排除绕序或镜像变换造成的背面剔除。 - 靠近相机时被截断: 检查模型是否进入
z=-0.1之前的区域;近平面裁剪是正常行为。移动相机或根据场景尺度调整near,不要把near设成 0。直接从 OpenGL 移植的投影矩阵还需检查深度范围。 - 远物体遮住近物体: 确认确实存在深度附件,且每帧以 1.0 清除并使用
"less"。若远近表面几乎共面而闪烁,适当增大近平面距离、缩小远近平面比值可提高常规深度缓冲的有效精度。 - 上下颠倒或位置偏移: 检查是否把 NDC 的 y 当作像素 y,又在投影或视口变换里重复翻转;另外核对画布实际绘图尺寸,而不是只看 CSS 宽高。
若 CPU 测试的六个坐标全部符合预期,而 GPU 画面仍不正确,应优先检查上传到着色器的矩阵字节排列、渲染管线的剔除状态以及深度纹理是否真正参与当前通道。