From 4ea7caf3dfb210b8b36b3588c7105dd084c727ca Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 14 Nov 2026 00:11:13 -0500 Subject: [PATCH] Devlog: H1, R1 and H2 Co-Authored-By: Claude Opus 5.5 --- docs/DEVLOG.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/docs/DEVLOG.md b/docs/DEVLOG.md index 808e8b8..0988061 100644 --- a/docs/DEVLOG.md +++ b/docs/DEVLOG.md @@ -1138,3 +1138,22 @@ high-priority issues, and A3, A7, A12 and A13 deferred. - So the smoke fault check expects only a non-zero exit in package mode. - The systemd unit already has `Restart=on-failure`. - This makes the debug-only checks in `make check` and the soak the real guard for script errors. + +**H2 (#55): graphics presets and Linux compatibility.** +- Presets (`GameSettings.QUALITY`): + - Low: no sun shadows, 75% render scale, FXAA. + - Medium: shadows to 200 m with 2 cascades, 100%, FXAA. + - High: shadows to 400 m with 4 cascades, 100%, MSAA 2x. +- `GameSettings.apply_to_viewport` sets render scale, MSAA and FXAA. `MatchView.apply_settings` sets the sun's cascades. +- **Decision:** no preset changes prop or piece draw distances, so a lower preset can never show a player through cover that a higher one draws. A test guards it. +- **Vulkan fallback:** + - Godot's `fallback_to_opengl3` is on by default. + - `RendererCheck` notices when the renderer isn't the one asked for (and the player didn't choose it on the command line). The main menu then shows a notice in ochre red, and the game prints it. + - Proven with the new `CAPTURE_RENDERER=no_vulkan` mode of `tools/capture.sh`, which hides the Vulkan ICD in the container and expects `gl_compatibility`. The `menu_main_no_vulkan` capture shows the notice. +- Captures `quality_{low,medium,high}` in Forward+ and in Compatibility were opened and reviewed: + - Shadows appear and disappear as they should. + - Low is slightly softer from the 75% scale. + - Draw calls: 218, 354 and 432 (Forward+); 250, 391 and 464 (Compatibility). + - Found: under Compatibility, shadows on makes the ground and rocks paler. It happens in the default view too, so it's the renderer, not the presets. Filed as H14 (#81), low priority. +- `docs/PLAY.md`: presets, renderers, Wayland (XWayland by default, `--display-driver wayland` to try native), hybrid-GPU offload variables, and a tested-configurations table that marks every row as software-only or not tested. Wayland and real or hybrid GPUs are untested until R6. +- Tests: `test_game_settings` +4 (presets rise from Low to High; viewport and sun settings; presets never touch draw distance; the fallback notice logic).