SceneKit：平行光阴影随相机角度异常的问题排查

我在项目中实现了飞船飞越地形的场景，使用平行光让飞船投射固定大小的正下方阴影（不随飞船高度变化），但阴影表现不稳定：

• 相机视角趋近水平时，阴影先像素化、闪烁，直至完全消失
• 视角向下倾斜超过约30°时，阴影显示正常

查过相关讨论，可变角度相机的场景较为少见，固定视角相机的案例更普遍。尝试调整shadowRadius、shadowBias、shadowSampleCount等参数均无效，现寻求解决方案，以及SceneKit灯光阴影参数的详尽参考资料。

相关代码 #

self.dirLightNode = SCNNode()
self.dirLightNode.light = SCNLight()
self.dirLightNode.position = SCNVector3(x: -0 * dividerx, 
                                        y: 20 * dividery, 
                                        z: -00)
self.dirLightNode.light?.type = .directional
self.dirLightNode.light!.color = UIColor.black
self.dirLightNode.light?.castsShadow = true
self.dirLightNode.light?.shadowMode = .deferred
self.dirLightNode.light?.categoryBitMask = 1
self.dirLightNode.light?.shadowColor = UIColor.black.withAlphaComponent(0.8)
self.dirLightNode.rotation = SCNVector4Make(1,0,0, 1.5 * Float.pi)
self.dirLightNode.light?.orthographicScale = 10
self.dirLightNode.light?.shadowRadius = 10
self.dirLightNode.light?.shadowBias = 1
self.dirLightNode.light?.zFar = 100
self.dirLightNode.light?.zNear = 0
self.dirLightNode.light?.maximumShadowDistance = 10000
self.dirLightNode.light?.shadowSampleCount = 1
self.dirLightNode.light?.shadowMapSize = CGSize(width: 4096, height: 4096)

1. 修复阴影投影的视锥体适配问题 #

平行光的阴影依赖正交投影视锥体，当主相机视角变水平时，固定的orthographicScale会导致阴影贴图的精度被过度拉伸，或视锥体无法覆盖飞船到地形的投影范围：

• 动态调整orthographicScale：根据当前相机的垂直视场角、飞船高度，计算需要覆盖的地面范围，实时更新平行光的orthographicScale，保证阴影贴图始终精准覆盖飞船正下方的区域
• 修正zNear和zFar：将zNear设为0.1（避免0值导致的深度精度丢失），zFar设为飞船最高飞行高度到地形的距离+10（不要过大，减少深度缓冲的精度浪费）

2. 调整阴影渲染模式与采样参数 #

• 切换shadowMode为.forward：延迟渲染（.deferred）在相机视角剧烈变化时，阴影深度缓冲的兼容性较差，前向渲染对动态视角的阴影适配更稳定
• 优化采样与模糊参数：将shadowSampleCount提升至4-8（增强抗锯齿），shadowRadius降至2-3（减少过度模糊导致的像素化），shadowBias设为0.01（避免视角变化时的阴影偏移或消失）

3. 绑定平行光到飞船（确保阴影始终正下方） #

若要阴影始终保持在飞船正下方且大小固定，将平行光节点设为飞船节点的子节点，局部旋转设为SCNVector4Make(1,0,0, Float.pi/2)（垂直向下），这样无论飞船移动或相机视角变化，平行光始终垂直照射地面，阴影范围保持稳定。

• shadowMapSize：阴影贴图分辨率，数值越大阴影越清晰，性能消耗越高，常用值为2048、4096
• orthographicScale：平行光阴影正交视锥体的缩放比例，直接决定阴影覆盖的地面范围
• shadowRadius：阴影边缘模糊半径，值越大阴影越柔和，过高会导致边缘像素化
• shadowBias：阴影深度偏移值，用于解决表面自阴影（shadow acne），过小会出现斑点，过大则阴影会脱离物体
• shadowSampleCount：阴影采样数量，越高阴影抗锯齿效果越好，对应性能消耗也越高
• maximumShadowDistance：相机到阴影的最大距离，超出该范围的阴影会被裁剪
• zNear/zFar：阴影相机的近、远裁剪面，范围越小深度缓冲的精度越高
• shadowMode：
  • .forward：前向渲染模式，兼容性好，适合动态视角场景
  • .deferred：延迟渲染模式，性能更优，但对动态视角的阴影适配较差
  • .modulated：仅混合阴影颜色，无深度测试，性能消耗最低但效果最差

内容的提问来源于stack exchange，提问作者ULI