Keelson

Every channel, under your hand.

Channel utility: flip polarity per channel, swap channels, fold to mono (sum, left or right), balance or pan with a choice of pan law, delay each channel by samples plus milliseconds for time alignment, remove DC, and trim the level.

● Freeorg.sournd.utility.keelson

Hear it

The real engine runs in your browser. Try the test sounds, your own file or a microphone, move the parameters or press Randomise, and switch bypass to compare.

Details

Engine id: org.sournd.utility.keelson
Category: Utility
Type: Phase, pan
Licence: Free (Apache-2.0)
Version: 1.0.0
Parameters: 12
Latency: none
Tail: 0.25 s
Sidechain input: no
Channels: mono or stereo

Parameters

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

Id	Key	Name	Min	Max	Unit	Taper
0	`invert_left`	Invert left	0	1	-	linear
1	`invert_right`	Invert right	0	1	-	linear
2	`swap`	Swap channels	0	1	-	linear
3	`mono_mode`	Mono (off, sum, left, right)	0	3	-	linear
4	`balance_pct`	Balance / pan	-100	100	%	linear
5	`pan_law`	Pan law (0, 3, 4.5, 6 dB)	0	3	-	linear
6	`delay_left_samples`	Left delay	0	4800	samples	linear
7	`delay_right_samples`	Right delay	0	4800	samples	linear
8	`delay_left_ms`	Left delay (ms)	0	100	ms	linear
9	`delay_right_ms`	Right delay (ms)	0	100	ms	linear
10	`dc_filter`	DC filter	0	1	-	linear
11	`gain_db`	Gain	-24	24	dB	linear

How it is made

Original sOURnd utility blending general techniques: polarity inversion, channel matrixing, linear-balance and sine-power pan laws, sample-exact delay lines with a short crossfade on change, and a one-pole DC blocker.

CMake

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)

Three lines. Full steps: JUCE quick start.

C++ (JUCE)

cpp

#include <sournd_engine/sournd_engine.h>

sournd::SourndEngine engine { "org.sournd.utility.keelson" };
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

sournd_engine *e = NULL;
if (sournd_engine_create("org.sournd.utility.keelson", &e) == SOURND_OK) {
    sournd_engine_prepare(e, 48000.0, 512);
    sournd_engine_set_param(e, 0, 0); /* Invert left */
    sournd_engine_process(e, in, out, 2, frames);
    sournd_engine_destroy(e);
}

Ask your AI

Paste this into your coding assistant:

Prompt

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