mpeg-pes 0.7.0

PES (Packetized Elementary Stream) depacketization + PTS/DTS — ISO/IEC 13818-1 §2.4.3.
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

//! Error type for PES parsing.

/// Result alias for PES parsing.
pub type Result<T> = core::result::Result<T, Error>;

/// A PES parse error.
#[derive(Debug, Clone, PartialEq, Eq, thiserror::Error)]
#[non_exhaustive]
pub enum Error {
    /// Input shorter than required.
    #[error(transparent)]
    BufferTooShort(#[from] broadcast_common::error::BufferTooShort),

    /// Output buffer smaller than the serialized form requires.
    #[error(transparent)]
    OutputBufferTooSmall(#[from] broadcast_common::error::OutputBufferTooSmall),

    /// `packet_start_code_prefix` was not `0x000001`.
    #[error(transparent)]
    InvalidSync(#[from] broadcast_common::error::InvalidSync),
    /// A required `marker_bit` was not `1` in a PTS/DTS field.
    #[error("bad timestamp marker bit in {0}")]
    BadTimestampMarker(&'static str),
    /// The PTS/DTS leading 4-bit prefix did not match the expected `0010`/`0011`/`0001`.
    #[error("bad timestamp prefix in {0}")]
    BadTimestampPrefix(&'static str),
    /// `optional_fields` exceeds the 255-byte `PES_header_data_length` limit
    /// (an 8-bit field) — cannot be serialized.
    #[error("optional_fields too large to serialize: {0} bytes (max 255)")]
    OptionalFieldsTooLarge(usize),
    /// A length or count field's value does not fit its wire field
    /// (see `broadcast_common::len`, #1129).
    #[error(transparent)]
    FieldOverflow(#[from] broadcast_common::len::FieldOverflow),
    /// The two fixed marker bits of the first PES header flag byte were not
    /// `'10'` (ISO/IEC 13818-1 Table 2-21): not an MPEG-2 PES header.
    #[error("PES header marker bits are not '10'")]
    BadHeaderMarker,
    /// `PTS_DTS_flags` on the wire was `01` (ISO/IEC 13818-1 Table 2-21
    /// reserves this combination — only `00`/`10`/`11` are defined), or a
    /// `PesHeader` had `dts.is_some()` with `pts.is_none()` (the same
    /// forbidden combination, one layer up, that `serialize_into` refuses
    /// to write silently as `PTS_DTS_flags=00`).
    #[error("forbidden PTS_DTS_flags combination: DTS without PTS")]
    ForbiddenPtsDtsFlags,
}