zwitschi
cab3b8e46b
- Probed DemoMap world-space positions (commandlet) and compared against Geo reference measurements: road 24.3 m (ref crossings 20.9-25.9), sidewalk centreline offsets 12.5/13.2 m (ref 12.6/13.6), hero frontage 26.0 m and setback ~13 m (ref 25.75 m / 14.5 m), frontage + north buildings in verified OSM positions. Recorded as PASS with deliberate deviations (flat blockout surfaces -> 0.1.4; kerb upstand -> 0.1.1; kerb-flush crossing ramps -> 0.1.1) in Docs/release-checks.md. - Fixed the demo-north-buildings camera: it sat at X -22800 (9.5 km west of the site) aiming at its own position -> 85%-sky frame. Now at the buildings' mass centre (X -22750) south of the road looking north; sky fraction 85% -> 41%.
86 lines
7.0 KiB
Markdown
86 lines
7.0 KiB
Markdown
# Release checks
|
||
|
||
Every version in `TODO.md` ends with release checks, and the scope and goal of each version are in `ROADMAP.md`. A version is not tagged until all of its checks pass. If a check fails, do not tag; open a patch task in `TODO.md` and report the failing check in `CHANGELOG.md`.
|
||
|
||
Record results in the table at the end of this file, with the date, the exact build under test, and the evidence (screenshot, log, or command output). A check without recorded evidence counts as failed.
|
||
|
||
## General checks (every release)
|
||
|
||
0. **Blender pre-check (before the engine pass).** `Art/blender/site/site_assembly.py` raycasts both sidewalks and the designated crossing on a 1 m grid and reports holes and step heights. It is evidence, not the check: the engine traversal below is still required.
|
||
|
||
1. **Fresh checkout builds.** Clone into a clean directory, `git lfs pull`, build and package using only the documented external engine installation. No machine-specific paths, no uncommitted steps.
|
||
2. **No packaging errors.** The packaged build launches, reaches gameplay, and quits cleanly. Logs contain no missing-asset, missing-map, or shader-compile errors.
|
||
3. **Licensing.** Every new asset has provenance in `THIRD_PARTY_NOTICES.md`, or is recorded as unresolved and kept out of the build.
|
||
4. **Version discipline.** Patch releases contain fixes, optimisation, docs, or tuning only — no new scope.
|
||
|
||
## Performance check
|
||
|
||
Measured at 1440p on the development workstation: Bazzite, Ryzen 7 7700X, 64 GB RAM, RTX 5070 Ti 16 GB.
|
||
|
||
- Record the quality preset, the exact upscaling state (off, DLSS/TSR/FXAA and mode), and the engine version.
|
||
- Report frame rate without frame generation and with frame generation, separately.
|
||
- Target: 60 FPS at 1440p without frame generation.
|
||
- Capture a frame-time graph over a fixed traversal route, not a single sample. State the route.
|
||
|
||
## `0.1.0` checks
|
||
|
||
1. Player traverses both the south-side frontage and the north-side frontage of the demo without falling through geometry, including the designated crossing. Walk the route twice: once normally, once with collision debug visualisation enabled.
|
||
2. Building placement, street width, sidewalk depth, and site identity match the reference photography. Compare side by side and note every deliberate deviation. "Looks right" is not evidence.
|
||
3. No blocking collision, no invisible walls, no gaps at sidewalk/road seams.
|
||
4. 60 FPS at 1440p per the performance check above.
|
||
5. Fresh checkout builds against the documented external engine installation.
|
||
6. Linux build packaged and launched; controls documented in `Docs/` and shown in-game.
|
||
7. Tag `v0.1.0`, write the `CHANGELOG.md` entry, then remove the completed section from `TODO.md` (its goal stays in `ROADMAP.md`).
|
||
|
||
## Check-record template
|
||
|
||
| Version | Check | Result | Evidence | Date |
|
||
| ------- | ----------------------- | ------ | -------- | ---- |
|
||
| `0.1.0` | Traversal, both sides | — | — | — |
|
||
| `0.1.0` | Placement vs references | PASS (with deliberate simplifications) | Section below, 2026-11-08 | 2026-11-08 |
|
||
| `0.1.0` | Collision and packaging | — | — | — |
|
||
| `0.1.0` | 60 FPS at 1440p | — | — | — |
|
||
| `0.1.0` | Fresh checkout build | — | — | — |
|
||
| `0.1.0` | Packaged Linux build | — | — | — |
|
||
|
||
## `0.1.0` — Placement vs references — record (2026-11-08)
|
||
|
||
Checked against the reference photography (`Art/reference/`) and the Geo measurements
|
||
(`Geo/verification/*`). Build under test: current `main` content, DemoMap rendered via
|
||
`Tools/render_screenshots.sh` (2026-11-08, Vulkan SM5, 1920×1080); engine positions
|
||
probed from the DemoMap (commandlet, 2026-11-08).
|
||
|
||
### Placement and scale (in-engine ↔ reference)
|
||
|
||
| Quantity | In-engine (probed world-space) | Reference | Match |
|
||
| --- | --- | --- | --- |
|
||
| Road (Hollywood Blvd carriageway) | Y −13.82..+10.47 m → **24.3 m** | crossing ways 20.9–25.9 m | ✓ within range |
|
||
| South sidewalk strip | 7.3 m (bbox incl. kerb apron); built walkable strip 4.0 m per `Art/blender/README.md` | 12.6 m centreline offset; strip width from setback arithmetic | ✓ offset 12.5 m ≈ ref 12.6 m |
|
||
| North sidewalk strip | 8.6 m (bbox); built strip 5.3 m | 13.6 m centreline offset | ✓ offset 13.2 m ≈ ref 13.6 m |
|
||
| Kerbs | 3.3 m apron face to 0.13 m upstand | 0.15 m assumption; photo check pending (`0.1.1` Kerb height item) | ≈ (recorded deviation) |
|
||
| Hero façade (6840 El Capitan Ent. Ctr.) | X −146.38..−120.34 m (26.0 m frontage), Y +13.0..+25.6 m from road centre (13.0 m deep) | 6840 setback 14.5 m; 25.75 m frontage (resolved) | ✓ frontage; setback ~1.5 m deeper than ref (recorded) |
|
||
| El Capitan Theatre (6838) | X −120.82..−82.10 m, Y +13.4..+68.5 m | theatre east of 6840 | ✓ east |
|
||
| South frontage run (6922, 6902, 6838, 6822, 6806, 6800) | X −242.76..−14.37 m, all Y +12..+68 m | verified OSM footprints in place | ✓ |
|
||
| North buildings TCL / Tussaud's | TCL X −228.9..−184.4, Y −94.3..−18.0; Tussaud's X −270.7..−228.0, Y −75.9..−18.9 | north of the Blvd, west of hero (per OSM) | ✓ placed north (−Y) across the road |
|
||
|
||
### Visual comparison (demo views vs references)
|
||
|
||
| Shot | Reference(s) used | Verdict | Notes |
|
||
| --- | --- | --- | --- |
|
||
| `review-demo-spawn-view` | `hollywood/el-capitan-facade-day-*` (CC BY 2.0), `el-capitan-entrance/*` | PASS | Facade frontage, column rhythm and neighbour massing match; camera frames the whole block from the north sidewalk. |
|
||
| `review-demo-street-level` | `hollywood/el-capitan-theatre-blade-sign-*`, `premiere-staging-*` | PASS | Street-level colonnade + frontage neighbours; sidewalk depth consistent with the blade-sign frame. |
|
||
| `review-demo-crossing` | street-profile crossing s=130.1 m | PASS | Zebra markings visible along the crosswalk; kerb flushed at the crossing. |
|
||
| `review-demo-north-buildings` | north-side OSM positions; TCL/Tussaud's `Art/reference/north-*` | PASS | Camera re-pointed 2026-11-08 (was 9.5 km west → 85% sky); buildings now framed. Flat blockout surfaces are the `0.1.4` scope. |
|
||
|
||
### Deliberate deviations recorded
|
||
|
||
- **North/south building surfaces are flat blockouts** (bloblike, no façade detail). Detail texturing/façade style is the planned `0.1.4` (Proper building façades) work; placement and massing are what this check verifies.
|
||
- **Kerb upstand 0.13 m as built vs 0.15 m assumed**; the DEM cannot resolve a kerb — tracked in `0.1.1` (Kerb height assumption).
|
||
- **Sidewalk surface detail** (railings, pavers, domes) not modelled — outside `0.1.0` scope.
|
||
- **Crossing ramps are kerb flushes, not graded ramps** — the `0.1.1` Crossing ramp gradient item.
|
||
- Site identity (the neoclassical hero with motto band) matches the 2009 façade photograph and the 1922 Masonic elevation within blockout fidelity.
|
||
|
||
Pre-check method: `Tools/judge_screenshot.py` (vision model) flagged the simplified
|
||
flat surfaces as "unexpected" — those flags are the deliberate deviations above, not
|
||
placement errors. Final verdict is by human review of the shots in `Screenshots/demo/`.
|