Struct StereoField 

pub struct StereoField {
    pub balance: f32,
    pub spread: f32,
}

One hop’s whole-mix stereo field.

Fields

balance: f32

Where the mix sits, -1 hard left to +1 hard right, 0 centred.

spread: f32

How decorrelated the two channels are: 0 identical, 0.5 fully decorrelated, 1 polarity-inverted.

Implementations

impl StereoField

pub fn measure(left: &[f32], right: &[f32]) -> Self

Measure one hop from channels 0 and 1.

balance is the ratio of the two channels’ RMS through ratio, and spread is (1 - corr) / 2 over the normalized correlation Σ(l·r) / sqrt(Σl² · Σr²). Both read exactly 0 when the larger channel’s RMS sits below WAVE_FLOOR, and identical channels read exactly 0 for both: the correlation’s numerator and denominator are then the same sum, and sqrt(a·a) is exactly a under round-to-nearest.

Only the overlapping prefix of the two slices is read, so a caller that has one channel shorter measures what it has rather than reaching past it. The sums stay far from overflow at hop length: every sample of a validated stream is finite and the squares of a ±1 hop total at most its own sample count.

Trait Implementations

impl Clone for StereoField

fn clone(&self) -> StereoField

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StereoField

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

Formats the value using the given formatter.

impl Default for StereoField

fn default() -> StereoField

Returns the “default value” for a type.

impl PartialEq for StereoField

fn eq(&self, other: &StereoField) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for StereoField

impl StructuralPartialEq for StereoField