hall.module
This package holds more than this page lists. See all of its files in its world.
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 underroot. Called by the scene build throughdemo.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.buildMouthplaces the 23 columns with these atp = 0and hands the same six numbers toHallFaceRig, 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 calledref:name(...). That is the one calling convention a component ref answers to; a dot-call puts the first argument whereselfbelongs. - 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.