rskit-media 0.2.0-alpha.3

Media types, codec/format registry, pipeline builder, and processing traits
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
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84

//! Composition operations for combining multiple media sources.

use rskit_storage::FileSource;
use serde::{Deserialize, Serialize};
use std::time::Duration;

use crate::time::{TimeRange, Timestamp};

/// Overlay another source on top of the current video.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct OverlayOp {
    /// The overlay source (image or video).
    pub source: FileSource,
    /// Where to place the overlay.
    pub position: OverlayPosition,
    /// Opacity (0.0 = transparent, 1.0 = opaque).
    pub opacity: f32,
    /// Time range during which the overlay is visible.
    pub time_range: Option<TimeRange>,
    /// Scale factor for the overlay.
    pub scale: Option<f64>,
}

/// Position for overlay placement.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub enum OverlayPosition {
    /// Offset from top-left corner.
    TopLeft(u32, u32),
    /// Offset from top-right corner.
    TopRight(u32, u32),
    /// Offset from bottom-left corner.
    BottomLeft(u32, u32),
    /// Offset from bottom-right corner.
    BottomRight(u32, u32),
    /// Centered on the video.
    Center,
    /// Custom position using expressions (e.g., FFmpeg expressions).
    Custom {
        /// X position expression.
        x: String,
        /// Y position expression.
        y: String,
    },
}

/// Concatenate another source after the current one.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ConcatOp {
    /// Source to append.
    pub source: FileSource,
    /// Optional transition between segments.
    pub transition: Option<Transition>,
}

/// Transition between concatenated segments.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub enum Transition {
    /// Cross-fade between segments.
    CrossFade(Duration),
    /// Fade to black between segments.
    FadeToBlack(Duration),
    /// Hard cut (no transition).
    Cut,
}

/// Replace the audio track entirely.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ReplaceAudioOp {
    /// New audio source.
    pub audio_source: FileSource,
    /// Offset into the video to start the new audio.
    pub offset: Option<Timestamp>,
}

/// Mix additional audio on top of existing audio.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct MixAudioOp {
    /// Audio source to mix in.
    pub audio_source: FileSource,
    /// Volume of the mixed audio (relative to original).
    pub volume: f64,
    /// Offset into the video to start mixing.
    pub offset: Option<Timestamp>,
}