Struct SmoothedValue

pub struct SmoothedValue<S: Sample, T: SmoothingStrategy> { /* private fields */ }

A value that smoothly transitions to a target over time.

Uses the specified SmoothingStrategy to interpolate between values, avoiding clicks and pops when parameters change.

Generic over S: Sample for the value type and T: SmoothingStrategy for the interpolation method.

Implementations

impl<S: Sample, T: SmoothingStrategy> SmoothedValue<S, T>

pub fn new(initial_value: S) -> Self

Create a new SmoothedValue with the given initial value.

Uses default sample rate (44100.0) and ramp length (50ms).

pub fn reset(&mut self, sample_rate: f64, ramp_length_millis: f64)

Reset the sample rate and ramp length.

This recalculates the increment based on the new timing parameters. A minimum ramp length of 0.01ms is enforced to prevent clicks.

pub fn set_target_value(&mut self, value: S)

Set a new target value to smooth towards.

pub fn get_next_value(&mut self) -> S

Get the next smoothed value (call once per sample).

pub fn skip(&mut self, num_samples: i32)

Skip ahead by the specified number of samples.

pub fn current(&self) -> S

Get the current value without advancing.

pub fn target(&self) -> S

Get the target value.

pub fn is_smoothing(&self) -> bool

Check if the value is still smoothing towards the target.

pub fn set_immediate(&mut self, value: S)

Immediately set both current and target to a value (no smoothing).

Trait Implementations

impl<S: Clone + Sample, T: Clone + SmoothingStrategy> Clone for SmoothedValue<S, T>

fn clone(&self) -> SmoothedValue<S, T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<S: Debug + Sample, T: Debug + SmoothingStrategy> Debug for SmoothedValue<S, T>

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

Formats the value using the given formatter.

impl<S: Sample, T: SmoothingStrategy> Default for SmoothedValue<S, T>

fn default() -> Self

Returns the “default value” for a type.