# Crown Landmark (PI-BLD-0001-V01) exterior build C03 — shared spec

Goal: a Blender exterior shell that matches the approved EXT R06 reference imagery and the authored targets. Isolated modeling only: no Unreal, no shared-world placement, no change to INT R02.
Labels: **target** = authored in R06 (proposed for blockout, not accepted); **proposed** = a builder choice, must be recorded; **measured** = read from the built mesh.

## Frame and units
Metres, Z up, front = -Y, X = local right, origin = tower centre at finished ground (z=0). Exterior only; shell must be hollow-ready (thin shells and slabs, no solid-filled volumes) because interiors follow later.

## References (read the images; they control the look)
`CrownLandmark/refs/` (copied from repo `production/assets/buildings/PI-BLD-0001-V01/EXT/R06/`):
- Silhouette authority: `01_Master/..._Master_Tall.jpeg` and `03_IndividualViews/..._01_Front.png`.
- Rear authority: `..._02_Rear.png` (central lens-shaped glass pod with crossed gold curves, flanked by ribs). B02's continuous blue-glass rear is secondary only.
- Sides: `02_OverviewBoards/..._B02_Elevations_Corrected.jpeg`, B01 oblique; elevated: `..._05_FrontElevated`, `..._07_ElevatedCrown`, `..._08_ThreeQuarter`.
- Details: `..._09_CrownDetail`, `..._10_EntranceContext`, `..._11_PodiumContext`, `..._12_FacadeDetail`, `06_TightDetails/D01..D04`, `02_OverviewBoards/..._B03_ExteriorDetails.jpeg`.
- Plan: `05_ScaleAndPlan/..._13_RoofFootprintPlan.png`; numbers in `..._DesignTargets.json`; text in `04_Handoff/MODELING_BRIEF.txt`.

## What the references show (analysis)
- Tall concave "horn" glass tower: wide at the podium, flaring in smoothly, narrowing to a pointed crown. Blue glass, champagne-gold mullions, horizontal storey bands.
- Two large ivory ribs (R1, R2) form an A-frame at the front, springing from oval water basins at ±58 m, leaning inward to the crown tips. Four more ribs (R3/R4 sides, R5/R6 rear) are slimmer blades that hug the tower and rise into outer crown petals. Smaller secondary fins and curved flare fins sweep from the podium corners onto the tower base.
- Front: narrow gold-lit atrium channel up the tower centre with crossed gold curves; grand pointed entry arch (18 m wide, 14 m clear) with an 8 x 4.5 m portal, a small curved glass canopy, and a small ribbed glass dome/lantern over the arch.
- Podium: three stepped terraces (decks +18/+36/+54 m; 145x106, 125x90, 105x76 m), thin curved slab edges, flared tulip-shaped piers carrying arcades of tall arched glazed openings, blue glass parapets, rounded-rectangle plan.
- Crown: tall pointed petals (the six rib tips R1-R6 at 240/238/234/232/236/238 m plus smaller secondary petals), central glazed cap (16 x 24 m envelope).

## Targets (R06) — see cl_common.py for the constants
Height 240 m; foundation 160x120; decks +18/+36/+54 (145x106, 125x90, 105x76); tower body 68x54 at +54; roof +216; crown zone 216-240; entry arch 18 wide x 14 clear; portal 8 x 4.5; ribs R1..R6 foot/tip/tip-z as in `cl_common.RIBS`.
Proposed (not in R06): tower top 34x26 at +216 and concavity exponent 3.0 (`cl_common.tower_half_extents`). **Known conflict to record, not to resolve:** a strong taper pulls the glass inside the proposed L25/L26 room blocks (60x40, 60x48 m) used by INT R02; the repo's C02 kept the tower near 63.8x53.2 m through +135 m to fit them. C03 follows the reference silhouette first; `FLARE_K` and `TOWER_TOP` are the single knobs.

## Module contract
Five modules, one file each in `CrownLandmark/build/modules/`: `podium.py`, `tower.py`, `ribs.py`, `entrance.py`, `crown.py`. Each has `COLLECTION = "<Name>"` and `build()` creating objects only through `cl_common` helpers (`make_object`, `loft`, `blade`, `rounded_rect`, `pointed_arch`, `bezier`, `mat(...)`, `collection(...)`). Do not edit `cl_common.py` or `assemble.py`; module-local helper code is fine; ask for toolkit changes in your report.
Object names: `Podium_*`, `Tower_*`, `Rib_R1`..`Rib_R6` and `Fin_*`, `Entry_*`, `Crown_*`. One object per logical part, material from the shared palette (`ivory`, `glass`, `gold`, `amber`, `water`, `stone`, `parapet`).
Cross-module rules:
- Tower glass profile: use `C.tower_half_extents(z)`; ribs and fins hug it (small clearance, no deep intersection) and podium/tower meet at z=54.
- The front centre bay (|x| <= 22 m) is kept open in the podium walls and tier slabs where the entry arch and front atrium sit; podium must NOT put wall across the entry. The entry must be a real opening: at z=1.0 and z=1.7 m a ray along +Y from y=-100, x in [-4, 4] must pass the arch zone and the portal without hitting wall geometry until the lobby recess back wall.
- Ribs may pass through slab edges; avoid z-fighting and coincident surfaces.
- Keep each module under ~150k triangles; the whole build under ~1M.

## Build and test
Headless: `"C:\Program Files\Blender Foundation\Blender 5.2\blender.exe" --background --factory-startup --python CrownLandmark\build\assemble.py -- --modules <name> --tag <name>_vN --out CrownLandmark\out\<name>`
Renders (Workbench, material colours): front, rear, left, right (orthographic), top, elevated, elevated_rear. Compare your renders to the reference images with the Read tool; iterate at least three times per module. Record parameters and measured bounds in your report.

## Acceptance (per module, checked by reviewers)
Silhouette and proportions match the references in the matching view; targets above met (measured); no loose or inverted geometry; names/materials per contract; nothing built outside your module's scope.
