diff --git a/docs/DEVLOG.md b/docs/DEVLOG.md index 9e00f92..2e9d8bd 100644 --- a/docs/DEVLOG.md +++ b/docs/DEVLOG.md @@ -1530,3 +1530,41 @@ diagnostics went in. M6 and M7 (bots that build, duos), which carry no priority label. - A change to the game after v1.0.0 would need its own point release. Keep `main` releasable. + +## 2026-11-14 (night): H14, no sun shadows under OpenGL + +The v1.0.0 release is still a draft with no binaries, so R5 waits on Eric. This run +took the deferred bugs, starting with H14 (#81). + +**H14 (#81): the cause.** +- A small scene (flat ground, a boulder, a post, Look's environment and sun) shows the + same paleness with plain `StandardMaterial3D`. So it isn't our terrain shader. +- I switched each part of the environment off in turn: fog, grading, glow, ambient, + tonemapper, `use_hdr_2d` and render scale. None of them removes it. +- With linear tonemapping and no fog or grading, every sunlit pixel under the + Compatibility renderer equals srgb(ambient) + srgb(sun) to within one level in 255, + in all three channels and at half sun energy too. Forward+ gives srgb(ambient + sun). + Compatibility draws a shadowed directional light in its own pass and adds it after + the frame is in sRGB. That's engine behaviour, and no project setting changes it. + +**The fix.** +- `Look.sun_shadows_supported()` is false under `gl_compatibility`. +- `Look.sun()` and `MatchView.apply_settings()` leave the sun's shadows off there, on + every preset. The presets' other settings still apply. +- A test covers it. PLAY.md and the README explain it. +- New capture scenarios: `sun_probe`, and `sun_shadow_probe`, which forces the shadows + on. They're for rechecking after an engine upgrade. + +**Captures (software rendering), looked at:** +- `sun_probe`: luminance mean 0.622 under Compatibility against 0.603 under Forward+, + the usual renderer difference. The colours match; only the shadows are missing. +- `sun_shadow_probe` under Compatibility still shows the pale ground (0.743), as + expected. +- `quality_{low,medium,high}` under Compatibility now agree with each other (means + 0.239, 0.241, 0.240 on a seed-2 log). + - The landed view in today's logs is inside a building, not out on the hillside the + issue was filed from. Indoors, Forward+ High is darker from the roof's shadow, + which OpenGL now doesn't draw, just like Low. + +This changes the game after the v1.0.0 tag, so it belongs in a 1.0.1 if Eric wants +OpenGL players to have it before the next release.