Log inGet started
World

The House Wears a Face

Branchmain
Branchesmain
Commit8e7f3baa4a

README.md

hall

The place itself — everything in THE HOUSE WEARS A FACE that is architecture. Grounds and the grin-gate, the facade, the entry hall, the mirror corridor, the two-storey ballroom shell with its ceiling hole and its 176-square checkerboard, the proscenium that becomes a mouth, the two clerestory eyes and their lids, and the stage. Around 2,100 entities, cut from five primitive meshes and 26 hall_* materials.

Light is not its job — that is demo.look. Weather is not its job — that is demo.air. Anything that is not part of the building is demo.props.

Exports

  • M.content(root) -> Entity — build the whole place under root. Called by the scene build through demo.beats, in slice order.
  • M.register() — declare this slice's beat handlers. One thing is left on a beat: the window above the porch, lit in shot 1 and put out in the middle of shot 2 (b01_gate, b02_facade, b02_windowout).
  • M.reset() — return the slice to its shot-1 state: the rest pose, the lit window, the breath rewound.
  • M.restPose() — the pose the film opens on. Reform 0, chew 0, lids shut, panes dark. Written through the rig's own methods, so it corrects a world whose scene record was saved holding the END pose.
  • M.setReform(p, secs), M.setChew(v, secs), M.setEyesOpen(v, secs), M.setEyeGlow(v, secs) — the slice's own writers onto the rig.
  • M.floor(), M.mouth(), M.eye(side) — the rig's three component refs.
  • M.bakeReflections() — re-bake every reflection probe from the light standing in the rooms right now. An authoring step; it yields.
  • M.mouthColumnX(i), M.mouthLips(i, p) — the proscenium's column geometry. buildMouth places the 23 columns with these at p = 0 and hands the same six numbers to HallFaceRig, which evaluates the same curve every frame from there on, so the aperture exists as one set of numbers.
  • M.MOUTH_COLS, M.MOUTH_W — the column count and width, for a slice that has to line something up with the arch.

Who drives the room

The film's schedule is the stagecraft slice's FaceRig, which holds reform, eye-open, eye-glow and chew on continuous curves across the whole hundred seconds and writes all four every frame. This slice does not hang them on beats. Two drivers of one field is how a room moves twice, or not at all.

Components

HallFaceRig (the proscenium's move), HallEye (one clerestory), and HallFloorChew (the checkerboard) are the rig. HallBreath, HallDrift, HallChain, HallRun and HallMirrorLag are the motion that runs by itself. Each has its own README.

Notes

  • Every method another file calls is typed function public:name(...) and is called ref:name(...). That is the one calling convention a component ref answers to; a dot-call puts the first argument where self belongs.
  • Every driven field is authored at its shot-1 value on component.add, target and rate included. A field left off takes the value the scene record persisted, not the component's declared default.
  • The reflection probes make the mirrors and the wet floor reflect the rooms rather than the sky. Their cubes are stills: baked over a dark house they are black. After a change to the light rig, seek into Act II and call M.bakeReflections().
  • After editing this file, rebuild the scene: tools.use("scene", "reload"). Editing a module a build requires does not itself trigger the rebuild.