ffmpeg-the-third 5.0.0+ffmpeg-8.1

Safe FFmpeg wrapper (FFmpeg 5+ compatible fork of the ffmpeg crate)
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
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104

use crate::ffi::*;
use crate::utils;
#[cfg(feature = "serialize")]
use serde::{Deserialize, Serialize};

#[derive(Eq, PartialEq, Clone, Copy, Debug)]
#[cfg_attr(feature = "serialize", derive(Serialize, Deserialize))]
pub enum Primaries {
    Reserved0,
    BT709,
    Unspecified,
    Reserved,
    BT470M,

    BT470BG,
    SMPTE170M,
    SMPTE240M,
    Film,
    BT2020,

    SMPTE428,
    SMPTE431,
    SMPTE432,
    EBU3213,

    #[cfg(feature = "ffmpeg_8_1")]
    V_GAMUT,
}

impl Primaries {
    pub const JEDEC_P22: Primaries = Primaries::EBU3213;

    pub fn name(&self) -> Option<&'static str> {
        if *self == Primaries::Unspecified {
            return None;
        }
        unsafe {
            let ptr = av_color_primaries_name((*self).into());
            utils::optional_str_from_c_ptr(ptr)
        }
    }
}

impl From<AVColorPrimaries> for Primaries {
    fn from(value: AVColorPrimaries) -> Primaries {
        use AVColorPrimaries as AV;

        match value {
            AV::RESERVED0 => Primaries::Reserved0,
            AV::BT709 => Primaries::BT709,
            AV::UNSPECIFIED => Primaries::Unspecified,
            AV::RESERVED => Primaries::Reserved,
            AV::BT470M => Primaries::BT470M,

            AV::BT470BG => Primaries::BT470BG,
            AV::SMPTE170M => Primaries::SMPTE170M,
            AV::SMPTE240M => Primaries::SMPTE240M,
            AV::FILM => Primaries::Film,
            AV::BT2020 => Primaries::BT2020,
            AV::NB => unreachable!(),

            AV::SMPTE428 => Primaries::SMPTE428,
            AV::SMPTE431 => Primaries::SMPTE431,
            AV::SMPTE432 => Primaries::SMPTE432,
            AV::EBU3213 => Primaries::EBU3213,

            #[cfg(feature = "ffmpeg_8_1")]
            // upstream defines it this way
            AV::EXT_BASE => Primaries::V_GAMUT,
            #[cfg(feature = "ffmpeg_8_1")]
            AV::EXT_NB => unreachable!(),

            _ => unimplemented!(),
        }
    }
}

impl From<Primaries> for AVColorPrimaries {
    fn from(value: Primaries) -> AVColorPrimaries {
        use AVColorPrimaries as AV;

        match value {
            Primaries::Reserved0 => AV::RESERVED0,
            Primaries::BT709 => AV::BT709,
            Primaries::Unspecified => AV::UNSPECIFIED,
            Primaries::Reserved => AV::RESERVED,
            Primaries::BT470M => AV::BT470M,

            Primaries::BT470BG => AV::BT470BG,
            Primaries::SMPTE170M => AV::SMPTE170M,
            Primaries::SMPTE240M => AV::SMPTE240M,
            Primaries::Film => AV::FILM,
            Primaries::BT2020 => AV::BT2020,

            Primaries::SMPTE428 => AV::SMPTE428,
            Primaries::SMPTE431 => AV::SMPTE431,
            Primaries::SMPTE432 => AV::SMPTE432,
            Primaries::EBU3213 => AV::EBU3213,

            #[cfg(feature = "ffmpeg_8_1")]
            Primaries::V_GAMUT => AV::V_GAMUT,
        }
    }
}