Struct GainMapMetadata 

pub struct GainMapMetadata {
    pub is_multichannel: bool,
    pub use_base_colour_space: bool,
    pub base_hdr_headroom_n: u32,
    pub base_hdr_headroom_d: u32,
    pub alternate_hdr_headroom_n: u32,
    pub alternate_hdr_headroom_d: u32,
    pub channels: [GainMapChannel; 3],
}

Gain map metadata from a ToneMapImage (tmap) derived image item.

Describes how to apply a gain map to convert between SDR and HDR renditions. The gain map is a separate AV1-encoded image that, combined with this metadata, allows reconstructing an HDR image from the SDR base.

See ISO 21496-1:2025 for the full specification.

Fields

is_multichannel: bool

If true, each RGB channel has independent gain map parameters. If false, channels[0] applies to all three channels.

use_base_colour_space: bool

If true, the gain map is encoded in the base image’s colour space. If false, it’s in the alternate image’s colour space.

base_hdr_headroom_n: u32

Base HDR headroom (numerator).

base_hdr_headroom_d: u32

Base HDR headroom (denominator).

alternate_hdr_headroom_n: u32

Alternate HDR headroom (numerator).

alternate_hdr_headroom_d: u32

Alternate HDR headroom (denominator).

channels: [GainMapChannel; 3]

Per-channel parameters. For single-channel mode, only index 0 is meaningful (indices 1 and 2 are copies of index 0).

Trait Implementations

impl Clone for GainMapMetadata

fn clone(&self) -> GainMapMetadata

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GainMapMetadata

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

Formats the value using the given formatter.

impl PartialEq for GainMapMetadata

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

impl StructuralPartialEq for GainMapMetadata