Effects

Signal processing effects for shaping sound character.

Saturator

Soft clipping distortion based on analog saturation curves.

use quiver::analog::{Saturator, saturation};

let sat = patch.add("saturator", Saturator::new(saturation::tanh_sat));

Inputs

Output

Saturation Types

Wavefolder

Creates complex harmonics by reflecting the signal about a threshold. Supports opt-in oversampling via set_oversample. type_id: wavefolder.

let folder = patch.add("folder", Wavefolder::new(1.0)); // threshold

Inputs

Output

The Folding Process

Input:   ╱╲
        ╱  ╲
       ╱    ╲

1 Fold: ╱╲╱╲
       ╱    ╲

2 Folds: ╱╲╱╲╱╲╱╲
        ╱      ╲

$$y = \sin(f \cdot \pi \cdot x)$$

Where $f$ is the fold amount.

Crosstalk

Simulates channel bleed between left and right.

let crosstalk = patch.add("xtalk", Crosstalk::new());

Inputs

Outputs

The Effect

$$L_{out} = L_{in} + \text{amount} \cdot R_{in}$$ $$R_{out} = R_{in} + \text{amount} \cdot L_{in}$$

Adds subtle width and analog character.

Ground Loop

Simulates 50/60Hz power supply hum.

let hum = patch.add("hum", GroundLoop::new(44100.0));

Inputs

Output

Configuration

let hum = GroundLoop::new(44100.0)
    .with_frequency(60.0)   // 60Hz (US) or 50Hz (EU)
    .with_harmonics(3);     // Include 2nd and 3rd harmonics

Mix very subtly for vintage authenticity.

Scope

Real-time waveform visualization.

let scope = patch.add("scope", Scope::new(44100.0));

Inputs

Trigger Modes

Reading the Buffer

let waveform = scope.buffer();
// Vec<f64> of recent samples

Spectrum Analyzer

FFT-based frequency analysis.

let analyzer = patch.add("spectrum", SpectrumAnalyzer::new(44100.0));

Input

Reading Data

let bins = analyzer.bins();           // Frequency bins
let mags = analyzer.magnitudes();     // dB values
let peak = analyzer.peak_frequency(); // Dominant frequency

Level Meter

RMS and peak level monitoring.

let meter = patch.add("meter", LevelMeter::new(44100.0));

Input

Reading Levels

let rms = meter.rms();       // RMS level in volts
let peak = meter.peak();     // Peak level
let rms_db = meter.rms_db(); // RMS in dB

Peak Hold

let meter = LevelMeter::new(44100.0)
    .with_peak_hold(500.0);  // 500ms hold time

Distortion

Waveshaping distortion with four selectable algorithms (soft clip, hard clip, foldback, asymmetric), a one-pole tone control, dry/wet mix, and opt-in oversampling (set_oversample). type_id: distortion.

let dist = patch.add("dist", Distortion::new(44100.0));

Inputs

Output

Bitcrusher

Lo-fi bit-depth and sample-rate reduction. type_id: bitcrusher.

let crush = patch.add("crush", Bitcrusher::new());

Inputs

Output

Delay Line

Delay of up to 2 seconds with feedback and wet/dry mix; slew-smoothed delay time for CV-modulated effects. Breaks feedback cycles. type_id: delay_line.

let delay = patch.add("delay", DelayLine::new(44100.0));

Inputs

Output

Chorus

Three-voice modulated-delay chorus with a mono and a stereo-spread output. type_id: chorus.

let chorus = patch.add("chorus", Chorus::new(44100.0));

Inputs

Outputs

Flanger

Short-modulated-delay flanger with feedback; mono in, stereo out via a spread control. out mirrors left for backward compatibility. type_id: flanger.

let flanger = patch.add("flanger", Flanger::new(44100.0));

Inputs

Outputs

Phaser

Cascaded-allpass phaser (2/4/6 selectable stages) with feedback; mono in, stereo out with a spread control. out mirrors left. type_id: phaser.

let phaser = patch.add("phaser", Phaser::new(44100.0));

Inputs

Outputs

Tremolo

Amplitude-modulation tremolo with a sine-to-triangle shape blend. type_id: tremolo.

let trem = patch.add("trem", Tremolo::new(44100.0));

Inputs

Output

Vibrato

Pitch-modulation vibrato via a modulated delay line; defaults fully wet. type_id: vibrato.

let vib = patch.add("vib", Vibrato::new(44100.0));

Inputs

Output

Reverb

Freeverb-style algorithmic reverb (8 comb + 4 allpass) with size, damping, mix, and pre-delay. Stereo output. type_id: reverb.

let reverb = patch.add("reverb", Reverb::new(44100.0));

Inputs

Outputs

Pitch Shifter

Granular (two-grain, crossfaded) real-time pitch shifter. type_id: pitch_shifter.

let shift = patch.add("shift", PitchShifter::new(44100.0));

Inputs

Output

Granular

Granular processor: records the input into a circular buffer and plays overlapping Hann-windowed grains. type_id: granular.

let gran = patch.add("gran", Granular::new(44100.0));

Inputs

Output

Vocoder

Channel vocoder: per-band envelope followers on the modulator impose its spectral envelope onto the carrier. type_id: vocoder.

let voc = patch.add("voc", Vocoder::new(44100.0));

Inputs

Output

Building Effect Chains

Serial Processing

// Input → Saturator → Filter → Output
patch.connect(input, sat.in_("in"))?;
patch.connect(sat.out("out"), vcf.in_("in"))?;
patch.connect(vcf.out("lp"), output)?;

Parallel Processing

// Dry/wet mix
patch.connect(input, mult.in_("in"))?;
patch.connect(mult.out("out_1"), effect.in_("in"))?;  // Wet
patch.connect(mult.out("out_2"), xfade.in_("a"))?;    // Dry
patch.connect(effect.out("out"), xfade.in_("b"))?;    // Wet

Feedback Loop

// With unit delay to prevent infinite loop
patch.connect(effect.out("out"), delay.in_("in"))?;
patch.connect(delay.out("out"), atten.in_("in"))?;  // Feedback amount
patch.connect(atten.out("out"), effect.in_("in"))?;