Struct oddio::Reinhard

pub struct Reinhard<T>(/* private fields */);

Smoothly maps a signal of any range into (-1, 1)

For each input sample x, outputs x / (1 + |x|).

When many signals are combined with a Mixer or Spatial, or when spatial signals are very near by, audio can get arbitrarily loud. Because surprisingly loud audio can be disruptive and even damaging, it can be useful to limit the output range, but simple clamping introduces audible artifacts.

See also Tanh, which distorts quiet sounds less, and loud sounds more.

Implementations

impl<T> Reinhard<T>

pub fn new(signal: T) -> Self

Apply the Reinhard operator to signal

Trait Implementations

impl<T> Seek for Reinhard<T>

where T: Signal + Seek, T::Frame: Frame,

fn seek(&mut self, seconds: f32)

Shift the starting point of the next sample call by seconds

impl<T: Signal> Signal for Reinhard<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