HallRun.component
README.md
HallRun
A wave that travels across every child of one group. Each child gets the same motion a fixed phase later than the one before it, so the group reads as one thing crossing rather than as many things wobbling.
Three of them are in the film: the grass thrashing in the rain outside the facade in shot 2, the wallpaper peeling away in a run down the mirror corridor in shot 5, and the lath swinging under the ceiling hole.
Each child's authored rotation is captured the first time it is driven and everything is added on top of it, so a child placed at its own angle keeps it.
What it carries
mode—"rot"or"pos";axisX/Y/Zis the direction.amp,base,period,phaseStep,gain— the wave and the lag per child.oneSided— clamp the wave into [0, 1], for something that only bends one way (a peeling strip does not bend back into the wall).gust— a slow envelope crossing the group on top of the wave, so grass in rain comes in runs instead of at a constant amplitude.
Method
ref:recapture()— re-read every child's authored rotation as the new rest pose. Call it after re-placing the children; otherwise the wave is added to whatever angles were captured first.
Cost
One transform write per child per tick. It guards both hooks on engine.mode:
the film runs in edit with the simulation going, where the engine fires both,
and an unguarded body makes the 1.15 s grass a 0.57 s one and the 4.7 s peel a
2.35 s one.