summaryrefslogtreecommitdiff
path: root/rust/crates/timeline/src/placement/mod.rs
blob: 4eb2660e0be035cc4fc5b4cf67894421cf3c1520 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
use scene::{SceneTracks, Track};
use time::MediaTime;

use crate::types::{ElementType, TrackType};

pub mod apply;
pub mod compatibility;
pub mod insert_index;
pub mod main_track;
pub mod overlap;
pub mod resolve;
pub mod track_factory;

pub use apply::{PlacementApplied, apply_placement};
pub use compatibility::{
    can_element_go_on_track, get_track_type_for_element_type, validate_element_track_compatibility,
};
pub use insert_index::{
    get_default_insert_index_for_track, get_highest_insert_index_for_track,
    resolve_preferred_new_track_placement,
};
pub use main_track::{MAIN_TRACK_NAME, enforce_main_track_start, get_earliest_main_track_element};
pub use overlap::can_place_time_spans_on_track;
pub use resolve::{ResolveTrackPlacementParams, resolve_track_placement};
pub use track_factory::build_empty_track;

#[derive(Clone, Debug, PartialEq)]
pub struct PlacementTimeSpan {
    pub start_time: MediaTime,
    pub duration: MediaTime,
    pub exclude_element_id: Option<String>,
}

#[derive(Clone, Copy, Debug, PartialEq)]
pub enum PlacementSubject {
    ElementType(ElementType),
    TrackType(TrackType),
}

#[derive(Clone, Copy, Debug, Eq, PartialEq)]
pub enum InsertDirection {
    Above,
    Below,
}

#[derive(Clone, Copy, Debug, Eq, PartialEq)]
pub enum VerticalDragDirection {
    Up,
    Down,
}

#[derive(Clone, Copy, Debug, Eq, PartialEq)]
pub enum NewTrackPosition {
    Highest,
    Default,
}

#[derive(Clone, Debug, PartialEq)]
pub enum PlacementStrategy {
    Explicit {
        track_id: String,
    },
    FirstAvailable,
    PreferIndex {
        track_index: usize,
        hover_direction: InsertDirection,
        vertical_drag_direction: Option<VerticalDragDirection>,
        create_new_track_only: bool,
    },
    AboveSource {
        source_track_index: usize,
    },
    AlwaysNew {
        position: NewTrackPosition,
    },
}

#[derive(Clone, Debug, PartialEq)]
pub enum PlacementResult {
    ExistingTrack {
        track_id: String,
        track_index: usize,
        track_type: TrackType,
        adjusted_start_time: Option<MediaTime>,
    },
    NewTrack {
        track_type: TrackType,
        insert_index: usize,
        insert_position: Option<InsertDirection>,
    },
}

pub fn ordered_tracks(tracks: &SceneTracks) -> Vec<&Track> {
    tracks
        .overlay
        .iter()
        .chain(std::iter::once(&tracks.main))
        .chain(tracks.audio.iter())
        .collect()
}