Refresh the capture gallery and build captioned visual docs

docs/screenshots/README.md

@@ -1,29 +1,34 @@
-# Screenshots
+# Game screenshots
 
-Committed gallery captures generated from the current build by src/test/capture_screenshots.gd, src/test/capture_ui_states.gd and src/test/capture_prop_gallery.gd.
+The gallery is regenerated with `tools/check_screenshots.sh`, which re-renders every capture from
+the current build and compares it with the screen-design reference. Captures are used by the
+README, the gameplay docs and the screenshot gate; do not edit them by hand.
 
-## Image previews
+| # | Capture | What it shows |
+| --- | --- | --- |
+| 01 | [Overview](01-venue-overview.png) | Hollywood Boulevard, the El Capitan facade and the shift HUD |
+| 02 | [Targeting](02-targeting-npc.png) | Focus ring, name tag and the target chip |
+| 03 | [Inspection](03-access-inspection.png) | Artifact check and the recognize / decide controls |
+| 04 | [Radio](04-radio-report.png) | Dispatch panel with the report fields |
+| 05 | [Night street](05-late-night-avenue.png) | Late-shift lighting and the skyline |
+| 06 | [Flashlight](06-night-flashlight.png) | Night patrol with the flashlight spot |
+| 07 | [Wand screening](07-wand-screening.png) | False alarm on keys at the Joke Shop |
+| 08 | [Escalation](08-escalation-hud.png) | Level 3 blocking with the body camera armed |
+| 09 | [Timeline](09-body-camera-timeline.png) | Recorded events in the shift review |
+| 10 | [Prop gallery](10-prop-gallery.png) | The Blender prop library on a studio backdrop |
+| 11 | [Precision walk](11-precision-walk.png) | Half-speed movement on the steps |
+| 12 | [Joke Shop](12-joke-shop.png) | Sunset Strip club frontage at night |
+| 13 | [Studio arrival](13-studio-arrival.png) | Late-night TV studio entrance |
+| 14 | [Start menu](14-start-menu.png) | Venue rows, Continue and campaign links |
+| 15 | [Pause](15-pause-overlay.png) | Pause overlay actions |
+| 16 | [Settings](16-settings-panel.png) | Difficulty, audio, accessibility and remapping |
+| 17 | [Shift review](17-shift-review.png) | Grade, policy result and incidents |
+| 18 | [Emergency radio](18-emergency-radio.png) | Hold-to-confirm emergency call |
+| 19 | [Action wheel](19-radial-menu.png) | De-escalation-first verb wheel |
+| 20 | [Crowd panic](20-crowd-panic.png) | Bystanders clearing away from an incident |
+| 21 | [Responder arrival](21-responder-arrival.png) | A responder at the locked door |
 
-| Preview | File |
-| --- | --- |
-| <img src="01-venue-overview.png" width="280" alt="01-venue-overview.png"> | [`01-venue-overview.png`](01-venue-overview.png) |
-| <img src="02-targeting-npc.png" width="280" alt="02-targeting-npc.png"> | [`02-targeting-npc.png`](02-targeting-npc.png) |
-| <img src="03-access-inspection.png" width="280" alt="03-access-inspection.png"> | [`03-access-inspection.png`](03-access-inspection.png) |
-| <img src="04-radio-report.png" width="280" alt="04-radio-report.png"> | [`04-radio-report.png`](04-radio-report.png) |
-| <img src="05-late-night-avenue.png" width="280" alt="05-late-night-avenue.png"> | [`05-late-night-avenue.png`](05-late-night-avenue.png) |
-| <img src="06-night-flashlight.png" width="280" alt="06-night-flashlight.png"> | [`06-night-flashlight.png`](06-night-flashlight.png) |
-| <img src="07-wand-screening.png" width="280" alt="07-wand-screening.png"> | [`07-wand-screening.png`](07-wand-screening.png) |
-| <img src="08-escalation-hud.png" width="280" alt="08-escalation-hud.png"> | [`08-escalation-hud.png`](08-escalation-hud.png) |
-| <img src="09-body-camera-timeline.png" width="280" alt="09-body-camera-timeline.png"> | [`09-body-camera-timeline.png`](09-body-camera-timeline.png) |
-| <img src="10-prop-gallery.png" width="280" alt="10-prop-gallery.png"> | [`10-prop-gallery.png`](10-prop-gallery.png) |
-| <img src="11-precision-walk.png" width="280" alt="11-precision-walk.png"> | [`11-precision-walk.png`](11-precision-walk.png) |
-| <img src="12-joke-shop.png" width="280" alt="12-joke-shop.png"> | [`12-joke-shop.png`](12-joke-shop.png) |
-| <img src="13-studio-arrival.png" width="280" alt="13-studio-arrival.png"> | [`13-studio-arrival.png`](13-studio-arrival.png) |
-| <img src="14-start-menu.png" width="280" alt="14-start-menu.png"> | [`14-start-menu.png`](14-start-menu.png) |
-| <img src="15-pause-overlay.png" width="280" alt="15-pause-overlay.png"> | [`15-pause-overlay.png`](15-pause-overlay.png) |
-| <img src="16-settings-panel.png" width="280" alt="16-settings-panel.png"> | [`16-settings-panel.png`](16-settings-panel.png) |
-| <img src="17-shift-review.png" width="280" alt="17-shift-review.png"> | [`17-shift-review.png`](17-shift-review.png) |
-| <img src="18-emergency-radio.png" width="280" alt="18-emergency-radio.png"> | [`18-emergency-radio.png`](18-emergency-radio.png) |
-| <img src="19-radial-menu.png" width="280" alt="19-radial-menu.png"> | [`19-radial-menu.png`](19-radial-menu.png) |
-| <img src="20-crowd-panic.png" width="280" alt="20-crowd-panic.png"> | [`20-crowd-panic.png`](20-crowd-panic.png) |
-| <img src="21-responder-arrival.png" width="280" alt="21-responder-arrival.png"> | [`21-responder-arrival.png`](21-responder-arrival.png) |
+The captures are 1280×720 PNGs. Reference designs and the judge report live in
+[`../screens/`](../screens/README.md) and [`../screen-design-report.md`](../screen-design-report.md);
+the re-evaluation's pose and review sheets are under
+[`../blender_previews/`](../blender_previews/README.md).