Skip to main content

Preprocessor

Struct Preprocessor 

Source
pub struct Preprocessor { /* private fields */ }
Expand description

Audio preprocessor that applies configured processing stages.

Each instance maintains its own filter state, so you should create one Preprocessor per audio stream (or per VAD config in vad-lab).

§Processing Order

  1. High-pass filter (removes low-frequency noise)
  2. Noise suppression (RNNoise, resamples internally if not 48kHz)
  3. Normalization (RMS-based amplitude adjustment)

Implementations§

Source§

impl Preprocessor

Source

pub fn new(config: &PreprocessorConfig, sample_rate: u32) -> Self

Create a new preprocessor with the given configuration.

§Arguments
  • config - Preprocessing configuration
  • sample_rate - Audio sample rate in Hz
Source

pub fn sample_rate(&self) -> u32

Returns the sample rate this preprocessor was configured for.

Source

pub fn is_enabled(&self) -> bool

Returns true if any preprocessing stages are enabled.

Source

pub fn is_denoising(&self) -> bool

Returns true if noise suppression is active.

Source

pub fn is_normalizing(&self) -> bool

Returns true if normalization is active.

Source

pub fn process(&mut self, samples: &[i16]) -> Vec<i16>

Process audio samples and return the preprocessed result.

Returns a new Vec<i16> with the processed samples. If no preprocessing is enabled, returns a clone of the input.

Source

pub fn reset(&mut self)

Reset all filter states.

Call this when starting a new audio stream or after a long pause.

Trait Implementations§

Source§

impl Debug for Preprocessor

Source§

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<S> FromSample<S> for S

Source§

fn from_sample_(s: S) -> S

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T, U> ToSample<U> for T
where U: FromSample<T>,

Source§

fn to_sample_(self) -> U

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

impl<S, T> Duplex<S> for T
where T: FromSample<S> + ToSample<S>,