Struct HdrToneMapper 

pub struct HdrToneMapper { /* private fields */ }

HDR tone mapper operating on RGB f32 pixel data.

Pixels are expected to arrive in linear, scene-referred light normalised so that 1.0 == config.peak_brightness nits (i.e. values may exceed 1.0 for content brighter than the configured peak).

Use HdrToneMapper::map_pixel for single pixels or HdrToneMapper::map_frame to process a flat interleaved RGB f32 buffer.

Implementations

impl HdrToneMapper

pub fn new(config: ToneMappingConfig) -> Self

Create a new tone mapper from configuration.

pub fn config(&self) -> &ToneMappingConfig

Return a reference to the current configuration.

pub fn map_pixel(&self, rgb: [f32; 3]) -> [f32; 3]

Apply tone mapping to a single RGB pixel.

Input: linear, scene-referred RGB where values may exceed 1.0. The absolute maximum representable brightness is config.peak_brightness.

Output: gamma-encoded SDR RGB in [0, 1].

pub fn map_frame(&self, buffer: &mut [f32])

Process a flat interleaved RGB f32 frame in-place.

The buffer must have length == width * height * 3. Each triple [r, g, b] is processed by Self::map_pixel.

pub fn map_frame_owned(&self, input: &[f32]) -> Vec<f32>

Process a frame from a read-only input buffer into a new output Vec.

Allocates a new Vec<f32> of the same length as input.

pub fn pq_eotf_nits(signal: f32) -> f32

Apply the PQ EOTF to a normalised signal [0, 1] and return linear nits.

Useful when building custom pipelines that feed PQ-encoded data.

pub fn bt709_oetf(linear: f32) -> f32

Apply the BT.709 OETF (gamma encode) to a linear value in [0, 1].

impl HdrToneMapper

pub fn aces_hdr10() -> Self

Create a mapper using ToneMapOperator::AcesFilmic with typical HDR10 parameters.

Peak: 1 000 nits, white point: 203 nits, neutral saturation.

pub fn hable_hdr10() -> Self

Create a mapper using ToneMapOperator::Hable with typical HDR10 parameters.

pub fn pq_to_sdr_hdr10() -> Self

Create a mapper using ToneMapOperator::PqToSdr for HDR10 → SDR conversion.

pub fn reinhard_hdr10() -> Self

Create a mapper using ToneMapOperator::ReinhardLocal with default HDR10 parameters.

Trait Implementations

impl Clone for HdrToneMapper

fn clone(&self) -> HdrToneMapper

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HdrToneMapper

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

Formats the value using the given formatter.