| type | Technique | |||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| title | Sun shadows | |||||||||||||||||||||
| description | Cascaded shadow maps for the sun, with cascades, reach and resolution chosen per tier from measurements, and from T3 edges that soften with distance as a real sun's do. | |||||||||||||||||||||
| resource | https://github.com/smichea/osage/blob/main/crates/osage-render/src/shadows.rs | |||||||||||||||||||||
| licence | LicenseRef-osage-AGPL-3.0-or-later-with-exceptions | |||||||||||||||||||||
| tiers |
|
|||||||||||||||||||||
| status | draft | |||||||||||||||||||||
| tags |
|
|||||||||||||||||||||
| sources |
|
|||||||||||||||||||||
| generated |
|
Gives every object a shadow from the sun, sharp near the camera and coarser far away.
Cascaded shadow maps1: the view is cut into slices by distance, and the scene is drawn from the sun's point of view once per slice into a square depth map. Near slices cover little ground, so their shadows are sharp. Bevy provides the cascades2; this technique chooses how many, how far and how large. From T3 it adds contact shadows, a short ray march in screen space that restores the small shadows a coarse map misses, and soft shadows: percentage-closer soft shadows3 search the map for the blockers around a point, and blur the shadow's edge by the gap between blocker and receiver times the light's size, so that a shadow is sharp where it touches what casts it and softer further off, as the half-degree disc of the sun makes it. Their noise is smoothed by T3's TAA; Bevy's temporal shadow filter, meant for them, hung the Intel Iris Xe (Mesa) a few hundred frames into a lap, so the default filter stays.
| Tier | Cascades | Reach | Map size | Contact shadows | Soft shadows |
|---|---|---|---|---|---|
| T1 | 2 | 60 m | 1024 | no | no |
| T2 | 2 | 80 m | 1024 | no | no |
| T3 | 4 | 200 m | 2048 | yes | light size 1.0 |
| T4 | 4 | 300 m | 4096 | yes | light size 1.0 |
The light size was chosen by eye against long evening shadows on the kart circuit (fence posts): 1.0 softens them as they lengthen; 4.0 blurred them away.
The first cascade always ends 12 m from the camera.
On the Intel Iris Xe (Raptor Lake-P, Mesa 26.2), 1920×1080, 2026-11-10, first scene: two cascades of 1024 over 80 m cost 2.6 ms; three of 2048 over 120 m, 4.7 ms. With the scenery (about 3 000 objects) the T2 setting costs 2.3 ms at 1632×918. Each object is drawn once more per cascade: the cost follows the number of objects within reach as much as the map size. Soft shadows at T3 cost about 3 % of the frame on the Iris Xe at 2560×1440 (kart circuit, evening start view, 2026-11-11: 119 ms without, 123 ms with).
Below T3, hard-edged shadows. Beyond the reach there is no shadow at all, which shows on hills.
The render bench, with and without --without shadows.
The table and its method: start from the budget, measure each candidate setting on the weakest hardware of the tier, keep the best that fits.