Struct Resampler

pub struct Resampler { /* private fields */ }

How the Resampler works For audio stretching:

1. The input audio remains its original length, and zero-padding is applied at the end to reach the target length.
2. Perform FFT transformation to obtain the frequency domain.
3. In the frequency domain, scale down the frequency values proportionally (shift them lower).
4. Perform inverse FFT to obtain the stretched audio.

For audio compression:

1. Take the input audio.
2. Perform FFT transformation.
3. In the frequency domain, scale up the frequency values proportionally (shift them higher).
4. Perform inverse FFT to obtain audio with increased pitch but unchanged length.
5. Truncate the audio to shorten its duration.

This implies: the FFT length must be chosen as the longest possible length involved.

Implementations

impl Resampler

pub fn new(fft_size: usize) -> Resampler

pub fn resample_core( &self, samples: &[f32], desired_length: usize, ) -> Result<Vec<f32>, ResamplerError>

desired_length: The target audio length to achieve, which must not exceed the FFT size. When samples.len() < desired_length, it indicates audio stretching to desired_length. When samples.len() > desired_length, it indicates audio compression to desired_length.

pub fn get_process_size( &self, orig_size: usize, src_sample_rate: u32, dst_sample_rate: u32, ) -> usize

The processing unit size should be adjusted to work in “chunks per second”, and artifacts will vanish when the chunk count aligns with the maximum infrasonic frequency. Calling self.get_desired_length() determines the processed chunk size calculated based on the target sample rate.

pub fn get_desired_length( &self, proc_size: usize, src_sample_rate: u32, dst_sample_rate: u32, ) -> usize

Get the processed chunk size calculated based on the target sample rate.

pub fn resample( &self, input: &[f32], src_sample_rate: u32, dst_sample_rate: u32, ) -> Result<Vec<f32>, ResamplerError>

pub fn get_fft_size(&self) -> usize

Trait Implementations

impl Clone for Resampler

fn clone(&self) -> Resampler

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Resampler

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

Formats the value using the given formatter.