Struct TraceNormalizer 

pub struct TraceNormalizer { /* private fields */ }

The waveform’s normalizer: one running peak of the trace’s magnitude, applied as a uniform gain to the whole trace.

One shared peak for the same reason BandNormalizer uses one — the samples of a trace only mean anything relative to each other, and a per-sample gain would erase the shape the trace exists to show. Two differences from that type, both forced by the quantity:

• The peak tracks |x| and the output stays signed. A trace is a signal, not a magnitude, so it is divided rather than rectified and clamps to -1..=1 instead of 0..=1.
• The divisor is returned rather than discarded, because it is published as AnalysisFrame::waveform_gain (ADR-0139): the raw amplitude is waveform[i] * waveform_gain, which is the escape hatch a consumer that genuinely wants absolute level reaches for.

Implementations

impl TraceNormalizer

pub fn new(sample_rate: u32) -> Self

A normalizer for the trace at sample_rate.

pub fn normalize(&mut self, trace: &mut [f32; 512]) -> f32

Advance one hop, normalizing trace in place, and return the divisor removed — 0.0 while the tracked peak sits under the floor, where the trace is zeroed rather than amplified.