Struct Timeline 

pub struct Timeline { /* private fields */ }

Immutable, validated multi-track timeline with integer frame-aligned intervals.

Created by TimelineBuilder::build; a built timeline never changes. Empty timelines last zero ticks; trailing gaps contribute duration. An explicit duration clips or extends all tracks without retiming their scenes. This is the canonical root Timeline. Nested output clips the child viewport before centered contain mapping into its parent’s design space; child frame rate does not retime parent ticks.

Implementations

impl Timeline

pub fn new(size: Size, rate: FrameRate) -> TimelineBuilder

Starts a timeline; invalid dimensions or rates are reported by build.

pub fn try_new(size: Size, rate: FrameRate) -> Result<TimelineBuilder>

Starts a timeline without discovering fonts, devices or encoders. Rates above one frame per tick cannot define a distinct frame grid.

pub fn to_builder(&self) -> TimelineBuilder

Reopens this timeline for further edits. Audio resolved by resolve_audio is dropped and must be resolved again.

pub fn size(&self) -> Size

Logical timeline viewport; supply this to composition rendering.

pub fn frame_rate(&self) -> FrameRate

Frame grid used for all schedule boundary adjustments.

pub fn background(&self) -> Option<Color>

Background below every track, if any.

pub fn duration(&self) -> Duration

Final duration: the explicit value, or the end of the tracks and audio, independent of any parent clip duration.

pub fn frame_count(&self) -> u64

Exact output frame count. Existing Composition needs checked u32 conversion.

pub fn tracks(&self) -> &[Track]

Immutable tracks in bottom-to-top paint order.

pub fn soundtrack(&self) -> &Soundtrack

Audio clips, buses and master settings declared on this timeline.

pub fn diagnostics(&self) -> &Diagnostics

Structured warnings, without stderr side effects.

pub fn resolve_audio( &self, resolve: impl FnMut(&AudioClip) -> Result<AudioClip>, ) -> Result<ResolvedAudio>

Resolves the soundtrack’s clips at an I/O boundary, for example by reading files. The timeline itself is unchanged; the result carries the clips and the output duration they require.

pub fn visual(&self) -> TimelineVisual

Wraps this timeline as a picture-only Scene, for embedding where audio must not follow, for example SceneContext::embed.

pub fn render(&self, context: &SceneContext<'_>) -> Node

Builds one snapshot without retaining previous-frame state. Times at or after duration produce nothing.

pub fn render_until(&self, context: &SceneContext<'_>, end: Duration) -> Node

Like render but keeps drawing until end, for exports whose resolved audio outlasts the picture.

Trait Implementations

impl Clone for Timeline

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Timeline

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.