lasagnastack.models.reel_pipeline.cut_list¶
lasagnastack.models.reel_pipeline.cut_list
¶
AltCaptionSet
¶
Caption
¶
Bases: BaseModel
Clip-scoped text overlay for a single cut.
Timing is relative to the cut's own start and is clamped to the cut's
duration at render time. For text that must persist across a cut boundary,
use CutList.overlays instead.
out_ms
instance-attribute
¶
Milliseconds after this cut's start when the caption disappears.
Must not exceed the cut's duration_sec × 1000; enforced by the critique stage.
CropHint
¶
Cut
¶
Bases: BaseModel
One clip segment placed on the edit timeline.
caption
instance-attribute
¶
caption: Caption | None
Optional clip-scoped text overlay. Use CutList.overlays for text that spans multiple cuts.
in_
class-attribute
instance-attribute
¶
Trim-in point in MM:SS.D format. Aliased from 'in' to avoid the Python keyword.
role
instance-attribute
¶
hook | establish_location | payoff_reaction | detail | transition | callout | outro
source_file
instance-attribute
¶
Filename of the source clip, matched against input_dir at render time.
source_segment_id
instance-attribute
¶
The Segment.id this cut was taken from.
speed
instance-attribute
¶
Playback speed multiplier. 1.0 = normal; < 1.0 = slow motion; > 1.0 = speed ramp.
transition_in
instance-attribute
¶
Incoming transition: none | cut | fade | dissolve
transition_out
instance-attribute
¶
Outgoing transition: none | cut | fade | dissolve.
May be overridden by ReelStyleSheet.cut_styles at render time.
CutList
¶
Bases: BaseModel
Stage 3 output: the full ordered edit.
alt_captions
instance-attribute
¶
alt_captions: list[AltCaptionSet]
Alternative caption texts for A/B testing, one set per captioned cut.
Overlay
¶
Bases: BaseModel
A text overlay placed at an absolute timeline position, independent of any single cut.
Use this for text that must persist across a cut boundary — e.g. a location title that bridges an establishing shot and the first detail shot, or a CTA that appears over the final two clips. Timing is expressed in milliseconds from the start of the full reel timeline, NOT relative to any individual cut.