Struct Meta 

pub struct Meta {
    pub primary: Option<u32>,
    pub items: Vec<Item>,
    pub references: Vec<Reference>,
    pub properties: Properties,
    /* private fields */
}

The parsed meta box.

Fields

primary: Option<u32>

The primary item, from pitm.

items: Vec<Item>

Every item in the file, in iinf order.

references: Vec<Reference>

Every iref entry.

properties: Properties

The item properties, from iprp.

Implementations

impl Meta

pub fn parse(meta: Reader<'_>) -> Result<Self>

Parse a meta box payload.

Errors

Returns PixelsError::Malformed if any child box is structurally invalid.

pub fn item(&self, id: u32) -> Option<&Item>

The item with this ID, if the file has one.

pub fn primary_item(&self) -> Option<&Item>

The primary item, resolved.

Falls back to the first coded image or grid when pitm is absent. A file without pitm is malformed, but the intent is unambiguous when there is exactly one image, and rejecting it buys nothing.

pub fn referenced(&self, from: u32, kind: &[u8; 4]) -> &[u32]

The items from points to with a reference of this type.

pub fn alpha_item(&self, id: u32) -> Option<&Item>

The alpha plane item for id, if the file carries one.

An alpha item is an auxiliary item whose auxl reference points at id and whose auxC property carries the alpha URN. Both halves are checked: an auxl item with some other auxiliary type is a depth map or a gain map, not transparency, and treating it as alpha would produce a confidently wrong image.

pub fn item_data<'a>( &self, file: &'a [u8], item: &Item, ) -> Result<Cow<'a, [u8]>>

The bytes of item, resolved from file.

Borrows when the item is one contiguous extent, which is the common case, and concatenates otherwise.

Errors

Returns PixelsError::Unsupported for item-relative construction, or PixelsError::Malformed if an extent falls outside the file or outside idat.

Trait Implementations

impl Clone for Meta

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Meta

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

Formats the value using the given formatter.

impl Default for Meta

fn default() -> Self

Returns the “default value” for a type.