Struct Distortion 

pub struct Distortion { /* private fields */ }

Distortion

Waveshaping distortion with multiple algorithms:

• Soft clip (bounded tanh)
• Hard clip
• Foldback
• Asymmetric (tube-style)

All shapers operate in the normalized ±1 domain (the Audio convention is ±5V) so their saturation points match the signal level, and every algorithm stays within ±5V. The tone control is a real one-pole low-pass whose cutoff is swept from DISTORTION_TONE_MIN_HZ (dark) to DISTORTION_TONE_MAX_HZ (≈ transparent).

Implementations

impl Distortion

pub fn new(sample_rate: f64) -> Self

pub fn set_oversample(&mut self, mode: Oversample)

Select the oversampling factor for the waveshaping stage (Q143).

Defaults to Oversample::Off. Enabling 2x/4x runs the (aliasing-prone) waveshaper at a higher internal rate and band-limits before decimation, materially reducing the inharmonic aliasing of hard/foldback modes at high input frequencies. The tone low-pass runs at the base rate, after decimation.

pub fn oversample_factor(&self) -> usize

Current oversampling factor of the waveshaping stage (1 = off, 2, or 4).

Trait Implementations

impl Default for Distortion

fn default() -> Self

Returns the “default value” for a type.

impl GraphModule for Distortion

fn port_spec(&self) -> &PortSpec

Returns the module’s port specification

fn tick(&mut self, inputs: &PortValues, outputs: &mut PortValues)

Process one sample given port values

fn reset(&mut self)

Reset internal state

fn set_sample_rate(&mut self, sample_rate: f64)

Set sample rate

fn type_id(&self) -> &'static str

Get module type identifier for serialization

fn introspect(&self) -> Option<&dyn ModuleIntrospection>

Available on crate feature alloc only.

Downcast this module to its ModuleIntrospection view, if it exposes one.

fn introspect_mut(&mut self) -> Option<&mut dyn ModuleIntrospection>

Available on crate feature alloc only.

Mutable companion to introspect, used to set internal parameters.

fn process_block( &mut self, inputs: &BlockPortValues, outputs: &mut BlockPortValues, frames: usize, )

Process a block of samples (optional optimization).

fn breaks_feedback_cycle(&self) -> bool

Whether this module breaks a feedback cycle in the patch graph.

fn params(&self) -> &[ParamDef]

Get parameter definitions for UI binding.

fn get_param(&self, _id: ParamId) -> Option<f64>

Get a parameter value.

fn set_param(&mut self, _id: ParamId, _value: f64)

Set a parameter value.

fn serialize_state(&self) -> Option<Value>

Available on crate feature alloc only.

Serialize module state (alloc feature only)

fn deserialize_state(&mut self, _state: &Value) -> Result<(), String>

Available on crate feature alloc only.

Deserialize module state (alloc feature only)

impl ModuleIntrospection for Distortion

Available on crate feature alloc only.

fn param_infos(&self) -> Vec<ParamInfo>

Get all parameter descriptors for this module

fn set_param_by_id(&mut self, id: &str, value: f64) -> bool

Set a parameter value by its ID

fn get_param_info(&self, id: &str) -> Option<ParamInfo>

Get a specific parameter by its ID