PROCITY/docs/shots/README.md
m3ultra 9b1c54ea81 Lane F R10: verify giant-rig fix + re-shoot tour + re-frame night_crowd
Verified Lane D's R10 buildFigure span-normalize fix: qa.sh --strict GREEN 6/6 incl. the new
no-giants scale gate (24 interior figs / 6 shops all crown 1.4-2.0m, under-ceiling). The 3.83m I
first measured live was a STALE ES-module cache in a day-old browser tab, not a regression
(served rigs.js + fresh-chromium gate both correct).

Re-shot the v2 tour on the fixed tree: browsers.png now shows human-sized figures (browser at the
rack + keeper at the counter). night_crowd.png re-framed to a readable clean-night "lit VIDEO REGAL
amid CLOSED town" (pulled out of the rain group; reuses night_neon's tighter dist-12 pose).

Honest finding: night_crowd has no visible street crowd and can't without new work. Lane D's night
patronage parks ducked-in patrons hidden INSIDE the shop (they are the interior browsers), and this
seed's video shop is a low-traffic corner (tested: 0 patronage / 0 visible at night). Flagged for D;
a visible outdoor night queue is a v3 mechanic. ~20fps in night captures is a headless software-GL
artifact (scene is light: 128 draws / 65k tris).

Full-default soak PASS (heap 54MB stable, no perf drift, 0 errors). Tour README updated with stable
v2 filenames. v2.0 annotated tag staged separately (push held for John — public release + the
night_crowd caveat on his flagged money shot).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-15 13:56:23 +10:00

48 lines
2.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# docs/shots — visual regression + devlog reference tree
Owned by Lane F (each lane also drops its own acceptance screenshots here).
```
docs/shots/
laneA/ … laneE/ … per-lane acceptance screenshots (each lane owns its dir)
v1_tour/ … F: the v1 beauty shots (tools/shots.py) — frozen devlog set
v2_tour/ … F: the v2 tour (tools/v2_tour.py) — the CURRENT canonical set (see below)
before/ … F: last known-good capture, for side-by-side regression
references/ … real-world reference photos named per shot
v2_contact.html … generated contact sheet for the v2 tour
```
## v2 tour — stable filenames (do not rename; the v3 site links these)
`cd web && python3 -m http.server 8130` then `tools/.venv/bin/python tools/v2_tour.py`
→ 1280×720 PNGs in `v2_tour/` + `docs/shots/v2_contact.html`.
| file | what it documents |
|---|---|
| `street_noon.png` | main strip at midday |
| `crossroads_busy.png` | busiest intersection, peds about |
| `shopfront_detail.png` | verandah + sign + window up close |
| `patronage_door.png` | streamed peds at an open shop's door (Lane D patronage) |
| `rain_verandah.png` | rain outside a lit `?winmap` video-shop window |
| `rain_street.png` | wet strip, rain down the street |
| `tram_stop.png` | the v2 tram paused at a shelter (`?tram=1`) |
| `night_crowd.png` | **VIDEO REGAL glowing amid CLOSED neighbours at night** — the §3.5 hours story (clean-night boot). **NB:** no visible street crowd — see the note below. |
| `browsers.png` | **an occupied shop's interior life** — a browser at the rack + the keeper at the counter, both human-sized (R10 giant-rig fix). *figures human-sized vs door/fittings: yes.* |
| `dig_real.png` | riffling a real-cover record bin (`?dig=1&stock=real`) |
| `katoomba_main.png` | plan-agnostic main strip (`?plansrc=osm&town=katoomba`) |
### Note on `night_crowd` (Lane F, R10)
Re-framed to the tighter, readable "one lit shop in a closed town" composition. It does **not** show a
standing street crowd, and that is not a framing bug: Lane D's night patronage parks ducked-in patrons
*hidden inside* the shop (they become the interior browsers seen in `browsers.png`), and seed 20261990's
video shop sits on a low-traffic corner, so none gather visibly outside (tested: 0 patronage / 0 visible
at night). The town's night life is the interior presence + the neon-vs-CLOSED mood. A visible outdoor
night queue would need a new Lane-D mechanic (loiter-outside-the-openLate-shop) — parked for v3. The
~20 fps in night captures is a **headless-chromium software-GL artifact** (the scene is light, ~128
draws / 65k tris); on real hardware the night scene is not a perf concern.
## Regression workflow
Before a risky change, snapshot the good state into `before/`, then re-run `v2_tour.py` and eyeball
`v2_contact.html`. **Process rule (R10): any shot containing a humanoid gets an explicit
"figures human-sized relative to doors/fittings: yes" line in the progress note — actually look.**