Struct RegionLayout 

pub struct RegionLayout { /* private fields */ }

An ordered description of a synthesized virtual file: the metadata region (inline framing + art images) followed by the backing audio. Totals are computed once at construction; segments is private so they cannot desync.

Implementations

impl RegionLayout

pub fn validated(segments: Vec<Segment>) -> Result<RegionLayout, LayoutError>

pub fn segments(&self) -> &[Segment]

The ordered segments composing the synthesized virtual file.

pub fn has_binary_tag(&self) -> bool

True if any segment streams an opaque binary tag payload from the DB.

pub fn streams_db_rowid(&self) -> bool

True if any segment is streamed from the DB by a rowid at read time — BinaryTag (a tags rowid), ArtImage, or OggArtSlice (both an art rowid). These are the segments exposed to the rowid-reuse hazard (a concurrent delete + reinsert reusing a freed rowid), so the serve path must read them under a single WAL snapshot with a content_version recheck. BackingAudio/OggAudio/Inline carry no DB rowid.

pub fn total_len(&self) -> u64

Total size of the synthesized virtual file in bytes (stored at construction).

pub fn header_len(&self) -> u64

Size of the synthesized metadata region preceding the backing audio (stored).

pub fn validate(&self) -> Result<(), LayoutError>

Validate basic producer invariants. Returns Ok(()) if the layout is structurally sound (no empty metadata segments, lengths don’t overflow). Zero-length backing audio is valid for formats that can represent an empty media payload.

Trait Implementations

impl Clone for RegionLayout

fn clone(&self) -> RegionLayout

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RegionLayout

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

Formats the value using the given formatter.

impl Eq for RegionLayout

impl PartialEq for RegionLayout

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for RegionLayout