MIX & Plugins

Technical notes

Documentation

Straight description of each processing path. The Plugin overview button opens the same card as on the Plugins page. Buy licenses in the plugin catalog.

Plugin catalog →

Contents

Each plugin below has a full write-up and a signal-flow diagram from the DSP code. FX-KNOBS is the Knobs-line rack, built on those same algorithms.

  1. STM Pusher
  2. STM Knob Line
  3. STM FX-KNOBS
  4. Duck Reverb

STM Pusher

Источник реализации: shared/dsp/ImPusherDsp.cpp.

Входной стерео-буфер умножается на Input gain (дБ → линейный коэффициент, сглаживание ~20 ms). Далее каскад фильтров Linkwitz–Riley:

1) разделение на 180 Hz → полоса low и «rest»; 2) «rest» разделяется на 3500 Hz → mid и high.

Обработка полос (по сэмплам, L/R независимо до суммирования): — Low *= decibelsToGain(LowKnob * 8 dB); — Mid *= decibelsToGain(BodyKnob * 6 dB); — при Magic > 0 к mid добавляется Magic * 0.25 * tanh(mid * 3) (мягкие гармоники на середине); — High *= decibelsToGain(HighKnob * 7 dB).

Полосы суммируются обратно в L/R. Затем mid/side ширина: mid = ½(L+R), side = ½(L−R), side *= (1 + Stereo * 1.5), L/R = mid ± side.

Стадия Push: drive = decibelsToGain(Push * 10 dB). Ведётся peak envelope (attack ≈ 0.8 ms, release ≈ 60 ms). В режиме Clip применяется soft-tanh ceiling около 0.95; в режиме Limit при env > 0.95 выполняется GR = 0.95/env. Выход жёстко ограничивается в [−1, 1].

Важно: UI показывает четыре ручки Low/Body/Magic/High, но акустически это три полосы (180 / 3500 Hz). Body и Magic оба действуют на mid-полосу. Latency определяется порядком кроссоверов; lookahead нет.

Signal diagram
Diagram: STM Pusher

STM Knob Line

Линейка построена на общем каркасе JUCE AudioProcessor + APVTS (KnobProcessor). Главный параметр Amount нормализован в диапазоне 0…10 и внутри DSP приводится к 0…1 (кроме Width, где Amount мапится в w ∈ [−1, +1]).

Каждый плагин — отдельный AU-бандл с уникальным PLUGIN_CODE; DSP-модули лежат в shared/dsp и выбираются по KnobKind. UI — компактный OneKnobEditor (фиксированный размер шасси). Вторичные параметры (Rate/Offset у Pumper, Slope/Reso у Filter) — choice-параметры APVTS.

Ниже — алгоритмы отдельных модулей линейки со схемами сигнала.

PUMPER-Knob

Источник: shared/dsp/PumperDsp.cpp.

Генерируется периодическая огибающая gain, синхронизированная с host tempo (BPM из AudioPlayHead; fallback 120). Rate выбирает длительность цикла в долях такта через таблицу beats: 0.125, 0.25, 1/3, 0.5, 1, 1.5, 2, 4, 8, 16 (соответствует UI 1/32 … 4 Bar).

Offset сдвигает фазу цикла: −90 → 0.75, 0 → 0.0, +90 → 0.25. Внутри цикла p ∈ [0,1); env = exp(−p * 4.5) — классическая форма «быстрый провал / экспоненциальный подъём». Итоговый gain g = 1 − Amount * env, сглаживается SmoothedValue (~10 ms) и умножается на L и R (linked stereo). Lookahead нет.

Signal diagram
Diagram: PUMPER-Knob

FILTER-Knob

Источник: shared/dsp/FilterDsp.cpp.

Используется juce::dsp::StateVariableTPTFilter в режиме lowpass. Amount A ∈ [0,1] мапится в cutoff: fc = 20 * 1000^(1−A) Гц — при A=0 фильтр открыт (~20 kHz), при A=1 закрыт (~20 Hz). Cutoff сглаживается ~30 ms.

Slope: 12 dB/oct = один каскад; 24 dB/oct = два каскада подряд. Reso задаёт Q: 0.707 / 1.2 / 2.5 / 6.0 (Off…High). Каналы обрабатываются одинаково.

Signal diagram
Diagram: FILTER-Knob

PHATTER-Knob

Источник: shared/dsp/ToneBoostDsp.cpp, Mode::Phatter.

Цепочка IIR на каждый канал: low-shelf @ 90 Hz (Q≈0.65) с усилением до +16 dB (A*16), затем peaking @ 110 Hz (Q≈0.9) до +8 dB (A*8). Коэффициенты пересчитываются несколько раз за блок по сглаженному Amount. При A≈0 обработка пропускается (bypass). Waveshaping в Phatter нет.

Signal diagram
Diagram: PHATTER-Knob

BRIGHTER-Knob

Источник: shared/dsp/ToneBoostDsp.cpp, Mode::Brighter.

High-shelf @ 4500 Hz, Q=0.707, усиление до +14 dB (A*14). Peak-стадия в этом режиме держится на unity (flat). При A≈0 — bypass. Предназначен для air/presence без отдельного эксайтера.

Signal diagram
Diagram: BRIGHTER-Knob

DRIVER-Knob

Источник: shared/dsp/DriverDsp.cpp.

Тракт на канал: dry → high-shelf pre @ 800 Hz (+A*4 dB) → умножение на drive=(1+A*18) → waveshape: tanh(x) + 0.15*A*x/(1+|x|) → low-shelf post @ 200 Hz (+A*2 dB) → makeup dB(−A*3). Выход: dry*(1−mix) + wet*mix, где mix=A. Параллельный dry/wet сохраняет исходный сигнал при малых A.

Signal diagram
Diagram: DRIVER-Knob

PRESSURE-Knob

Источник: shared/dsp/PressureDsp.cpp.

Linked stereo peak detector с attack/release, зависящими от Amount (от мягкого к «smash»). Порог thresh = dB(−6 − A*18), ratio = 2 + A*18. При env > thresh считается GR в дБ и переводится в линейный коэффициент. Makeup = dB(A*6). Parallel blend: wetMix = 0.35 + A*0.65; out = dry*(1−wetMix) + (dry*GR*makeup)*wetMix. Lookahead нет.

Signal diagram
Diagram: PRESSURE-Knob

LOUDER-Knob

Источник: shared/dsp/LouderDsp.cpp.

Linked peak envelope (attack ≈ 0.5 ms, release ≈ 80 ms). drive = dB(A*12). Ceiling ≈ −0.3 dB: если env*drive превышает ceiling, применяется GR = ceiling/(env*drive). Затем x = tanh(x*1.2)/1.2 как soft-clip safety. Это плотность/громкость для шин, не полноценный мастер-лимитер.

Signal diagram
Diagram: LOUDER-Knob

WETTER-Knob

Источник: shared/dsp/WetterDsp.cpp.

Четыре DelayLine (пары L/R) с задержками sr*{0.029, 0.037, 0.053, 0.067}*size, где size = 0.08 + A*0.85. Feedback fb = 0.25 + A*0.55 с перекрёстной подачей L↔R. One-pole damping: damp = 0.35 + A*0.45. Dry/wet: mix = A*0.72; out = in*(1−mix) + wet*mix. В процессоре tail length учитывается (~2.5 s). Компактная FDN-подобная сеть, не полноценный hall-алгоритм.

Signal diagram
Diagram: WETTER-Knob

WIDTH-Knob

Источник: shared/dsp/WidthDsp.cpp.

Классический mid/side процессор. Amount A ∈ [0,10] линейно мапится в w = 2*(A/10) − 1 ∈ [−1,+1]: — A=0 → w=−1 (инверсия side); — A=5 → w=0 (моно, side обнуляется); — A=10 → w=+1 (unity stereo) — значение по умолчанию.

По сэмплам: mid = ½(L+R); side = ½(L−R); L′ = mid + side*w; R′ = mid − side*w. Параметр w сглаживается (~30 ms). На моно-разводке process early-return (нет стерео-пути).

Signal diagram
Diagram: WIDTH-Knob

STM FX-KNOBS

FX-KNOBS не вводит отдельный алгоритм обработки: это объединение всей линейки STM Knob в одном AU-окне.

В FxKnobsProcessor::processBlock модули вызываются в порядке: Phatter → Brighter → Driver → Pressure → Louder → Filter → Pumper → Wetter. Каждый читает параметр <id>_amt (0…10); при Amount≈0 обработка модуля пропускается (bypass по нулевой глубине). Pumper дополнительно использует pumper_rate и pumper_offset.

Порядок в UI-списке может отличаться от аудио-порядка — для автоматизации ориентир имена параметров APVTS. Подробности каждого блока см. в разделах соответствующих Knob ниже/выше и на их сигнальных схемах.

Signal diagram
Diagram: STM FX-KNOBS

Duck Reverb

Источник: DUCK REVER Logic Pro AU Plugin by STM — PluginProcessor::processBlock.

Вход санитизируется (non-finite → 0) и копируется в dryBuffer и wetBuffer.

Ключ дакинга строится с dry: monoAbs = ½(|L|+|R|) → envelope follower → bloomEngine → per-sample gain g (ограничивается разумным диапазоном). Параметры Threshold / Duck Attack / Duck Release / Duck Floor / Bloom Ceiling задают форму g. Детектор огибающей внутри быстрый (attack/release порядка единиц–десятков мс); Attack/Release ручек в основном двигают bloomEngine.

Wet-путь: FDN (RT60, damping, pre-delay, width) → low-pass Cutoff на wet → wet *= g → SpatialEngine (M/S width / ping-pong влияние). Смешивание: out = dry * Dry * (1−Mix) + wet * Wet * Mix, с сглаженными Dry/Wet/Mix.

Fail-safe: если wet содержит non-finite — DSP сбрасывается, на выход идёт только dry. Latency samples = 0 на уровне процессора (задержки внутри FDN/pre-delay).

Signal diagram
Diagram: Duck Reverb