Struct ToneMapper 

pub struct ToneMapper { /* private fields */ }

A configured tone-mapping transform.

Immutable: the tables are built once from the parameters, so changing a parameter means building another mapper.

Implementations

impl ToneMapper

pub fn bt709_to_bt2020_pq(sdr_white_nits: f32) -> Self

SDR into an HDR composition.

sdr_white_nits is where SDR’s 1.0 lands on the PQ curve. 100 is the conventional default and matches how most HDR displays render an SDR signal; 203 is the common “diffuse white” reference and makes the SDR part brighter within the composition.

pub fn bt2020_pq_to_bt709(target_max_nits: f32, curve: ToneMapCurve) -> Self

HDR down to an SDR display.

target_max_nits is what SDR’s 1.0 means in absolute terms; anything above it goes through curve so highlights compress instead of clipping.

pub fn hlg_to_bt709(target_max_nits: f32) -> Self

HLG down to an SDR display.

Always Reinhard: HLG’s OOTF has already shaped the highlights, so a second subjective curve on top would double-compress them.

pub const fn direction(&self) -> Direction

The direction this mapper transforms.

pub const fn curve(&self) -> ToneMapCurve

The curve it applies.

pub const fn sdr_white_nits(&self) -> f32

Where SDR white lands, in nits.

pub const fn target_max_nits(&self) -> f32

What SDR 1.0 represents, in nits.

pub fn map(&self, pixel: u64) -> u64

Transform one pixel.

pub fn apply(&self, src: &[u64], dst: &mut [u64])

Transform a run of pixels.

The direction is decided once rather than per pixel, which is the whole reason this exists rather than the caller looping over map.

Trait Implementations

impl Debug for ToneMapper

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

Formats the value using the given formatter.