Drive

Four nonlinear shapers with DC removal, tone and latency-aligned filtered oversampling.

  • Effect
  • Since 0.2.0
  • distortion
  • saturation
  • warmth
  • overdrive

Open in TuneToys

Drive as the Patch draws it, at default values: inlets on the left, outlets on the right.

Drive adds harmonics by pushing a signal into a nonlinear shaper. A little adds warmth; a lot adds grit.

What it does#

The input is multiplied by Drive (in dB), passed through the chosen shaper, filtered by Tone, blended with the dry signal by Mix and trimmed by Output. The shapers are Soft clip, Hard clip, Asymmetric and Wavefold. A DC blocker removes any constant offset that Bias or the Asymmetric shaper creates. Quality sets filtered oversampling to reduce aliasing; every setting has the same 12-sample processing latency, aligned before the dry and wet signals are blended.

When to use it#

Use it to warm a clean tone, thicken bass, or add edge to a synth. Follow it with a Low-pass filter or its own Tone control to tame brightness, and with a Limiter if the level gets hot.

Ports#

PortDirectionSignalLanes
audioInputAudioInferred from the cable
audioOutputAudioInferred from the cable

Parameters#

ParameterLabelRangeDefaultUnitScaleNotes
driveDrive0 to 369dBlinearGain into the selected nonlinear shaper.
toneTone200 to 2000020000HzlogLow-pass cutoff; maximum is Open.
mixMix0 to 11linearDry/wet blend. Processing latency is aligned before blending.
outputOutput-24 to 00dBlinearPost-blend output gain.
typeType0 to 30linearSelects the implemented algorithm. Choices are discrete and are not LFO targets. Choices: 0 Soft clip, 1 Hard clip, 2 Asymmetric, 3 Wavefold.
biasBias-0.9 to 0.90linearOffset into the shaper. A DC blocker removes persistent offset.
qualityQuality0 to 21linearFiltered oversampling factor. Every setting has the same 12-sample processing latency. Choices: 0 1×, 1 2× filtered, 2 4× filtered.

Drive (drive)#

The gain into the shaper, 0 to 36 dB. More drive means more distortion and more loudness.

Tone (tone)#

A low-pass cutoff on the wet signal, 200 to 20000 Hz. At the maximum it is Open.

Mix (mix)#

Dry and wet blend. At 1 only the shaped signal is heard; lower values give parallel distortion.

Output (output)#

A post-blend gain from -24 to 0 dB. Use it to compensate for the loudness added by Drive.

Type (type)#

Soft clip, Hard clip, Asymmetric or Wavefold. A discrete choice.

Bias (bias)#

An offset into the shaper, from -0.9 to 0.9. It changes which half of the wave is shaped harder, adding even harmonics. A DC blocker removes the offset afterwards.

Quality (quality)#

The filtered oversampling factor: 1x, 2x filtered or 4x filtered. Higher settings reduce aliasing at more CPU.

Tips#

  • Lower Output as you raise Drive, or the result will be much louder.
  • Soft clip is gentle and sounds warm; Wavefold is more extreme and bright.
  • Use Mix around 0.3 to 0.5 to keep the original attack and add grit underneath.

See also#

Low-pass filter, Filter, Limiter.

Help patches

Each help patch is an ordinary Toy that teaches one idea. The diagram shows the Patch; the preview shows its Frame. Open it in TuneToys to play and edit it.

1. Warm up a clean tone

beginner Teaches: drive, type, output, mix

A triangle wave pushed into a soft clipper.

Patch: Oscillator audio output connected to Drive audio input. Drive audio output connected to Patch outputs audio input.
Connections as text
  • Oscillator audio output connected to Drive audio input
  • Drive audio output connected to Patch outputs audio input
  • Drive is gain into the shaper in dB. More drive adds harmonics.
  • Pull Output down as you add Drive to keep the level steady.
Frame preview: Warm up a clean toneFrame “Warm up a clean tone” with 5 elements: knob Drive, text heading, knob Mix, knob Output, segmented Type.14 dBDriveWARM UP A CLEAN TONE1Mix-6 dBOutputSoft clipHard clipAsymmetricWavefoldType
Frame preview (static). Controls show their default values.

Open in TuneToys

2. Tone, bias and oversampling quality

advanced Teaches: tone, bias, quality

Shape the harshness with tone, asymmetry with bias, and aliasing with quality.

Patch: Oscillator audio output connected to Drive audio input. Drive audio output connected to Patch outputs audio input.
Connections as text
  • Oscillator audio output connected to Drive audio input
  • Drive audio output connected to Patch outputs audio input
  • Bias offsets the signal before the shaper; a DC blocker removes the leftover offset.
  • Every quality setting has the same 12-sample latency, so switching never changes timing.
Frame preview: Tone, bias and oversampling qualityFrame “Tone, bias and oversampling quality” with 5 elements: knob Bias, knob Drive, text heading, segmented Quality, knob Tone.0Bias20 dBDriveTONE, BIAS AND OVERSAMPLING QUALITY1×2× filter…4× filter…Quality5000 HzTone
Frame preview (static). Controls show their default values.

Open in TuneToys

  • Low-pass filter A gentle one-pole filter for warmer edges.
  • Filter Low-pass, high-pass, band-pass, notch, all-pass or morphing filter with resonance, 12/24 dB slopes, curve editing and output RTA.
  • Limiter Linked or independent sample-peak limiting with hold and adaptive release.

Edit this page on GitHub

esc

↑ ↓ move↩ open⌘↩ new tabesc close