Monogame + HLSL Fisheye Vertex Shader 深度值计算与遮挡错误问询
深度错误的核心原因
遮挡关系反转本质是深度映射不满足「距离越远深度值越大」的单调要求,具体有3处直接错误:
- 距离计算逻辑完全错误:
distance3d函数错把裁剪空间的w分量当作z参与三维运算,且输入是经过透视变换的非线性裁剪坐标,计算结果不代表真实空间距离。 - 深度计算依赖投影后坐标:鱼眼仅需要修改屏幕映射的XY分量,深度必须独立计算;原代码的距离依赖投影后的XY,调整鱼眼投影时会连带破坏深度值。
- 存在非法变量:未定义的
square直接参与Z分量计算,进一步导致输出深度异常。
正确实现逻辑
鱼眼属于非针孔投影,仅需要替换常规透视的XY屏幕映射规则,深度ZW分量必须独立基于视图空间位置计算,同时满足两个核心要求:
- 视锥内顶点的深度值随到相机的距离单调递增
- 近裁剪面深度为0,远裁剪面深度为1,符合常规NDC深度约定
所有空间位置、角度、距离计算都要在视图空间完成,禁止使用投影后的裁剪坐标计算真实空间距离。
实现步骤
- 将顶点依次变换到世界空间、视图空间,作为所有计算的基础
- 根据选用的鱼眼模型(如常用的等距f-θ模型),独立计算裁剪空间XY分量
- 基于视图空间的轴向线性深度,推导符合要求的裁剪空间Z、W分量
- 组装XY、Z、W为最终的裁剪空间顶点
HLSL参考代码
以下以工业界最常用的等距f-θ鱼眼为例,深度采用和常规透视一致的轴向深度,遮挡逻辑和普通透视投影完全一致:
// 外部传入的全局参数,建议直接传值,不要硬编码矩阵索引避免行列主序问题 float focalLength; float fov; float nearPlane; float farPlane; VOut VS(VIn input) { VOut output = (VOut)0; // 坐标变换到视图空间(行主序矩阵+行向量乘法写法) float4 worldPos = mul(input.Position, World); float4 viewPos = mul(worldPos, View); // -------------------------- // 1. 计算鱼眼投影XY(等距f-θ模型,可替换为其他鱼眼规则) // -------------------------- float radialLength = length(viewPos.xyz); float3 viewDir = viewPos.xyz / radialLength; // 视线与相机光轴(相机看向-Z轴)的夹角,clamp消除浮点精度误差 float cosTheta = clamp(-viewDir.z, -1.0f, 1.0f); float theta = acos(cosTheta); // 焦距缩放系数,和原矩阵的缩放规则完全对齐 float focalScale = -focalLength * sin(-fov); float clipRadius = focalScale * theta; // XY平面径向方向,处理相机原点的边界异常 float2 xyDir = radialLength > 1e-6f ? viewPos.xy / length(viewPos.xy) : float2(0.0f, 0.0f); float2 clipXY = xyDir * clipRadius; // -------------------------- // 2. 计算正确的深度ZW分量 // -------------------------- // 沿相机光轴的线性深度:近面等于nearPlane,远面等于farPlane // 需要物理径向深度时,直接替换为 radialLength 即可,映射公式不变 float linearDepth = -viewPos.z; // 裁剪空间W和常规透视保持一致,视锥内恒为正 float clipW = linearDepth; // 裁剪空间Z:保证 clipZ / clipW 近面为0、远面为1,且严格单调递增 float clipZ = farPlane * (linearDepth - nearPlane) / (farPlane - nearPlane); // 组装最终裁剪空间坐标 output.Position = float4(clipXY, clipZ, clipW); // 其余顶点输出(UV、颜色等)照常处理 // ... return output; }
关键注意事项
- 深度基准选择:默认用轴向深度
-viewPos.z即可保证遮挡逻辑和普通透视完全一致;需要匹配鱼眼径向物理属性时,直接替换linearDepth为径向长度即可,映射公式无需修改。 - 矩阵布局匹配:如果引擎用列主序传入矩阵,需要调换
mul参数顺序(如mul(World, input.Position)),校验标准是:相机正前方的点,视图空间Z值为负数。 - 不要硬编码矩阵分量:投影矩阵索引受行/列主序、API符号约定影响很大,直接传入near、far参数计算容错率更高,也更易调试。
- 视锥内顶点的
linearDepth恒为正,不需要额外做符号翻转;视锥外的负W顶点会被硬件自动裁剪。 - 如果需要复用常规透视的XY缩放逻辑,也可以先乘投影矩阵提取XY,但ZW必须重新基于视图空间计算,不能复用投影后的Z、W值。
- 常规深度测试默认使用
LESS/LESS_EQUAL规则(深度值越小越靠近相机),上述映射完全符合规则,不会出现遮挡反转。
内容的提问来源于stack exchange,提问作者JamesMusicus
相关产品推荐
相关产品推荐

