Struct Preface 

pub struct Preface {
    pub interchange: InterchangeObjectFields,
    pub last_modified_date: MxfTimestamp,
    pub version: u16,
    pub object_model_version: Option<u32>,
    pub primary_package: Option<UlBytes>,
    pub identifications: Vec<UlBytes>,
    pub content_storage: UlBytes,
    pub operational_pattern: UlBytes,
    pub essence_containers: Vec<UlBytes>,
    pub dm_schemes: Vec<UlBytes>,
    pub dark: Vec<(u16, Vec<u8>)>,
}

The Preface Set — SMPTE ST 377-1:2019 Annex A.2: the file’s overall metadata (modification time, Operational Pattern, Essence Container / Descriptive Metadata scheme inventory) and strong references to the Identification history and the ContentStorage Set.

Properties marked “dyn” in Annex A.2 (ApplicationSchemes, IsRIPPresent — no fixed static local tag; a real Primer Pack must be consulted to learn which tag a given file used) are preserved byte-for-byte in dark rather than individually typed in this first pass — see docs/st377-1.md’s Scope section.

Fields

interchange: InterchangeObjectFields

Interchange Object (A.1) base properties.

last_modified_date: MxfTimestamp

Last Modified Date (0x3B02, Req).

version: u16

Version (0x3B05, Req) — major*256 + minor; VERSION_1_3 for this revision.

object_model_version: Option<u32>

Object Model Version (0x3B07, Opt).

primary_package: Option<UlBytes>

Primary Package (0x3B08, Opt) — weak reference (Instance UID) to this file’s primary Material Package, if any.

identifications: Vec<UlBytes>

Identifications (0x3B06, E/req — encoder-required, but a decoder must not fail if it’s absent, per Annex A.2’s “Req?” column) — strong references to every Identification Set recording a modification to this file. Empty if the property was absent on parse.

content_storage: UlBytes

Content Storage (0x3B03, Req) — strong reference to the ContentStorage Set.

operational_pattern: UlBytes

Operational Pattern (0x3B09, Req) — copy of the Partition Pack’s own value.

essence_containers: Vec<UlBytes>

EssenceContainers (0x3B0A, Req) — Batch of Essence Container ULs used in/referenced by this file.

dm_schemes: Vec<UlBytes>

DM Schemes (0x3B0B, Req) — Batch of Descriptive Metadata Scheme ULs used in this file.

dark: Vec<(u16, Vec<u8>)>

Every other property found on parse, including any “dyn”-tagged optional property (ApplicationSchemes/IsRIPPresent) and any private/dark extension — preserved byte-for-byte, not decoded.

Trait Implementations

impl Clone for Preface

fn clone(&self) -> Preface

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Preface

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for Preface

impl<'a> Parse<'a> for Preface

type Error = Error

The error type this implementer returns. Typically the enclosing crate’s Error enum.

fn parse(bytes: &'a [u8]) -> Result<Self>

Parse bytes as Self. Returns Err(Self::Error) on any protocol violation or buffer underrun.

impl PartialEq for Preface

fn eq(&self, other: &Preface) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for Preface

type Error = Error

The error type this implementer returns (usually the same as the corresponding Parse impl, but need not be).

fn serialized_len(&self) -> usize

Number of bytes serialize_into will write.

fn serialize_into(&self, buf: &mut [u8]) -> Result<usize>

Write the serialised form into buf. Returns the number of bytes written (always equal to serialized_len()).

fn to_bytes(&self) -> Vec<u8>

where Self::Error: Debug,

Convenience: allocate a Vec and serialise into it.

impl StructuralPartialEq for Preface