Files
gig-line/Tools
zwitschi c5e30d1c36 feat: hero facade blockout for 6840 Hollywood Blvd
Tools/hero_facade_build.py builds the north elevation parametrically and writes
a JSON report naming the evidence behind every part: the 25.75 m frontage and
14.5 m height are measured, the 4.96 m column bay comes from the sibling notes
and matches that frontage, the three portal flights follow the photographs (five
risers, overturning the inherited eight-step, 12 m wide claim), and the rest is
labelled assumption.

Tools/ue_hero_facade_import.py imports it with the ue_metric_v1 preset
(2604 x 1257 x 1450 cm, 1892 tris, 4 materials) and places it on the measured
building line of /Game/Hollywood/DemoMap.

Two new review shots at review-04 and review-05, both pending approval. Camera
placement cost four renders: the first two sat inside the facade body, and the
frontage faces Unreal -Y, so a camera has to stand at Y < -1450 cm, not north of
the building line in project terms.
2026-11-07 11:42:29 +01:00
..

Tools

Repeatable import/export and processing helpers. Anything that was done twice by hand belongs here.

Conventions

  • One script, one job. No interactive prompts; every input is an argument.
  • Each script documents its input format, output format, and the exact tool version it was tested with.
  • Blender scripts run headless (blender --background --python), so they can be re-run for a regression check.
  • No credentials, no absolute machine paths, no writes outside the project by default.
  • A script that produces game content logs what it produced, so Game/Content can be audited against it.

Helpers

  • render_screenshots.sh — visual-review pipeline: rebuilds /Game/Test/ReviewMap from current content (ue_build_review_map.py), runs the game on it in -game mode, lets AGigLineShotActor (Game/GigLine/Source/GigLine/) capture the fixed camera list, and copies the PNGs into the gitignored Screenshots/. See Screenshots/README.md.
  • check-lfs.sh — repository guard: fails if git-lfs or the lfs filter is missing, or if an LFS-tracked file was committed as a plain blob.
  • site_assembly.py — assembles terrain + street + blockout into one file and raycasts the walking routes for holes and steps.
  • street_mesh.py — road, kerbs, and sidewalks on the DEM, in the project frame; kerbs flush at the three crossings.
  • terrain_from_dem.py — terrain grid from the committed DEM, with building footprints cut out.
  • blosm_blockout.py — headless Blosm import of the committed .osm extract into a .blend, with a per-building scale report. Exact invocation in Art/blender/README.md.
  • page_image_fetch.py — resolves a web page's og:image and downloads it, with page URL and hash in a local sidecar. Works for Flickr, Commons file pages, and most photo blogs.
  • commons_fetch.py — Wikimedia Commons reference fetcher. Search, exact File: titles, or a whole Commons category (--category), thumbnails, provenance sidecar.json per folder. Wikimedia throttles upload.wikimedia.org (HTTP 429), so keep batches to six or fewer files and pass --delay 3; a throttled file is skipped and recorded rather than aborting the run. Writes only into the gitignored Art/reference/; reference images are never committed.

Planned helpers

  • Blender export preset runner (named presets, metric scale assertion)
  • OSM extract fetch and manifest writer (records date, bounds, checksum)
  • QGIS processing steps as batch scripts, so the geo cleanup is reproducible rather than GUI-only