Struct PllFilter 

pub struct PllFilter {
    pub natural_freq_hz: f32,
    pub damping: f32,
    /* private fields */
}

Simple digital Phase-Locked Loop for pitch/tempo tracking.

Uses a second-order loop filter (PI controller).

Fields

natural_freq_hz: f32

Loop natural frequency in Hz.

damping: f32

Damping factor ζ.

Implementations

impl PllFilter

pub fn new( center_freq_hz: f32, natural_freq_hz: f32, damping: f32, sample_rate: f32, ) -> Self

Create a PLL.

• center_freq_hz — initial center frequency
• natural_freq_hz — loop bandwidth
• damping — damping factor (0.707 = Butterworth)

pub fn process_sample(&mut self, input: f32) -> f32

Process one sample. Input is the raw signal (or phase error signal). Returns the VCO output (cosine at locked frequency).

pub fn process_buffer(&mut self, input: &[f32]) -> Vec<f32>

Process a buffer, returning VCO output.

pub fn frequency_hz(&self) -> f32

Current estimated frequency in Hz.

pub fn phase(&self) -> f32

Current phase in radians.

pub fn reset(&mut self)

Reset the PLL state.

Trait Implementations

impl Clone for PllFilter

fn clone(&self) -> PllFilter

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PllFilter

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

Formats the value using the given formatter.