Log inGet started
World

Fire For Effect

Branchmain
Branchesmain
Commit37462ca2bd

README.md

shots

The sixteen camera set-ups of FIRE FOR EFFECT, one per entry in Film.SHOTS and in the same order, plus the lens each one implies. Consumed by ffe.cinema, which evaluates it every rendered frame.

Exports

  • Shots.SETUPS — the sixteen set-ups. SETUPS16 is SETUPS1, the same table by reference: that equality is the film's arc.
  • Shots.eval(t) -> eye, aim, fov, setup, u — the camera at film time t. Anchors that are functions are resolved first, so the result is plain numbers and cutscene.evaluate never sees an entity name that might be gone.
  • Shots.focalLength(fov) -> mm — the lens a vertical field of view implies against Shots.SENSOR_HEIGHT (24 mm, full frame).
  • Shots.focusDistance(setup, eye, aim, u) — the rack the shot asks for, or the distance to what it is aimed at when it does not rack.
  • Shots.ridePosition(t) / Shots.shell(t) / Shots.rideDir(t) — the registration round's flight, which shot 6's camera rides.
  • Shots.check() — every station evaluated at its own mid-point, as text.

Places

HERO_MUZZLE, HERO_BREECH, HERO_CENTRE, BRASS_PILE, AMMO_DUMP, SPOTTING_MAST, EAST_LIP — where the camera stands and what it looks at, in one block, so a station can be re-read against the geography instead of hunted for inside a shot.

Notes

  • A named anchor is a preference, not a requirement. Four agents build this world in parallel, so a shot has to frame something whether or not its subject exists yet: Shots.named tries a list of entity names and falls through to a coordinate. Nothing in this file raises on a missing entity.
  • The ride is authored twice on purpose. ffe.battery owns the shell; when its entity is in the world the camera rides the real round, and when it is not, ridePosition stands in — fired at t = 30.5, through the deck at t = 37.6, onto the target at t = 40.0, the same three numbers.
  • ease is linear wherever the move has a stated speed (the shot-12 aerial at 14 m/s) and eased everywhere the move is an operator's.