H14: No sun shadows under the OpenGL fallback

Godot's Compatibility renderer draws a shadowed directional light in a
pass of its own and adds it after the frame is in sRGB, so sunlit pixels
come out as srgb(ambient) + srgb(sun) (measured to within 1/255 on
llvmpipe) and ground and rocks wash out. No environment or project
setting avoids it, so Look.sun_shadows_supported() is false under
gl_compatibility and the sun casts no shadows there on any preset.

Adds the sun_probe and sun_shadow_probe capture scenarios to recheck
after an engine upgrade, a test, and the explanation in PLAY.md and the
README.

Closes #81

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-11-14 20:28:31 -05:00
co-authored by Claude Opus 5.5
parent 358234d246
commit 8710c099b3
9 changed files with 106 additions and 8 deletions
+9 -4
View File
@@ -134,7 +134,7 @@ Settings → Graphics → Quality.
| Preset | Sun shadows | Shadow cascades | 3D resolution | Anti-aliasing | Effect particles |
|---|---|---|---|---|---|
| Low | Off | n/a | 75% of the window | FXAA | 256 at once |
| Low | Off (and off on every preset under OpenGL) | n/a | 75% of the window | FXAA | 256 at once |
| Medium | Up to 200 m | 2 | 100% | FXAA | 512 |
| High (default) | Up to 400 m | 4 | 100% | MSAA 2x | 1,024 |
@@ -154,8 +154,13 @@ Tidewall is made for Godot's **Forward+** renderer on **Vulkan**. If Vulkan can'
(no Vulkan driver, or a GPU too old for it), the game falls back to **OpenGL**
(Godot's Compatibility renderer) rather than crashing. The main menu then says so in
red under the motto. Everything works there, but the light, fog and sea look a little
different. Known difference: with shadows on (Medium, High) the ground and rocks come
out paler under OpenGL than under Vulkan (issue #81).
different. **Under OpenGL the sun casts no shadows, on every preset** (the presets'
other settings still apply). Godot's Compatibility renderer draws a shadowed sun in
a pass of its own and adds it to the picture after the picture is already converted
for the screen (sRGB), so sunlit ground and rocks came out pale and washed out
(issue #81). No setting in the engine avoids that, so the game turns those shadows
off rather than show wrong colours. The `sun_probe` and `sun_shadow_probe` capture
scenarios show the difference, to recheck after an engine upgrade.
To choose a renderer yourself:
@@ -187,7 +192,7 @@ is checked in the hands-on playtest (R6), and this table will be updated from it
| Configuration | Renderer | How it was tested | Result |
|---|---|---|---|
| Debian 13, Xvfb (X11), Mesa Lavapipe | Forward+ / Vulkan | Software only: every capture, all three presets (`quality_*` captures) | Draws correctly |
| Debian 13, Xvfb (X11), Mesa llvmpipe | Compatibility / OpenGL | Software only: all three presets | Draws correctly. Paler ground with shadows on (see above) |
| Debian 13, Xvfb (X11), Mesa llvmpipe | Compatibility / OpenGL | Software only: all three presets | Draws correctly, with no sun shadows (see above) |
| Debian 13, Xvfb (X11), no Vulkan driver | Falls back to OpenGL | Software only: `CAPTURE_RENDERER=no_vulkan` capture of the main menu | Falls back and shows the notice |
| Release package outside the repo, headless | None (server and autoplay client) | `make dist-check` | Plays a full match; the game joins its server |
| Wayland (native or XWayland) | Any | **Not tested** | Unknown |