Slice a caption sidecar to one chunk's window [frameStart, frameEnd), with spans clipped to the window and re-based to chunk-local frame indices.
This is the caption counterpart of planChunkedSequenceRender's frame-atomic chunking, so each chunk render carries its own caption track. A frameEnd past the sidecar's coverage is clamped to frameCount, which is how the last, shorter chunk is sliced. Throws when frameStart is not a non-negative integer, when frameEnd is not an integer above frameStart, or when frameStart is at or beyond frameCount, which means the render and the caption plan disagree on the frame count, for example because they were planned at different fps. The input spans must be in play order and tile the frames, as planCaptionSidecar and this function produce them.
Slice a caption sidecar to one chunk's window
[frameStart, frameEnd), with spans clipped to the window and re-based to chunk-local frame indices.This is the caption counterpart of
planChunkedSequenceRender's frame-atomic chunking, so each chunk render carries its own caption track. AframeEndpast the sidecar's coverage is clamped toframeCount, which is how the last, shorter chunk is sliced. Throws whenframeStartis not a non-negative integer, whenframeEndis not an integer aboveframeStart, or whenframeStartis at or beyondframeCount, which means the render and the caption plan disagree on the frame count, for example because they were planned at different fps. The input spans must be in play order and tile the frames, asplanCaptionSidecarand this function produce them.