# Downstep

> Drop tuning without retuning: chords and single notes move down (or up) as one, fully wet by default, body resonances left where they were and the low end filled back in so it sounds like a lower-tuned instrument rather than a pitch shifter.

- Engine id: `org.sournd.pitch.downstep`
- Category: Pitch
- Licence: paid: £2.99 an effect or £4.99 a synth, once (owned for good, with updates), or included in the Everything plan (£14.99 a month)
- Version: 1.0.0
- Latency: 624 samples
- Tail: 0.1 s
- Sidechain input: no
- Channels: mono or stereo
- Audio demo: https://sournd.com/static/preview/demos/downstep.mp3 (plucked chords, default settings)
- Demo video: https://www.youtube.com/watch?v=jwNkrRcLz1w (two minutes, no talking)

## Parameters

The id is the C ABI parameter id and the JUCE parameter id (as a decimal string).

| Id | Key | Name | Min | Max | Default | Unit | Taper |
|---|---|---|---|---|---|---|---|
| 0 | `semitones` | Tuning | -12 | 12 | -2 | st | linear |
| 1 | `cents` | Fine | -50 | 50 | 0 | cents | linear |
| 2 | `body` | Body | 0 | 100 | 100 | % | linear |
| 3 | `tone_match` | Tone match | 0 | 100 | 50 | % | linear |
| 4 | `mix` | Mix | 0 | 100 | 100 | % | linear |
| 5 | `output_db` | Output | -24 | 12 | 0 | dB | linear |

## Use it in JUCE

CMake ([quick start](/docs/juce/index.md)):

```cmake
juce_add_module(path/to/sournd_engine)
target_include_directories(MyPlugin PRIVATE path/to/include)
target_link_libraries(MyPlugin PRIVATE sournd_engine path/to/libsournd_cabi.a)
```

C++:

```cpp
#include <sournd_engine/sournd_engine.h>

sournd::SourndEngine engine { "org.sournd.pitch.downstep" };
juce::AudioProcessorValueTreeState parameters { *this, nullptr, "Parameters",
    sournd::SourndEngineParameters::createLayout (engine) };
sournd::SourndEngineParameters bridge { engine, parameters };

// prepareToPlay
engine.prepare ({ sampleRate, (juce::uint32) maximumBlock, 2 });
bridge.prepare (sampleRate);
setLatencySamples ((int) engine.latency());

// processBlock
bridge.apply ((uint32_t) buffer.getNumSamples());
juce::dsp::AudioBlock<float> block { buffer };
engine.process (juce::dsp::ProcessContextReplacing<float> { block });

// get/setStateInformation: hold getCallbackLock() around saveState / loadState,
// so state work never overlaps processBlock (full example: /docs/juce/)
```

Plain C:

```c
sournd_engine *e = NULL;
if (sournd_engine_create("org.sournd.pitch.downstep", &e) == SOURND_OK) {
    sournd_engine_prepare(e, 48000.0, 512);
    sournd_engine_set_param(e, 0, -2); /* Tuning */
    sournd_engine_process(e, in, out, 2, frames);
    sournd_engine_destroy(e);
}
```

## How it is made

Original sOURnd design blending general techniques: a sinusoidal phase vocoder on the analytic signal (low-delay asymmetric window, whole-lobe resynthesis of every partial, transient phase reset), cepstral envelope keeping for the body resonances, and a low shelf scaled by the interval. Latency class and ranges informed by our own measurements of drop-tune and pitch pedals.

## Ask your AI

Paste this into your coding assistant:

```text
Add the sournd engine org.sournd.pitch.downstep to my JUCE plugin. Follow https://sournd.com/docs/juce/index.md
and the engine reference at https://sournd.com/engines/downstep/index.md. Expose every parameter through APVTS.
```
