h264-reader 0.8.0

Reader for H264 bitstream syntax
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
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129

use super::SeiMessage;
use crate::nal::sei::HeaderType;
use crate::nal::sps;
use crate::rbsp::BitRead;
use crate::rbsp::BitReaderError;
use crate::Context;

#[derive(Debug)]
pub enum BufferingPeriodError {
    ReaderError(BitReaderError),
    UndefinedSeqParamSetId(sps::SeqParamSetId),
    InvalidSeqParamSetId(sps::SeqParamSetIdError),
}
impl From<BitReaderError> for BufferingPeriodError {
    fn from(e: BitReaderError) -> Self {
        BufferingPeriodError::ReaderError(e)
    }
}
impl From<sps::SeqParamSetIdError> for BufferingPeriodError {
    fn from(e: sps::SeqParamSetIdError) -> Self {
        BufferingPeriodError::InvalidSeqParamSetId(e)
    }
}

#[derive(Debug, Eq, PartialEq)]
struct InitialCpbRemoval {
    initial_cpb_removal_delay: u32,
    initial_cpb_removal_delay_offset: u32,
}

fn read_cpb_removal_delay_list<R: BitRead>(
    r: &mut R,
    count: usize,
    length: u32,
) -> Result<Vec<InitialCpbRemoval>, BitReaderError> {
    let mut res = vec![];
    for _ in 0..count {
        res.push(InitialCpbRemoval {
            initial_cpb_removal_delay: r.read(length, "initial_cpb_removal_delay")?,
            initial_cpb_removal_delay_offset: r.read(length, "initial_cpb_removal_delay_offset")?,
        });
    }
    Ok(res)
}

#[derive(Debug, Eq, PartialEq)]
pub struct BufferingPeriod {
    nal_hrd_bp: Option<Vec<InitialCpbRemoval>>,
    vcl_hrd_bp: Option<Vec<InitialCpbRemoval>>,
}
impl BufferingPeriod {
    pub fn read(
        ctx: &Context,
        msg: &SeiMessage<'_>,
    ) -> Result<BufferingPeriod, BufferingPeriodError> {
        assert_eq!(msg.payload_type, HeaderType::BufferingPeriod);
        let mut r = crate::rbsp::BitReader::new(msg.payload);
        let seq_parameter_set_id =
            sps::SeqParamSetId::from_u32(r.read_ue("seq_parameter_set_id")?)?;
        let sps = ctx
            .sps_by_id(seq_parameter_set_id)
            .ok_or_else(|| BufferingPeriodError::UndefinedSeqParamSetId(seq_parameter_set_id))?;
        let vui = sps.vui_parameters.as_ref();
        let mut read = |p: &sps::HrdParameters| {
            read_cpb_removal_delay_list(
                &mut r,
                p.cpb_specs.len(),
                u32::from(p.initial_cpb_removal_delay_length_minus1) + 1,
            )
        };
        let nal_hrd_bp = vui
            .and_then(|v| v.nal_hrd_parameters.as_ref())
            .map(&mut read)
            .transpose()?;
        let vcl_hrd_bp = vui
            .and_then(|v| v.vcl_hrd_parameters.as_ref())
            .map(&mut read)
            .transpose()?;
        r.finish_sei_payload()?;
        Ok(BufferingPeriod {
            nal_hrd_bp,
            vcl_hrd_bp,
        })
    }
}

#[cfg(test)]
mod test {
    use hex_literal::hex;

    use crate::rbsp;

    use super::*;

    #[test]
    fn parse() {
        // https://standards.iso.org/ittf/PubliclyAvailableStandards/ISO_IEC_14496-4_2004_Amd_6_2005_Bitstreams/
        // This example taken from CVSEFDFT3_Sony_E.zip.
        let mut ctx = Context::default();
        let sps_rbsp = hex!(
            "
            4d 60 15 8d 8d 28 58 9d 08 00 00 0f a0 00 07 53
            07 00 00 00 92 7c 00 00 12 4f 80 fb dc 18 00 00
            0f 42 40 00 07 a1 20 7d ee 07 c6 0c 62 60
        "
        );
        ctx.put_seq_param_set(
            sps::SeqParameterSet::from_bits(rbsp::BitReader::new(&sps_rbsp[..])).unwrap(),
        );

        let msg = SeiMessage {
            payload_type: HeaderType::BufferingPeriod,
            payload: &hex!("d7 e4 00 00 57 e4 00 00 40")[..],
        };
        assert_eq!(
            BufferingPeriod::read(&ctx, &msg).unwrap(),
            BufferingPeriod {
                nal_hrd_bp: Some(vec![InitialCpbRemoval {
                    initial_cpb_removal_delay: 45_000,
                    initial_cpb_removal_delay_offset: 0,
                },]),
                vcl_hrd_bp: Some(vec![InitialCpbRemoval {
                    initial_cpb_removal_delay: 45_000,
                    initial_cpb_removal_delay_offset: 0,
                },]),
            }
        );
    }
}