Struct LoudnessNormalizer 

pub struct LoudnessNormalizer { /* private fields */ }

Loudness normalizer with EBU R128 compliance. Supports track-based pre-analysis and real-time streaming modes.

Implementations

impl LoudnessNormalizer

pub fn new(channels: usize, sample_rate: u32, config: LoudnessConfig) -> Self

pub fn atomic_state(&self) -> Arc<AtomicLoudnessState>

pub fn set_enabled(&mut self, enabled: bool)

pub fn set_config(&mut self, config: LoudnessConfig)

pub fn set_target_lufs(&mut self, target_lufs: f64)

pub fn set_album_gain(&self, gain_db: f64)

pub fn set_preamp_gain(&self, gain_db: f64)

pub fn set_mode(&self, mode: NormalizationMode)

pub fn analyze_track(&mut self, samples: &[f64]) -> f64

Pre-analyze track loudness (call before streaming playback)

FIX for Defect 39: Check loudness.is_finite() to prevent +inf gain when ebur128 returns -inf (silent or very short tracks <400ms). Invalid loudness values result in 0 dB gain (no normalization).

pub fn calculate_gain(&mut self, samples: &[f64]) -> f64

Calculate track gain without updating atomic state (for gapless preload) Returns the target gain in dB that should be applied after buffer swap. This prevents premature gain update during the last seconds of current track.

FIX for Defect 39: Check loudness.is_finite() to prevent +inf gain when ebur128 returns -inf (silent or very short tracks <400ms).

pub fn calculate_gain_with_mode( &mut self, samples: &[f64], mode: NormalizationMode, metadata: &TrackMetadata, ) -> f64

Calculate gain for gapless preload with mode awareness (Bug-4 fix)

For ReplayGain modes, reads gain from metadata tags instead of EBU R128 analysis. Falls back to EBU R128 if tags are missing.

pub fn reset(&mut self)

pub fn process(&mut self, samples: &mut [f64])

Process interleaved f64 samples in-place

pub fn get_loudness_info(&self) -> LoudnessInfo

pub fn track_loudness(&self) -> Option<f64>

pub fn is_analyzed(&self) -> bool