Documentation

Unity Engine


User Manual

Script Reference

Unity Engine


cameraRelativeShadowCulling

Enable or disable using the camera position as the reference point for culling shadows.
Read time 1 minuteLast updated 12 days ago

Definition

public static bool cameraRelativeShadowCulling { get; set; }

Remarks

When Unity culls distant shadows, a shadow that's far away from the world space origin can flicker. The flickering happens because GameObject coordinates become increasingly less precise as they get further away, so the shadow moves in and out of culling range.
If you set
cameraRelativeShadowCulling
to
true
, Unity uses the camera position as the reference point for culling shadows instead of the world space origin. This can reduce flickering.
If a shadow is closer to the world space origin than the camera position, setting
cameraRelativeShadowCulling
to
true
may introduce flickering or make it worse. You can use the following approaches instead:
  • Reduce Camera.farClipPlane to avoid the distance of shadows becoming too large for precise calculations.
  • Make everything in your scene smaller, to reduce distances across your whole scene.
Additional Resources: _cameraRelativeLightCulling