mp4-atom 0.17.0

A MP4/ISOBMFF atom decoder and encoder
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

use crate::*;

use super::spatial::ignore_trailing;

/// Stereoscopic 3D Video Box, [Spherical Video V2](https://github.com/google/spatial-media/blob/master/docs/spherical-video-v2-rfc.md#stereoscopic-3d-video-box-st3d).
///
/// `stereo_mode` is kept as the wire byte so reserved values round-trip.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
pub struct St3d {
    pub stereo_mode: u8,
}

impl St3d {
    pub const MONO: u8 = 0;
    /// Left eye on top.
    pub const TOP_BOTTOM: u8 = 1;
    /// Left eye on the left.
    pub const LEFT_RIGHT: u8 = 2;
    /// Both eyes, in a layout signalled elsewhere: for example by an `mshp`
    /// with one mesh per eye.
    pub const STEREO_CUSTOM: u8 = 3;
    /// Right eye on the left.
    pub const RIGHT_LEFT: u8 = 4;
}

impl AtomExt for St3d {
    type Ext = FullBoxV0;

    const KIND_EXT: FourCC = FourCC::new(b"st3d");

    fn decode_body_ext<B: Buf>(buf: &mut B, _ext: FullBoxV0) -> Result<Self> {
        let stereo_mode = u8::decode(buf)?;
        ignore_trailing(Self::KIND_EXT, buf);
        Ok(St3d { stereo_mode })
    }

    fn encode_body_ext<B: BufMut>(&self, buf: &mut B) -> Result<FullBoxV0> {
        self.stereo_mode.encode(buf)?;
        Ok(FullBoxV0)
    }
}