Struct ToneMappingSettings 

pub struct ToneMappingSettings {
    pub mode: ToneMappingMode,
    pub lut_texture: Option<TextureHandle>,
    /* private fields */
}

Tone mapping configuration.

This struct holds all parameters for the tone mapping post-processing pass. Changes to uniforms are tracked via CpuBuffer’s internal version for efficient GPU sync.

Usage

// Get settings from scene
let settings = &mut scene.tone_mapping;

// Modify parameters (automatically updates version)
settings.set_exposure(1.5);
settings.set_mode(ToneMappingMode::ACESFilmic);

Fields

mode: ToneMappingMode

Selected tone mapping algorithm

lut_texture: Option<TextureHandle>

Exposure multiplier (default: 1.0) Optional 3D LUT texture handle. When Some, the USE_LUT shader macro is enabled and the pipeline is recompiled. When None, no LUT is applied.

Implementations

impl ToneMappingSettings

pub fn new() -> ToneMappingSettings

Creates new tone mapping settings with default values.

pub fn uniforms(&self) -> BufferReadGuard<'_, ToneMappingUniforms>

pub fn uniforms_mut(&mut self) -> BufferGuard<'_, ToneMappingUniforms>

pub fn set_mode(&mut self, mode: ToneMappingMode)

Sets the tone mapping mode.

Only updates the mode if the value actually changed.

pub fn set_exposure(&mut self, exposure: f32)

Sets the exposure value.

pub fn set_contrast(&mut self, contrast: f32)

Sets the contrast adjustment.

pub fn set_saturation(&mut self, saturation: f32)

Sets the saturation adjustment.

pub fn set_chromatic_aberration(&mut self, intensity: f32)

Sets the chromatic aberration intensity.

pub fn set_film_grain(&mut self, intensity: f32)

Sets the film grain intensity.

pub fn set_vignette_intensity(&mut self, intensity: f32)

Sets the vignette intensity.

A value of 0.0 disables the vignette effect.

pub fn set_vignette_smoothness(&mut self, smoothness: f32)

Sets the vignette smoothness.

Controls how quickly the darkening falls off from the edges. Recommended range: 0.1 ~ 1.0. Default is 0.5 for a balanced look.

pub fn set_vignette_color(&mut self, color: Vec4)

Sets the vignette color. This is the color used for the vignette effect (default: black with full alpha).

pub fn set_lut_texture(&mut self, lut: Option<TextureHandle>)

Sets the 3D LUT texture for color grading.

Pass Some(handle) to enable LUT-based color grading, or None to disable it. Changing this triggers a pipeline rebuild (shader macro change).

pub fn set_lut_contribution(&mut self, contribution: f32)

Sets the LUT contribution weight.

0.0 = original color, 1.0 = fully LUT-graded.

pub fn has_lut(&self) -> bool

Returns whether a LUT texture is currently set.

pub fn exposure(&self) -> f32

Returns the current exposure value.

pub fn vignette_intensity(&self) -> f32

Returns the current vignette intensity.

pub fn mode(&self) -> ToneMappingMode

Returns the current tone mapping mode.

pub fn contrast(&self) -> f32

Returns the current contrast value.

pub fn saturation(&self) -> f32

Returns the current saturation value.

pub fn chromatic_aberration(&self) -> f32

Returns the current chromatic aberration intensity.

pub fn film_grain(&self) -> f32

Returns the current film grain intensity.

pub fn vignette_smoothness(&self) -> f32

Returns the current vignette smoothness.

pub fn vignette_color(&self) -> Vec4

Returns the current vignette color.

pub fn lut_contribution(&self) -> f32

Returns the current LUT contribution.

Trait Implementations

impl Clone for ToneMappingSettings

fn clone(&self) -> ToneMappingSettings

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ToneMappingSettings

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

Formats the value using the given formatter.

impl Default for ToneMappingSettings

fn default() -> ToneMappingSettings

Returns the “default value” for a type.