CesiumJS深度测试失效问题分析与修复

问题现象

在CesiumJS 1.123版本中，用户报告了一个关于深度测试失效或Z-fighting的图形渲染问题。具体表现为当视角靠近地球表面时，某些3D图元会穿透地球表面显示出来，造成视觉上的渲染错误。这个问题在1.122版本之前并不存在，且当启用viewer.scene.globe.depthTestAgainstTerrain设置为true时，问题会消失。

问题重现

该问题在多个平台上都有重现报告：

• Linux系统上的Chrome浏览器
• iOS移动设备(iPhone 14 Pro Max)
• 其他用户也在不同环境下观察到类似现象

典型的重现步骤包括：

1. 加载包含卫星轨迹的CZML数据
2. 选择并跟踪特定卫星(如GeoEye-1)
3. 当相机靠近地球表面时，会观察到其他轨道线穿透地球表面显示

技术分析

经过开发团队的深入调查，发现问题根源在于1.122版本中的一次着色器代码修改。具体来说，在#12188提交中，顶点着色器的计算方式发生了变化：

原代码：

positionEC = czm_modelView * position;
gl_Position = czm_projection * positionEC;

修改后代码：

positionEC = czm_modelView * position;
gl_Position = czm_modelViewProjection * position;

这种修改虽然看似数学等价(因为czm_modelViewProjection理论上等于czm_projection * czm_modelView)，但在实际渲染管线中却导致了深度计算精度的差异。

问题本质

深度缓冲(Z-buffer)技术是3D图形中解决可见性问题的关键技术。它通过为每个像素存储其深度值，在渲染时比较新图元与已存储图元的深度来决定谁应该被显示。

在CesiumJS的场景中：

1. 地球表面和轨道线等图元都需要写入深度缓冲
2. 当两者在屏幕空间中非常接近时，浮点数精度限制可能导致深度比较失效
3. 着色器计算顺序的改变影响了最终的深度值精度
4. 启用depthTestAgainstTerrain强制了更严格的深度测试，掩盖了问题

解决方案

开发团队确认恢复原来的着色器计算方式可以解决这个问题。这是因为：

1. 分步计算(modelView变换后接projection变换)能保持更高的中间计算精度
2. 直接使用预计算的modelViewProjection矩阵可能导致精度损失
3. 在顶点着色器中保留更多中间步骤有利于GPU优化

经验总结

这个案例提供了几个有价值的经验教训：

1. 数学等价≠渲染等价：即使两种计算方法数学上等价，在实际渲染中可能有不同的表现
2. 精度敏感操作：涉及深度计算的操作对数值精度特别敏感
3. 跨平台测试重要性：图形问题可能在特定硬件/驱动组合下才显现
4. 回归测试价值：图形管线的微小改动可能产生意想不到的副作用

结论

CesiumJS团队通过细致的代码审查和问题定位，成功识别并修复了这个深度测试问题。这个案例展示了3D图形编程中深度缓冲机制的微妙之处，以及保持计算精度的重要性。对于开发者而言，当遇到类似的渲染问题时，检查着色器计算精度和变换顺序应该成为首要的排查方向之一。