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
105
106
107
108
109
110
111

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 TransferCharacteristic {
    Reserved0,
    BT709,
    Unspecified,
    Reserved,
    GAMMA22,
    GAMMA28,
    SMPTE170M,
    SMPTE240M,
    Linear,
    Log,
    LogSqrt,
    IEC61966_2_4,
    BT1361_ECG,
    IEC61966_2_1,
    BT2020_10,
    BT2020_12,
    SMPTE2084,
    SMPTE428,
    ARIB_STD_B67,

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

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

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

        match value {
            AV::RESERVED0 => TransferCharacteristic::Reserved0,
            AV::BT709 => TransferCharacteristic::BT709,
            AV::UNSPECIFIED => TransferCharacteristic::Unspecified,
            AV::RESERVED => TransferCharacteristic::Reserved,
            AV::GAMMA22 => TransferCharacteristic::GAMMA22,
            AV::GAMMA28 => TransferCharacteristic::GAMMA28,
            AV::SMPTE170M => TransferCharacteristic::SMPTE170M,
            AV::SMPTE240M => TransferCharacteristic::SMPTE240M,
            AV::LINEAR => TransferCharacteristic::Linear,
            AV::LOG => TransferCharacteristic::Log,
            AV::LOG_SQRT => TransferCharacteristic::LogSqrt,
            AV::IEC61966_2_4 => TransferCharacteristic::IEC61966_2_4,
            AV::BT1361_ECG => TransferCharacteristic::BT1361_ECG,
            AV::IEC61966_2_1 => TransferCharacteristic::IEC61966_2_1,
            AV::BT2020_10 => TransferCharacteristic::BT2020_10,
            AV::BT2020_12 => TransferCharacteristic::BT2020_12,
            AV::NB => TransferCharacteristic::Reserved0,
            AV::SMPTE2084 => TransferCharacteristic::SMPTE2084,
            AV::SMPTE428 => TransferCharacteristic::SMPTE428,
            AV::ARIB_STD_B67 => TransferCharacteristic::ARIB_STD_B67,

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

            _ => unimplemented!(),
        }
    }
}

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

        match value {
            TransferCharacteristic::Reserved0 => AV::RESERVED0,
            TransferCharacteristic::BT709 => AV::BT709,
            TransferCharacteristic::Unspecified => AV::UNSPECIFIED,
            TransferCharacteristic::Reserved => AV::RESERVED,
            TransferCharacteristic::GAMMA22 => AV::GAMMA22,
            TransferCharacteristic::GAMMA28 => AV::GAMMA28,
            TransferCharacteristic::SMPTE170M => AV::SMPTE170M,
            TransferCharacteristic::SMPTE240M => AV::SMPTE240M,
            TransferCharacteristic::Linear => AV::LINEAR,
            TransferCharacteristic::Log => AV::LOG,
            TransferCharacteristic::LogSqrt => AV::LOG_SQRT,
            TransferCharacteristic::IEC61966_2_4 => AV::IEC61966_2_4,
            TransferCharacteristic::BT1361_ECG => AV::BT1361_ECG,
            TransferCharacteristic::IEC61966_2_1 => AV::IEC61966_2_1,
            TransferCharacteristic::BT2020_10 => AV::BT2020_10,
            TransferCharacteristic::BT2020_12 => AV::BT2020_12,
            TransferCharacteristic::SMPTE2084 => AV::SMPTE2084,
            TransferCharacteristic::SMPTE428 => AV::SMPTE428,
            TransferCharacteristic::ARIB_STD_B67 => AV::ARIB_STD_B67,

            #[cfg(feature = "ffmpeg_8_1")]
            TransferCharacteristic::V_LOG => AV::V_LOG,
        }
    }
}