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 裁剪体积与透视除法示意

这一规则与 WebGPU 坐标规范 一致。旧式 OpenGL 投影常把 NDC 深度映射为 −1~1,不能不加转换就直接移植。

用数值测试验证投影

选定垂直视场角 90°、宽高比 1、近平面 near=0.1、远平面 far=100。下面用列主序的 WebGPU 透视矩阵计算裁剪坐标;它只检查数学约定,不要求本机支持 GPU。将代码保存为 clip-check.mjs,使用 Node.js 18 或更高版本执行 node clip-check.mjs。

js
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}`);
}

预期输出:

text
近平面: 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), 可见=false

z=-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,清除值与比较方向都必须随投影一起改变。

按画面症状定位问题

  1. 整块模型消失: 先检查视空间中心点 (0, 0, -1),其裁剪 w 应约为 1,NDC 深度约为 0.901。若结果不同,逐项核对相机朝向、矩阵乘法顺序、列主序上传和投影参数。临时把 primitive.cullMode 设为 "none",可排除绕序或镜像变换造成的背面剔除。
  2. 靠近相机时被截断: 检查模型是否进入 z=-0.1 之前的区域;近平面裁剪是正常行为。移动相机或根据场景尺度调整 near,不要把 near 设成 0。直接从 OpenGL 移植的投影矩阵还需检查深度范围。
  3. 远物体遮住近物体: 确认确实存在深度附件,且每帧以 1.0 清除并使用 "less"。若远近表面几乎共面而闪烁,适当增大近平面距离、缩小远近平面比值可提高常规深度缓冲的有效精度。
  4. 上下颠倒或位置偏移: 检查是否把 NDC 的 y 当作像素 y,又在投影或视口变换里重复翻转;另外核对画布实际绘图尺寸,而不是只看 CSS 宽高。

若 CPU 测试的六个坐标全部符合预期,而 GPU 画面仍不正确,应优先检查上传到着色器的矩阵字节排列、渲染管线的剔除状态以及深度纹理是否真正参与当前通道。

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

目录与阅读设置

阅读设置

17

记录一个想法

校验裁剪空间与坐标约定

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

登录哪都通