HallEye.component
README.md
HallEye
One clerestory window: its lids, and what is behind them. Two of them exist,
H_EyeL and H_EyeR, and they are the face's eyes.
The lids are two stacks of seven slats cut to the circle. Shut, they meet on the
axis and the window is a dark disc; opening rolls each stack back into its hood
and squashes it, so the slats gather rather than slide off the frame. A shut lid
is never quite still — a small shiver rides on 1 - open.
glow writes the hall_eyepane material's emissive_intensity. That is the
glass itself; the light this puts in the ROOM belongs to the look slice's rig.
Both eyes share one pane material, so both panes carry whatever the last write
said. The write is gated on a 0.002 change so a still eye costs nothing.
What it carries
open,openTarget,openRateandglow,glowTarget,glowRate— all six are 0 in shot 1 and are authored that way oncomponent.add. A field left offaddtakes the value the scene record persisted, which for a record saved mid-film is the end pose.travel,squash— how far a lid stack rolls and how far it gathers.glowGain— the emissive intensityglow = 1reaches.shiver— the amplitude of the shut lid's tremor.
Methods
ref:openTo(v, secs)— roll the lids tov(0 shut, 1 wide) oversecs.ref:glowTo(v, secs)— bring the pane's glow tovoversecs.
secs = 0 snaps. With rate <= 0 the approach returns the target outright,
which is why every target is authored at 0 too.
Who drives it
The stagecraft slice's FaceRig, from its EYES_OPEN and EYE_GLOW curves, every
frame. demo.hall's M.setEyesOpen / M.setEyeGlow reach both eyes at once
and are what M.restPose() uses.
Note
Driving a material property in edit mode writes through to the committed
mat.yaml (OrigoZero/zero#8448), so a take leaves hall_eyepane/mat.yaml dirty
at whatever glow the film ended on. The committed value is the shot-1 one; do
not stage that file out of a take without checking what it holds.