Struct TrackBuilder 

pub struct TrackBuilder { /* private fields */ }

Fluent scheduler with deferred diagnostics and immediate try_* alternatives. The requested cursor is not repeatedly rounded: each boundary is snapped once.

Implementations

impl TrackBuilder

pub fn push(self, scene: impl Scene + 'static) -> Self

Appends a finite scene, retaining invalid input for validate().

pub fn scene<Output: IntoSceneOutput + 'static>( self, duration: Duration, build: impl Fn(&SceneContext<'_>) -> Output + Send + Sync + 'static, ) -> Self

Appends a finite authoring callback accepting drawables or Result outputs.

pub fn push_for(self, duration: Duration, scene: impl Scene + 'static) -> Self

Appends a scene at the cursor for duration, whatever its natural duration.

pub fn place_for( self, start: Time, duration: Duration, scene: impl Scene + 'static, ) -> Self

Places a scene at absolute ticks for duration, whatever its natural duration.

pub fn push_trimmed( self, offset: Duration, duration: Duration, scene: impl Scene + 'static, ) -> Self

Appends a scene at the cursor that starts offset into its own timeline.

pub fn try_push_for( self, duration: Duration, scene: impl Scene + 'static, ) -> Result<Self>

Immediately checks and appends a scene for duration.

pub fn try_place_for( self, start: Time, duration: Duration, scene: impl Scene + 'static, ) -> Result<Self>

Immediately checks and places a scene for duration.

pub fn try_push_trimmed( self, offset: Duration, duration: Duration, scene: impl Scene + 'static, ) -> Result<Self>

Immediately checks and appends a scene that starts offset into its own timeline.

pub fn nest(self, child: Timeline) -> Self

Appends a nested timeline at the cursor, using its own duration. Its picture is clipped and fitted into this timeline’s design space; its audio joins this timeline’s soundtrack, shifted and cropped to the clip.

pub fn nest_for(self, duration: Duration, child: Timeline) -> Self

Like nest with an explicit clip duration: the child’s picture and audio are cropped to it, or padded with silence when it is longer.

pub fn place_timeline(self, start: Time, child: Timeline) -> Self

Places a nested timeline at an absolute time, like nest.

pub fn try_nest(self, child: Timeline) -> Result<Self>

Immediately checks and appends a nested timeline at the cursor.

pub fn try_nest_for(self, duration: Duration, child: Timeline) -> Result<Self>

Immediately checks and appends a nested timeline with an explicit duration.

pub fn try_place_timeline(self, start: Time, child: Timeline) -> Result<Self>

Immediately checks and places a nested timeline.

pub fn transition( self, effect: impl Transition + 'static, duration: Duration, ) -> Self

Adds an adjacent transition, retaining invalid input for validate().

pub fn place(self, start: Time, scene: impl Scene + 'static) -> Self

Places a scene at absolute ticks, retaining invalid input for validate().

pub fn gap(self, duration: Duration) -> Self

Advances the cursor, retaining invalid input for validate().

pub fn try_transition( self, effect: impl Transition + 'static, duration: Duration, ) -> Result<Self>

Immediately checks and applies one adjacent transition.

pub fn try_place(self, start: Time, scene: impl Scene + 'static) -> Result<Self>

Immediately checks and places one scene.

pub fn try_gap(self, duration: Duration) -> Result<Self>

Immediately checks and advances the cursor.

pub fn try_push(self, scene: impl Scene + 'static) -> Result<Self>

Appends at the requested cursor; finite positive Scene::duration is required.

pub fn cursor(&self) -> Time

Requested append position, before frame alignment.