How the end state of each shot connects to the opening of the next across each cut; never read.
Shot placements in playback order; at least one is required.
OptionaltrimByEvents?: { endEvent: string; startEvent: string }Resolve both bounds in the referenced shot's built events before
applying the normal trim and seam rules. The edit gate requires
trim: null with these bounds. Both ids must be non-blank and each
must match exactly once. The end must follow the start on the shot clock.
Exact id of the event at the trim end.
Exact id of the event at the trim start.
Finite positive playback frame rate in frames per second.
Why the trims and transitions serve the film's rhythm; never read.
OptionalrequiredRequire exactly one event with the given id in the given playback entry,
after trimming and assigning events on contiguous seams. Events come
from the built shot's events field, such as an authored prop handoff.
Omitting this list or giving an empty list adds no requirements.
OptionalrequiredCompare one sampled prop channel on the two sides of a declared hard cut. Omitted or empty means no prop checks. Both shots must use the same staged scene and write the channel through objectMotions. Reads the outgoing trim end from the left and the incoming trim start inclusively. For a symbolic trim the selected event supplies the exact end. Without a trim, those times are the outgoing shot duration and incoming time zero. If the outgoing winning track starts, steps or loops exactly at the cut, the check refuses that boundary because the inclusive sampler would read the discarded side. There is no fallback to an unstored staged value.
Stable finished-film identity and display name; only the id is checked, and it must be non-blank.
Coding-agent-owned edit over shot artifacts that were already built.
cutSequence folds it into an IAutoMovieSequence and reports its accumulated runtime in seconds; pacing and continuity rationale are review prose. The cut refuses invalid edit spans and a non-finite runtime. A placement may use two exact built event ids as its source bounds. Optional requirements check that a chosen play retains an interaction event or that a prop channel matches across a hard cut.