Log inGet started
Package

FaceRig.component

Newest version

README.md

FaceRig

The schedule the room assembles itself on: when the mouth widens, when the lids open, when the light behind the eyes arrives, and when the floor starts chewing.

One of these exists, on the Stagecraft entity. The hall slice builds the mechanism (a mouth on a reform rig, two clerestory eyes with lids and a pane that glows, a floor that chews and carries the smile line) and this component is the other half of it. It changes when the room moves, never how far.

How it drives

Four curves, each a list of { t, value, ease } keys read off the film clock. Every frame it evaluates all four at the film's current second and writes them onto the hall's components with secs = 0, an immediate set. That is the difference between a room that assembles and a room that assembles the same way twice: a tween given a duration advances on the frame's own dt, so where it stands at 0:88 depends on how loaded the machine was on the way there, while a curve read off the cutscene's clock stands where the film says and nowhere else.

CurveShape
REFORMFlat at 0 until 77.2, a third of the way by 83, whole by 91, arriving a beat before the cut into shot 14 so the match cut lands on a room that has stopped moving.
EYES_OPENShut for ninety per cent of the film. Open across shot 13, held through the match cut, and the last movement in the picture is the lids coming back down.
EYE_GLOWAn ember from 77, 0.72 by 90, full inside shot 14, gone by 99.4. It arrives before the lids open, so the eyes are already alight when they show.
CHEWA tremor under the first full view of the ballroom, the whole floor chewing by the boot-level shot, and it never settles again.

Reaching the rig

Each part is resolved to its own component and called with a COLON: mouth:driveTo(v, 0), eye:openTo(v, 0), floor:chewTo(v, 0). A content component's method is on the component ref when it is declared typed function public:name(...), and is called the same way a builtin component's is. A function declared at file scope is the component's own and is not on the ref at all.

A value is recorded as applied only once the rig has taken it. If a call raises, the next frame tries the same value again: the room the curve asks for is where the room should stand, and a refusal the schedule treats as done leaves the room a whole shot behind the film. The complaint is made once per value, not once per frame.

Fields

FieldMeaning
activeOff leaves the room wherever it stands.

Methods

CallReturns
rig:report()The film's time, where each of the four curves stands at it, and driving, which says whether each of the four parts of the rig is answering. The one call that says whether shot 13 has anything to move.