Struct HdrMetadata 

pub struct HdrMetadata {
    pub transfer: TransferFunction,
    pub content_light_level: Option<ContentLightLevel>,
    pub mastering_display: Option<MasteringDisplay>,
}

👎Deprecated since 0.2.14:

redundant with zencodec::Metadata and frozen-shaped; carry ContentLightLevel / MasteringDisplay directly. Removal queued for 0.3.0.

Describes the HDR characteristics of pixel data.

Bundles transfer function, content light level, and mastering display metadata to provide everything needed for HDR processing.

Deprecated

This bundle is a redundant, weaker duplicate of the codec-layer carrier zencodec::Metadata (which the codecs actually populate, and which also carries CICP, ICC, EXIF/XMP, and orientation). It bundles transfer with CLL/mastering, which the prior art uniformly keeps separate (transfer belongs on the PixelDescriptor; CLL and mastering are independent optional metadata). It has frozen public fields (not #[non_exhaustive]), so the absolute-luminance anchor and gain-map fields HDR needs cannot be added without a break. Scheduled for removal in 0.3.0 — see CHANGELOG.md “QUEUED BREAKING CHANGES”. Carry CLL and mastering as the standalone ContentLightLevel / MasteringDisplay types, or use zencodec::Metadata.

Fields

transfer: TransferFunction

👎Deprecated since 0.2.14:

redundant with zencodec::Metadata and frozen-shaped; carry ContentLightLevel / MasteringDisplay directly. Removal queued for 0.3.0.

Transfer function (PQ, HLG, sRGB, Linear, etc.).

content_light_level: Option<ContentLightLevel>

👎Deprecated since 0.2.14:

redundant with zencodec::Metadata and frozen-shaped; carry ContentLightLevel / MasteringDisplay directly. Removal queued for 0.3.0.

Content light level (MaxCLL/MaxFALL). Optional.

mastering_display: Option<MasteringDisplay>

👎Deprecated since 0.2.14:

redundant with zencodec::Metadata and frozen-shaped; carry ContentLightLevel / MasteringDisplay directly. Removal queued for 0.3.0.

Mastering display color volume. Optional.

Implementations

impl HdrMetadata

pub fn is_hdr(&self) -> bool

True if this describes HDR content (PQ or HLG transfer function).

pub fn is_sdr(&self) -> bool

True if this describes SDR content.

pub fn hdr10(cll: ContentLightLevel) -> Self

Create HDR10 metadata with PQ transfer.

The mastering display is MasteringDisplay::HDR10_REFERENCE — the generic 1000-nit reference mastering volume, not measured metadata from any real mastering session. Replace it when the source carries an actual SMPTE ST 2086 record.

pub fn hlg() -> Self

Create HLG metadata.

Trait Implementations

impl Clone for HdrMetadata

fn clone(&self) -> HdrMetadata

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for HdrMetadata

impl Debug for HdrMetadata

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

Formats the value using the given formatter.

impl PartialEq for HdrMetadata

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