Struct Samplerate 

pub struct Samplerate { /* private fields */ }

A samplerate converter. This is a wrapper around libsamplerate’s SRC_STATE which also stores the source and target samplerates.

Example

use samplerate_rs::{Samplerate, ConverterType};

// Generate a 880Hz sine wave for 1 second in 44100Hz with one channel.
let freq = std::f32::consts::PI * 880f32 / 44100f32;
let mut input: Vec<f32> = (0..44100).map(|i| (freq * i as f32).sin()).collect();

// Instanciate a new converter.
let mut converter = Samplerate::new(ConverterType::SincBestQuality, 44100, 48000, 1).unwrap();

// Resample the input from 44100Hz to 48000Hz.
let resampled = converter.process_last(&input).unwrap();
assert_eq!(resampled.len(), 48000);

Implementations

impl Samplerate

pub fn new( converter_type: ConverterType, from_rate: u32, to_rate: u32, channels: usize, ) -> Result<Samplerate, Error>

Create a new samplerate converter with the given rates and channels.

pub fn reset(&mut self) -> Result<(), Error>

Reset the internal converter’s state.

pub fn from_rate(&self) -> u32

Retrieve the currently used source samplerate.

pub fn to_rate(&self) -> u32

Retrieve the currently used target samplerate.

pub fn set_from_rate(&mut self, from_rate: u32)

Change the source samplerate.

pub fn set_to_rate(&mut self, to_rate: u32)

Change the target samplerate.

pub fn ratio(&self) -> f64

Calculate the ratio (target samplerate divided by source samplerate).

pub fn channels(&self) -> Result<usize, Error>

Retrieve the number of channels used.

pub fn process(&self, input: &[f32]) -> Result<Vec<f32>, Error>

Perform a samplerate conversion on a block of data (use process_last if it is the last one) If the number of channels used was not 1 (Mono), the samples are expected to be stored interleaved.

pub fn process_last(&self, input: &[f32]) -> Result<Vec<f32>, Error>

Perform a samplerate conversion on last block of given input data. If the number of channels used was not 1 (Mono), the samples are expected to be stored interleaved.

Trait Implementations

impl Clone for Samplerate

fn clone(&self) -> Samplerate

Might panic if the underlying src_clone method from libsamplerate returns an error.

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

Performs copy-assignment from source.

impl Drop for Samplerate

fn drop(&mut self)

Executes the destructor for this type.