Struct Timeline 

pub struct Timeline {

    pub tracks: Vec<Track>,
    pub timebase: Rational,
    pub frame_rate: Rational,
    pub duration: i64,
    pub playhead: i64,
    pub selection: ClipSelection,
    pub transitions: TransitionManager,
    pub markers: MarkerManager,
    pub regions: RegionManager,
    pub in_out: InOutPoints,
    pub groups: GroupManager,
    pub links: LinkManager,
    pub next_clip_id: u64,
    pub clip_map: HashMap<ClipId, (usize, usize)>,
    pub snap_engine: Option<MagneticSnapEngine>,
}

A multi-track timeline.

Fields

tracks: Vec<Track>

Timeline tracks.

timebase: Rational

Timeline timebase (e.g., 1/1000 for milliseconds).

frame_rate: Rational

Timeline frame rate (for video).

duration: i64

Timeline duration (in timebase units).

playhead: i64

Current playhead position.

selection: ClipSelection

Clip selection.

transitions: TransitionManager

Transition manager.

markers: MarkerManager

Marker manager.

regions: RegionManager

Region manager.

in_out: InOutPoints

In/Out points.

groups: GroupManager

Group manager.

links: LinkManager

Link manager.

next_clip_id: u64

Next clip ID.

clip_map: HashMap<ClipId, (usize, usize)>

Clip lookup by ID.

snap_engine: Option<MagneticSnapEngine>

Optional magnetic snap engine.

Implementations

impl Timeline

pub fn new(timebase: Rational, frame_rate: Rational) -> Self

Create a new timeline.

pub fn with_magnetic_snap(self, config: MagneticSnapConfig) -> Self

Enable magnetic snapping with the given configuration.

pub fn default_settings() -> Self

Create a timeline with default settings (1ms timebase, 30fps).

pub fn add_track(&mut self, track_type: TrackType) -> usize

Add a new track.

pub fn remove_track(&mut self, index: usize) -> EditResult<Track>

Remove a track by index.

pub fn get_track(&self, index: usize) -> Option<&Track>

Get a track by index.

pub fn get_track_mut(&mut self, index: usize) -> Option<&mut Track>

Get a mutable track by index.

pub fn add_clip(&mut self, track_index: usize, clip: Clip) -> EditResult<ClipId>

Add a clip to a track.

Returns EditError::TrackTypeMismatch when the clip’s type does not match the track type (e.g., adding an audio clip to a video track).

pub fn remove_clip(&mut self, clip_id: ClipId) -> EditResult<Clip>

Remove a clip by ID.

Link policy: linked clips are preserved on delete; only the link association is removed. The linked clip remains in its track at its current position.

pub fn get_clip(&self, clip_id: ClipId) -> Option<&Clip>

Get a clip by ID.

pub fn get_clip_mut(&mut self, clip_id: ClipId) -> Option<&mut Clip>

Get a mutable clip by ID.

pub fn move_clip( &mut self, clip_id: ClipId, requested_start: i64, ) -> EditResult<()>

Move a clip to a new position on the timeline.

If magnetic snapping is enabled, the requested position is adjusted to the nearest snap target before the move is applied.

All clips linked to clip_id are moved by the same delta (cascade).

The operation is atomic: if any clip in the cascade would overlap an existing clip, the entire batch is rolled back and an error is returned.

pub fn move_clip_to_track( &mut self, clip_id: ClipId, target_track: usize, ) -> EditResult<()>

Move a clip to a different track.

pub fn get_clips_at(&self, position: i64) -> Vec<(usize, &Clip)>

Get all clips at a specific timeline position.

pub fn get_clips_in_range(&self, start: i64, end: i64) -> Vec<(usize, &Clip)>

Get all clips in a time range.

pub fn rebuild_clip_map(&mut self)

Rebuild the clip map from scratch.

pub fn set_playhead(&mut self, position: i64)

Set playhead position.

pub fn move_playhead(&mut self, delta: i64)

Move playhead forward by delta.

pub fn seek_to_start(&mut self)

Seek to start of timeline.

pub fn seek_to_end(&mut self)

Seek to end of timeline.

pub fn duration_seconds(&self) -> f64

Get timeline duration in seconds.

pub fn video_tracks(&self) -> Vec<&Track>

Get video tracks.

pub fn audio_tracks(&self) -> Vec<&Track>

Get audio tracks.

pub fn subtitle_tracks(&self) -> Vec<&Track>

Get subtitle tracks.

pub fn clip_count(&self) -> usize

Get total number of clips.

pub fn clear(&mut self)

Clear all tracks and clips.

Trait Implementations

impl Debug for Timeline

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

Formats the value using the given formatter.

impl Default for Timeline

fn default() -> Self

Returns the “default value” for a type.