Struct ResamplingProd 

pub struct ResamplingProd<T: Sample> { /* private fields */ }

The producer end of a realtime-safe spsc channel for sending samples across streams.

If the input and output samples rates differ, then this will automatically resample the input stream to match the output stream. If the sample rates match, then no resampling will occur.

Internally this uses the rubato and ringbuf crates.

Implementations

impl<T: Sample + 'static> ResamplingProd<T>

pub fn push( &mut self, input: &dyn Adapter<'_, T>, input_range: Option<Range<usize>>, active_channels_mask: Option<&[bool]>, ) -> PushStatus

Push the given input data.

• input - The input data. You can use one of the types in the audioadapter_buffers::direct module to wrap your input data into a type that implements Adapter.
• input_range - The range in each input channel to read from. If this is None, then the entire input buffer will be read.
• active_channels_mask - An optional mask that selects which channels in input to use. Channels marked with false will be skipped and that output channel filled with zeros. If None, then all of the channels will be active.

This method is realtime-safe.

Panics

Panics if:

• The input_range is out of bounds for any of the input channels.
• This producer was created with push_interleave_only set to true.

pub fn push_interleaved(&mut self, input: &[T]) -> PushStatus

Push the given input data in interleaved format.

The input buffer must have the same number of channels as this producer.

This method is realtime-safe.

pub fn available_frames(&mut self) -> usize

Returns the number of input frames (samples in a single channel of audio) that are currently available to be pushed to the channel.

If the output stream is not ready yet, then this will return 0.

This method is realtime-safe.

pub fn available_seconds(&mut self) -> f64

The amount of data in seconds that is available to be pushed to the channel.

If the output stream is not ready yet, then this will return 0.0.

This method is realtime-safe.

pub fn occupied_output_frames(&self) -> usize

The amount of data that is currently occupied in the channel, in units of output frames (samples in a single channel of audio).

Note, this is the number of frames in the output audio stream, not the input audio stream.

This method is realtime-safe.

pub fn occupied_seconds(&self) -> f64

The amount of data that is currently occupied in the channel, in units of seconds.

This method is realtime-safe.

pub fn num_channels(&self) -> usize

The number of channels configured for this stream.

This method is realtime-safe.

pub fn in_sample_rate(&self) -> f64

The sample rate of the input stream.

This method is realtime-safe.

pub fn out_sample_rate(&self) -> f64

The sample rate of the output stream.

This method is realtime-safe.

pub fn latency_seconds(&self) -> f64

The latency of the channel in units of seconds.

This method is realtime-safe.

pub fn is_resampling(&self) -> bool

Returns true if this channel is currently resampling.

This method is realtime-safe.

pub fn reset(&mut self)

Tell the consumer to clear all queued frames in the buffer.

This method is realtime-safe.

pub fn set_input_stream_ready(&mut self, ready: bool)

Manually notify the output stream that the input stream is ready/not ready to push samples to the channel.

If this producer end is being used in a non-realtime context, then it is a good idea to set this to true so that the consumer end can start reading samples from the channel immediately.

Note, calling ResamplingProd::push and ResamplingProd::push_interleaved automatically sets the input stream as ready.

This method is realtime-safe.

pub fn output_stream_ready(&self) -> bool

Whether or not the output stream is ready to read samples from the channel.

This method is realtime-safe.

pub fn autocorrect_underflows(&mut self) -> Option<usize>

Correct for any underflows.

This returns the number of extra zero frames (samples in a single channel of audio) that were added due to an underflow occurring. If no underflow occured, then None is returned.

Note, this method is already automatically called in ResamplingProd::push and ResamplingProd::push_interleaved.

This will have no effect if ResamplingChannelConfig::underflow_autocorrect_percent_threshold was set to None.

This method is realtime-safe.