Struct Decoder 

pub struct Decoder { /* private fields */ }

Ultra HDR decoder.

Decodes Ultra HDR JPEGs, extracting the SDR base image, gain map, and metadata. Can reconstruct HDR content at various display brightness levels.

Implementations

impl Decoder

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

Create a new decoder from JPEG data.

pub fn is_ultrahdr(&self) -> bool

Check if this is a valid Ultra HDR image.

pub fn metadata(&self) -> Option<&GainMapMetadata>

Get the gain map metadata.

pub fn gainmap_jpeg(&self) -> Option<&[u8]>

Get the raw gain map JPEG data.

pub fn decode_sdr(&self) -> Result<RawImage>

Decode the SDR base image.

pub fn decode_gainmap(&self) -> Result<GainMap>

Decode the gain map.

pub fn decode_hdr(&self, display_boost: f32) -> Result<RawImage>

Decode to HDR at the specified display boost level.

display_boost is the ratio of display peak brightness to SDR white. For example:

• 1.0 = SDR display (no HDR enhancement)
• 4.0 = Display capable of 4x SDR brightness
• ~49.0 = Full HDR10 (10000 nits / 203 SDR nits)

pub fn decode_hdr_with_format( &self, display_boost: f32, format: HdrOutputFormat, ) -> Result<RawImage>

Decode to HDR with a specific output format.

pub fn icc_profile(&self) -> Option<Vec<u8>>

Get the ICC profile from the primary image if present.

pub fn dimensions(&self) -> Result<(u32, u32)>

Get information about the decoded image dimensions.