docs: embed screenshots with markdown image syntax in review README

This commit is contained in:
zwitschi committed 2026-11-07 09:54:28 +01:00
1 parent bbb3e147b3
commit b3815499e0
1 file changed
+24 -10
+24 -10
View File
@@ -4,7 +4,8 @@ Rendered in-game captures of the current project content, generated by
[`Tools/render_screenshots.sh`](../Tools/render_screenshots.sh). **The PNGs in
this folder are never committed** (`.gitignore` excludes everything here
except this README) — they exist on disk so a human can review the game's
appearance after every change that could affect it.
appearance after every change that could affect it. The `![...]` embeds below
resolve locally next to this file.
## How to regenerate
@@ -17,18 +18,31 @@ content (floor, key light, sky, MPFB character, the three 1 m scale cubes),
runs the game on it in `-game` mode, lets `AGigLineShotActor` walk its fixed
camera list and capture, and copies the PNGs here. Takes about a minute.
Each screenshot is described below. After reviewing, mark the approval state
in the table so agents know whether the look is accepted or needs work.
Each screenshot is embedded below with its description and approval state.
After reviewing, tick the approval checkbox so agents know whether the look
is accepted or needs work.
## Current screenshots (generated 2026-11-07)
## review-00-overview.png — generated 2026-11-07, approval: ☐ pending
| File | View | Shows | Approval |
| --- | --- | --- | --- |
| `review-00-overview.png` | Wide shot from the south-west, elevated | The review scene: character at origin, three 1 m calibration cubes in a row at 4 m north, gray floor, key light + sky | ☐ pending |
| `review-01-character.png` | Medium shot, eye height, from the south | The MPFB-generated character with its baked skin material and A-pose bind | ☐ pending |
| `review-02-scale-cubes.png` | Close three-quarter view of the cube row | The 1 m cubes for scale judgement against the character | ☐ pending |
![Wide overview from the south-west: character at origin, three 1 m calibration cubes in a row at 4 m north, gray floor, key light and sky](review-00-overview.png)
All captures are 2560×1440 PNG (the game window's size), unedited.
Wide shot from the south-west, elevated. The review scene as a whole:
character at origin, three 1 m calibration cubes in a row at 4 m north, gray
floor, one key light plus fill sky.
## review-01-character.png — generated 2026-11-07, approval: ☐ pending
![Medium eye-height shot of the MPFB-generated character from the south, A-pose with baked skin material](review-01-character.png)
Medium shot, eye height, from the south. The MPFB-generated character with
its baked skin material and A-pose bind.
## review-02-scale-cubes.png — generated 2026-11-07, approval: ☐ pending
![Close three-quarter view of the 1 m scale-test cube row on the gray floor](review-02-scale-cubes.png)
Close three-quarter view of the cube row. Each cube is exactly 1 m — use it
to judge scale against the character.
## What to look for