Struct GainMapBundle 

pub struct GainMapBundle {
    pub metadata: Vec<u8>,
    pub color_encoding: Option<Vec<u8>>,
    pub alt_icc_compressed: Option<Vec<u8>>,
    pub gain_map_codestream: Vec<u8>,
}

Parsed JXL gain map bundle from a jhgm container box.

The bundle contains the ISO 21496-1 metadata, an optional JXL ColorEncoding, an optional Brotli-compressed ICC profile for the alternate rendition, and the bare JXL codestream of the gain map image.

Fields

metadata: Vec<u8>

ISO 21496-1 binary metadata blob (unparsed — caller parses with ultrahdr-core).

color_encoding: Option<Vec<u8>>

JXL ColorEncoding for the gain map (optional, raw bytes — JXL-native bit-packed).

alt_icc_compressed: Option<Vec<u8>>

Brotli-compressed ICC profile for alternate rendition (optional, not decompressed).

gain_map_codestream: Vec<u8>

Bare JXL codestream of the gain map image (no container wrapper).

Implementations

impl GainMapBundle

pub fn parse(data: &[u8]) -> Result<Self>

Parse a gain map bundle from the raw payload of a jhgm box.

Wire format:

jhgm_version:            u8       // must be 0x00
gain_map_metadata_size:  u16 BE   // size of ISO 21496-1 metadata
gain_map_metadata:       [u8; N]  // ISO 21496-1 binary metadata
color_encoding_size:     u8       // 0 = absent; else byte count
color_encoding:          [u8; M]  // JXL ColorEncoding (optional)
alt_icc_size:            u32 BE   // size of Brotli-compressed ICC
alt_icc:                 [u8; K]  // Brotli-compressed ICC (optional)
gain_map:                [u8; *]  // remaining bytes = bare JXL codestream

pub fn serialize(&self) -> Vec<u8>

Serialize a gain map bundle to the wire format used inside a jhgm box.

Returns the raw bytes that form the payload of a jhgm container box.

Trait Implementations

impl Clone for GainMapBundle

fn clone(&self) -> GainMapBundle

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GainMapBundle

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

Formats the value using the given formatter.

impl Eq for GainMapBundle

impl PartialEq for GainMapBundle

fn eq(&self, other: &GainMapBundle) -> 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 GainMapBundle