Log inGet started
Package

HallEye.component

Newest version

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, openRate and glow, glowTarget, glowRate — all six are 0 in shot 1 and are authored that way on component.add. A field left off add takes 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 intensity glow = 1 reaches.
  • shiver — the amplitude of the shut lid's tremor.

Methods

  • ref:openTo(v, secs) — roll the lids to v (0 shut, 1 wide) over secs.
  • ref:glowTo(v, secs) — bring the pane's glow to v over secs.

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.