cutscene.path

Camera-path evaluation for a cutscene's shot list.

eval(shots, t) walks the list by cumulative duration and returns the eye position, the point it looks at, the field of view, the shot in effect and its progress. Anchors that name an entity are resolved at the call, so a shot framing something that moves follows it.

• eval(shots, t) -> eye, at, fov?, index, u
• duration(shots) -> number
• lookRotation(eye, at, up?) -> { x, y, z, w } — one table, the shape a rotation setter reads, so entity(cam).localRotation = Path.lookRotation(eye, at) is unbraced. A Transform.quat* constructor instead returns the four components separately and is braced into a table at the same assignment.
• lerp3(a, b, t) · readVec3(v) · clamp01(x) · easings()

Easing names come from @builtin::modules.tween.easing, so every curve the tween library has is available to a shot.