Struct RubatoResampler 

pub struct RubatoResampler { /* private fields */ }

RT-safe resampler backed by the rubato Fft synchronous resampler.

It operates at a fixed input ratio (FixedSync::Input). On the processing path (process_into_buffer) it wraps the caller-provided planar-flat slice directly with a SequentialSlice adapter and hands it to rubato zero-copy and allocation-free.

Panics

No method on this type panics. Every error on the processing path is returned as a ResampleError.

Implementations

impl RubatoResampler

pub fn new( input_rate: f64, output_rate: f64, channels: usize, chunk_size: usize, ) -> Result<Self, ResampleError>

Creates a new resampler. Call this before entering the RT thread so that all internal state is prepared.

input_rate/output_rate must be positive finite values (>= 1.0 Hz, <= MAX_RATE, representable as integer Hz without loss). channels >= 1 and chunk_size >= 1 are required.

Errors

• rate <= 0, non-finite, or > MAX_RATE -> ResampleError::InvalidSampleRate.
• channels == 0 -> ResampleError::InvalidChannelCount.
• chunk_size == 0 -> ResampleError::InvalidChunkSize.
• rubato Fft construction failure -> ResampleError::ResampleFailed.

pub fn input_chunk_size(&self) -> usize

Returns the fixed number of input frames (per channel).

pub fn output_frames_max(&self) -> usize

Returns the upper bound on output frames (per channel). The RT caller must pre-allocate the output buffer to at least this size.

pub fn channels(&self) -> usize

Returns the channel count.

pub fn input_rate(&self) -> f64

Returns the input sample rate (Hz).

pub fn output_rate(&self) -> f64

Returns the output sample rate (Hz).

pub fn output_delay(&self) -> usize

Returns the resampler’s group delay, in output frames.

rubato Fft introduces a fixed delay equal to half the internal FFT block size, expressed in output frames. For offline / full-clip processing the caller may trim this many leading output frames to align output with input. For RT streaming the caller absorbs the delay through buffering.

This is a read-only query, so it is safe on the RT path (no allocation, no locking).

Trait Implementations

impl Debug for RubatoResampler

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

Formats the value using the given formatter.

impl Resampler for RubatoResampler

fn process_into_buffer( &mut self, input: &[f32], output: &mut [f32], ) -> Result<usize, ResampleError>

Writes resampled samples into the pre-allocated output buffer (RT-safe, allocation-free).

fn set_rate(&mut self, input_rate: f64, output_rate: f64)

Changes the input/output sample rates. NOT RT-safe — allocates (call only between audio cycles).