video-rs 0.11.0

High-level video toolkit based on ffmpeg.
Documentation 
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

/// Re-export [`url::Url`] since it is an input type for callers of the API.
pub use url::Url;

/// Represents a video file or stream location. Can be either a file resource (a path) or a network
/// resource (a URL).
#[derive(Debug, Clone, PartialEq, Eq, Hash)]
pub enum Location {
    /// File source.
    File(std::path::PathBuf),
    /// Network source.
    Network(Url),
}

impl Location {
    /// Coerce underlying location to a path.
    ///
    /// This will create a path with a URL in it (which is kind of weird but we use it to pass on
    /// URLs to ffmpeg).
    pub fn as_path(&self) -> &std::path::Path {
        match self {
            Location::File(path) => path.as_path(),
            Location::Network(url) => std::path::Path::new(url.as_str()),
        }
    }
}

impl From<&Location> for Location {
    fn from(value: &Location) -> Location {
        value.clone()
    }
}

impl From<std::path::PathBuf> for Location {
    fn from(value: std::path::PathBuf) -> Location {
        Location::File(value)
    }
}

impl From<&std::path::Path> for Location {
    fn from(value: &std::path::Path) -> Location {
        Location::File(value.to_path_buf())
    }
}

impl From<Url> for Location {
    fn from(value: Url) -> Location {
        Location::Network(value)
    }
}

impl From<&Url> for Location {
    fn from(value: &Url) -> Location {
        Location::Network(value.clone())
    }
}

impl std::fmt::Display for Location {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        match self {
            Location::File(path) => write!(f, "{}", path.display()),
            Location::Network(url) => write!(f, "{url}"),
        }
    }
}