Resolve one film-global frame to the shot frames that compose it, with dissolve and fade weights.
The active segment is the last one whose [startFrame, endFrame) contains the frame; the canonical builder orders segment starts without gaps. Inside an incoming dissolve of d frames, at offset k into the segment, the outgoing segment's tail frame sourceOutFrame - d + k is layered at weight 1 - k / d under the incoming frame at k / d. Otherwise the one layer is weighted by the smaller of an incoming fade's k / d and an outgoing fade's remaining / d, where remaining counts this frame and the ones after it in the segment. The timestamp is independently computed binary64 frame time at the reduced rational rate, not an exact rational value.
The answer depends only on the timeline and the frame number, so a browser seek, a render chunk and a full render resolve the same layers. Throws when the frame is not a safe integer inside [0, totalFrames), when no segment contains it, when a dissolving segment has no predecessor, or when the timeline's rate fields disagree.
Resolve one film-global frame to the shot frames that compose it, with dissolve and fade weights.
The active segment is the last one whose
[startFrame, endFrame)contains the frame; the canonical builder orders segment starts without gaps. Inside an incoming dissolve ofdframes, at offsetkinto the segment, the outgoing segment's tail framesourceOutFrame - d + kis layered at weight1 - k / dunder the incoming frame atk / d. Otherwise the one layer is weighted by the smaller of an incoming fade'sk / dand an outgoing fade'sremaining / d, whereremainingcounts this frame and the ones after it in the segment. The timestamp is independently computed binary64 frame time at the reduced rational rate, not an exact rational value.The answer depends only on the timeline and the frame number, so a browser seek, a render chunk and a full render resolve the same layers. Throws when the frame is not a safe integer inside
[0, totalFrames), when no segment contains it, when a dissolving segment has no predecessor, or when the timeline's rate fields disagree.