Struct PowerMapper 

pub struct PowerMapper { /* private fields */ }

Power curve range mapping.

Provides non-linear mapping using a power curve to give more resolution at one end of the range. Works with any range (positive, negative, or mixed).

Common use cases:

• Threshold parameters where more precision is needed near 0 dB
• Any parameter where UI feel should be skewed toward one end

Behavior

• exponent > 1.0: More resolution at the maximum (e.g., near 0 dB for threshold)
• exponent < 1.0: More resolution at the minimum
• exponent = 1.0: Linear (same as LinearMapper)

Panics

Panics if the exponent is not positive, or if the range end is not greater than the range start.

Example

// More resolution near 0 dB (max), less at -60 dB (min)
let mapper = PowerMapper::new(-60.0..=0.0, 2.0);

// With exponent 2.0, normalized 0.5 maps to -15 dB (not -30 dB)
let mid = mapper.denormalize(0.5);
assert!((mid - -15.0).abs() < 0.1);

Implementations

impl PowerMapper

pub fn new(range: RangeInclusive<f64>, exponent: f64) -> Self

Create a new power curve mapper.

Arguments

• range - Value range (can be negative, positive, or mixed)
• exponent - Power curve exponent (typical: 2.0-3.0)
  • exponent > 1.0: More resolution at max
  • exponent < 1.0: More resolution at min
  • exponent = 1.0: Linear (same as LinearMapper)

Panics

Panics if:

• exponent <= 0.0 (must be positive)
• max <= min (invalid range)

Trait Implementations

impl Clone for PowerMapper

fn clone(&self) -> PowerMapper

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PowerMapper

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

Formats the value using the given formatter.

impl RangeMapper for PowerMapper

fn normalize(&self, plain: f64) -> f64

Convert a plain value to normalized (0.0-1.0).

fn denormalize(&self, normalized: f64) -> f64

Convert a normalized value (0.0-1.0) to plain.

fn range(&self) -> (f64, f64)

Get the plain value range as (min, max).

fn default_normalized(&self, plain_default: f64) -> f64

Get the default normalized value for a given plain default.