security-game/docs/hollywood-boulevard-map.md

# Hollywood Boulevard map reference

The Hollywood venue is a stylized reconstruction of the real block around the
El Capitan Entertainment Centre. It is a game space, not a survey-accurate
model: the landmark silhouette, street wall and approach read from the player's
eye height, while side streets and interiors are simplified.

## Real site

- **Address:** 6840 Hollywood Boulevard, Hollywood, Los Angeles, CA 90028.
- **Coordinates:** 34.10118 N, 118.34009 W (OSM way `424024147`).
- **Building:** the 1921 Hollywood Masonic Temple, designed by John C. Austin in
  the Classical Revival style; now the El Capitan Entertainment Centre and the
  home of *Jimmy Kimmel Live!*. This is the game's **starting point**: the first
  shift (Hollywood) and the late-night TV Studio arrival both begin at this
  building, where the Kimmel stage and studio occupy the interior behind the
  six-column facade.
- **Facade:** a light stone/render Neoclassical front with six oversized Ionic
  columns, a recessed main entrance reached by eight stone steps, ornamental
  iron door grilles, a continuous crosscut-grille transom, two street-level side
  entrances, and a parapet with the Masonic motto and circular medallions.
- **Neighbours:** the El Capitan Theatre (6838) immediately west, a modern
  retail block east, and the Ovation Hollywood frontage (6801) across the
  four-lane boulevard.
- **Sidewalk:** the Hollywood Walk of Fame terrazzo strip with brass stars runs
  along the kerb; the kerb is painted red in the reference photographs.

### Late Night TV Studio venue

The game's third venue is **the same block**, not a separate real site. The building houses
*Jimmy Kimmel Live!*, so the "Late Night TV Studio" scenario restages 6840 Hollywood Blvd as a
studio arrival: the same stone facade and steps, plus a bulb-lit canopy, a glossy black car at the
kerb, a barrier/stanchion line and an audience queue. The Kimmel stage/audience and the entrance
marquee are researched as local-only reference sets under
`tmp/research/jimmy-kimmel-stage/` and `tmp/research/jimmy-kimmel-entrance/` (gitignored); the
photo-anchored entrance concepts live in
[`screens/concepts/hollywood_boulevard/README.md`](screens/concepts/hollywood_boulevard/README.md). `VENUE_SPECS["tv_studio"]` is a variant of the
Hollywood spec (30.0 m facade instead of 29.6 m, arrival staging instead of the day-time banners),
and it shares this block's reference board rather than owning one.

## Game mapping

| Real feature | In-game representation |
| --- | --- |
| 29.6 m wide, 14.5 m high facade | `VENUE_SPECS["hollywood_building"]`: `facade_width` 29.6, `facade_height` 14.5, front at `z = -4` |
| Eight stone steps | `stair_count` 8, `stair_height` 0.10, `stair_tread` 0.38, 12 m wide |
| Six Ionic columns | `IonicColonnade` at x = -12.4 … 12.4, 4.96 m bay spacing |
| Recessed main entrance + two side doors | central 4.2 m door and 2.5 m side doors with transoms |
| Red event banners | three stylized `EL / CAPITAN / LIVE` banners in the central bays |
| Masonic motto + medallions | `FriezeInscription` label and two stone discs |
| El Capitan Theatre | `NeighbourBlocks/ElCapitanTheatre` with marquee, blade sign and practical light |
| Retail block east | `NeighbourBlocks/EastRetailBlock` with glazed shopfront |
| Ovation Hollywood | `OvationHollywood` arcade with seven arched openings, sign and south sidewalk |
| Walk of Fame | `WalkOfFame` dark terrazzo band with ten stars |
| Four-lane boulevard | double-yellow centre, broken white lane lines, red kerb paint and crosswalk |
| TV Studio arrival staging | `VENUE_SPECS["tv_studio"]`: same six-column Masonic facade and eight steps (reuses `masonic_facade`), plus `bulb_canopy`, `sedan`, `handrail` and barrier placements instead of the day-time marquee |

The generated AI references live in
[`docs/screens/concepts/hollywood_boulevard/`](screens/concepts/hollywood_boulevard/README.md).
They are art direction for lighting, material scale and composition; they are
not texture or geometry sources.

## Deliberate simplifications

- Show branding is replaced by the venue-neutral `EL / CAPITAN / LIVE` banner
  text. The building name and address are retained.
- The opposite Ovation frontage is represented as a single arcade block rather
  than its full mall plan. Interiors, the Metro entrance and side streets are
  out of playable bounds.
- The AI concept frames are 1280×720 references. The in-game geometry is built
  from boxes, cylinders and a small number of custom arch/star meshes so it
  stays inside the Compatibility/Web budget.
- The venue menu offers Day and Night Hollywood rows. Night is the same
  geometry and scenario with a late-phase offset, not a second baked map; the
  phase still drives sun, sky, fog, windows, signage and practical lights.
- The landmark facade uses the shared smooth limestone/stone texture rather
  than the noisier granite panel tile. The whole venue measures **58,884
  triangles across 409 meshes** in `test_hollywood_geometry_stays_inside_the_map_budget`,
  well inside the 150k/600 budget.
- Local lights use linear attenuation (`omni_attenuation = 1.0`). Godot treats
  `0.0` as constant falloff, which previously turned the night facade into a
  flat yellow wall; the sconces now pool light instead.
- The masonic facade field uses the `limestone_ashlar` pick: a seamless ashlar
  tile generated reference-anchored on the 2009 facade photo (CC BY 2.0),
  768 px over ~4.6 m of wall (~167 px/m), so the wall carries course joints and
  per-block value variation instead of flat plaster.
- Night balance: the event banners carry a warm self-light and the marquee sign
  face + bulbs brighten after dark (registered with `_marquee_emissive`), so the
  facade reads as practical-lights-only rather than a flat lit wall. The marquee
  canopy stays black metal by design — the fictional "GIG LINE" marquee, not the
  red El Capitan Theatre marquee next door.

## 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). The three-up boards
(real photo | generated concept | current capture) live in
[`screens/boards/README.md`](screens/boards/README.md) and make the remaining facade-realism gap
visible: the capture panel still shows flat material bands where the photo has limestone value
variation, joint lines and reveal depth.

- [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)
- [Ovation Hollywood — OpenStreetMap way 151485232](https://www.openstreetmap.org/way/151485232)
- [Hollywood Masonic Temple facade — Wikimedia Commons](https://commons.wikimedia.org/wiki/File:El_Capitan_Theater_frontal_fachade-The_Masonic_Temple.jpg)
- Local frames that changed a decision (gitignored, never committed):
  - `tmp/research/elcapitan-2026/` (recent Commons geosearch) → established that no recent photo
    frames the El Capitan facade straight-on in daylight, so the 2009 CC BY frame stays the
    geometry reference.
  - `tmp/research/jimmy-kimmel-entrance/07.jpg` → the photo anchor for the four Jimmy Kimmel
    entrance concepts (day/night × gemini/gpt), confirming the starting-point building.
- [Hollywood Masonic Temple and El Capitan Theatre, 2013 — Wikimedia Commons](https://commons.wikimedia.org/wiki/File:Hollywood_Masonic_Temple_2013-10-13_10-02-25.jpg)

## Verification

```bash
godot --headless --path . --script res://src/test/test_runner.gd
godot --path . --script res://src/test/capture_realism.gd -- --out=/tmp/gig-line-hollywood --stages=day,evening,late
python3 tools/check_docs.py
```