Struct Resampler 

pub struct Resampler<T: Transcendental> { /* private fields */ }

Sample-rate converter wrapping InterpolatedReader.

Accepts a pre-loaded buffer with a known source sample rate and outputs at a target rate that can differ from the source rate.

Examples

use rill_core::traits::Algorithm;
use rill_core_dsp::generators::Resampler;

let source_rate = 44100.0;
let samples = vec![0.0f32; 1024];
let mut rs = Resampler::new(samples, source_rate);
rs.init(48000.0);
let mut out = vec![0.0f32; 512];
rs.process(None, &mut out).unwrap();
assert!((rs.position() - 512.0 * 44100.0 / 48000.0).abs() < 1.0);

Implementations

impl<T: Transcendental> Resampler<T>

pub fn new(buffer: Vec<T>, source_rate: f64) -> Self

Create a new resampler from a sample buffer and its source sample rate.

The resampler starts with target_rate = source_rate (passthrough). Call Algorithm::init or [set_target_rate] to convert to a different rate.

pub fn from_boxed(buffer: Box<[T]>, source_rate: f64) -> Self

Create a resampler from a pre-allocated boxed slice.

pub fn len(&self) -> usize

Number of samples in the source buffer.

pub fn is_empty(&self) -> bool

Returns true if the source buffer is empty.

pub fn source_rate(&self) -> f64

Source sample rate in Hz.

pub fn set_source_rate(&mut self, hz: f64)

Set the source sample rate and recompute the interpolation ratio.

pub fn target_rate(&self) -> f64

Target sample rate in Hz.

pub fn set_target_rate(&mut self, hz: f64)

Set the target sample rate and recompute the interpolation ratio.

pub fn set_cubic(&mut self, cubic: bool)

Enable (true) or disable (false) cubic Hermite interpolation.

Linear interpolation (default) is faster; cubic gives higher quality at the cost of more computation.

pub fn is_cubic(&self) -> bool

Returns true if cubic interpolation is enabled.

pub fn position(&self) -> f64

Current read position in the source buffer (in source samples).

pub fn set_position(&mut self, pos: f64)

Set the read position in the source buffer.

pub fn set_buffer(&mut self, buffer: Vec<T>)

Replace the source buffer and reset position to 0.

The new buffer is assumed to have the same source rate.

pub fn as_slice(&self) -> &[T]

Return the internal buffer as an immutable slice.

pub fn ratio(&self) -> f64

The computed interpolation ratio (source_rate / target_rate).

When ratio > 1.0 the source runs faster → downsampling. When ratio < 1.0 the source runs slower → upsampling.

Trait Implementations

impl<T: Transcendental> Algorithm<T> for Resampler<T>

fn init(&mut self, sample_rate: f32)

Initialise the algorithm with a sample rate.

fn reset(&mut self)

Reset the algorithm to its initial state.

fn process( &mut self, _input: Option<&[T]>, output: &mut [T], ) -> ProcessResult<()>

Process one block of signal.

fn metadata(&self) -> AlgorithmMetadata

Descriptive metadata (defaults to empty).

fn apply_command(&mut self, _value: T)

Receive a real-time command value from the control path.