Struct oddio::Adapt

pub struct Adapt<T: ?Sized> { /* private fields */ }

Smoothly adjusts gain over time to keep average (RMS) signal level within a target range

Useful for allowing both quiet and loud sounds to be heard without severe distortion.

Rapid changes in input amplitude can cause the output to rise above 1. If a hard limit on output is required, a stateless compressor like Reinhard should be chained afterwards.

This filter is configured in terms of signal root mean square values. For reference, the RMS value of a sine wave is amplitude / 2.0f32.sqrt(). Note that these are linear units, whereas perception of loudness is logarithmic.

Implementations

impl<T> Adapt<T>

pub fn new(signal: T, initial_rms: f32, options: AdaptOptions) -> Self

Apply adaptation to signal

Initialized as if an infinite signal with root mean squared level initial_rms had been processed.

Trait Implementations

impl<T: Signal> Signal for Adapt<T>

where T::Frame: Frame,

type Frame = <T as Signal>::Frame

Type of frames yielded by sample, e.g. [Sample; 2] for stereo

fn sample(&mut self, interval: f32, out: &mut [T::Frame])

Sample frames separated by interval seconds each

fn is_finished(&self) -> bool

Whether future calls to sample with a nonnegative interval will only produce zeroes