dvb-emsg 0.1.0

MPEG-DASH Event Message Box (`emsg`) — inband DASH/CMAF timed events (SCTE 35, ID3, ad triggers): version 0/1 FullBox parse + serialize. Box syntax per ISO/IEC 23009-1 §5.10.3.3; field semantics per DASH-IF IOP Part 10.
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

//! The `emsg` `FullBox` version field — DASH-IF IOP Part 10 §6.1 / Table 6-2.
//!
//! Per Table 6-2 (`emsg.version`): "version 0 is used for segment relative
//! timing, version 1 for representation relative timing." The two versions
//! carry the same logical field set except for the presentation-time field:
//!
//! - **version 0** — `presentation_time_delta` (u32), relative to the
//!   segment's earliest presentation time;
//! - **version 1** — `presentation_time` (u64), relative to `Period@start`.
//!
//! The box body field *ordering* also differs between the two versions — see
//! the crate root caveat and [`crate::EmsgBox`].

/// The `version` byte of the `'emsg'` `FullBox` (DASH-IF Part 10 Table 6-2).
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
#[cfg_attr(feature = "serde", derive(serde::Serialize))]
#[non_exhaustive]
pub enum EmsgVersion {
    /// Version 0 — segment-relative timing; carries `presentation_time_delta`
    /// (u32). Strings precede the integer fields on the wire.
    SegmentRelative,
    /// Version 1 — representation/`Period@start`-relative timing; carries
    /// `presentation_time` (u64). Integer fields precede the strings on the
    /// wire.
    RepresentationRelative,
}

/// The wire value of `version` for [`EmsgVersion::SegmentRelative`].
pub const VERSION_0: u8 = 0;
/// The wire value of `version` for [`EmsgVersion::RepresentationRelative`].
pub const VERSION_1: u8 = 1;

impl EmsgVersion {
    /// Decode the `FullBox` `version` byte; only 0 and 1 are defined.
    pub fn from_u8(v: u8) -> Option<Self> {
        match v {
            VERSION_0 => Some(EmsgVersion::SegmentRelative),
            VERSION_1 => Some(EmsgVersion::RepresentationRelative),
            _ => None,
        }
    }

    /// The `version` byte as it appears on the wire.
    pub fn to_u8(self) -> u8 {
        match self {
            EmsgVersion::SegmentRelative => VERSION_0,
            EmsgVersion::RepresentationRelative => VERSION_1,
        }
    }

    /// Spec label for this version.
    pub fn name(&self) -> &'static str {
        match self {
            EmsgVersion::SegmentRelative => "segment relative (v0)",
            EmsgVersion::RepresentationRelative => "representation relative (v1)",
        }
    }
}

dvb_common::impl_spec_display!(EmsgVersion);

#[cfg(test)]
mod tests {
    use super::*;
    use alloc::string::ToString;

    #[test]
    fn round_trips() {
        assert_eq!(EmsgVersion::from_u8(0), Some(EmsgVersion::SegmentRelative));
        assert_eq!(
            EmsgVersion::from_u8(1),
            Some(EmsgVersion::RepresentationRelative)
        );
        assert_eq!(EmsgVersion::from_u8(2), None);
        assert_eq!(EmsgVersion::SegmentRelative.to_u8(), 0);
        assert_eq!(EmsgVersion::RepresentationRelative.to_u8(), 1);
    }

    #[test]
    fn display_uses_name() {
        assert_eq!(
            EmsgVersion::SegmentRelative.to_string(),
            "segment relative (v0)"
        );
    }
}