oarust 0.9.0

GPU-first semantic computing engine written in Rust
// @generated by tool/gen/fn/generate.py; DO NOT EDIT.
// schema=audio.json schema_version=1 generator_version=64
// schema_sha256=2f2611fc0899110cb5a178958123b4ccab5dda014db67459ba74696cf97c6427
use crate::audio::{
	BiquadCoefficients, MelConfig, MfccConfig, NormalizeAudioConfig, ResampleConfig, StftConfig,
};
use crate::{Audio, Matrix, Result};

impl Audio {
	/// Normalize global peak or RMS level to the configured decibel target.
	///
	/// Delegates to [`crate::audio::normalize`].
	pub fn normalize(&self, config: NormalizeAudioConfig) -> Result<Self> {
		crate::audio::normalize(self, config)
	}

	/// Resample planar audio using the donor windowed-sinc gather kernel.
	///
	/// Delegates to [`crate::audio::resample`].
	pub fn resample(&self, config: ResampleConfig) -> Result<Self> {
		crate::audio::resample(self, config)
	}

	/// Apply scalar gain in decibels.
	///
	/// Delegates to [`crate::audio::gain`].
	pub fn gain(&self, gain_db: f32) -> Result<Self> {
		crate::audio::gain(self, gain_db)
	}

	/// Clamp every sample to an inclusive finite interval.
	///
	/// Delegates to [`crate::audio::clip`].
	pub fn clip(&self, minimum: f32, maximum: f32) -> Result<Self> {
		crate::audio::clip(self, minimum, maximum)
	}

	/// Apply tanh soft clipping with a dry/wet mix.
	///
	/// Delegates to [`crate::audio::saturate`].
	pub fn saturate(&self, drive_db: f32, mix: f32) -> Result<Self> {
		crate::audio::saturate(self, drive_db, mix)
	}

	/// Apply one stable zero-state biquad independently to every channel.
	///
	/// Delegates to [`crate::audio::biquad`].
	pub fn biquad(&self, coefficients: BiquadCoefficients) -> Result<Self> {
		crate::audio::biquad(self, coefficients)
	}

	/// Render a finite zero-state Schroeder reverberation tail.
	///
	/// Delegates to [`crate::audio::reverb`].
	pub fn reverb(&self, decay_seconds: f32, wet: f32) -> Result<Self> {
		crate::audio::reverb(self, decay_seconds, wet)
	}

	/// Apply one to 64 stable biquad sections as a zero-state cascade.
	///
	/// Delegates to [`crate::audio::sos_filter`].
	pub fn sos_filter(&self, sections: &[BiquadCoefficients]) -> Result<Self> {
		crate::audio::sos_filter(self, sections)
	}

	/// Apply `y[n] = x[n] - alpha*x[n-1]` independently per channel.
	///
	/// Delegates to [`crate::audio::pre_emphasis`].
	pub fn pre_emphasis(&self, alpha: f32) -> Result<Self> {
		crate::audio::pre_emphasis(self, alpha)
	}

	/// Average all channels into one mono channel.
	///
	/// Delegates to [`crate::audio::to_mono`].
	pub fn to_mono(&self) -> Result<Self> {
		crate::audio::to_mono(self)
	}

	/// Apply linear fade-in and fade-out envelopes measured in samples.
	///
	/// Delegates to [`crate::audio::fade`].
	pub fn fade(&self, fade_in_samples: u64, fade_out_samples: u64) -> Result<Self> {
		crate::audio::fade(self, fade_in_samples, fade_out_samples)
	}

	/// Compute a weighted sum of matching Audio values.
	///
	/// Delegates to [`crate::audio::mix`].
	pub fn mix(&self, right: &Audio, gain_left: f32, gain_right: f32) -> Result<Self> {
		crate::audio::mix(self, right, gain_left, gain_right)
	}

	/// Convert absolute amplitude to finite decibels with a silence floor.
	///
	/// Delegates to [`crate::audio::amplitude_to_db`].
	pub fn amplitude_to_db(&self, floor_db: f32) -> Result<Matrix> {
		crate::audio::amplitude_to_db(self, floor_db)
	}

	/// Reduce multichannel audio to `[bins, 2]` minimum/maximum pairs.
	///
	/// Delegates to [`crate::audio::waveform_envelope`].
	pub fn waveform_envelope(&self, bins: u32) -> Result<Matrix> {
		crate::audio::waveform_envelope(self, bins)
	}

	/// Compute magnitude STFT features in `[channels, frames, frequency_bins]` layout.
	///
	/// Delegates to [`crate::audio::stft`].
	pub fn stft(&self, config: StftConfig) -> Result<Matrix> {
		crate::audio::stft(self, config)
	}

	/// Compute HTK triangular-filter mel features in `[channels, mels, frames]` layout.
	///
	/// Delegates to [`crate::audio::mel_spectrogram`].
	pub fn mel_spectrogram(&self, config: MelConfig) -> Result<Matrix> {
		crate::audio::mel_spectrogram(self, config)
	}

	/// Compute orthonormal DCT-II coefficients in `[channels, coefficients, frames]` layout.
	///
	/// Delegates to [`crate::audio::mfcc`].
	pub fn mfcc(&self, config: MfccConfig) -> Result<Matrix> {
		crate::audio::mfcc(self, config)
	}
}

const _: fn(&Audio, NormalizeAudioConfig) -> Result<Audio> = crate::audio::normalize;
const _: fn(&Audio, NormalizeAudioConfig) -> Result<Audio> = Audio::normalize;
const _: fn(&Audio, ResampleConfig) -> Result<Audio> = crate::audio::resample;
const _: fn(&Audio, ResampleConfig) -> Result<Audio> = Audio::resample;
const _: fn(&Audio, f32) -> Result<Audio> = crate::audio::gain;
const _: fn(&Audio, f32) -> Result<Audio> = Audio::gain;
const _: fn(&Audio, f32, f32) -> Result<Audio> = crate::audio::clip;
const _: fn(&Audio, f32, f32) -> Result<Audio> = Audio::clip;
const _: fn(&Audio, f32, f32) -> Result<Audio> = crate::audio::saturate;
const _: fn(&Audio, f32, f32) -> Result<Audio> = Audio::saturate;
const _: fn(&Audio, BiquadCoefficients) -> Result<Audio> = crate::audio::biquad;
const _: fn(&Audio, BiquadCoefficients) -> Result<Audio> = Audio::biquad;
const _: fn(&Audio, f32, f32) -> Result<Audio> = crate::audio::reverb;
const _: fn(&Audio, f32, f32) -> Result<Audio> = Audio::reverb;
const _: fn(&Audio, &[BiquadCoefficients]) -> Result<Audio> = crate::audio::sos_filter;
const _: fn(&Audio, &[BiquadCoefficients]) -> Result<Audio> = Audio::sos_filter;
const _: fn(&Audio, f32) -> Result<Audio> = crate::audio::pre_emphasis;
const _: fn(&Audio, f32) -> Result<Audio> = Audio::pre_emphasis;
const _: fn(&Audio) -> Result<Audio> = crate::audio::to_mono;
const _: fn(&Audio) -> Result<Audio> = Audio::to_mono;
const _: fn(&Audio, u64, u64) -> Result<Audio> = crate::audio::fade;
const _: fn(&Audio, u64, u64) -> Result<Audio> = Audio::fade;
const _: fn(&Audio, &Audio, f32, f32) -> Result<Audio> = crate::audio::mix;
const _: fn(&Audio, &Audio, f32, f32) -> Result<Audio> = Audio::mix;
const _: fn(&Audio, f32) -> Result<Matrix> = crate::audio::amplitude_to_db;
const _: fn(&Audio, f32) -> Result<Matrix> = Audio::amplitude_to_db;
const _: fn(&Audio, u32) -> Result<Matrix> = crate::audio::waveform_envelope;
const _: fn(&Audio, u32) -> Result<Matrix> = Audio::waveform_envelope;
const _: fn(&Audio, StftConfig) -> Result<Matrix> = crate::audio::stft;
const _: fn(&Audio, StftConfig) -> Result<Matrix> = Audio::stft;
const _: fn(&Audio, MelConfig) -> Result<Matrix> = crate::audio::mel_spectrogram;
const _: fn(&Audio, MelConfig) -> Result<Matrix> = Audio::mel_spectrogram;
const _: fn(&Audio, MfccConfig) -> Result<Matrix> = crate::audio::mfcc;
const _: fn(&Audio, MfccConfig) -> Result<Matrix> = Audio::mfcc;