diff --git a/CREDITS.md b/CREDITS.md index aaf7512..3a89213 100644 --- a/CREDITS.md +++ b/CREDITS.md @@ -45,6 +45,20 @@ stylized reconstruction. The Joke Shop is a fictional stand-in for the real Sunset Strip block; the game does not claim endorsement by, or an exact replica of, any real venue or tenant. +### Development-only reference images + +The venue reference boards under `docs/screens/refs/` are development documentation and are not +bundled with the game or its release packages. Files under CC BY are attributed here as well as in +their folder sidecar: + +- `docs/screens/refs/hollywood/el-capitan-facade-day-wikimedia-2009-10-27.jpg` — "woo (Irvine, CA, + USA)", CC BY 2.0, via Wikimedia Commons. +- `docs/screens/refs/hollywood/el-capitan-theatre-blade-sign-day-wikimedia-2008-10.jpg` — Andreas + Praefcke, CC BY 3.0, via Wikimedia Commons. +- `docs/screens/refs/hollywood/premiere-staging-street-day-wikimedia-2006-02-12.jpg` — John + Barreiros, CC BY 2.0, via Wikimedia Commons. +- Public-domain files in the same folder: Charles W. Beam (1922) and Gary Minnaert (2006). + ## AI-assisted images Surface textures, skyline panoramas, UI art and concept references were produced diff --git a/MEMORY.md b/MEMORY.md index 4c4fac9..4b717aa 100644 --- a/MEMORY.md +++ b/MEMORY.md @@ -4,6 +4,14 @@ Session memory for durable decisions, state, and gotchas. Keep concise, remove o ## Decisions +- **Hollywood reference board (2026-11-03):** five Wikimedia photos live in + `docs/screens/refs/hollywood/` with `SIDECAR.md` (licences: CC BY 2.0 x2, CC BY 3.0, PD x2), + cropped/re-encoded to <=1600 px JPEG q85 with EXIF stripped, foreground crowd cropped out of the + facade shot. The board is linked from `docs/hollywood-boulevard-map.md` and the CC BY files are + credited in `CREDITS.md`. Gotchas: the Commons API needs a descriptive User-Agent and rate-limits + rapid thumbnail downloads (HTTP 429) - fetch all metadata in one `titles=A|B|C` query and space + the downloads. `check_docs` requires each image to be linked from its folder `README.md`, so each + venue folder needs both `README.md` (board) and `SIDECAR.md` (provenance). - **Imagery evidence model (2026-11-03):** `TODO.md` now separates three image sources that must not be mixed: licensed real-location photos (evidence of what a place looks like), generated concept boards (art-direction proposals with model/prompt/spend provenance), and build captures diff --git a/TODO.md b/TODO.md index 2f21ef5..c446180 100644 --- a/TODO.md +++ b/TODO.md @@ -148,9 +148,17 @@ and never ship a generated or downloaded image without provenance. licence and privacy gates and the three-way separation from concepts and captures; `SIDECAR-TEMPLATE.md` carries the photo table, redaction/permission notes, derived-decision log and the generated-board reference table. Linked from `docs/screens/README.md`.) -- [ ] Collect licence-cleared real-location photos for each venue (Wikimedia Commons, own captures, - and Mapillary only where its licence allows) into per-venue boards there. No Street View, - no scraped social media; link each board from its venue map doc. +- [x] Hollywood board: five licence-cleared photos (facade day, blade sign, 1922 elevation, + Ovation across street, premiere staging) with a sidecar and per-image purpose, linked from + `docs/hollywood-boulevard-map.md` and credited in `CREDITS.md`. Cropped the foreground crowd + out of the facade shot; EXIF stripped. (`docs/screens/refs/hollywood/`.) +- [ ] Joke Shop board: licence-cleared Sunset Strip photos (canopy, blade sign, hillside, + across-street frontage) with the same sidecar, and link it from `docs/joke-shop-map.md`. +- [ ] TV Studio board: licence-cleared studio-entrance photos (or a documented decision to use + generated concepts only, with the reason) and its sidecar. +- [ ] Fill the remaining Hollywood gaps noted in the board README: night facade, Walk of Fame + terrazzo close-up, sidewalk-level steps, east retail neighbours. No Street View, no scraped + social media. - [ ] Generate one concept board per venue with `tools/scene_concepts.py generate` (palette, facade rhythm, lighting), keep raw output gitignored, commit only the selected board, and record the model, prompt and spend in the sidecar. diff --git a/docs/hollywood-boulevard-map.md b/docs/hollywood-boulevard-map.md index 74179a8..96b8f0f 100644 --- a/docs/hollywood-boulevard-map.md +++ b/docs/hollywood-boulevard-map.md @@ -66,6 +66,10 @@ not texture or geometry sources. ## References +The committed, license-cleared photo board for this block — with the provenance sidecar and the +decisions each photo informed — is in +[`screens/refs/hollywood/README.md`](screens/refs/hollywood/README.md). + - [Hollywood Masonic Temple — Wikipedia](https://en.wikipedia.org/wiki/Hollywood_Masonic_Temple) - [El Capitan Entertainment Centre — OpenStreetMap way 424024147](https://www.openstreetmap.org/way/424024147) - [El Capitan Theatre — OpenStreetMap way 424024148](https://www.openstreetmap.org/way/424024148) diff --git a/docs/screens/refs/README.md b/docs/screens/refs/README.md index 552d19b..61c0c34 100644 --- a/docs/screens/refs/README.md +++ b/docs/screens/refs/README.md @@ -17,28 +17,38 @@ photo wins and the concept only informs palette and atmosphere. docs/screens/refs/ README.md # this file SIDECAR-TEMPLATE.md # copy per folder - hollywood/ # 6840 Hollywood Blvd block - SIDECAR.md + hollywood/ # 6840 Hollywood Blvd block (first board, 2026-11-03) + README.md # board overview and image gallery + SIDECAR.md # provenance table *.jpg|png joke-shop/ # 8433 Sunset Blvd block + README.md SIDECAR.md tv-studio/ # studio entrance reference set + README.md SIDECAR.md blocks// # local map-development blocks (TODO: Local map development) + README.md SIDECAR.md ``` -One folder per venue or block, one `SIDECAR.md` per folder listing **every** image in it. Keep the -folders flat; do not add sub-collections that the sidecar cannot describe. +One folder per venue or block with a `README.md` (the board: what each image is evidence for) and a +`SIDECAR.md` listing **every** image in it. `tools/check_docs.py` requires each tracked image to be +linked from the folder README, so the gallery and the sidecar stay in step. Keep the folders flat; +do not add sub-collections that the sidecar cannot describe. ## Naming ``` ----. -el-capitan-entrance-day-wikimedia-20231102.jpg -sunset-canopy-building-standard-ownphoto-20251103.jpg +---. +el-capitan-facade-day-wikimedia-2009-10-27.jpg +sunset-canopy-night-ownphoto-2025-11-03.jpg ``` +Use the full `YYYY-MM-DD` date when known; `YYYY-MM` or `YYYY` is acceptable for historical photos +where only that much is recorded (e.g. `masonic-temple-historic-pd-1922.jpg`). The sidecar always +carries the original capture date as precisely as the source states it. + Use lowercase words separated by hyphens, the camera view (`day`, `night`, `entrance`, `profile`, `across-street`), the source (`wikimedia`, `ownphoto`, `mapillary`), and the capture or download date. Never overwrite an existing file; add a new dated file instead diff --git a/docs/screens/refs/hollywood/README.md b/docs/screens/refs/hollywood/README.md new file mode 100644 index 0000000..fe649f2 --- /dev/null +++ b/docs/screens/refs/hollywood/README.md @@ -0,0 +1,30 @@ +# Hollywood Boulevard reference board + +Licensed photographs of the real El Capitan Entertainment Centre block at 6840 Hollywood +Boulevard, used as evidence for the venue's proportions, signage and staging. They are +development reference only and are **not** shipped with the game. + +Provenance, licences and the decisions these photos informed are in +[`SIDECAR.md`](SIDECAR.md). The rules for this folder are in +[`../README.md`](../README.md); generated art-direction frames live in +[`../../concepts/hollywood_boulevard/`](../../concepts/hollywood_boulevard/README.md). + +| Photo | What it is evidence for | +| --- | --- | +| ![El Capitan facade, day, with three vertical banners](el-capitan-facade-day-wikimedia-2009-10-27.jpg) | **Facade, day.** Six Ionic columns, the Masonic parapet motto, banner count and size, stone joints, window rhythm and the marquee overhang. | +| ![El Capitan theatre blade sign and the Masonic temple frontage from the street](el-capitan-theatre-blade-sign-day-wikimedia-2008-10.jpg) | **Block relationship.** The theatre's vertical blade sign next to the temple frontage, the setback, kerb line and street width. | +| ![The Masonic Temple in 1922, before the theatre complex](masonic-temple-historic-pd-1922.jpg) | **Original elevation.** The 1922 facade with the motto band, cornice and column order, before later signage and tenants. | +| ![Ovation Hollywood across the boulevard](ovation-hollywood-across-street-pd-2006-12-28.jpg) | **Across the street.** The Ovation Hollywood frontage, its height relative to the temple, and the plaza opening on Highland. | +| ![Red carpet premiere staging with barriers along the sidewalk](premiere-staging-street-day-wikimedia-2006-02-12.jpg) | **Premiere staging.** Red carpet run, crowd barriers, tent line and the way the sidewalk narrows for an event. | + +## Gaps to fill + +- A night photograph of the facade and blade sign (lighting reference; the current night + evidence is the generated concept frame). +- A close-up of the Walk of Fame terrazzo and of a star medallion for material scale. +- A sidewalk-level shot of the steps and door recess for the entrance approach. +- A licensed photo of the east retail neighbours (Jimmy Kimmel / El Capitan Theatre block + neighbours) for the facade rhythm beyond the hero building. + +Add new files with the naming convention in [`../README.md`](../README.md) and list them in the +sidecar in the same commit. diff --git a/docs/screens/refs/hollywood/SIDECAR.md b/docs/screens/refs/hollywood/SIDECAR.md new file mode 100644 index 0000000..f3269d0 --- /dev/null +++ b/docs/screens/refs/hollywood/SIDECAR.md @@ -0,0 +1,59 @@ +# Sidecar — El Capitan Entertainment Centre block, 6840 Hollywood Blvd + +| Field | Value | +| --- | --- | +| Venue / block | El Capitan Entertainment Centre (Masonic Temple), Hollywood Boulevard | +| Folder | `docs/screens/refs/hollywood/` | +| Collected by | project (agent session, 2026-11-03) | +| Date range | 1922–2009 (original captures); downloaded 2026-11-03 | +| Intended use | venue three-up board, facade proportions, signage, staging | +| Shipped? | no — development reference only; not bundled with the game or releases | + +## Photographs + +| File | Subject | View | Source | Author | Licence | Captured | Purpose | Shipped | +| --- | --- | --- | --- | --- | --- | --- | --- | --- | +| `el-capitan-facade-day-wikimedia-2009-10-27.jpg` | El Capitan facade | day, straight on (foreground crowd cropped) | | woo (Irvine, CA, USA) | CC BY 2.0 | 2009-10-27 | column order and spacing, motto band, banner size/count, stone joints | no | +| `el-capitan-theatre-blade-sign-day-wikimedia-2008-10.jpg` | El Capitan Theatre blade sign and temple frontage | day, across street | | Andreas Praefcke | CC BY 3.0 | 2008-10 | block relationship, setback, street width, sign height | no | +| `masonic-temple-historic-pd-1922.jpg` | Masonic Temple | historic elevation | | Charles W. Beam | Public domain | 1922 | original elevation, cornice, motto band, column order | no | +| `ovation-hollywood-across-street-pd-2006-12-28.jpg` | Ovation Hollywood (Hollywood & Highland) | day, across street | | Gary Minnaert | Public domain | 2006-12-28 | opposite frontage height, plaza opening, skyline relationship | no | +| `premiere-staging-street-day-wikimedia-2006-02-12.jpg` | premiere staging on the boulevard | day, elevated across street | | John Barreiros | CC BY 2.0 | 2006-02-12 | red carpet run, barriers, tent line, sidewalk narrowing | no | + +Licence texts: [CC BY 2.0](https://creativecommons.org/licenses/by/2.0/) and +[CC BY 3.0](https://creativecommons.org/licenses/by/3.0/). The CC BY files are also listed in +[`../../../CREDITS.md`](../../../CREDITS.md) under "Development-only reference images". + +## Redactions and permissions + +- The facade photo's foreground crowd (bottom 30%) was cropped out before committing; no faces were + blurred because none remain at the committed crop. +- The remaining files only contain incidental pedestrians at street distance (a few pixels tall); + no identifiable faces, plates or interiors. +- Public frontage only; no interiors, no staff, no property-permission requirement. + +## What was derived from this set + +| Decision | Evidence | Where it landed | +| --- | --- | --- | +| Six Ionic columns, ~2.4 m spacing, 8 steps | facade photo measured against the door width | `docs/hollywood-boulevard-map.md` geometry notes | +| Masonic parapet motto and medallions | 1922 elevation + facade photo | `WorldBuilder` facade, `docs/screenshots/01-venue-overview.png` | +| Three vertical event banners | facade photo | facade banners and the day/night capture set | +| Red carpet + barrier staging narrows the sidewalk | premiere photo | `docs/hollywood-boulevard-map.md` event staging notes | +| Across-street height and plaza opening | Ovation photo | opposite frontage massing | + +## Generated boards used with this set + +Generated frames are kept in [`../../concepts/hollywood_boulevard/`](../../concepts/hollywood_boulevard/README.md). +They are used for palette and mood only; shape and signage follow the photographs above. + +| Board | Path | Model | Generated | Spend | +| --- | --- | --- | --- | --- | +| Hollywood entrance, day | `docs/screens/concepts/hollywood_boulevard/hollywood_boulevard_entrance_day.png` | `openai/gpt-5-image-mini` | 2026-11-01 | ~$0.01 | +| Hollywood entrance, night | `docs/screens/concepts/hollywood_boulevard/hollywood_boulevard_entrance_night.png` | `openai/gpt-5-image-mini` | 2026-11-01 | ~$0.01 | +| Across the boulevard | `docs/screens/concepts/hollywood_boulevard/hollywood_boulevard_across_street.png` | `openai/gpt-5-image-mini` | 2026-11-01 | ~$0.01 | + +## Notes + +- Images were downloaded at 1600 px wide, re-encoded as JPEG q85 with EXIF removed (no GPS or + camera metadata is committed). +- The original untouched downloads stay outside the repository. diff --git a/docs/screens/refs/hollywood/el-capitan-facade-day-wikimedia-2009-10-27.jpg b/docs/screens/refs/hollywood/el-capitan-facade-day-wikimedia-2009-10-27.jpg new file mode 100644 index 0000000..5a01b33 Binary files /dev/null and b/docs/screens/refs/hollywood/el-capitan-facade-day-wikimedia-2009-10-27.jpg differ diff --git a/docs/screens/refs/hollywood/el-capitan-theatre-blade-sign-day-wikimedia-2008-10.jpg b/docs/screens/refs/hollywood/el-capitan-theatre-blade-sign-day-wikimedia-2008-10.jpg new file mode 100644 index 0000000..d3c212a Binary files /dev/null and b/docs/screens/refs/hollywood/el-capitan-theatre-blade-sign-day-wikimedia-2008-10.jpg differ diff --git a/docs/screens/refs/hollywood/masonic-temple-historic-pd-1922.jpg b/docs/screens/refs/hollywood/masonic-temple-historic-pd-1922.jpg new file mode 100644 index 0000000..009f566 Binary files /dev/null and b/docs/screens/refs/hollywood/masonic-temple-historic-pd-1922.jpg differ diff --git a/docs/screens/refs/hollywood/ovation-hollywood-across-street-pd-2006-12-28.jpg b/docs/screens/refs/hollywood/ovation-hollywood-across-street-pd-2006-12-28.jpg new file mode 100644 index 0000000..2094d93 Binary files /dev/null and b/docs/screens/refs/hollywood/ovation-hollywood-across-street-pd-2006-12-28.jpg differ diff --git a/docs/screens/refs/hollywood/premiere-staging-street-day-wikimedia-2006-02-12.jpg b/docs/screens/refs/hollywood/premiere-staging-street-day-wikimedia-2006-02-12.jpg new file mode 100644 index 0000000..fd421c0 Binary files /dev/null and b/docs/screens/refs/hollywood/premiere-staging-street-day-wikimedia-2006-02-12.jpg differ