playgrid.ccRead tutorial

Tutorial 038 / SuperCollider

Build Coral Crown in SuperCollider

Build Coral Crown in SuperCollider with layered oscillators, explicit envelopes and the sound-shaping chain explained in the guide.

5 stepsLayered OscillatorsSuperCollider

Listen to the finished sound

Download WEBM ↓

Follow the synthesis steps in order. Use the audio examples and device settings alongside the instructions.

Step 01 / 5

Build the detuned source and amplitude contour

Select ~soundStage = 1 and evaluate the full script at the end of this guide. Wait for the instrument-ready message before playing. The triangle source is an explicit odd-harmonic sine sum through partial 31, with components at or above 22 kHz muted.

Set ~soundStage = 1 in the full script. Use 3 band-limited saw voices at -9 dB each, spread by 6 cents between adjacent voices. Reverse the stereo weights across the channels. The amplitude opens in 0.0044 seconds, decays over 0.582 seconds to 0.630957, and releases over 0.186 seconds. Basic Shapes is represented by this explicit waveform; Shimmer, where present, becomes slow independent pitch drift rather than the original unison engine.

SuperCollider control Value
Sources 3 × saw, -9 dB
Adjacent pitch spacing 6 cents
Amp A/D/S/R 0.0044 s / 0.582 s / 0.630957 / 0.186 s
Instrument gain -6 dB
Velocity multiplier 0.4 + 0.6 × velocity

Sound after step 1 — WebM/Opus

Next: Blend the second source and animate the filters →

Step 02 / 5

Blend the second source and animate the filters

Set ~soundStage = 2 in the full script. Add a triangle layer at -13 dB, 0 semitones and 5 cents. Add the quieter octave-down sine sub. The notch center starts from 772 Hz and moves by -0.8 octaves under the second envelope. A positive depth opens the spectral ceiling; a negative depth moves the notch downward. The serial second filter keeps the specified high or low edge under control. Exact wavetable morphing, Warp/Fold and free-running source modulation are not implemented; the code below defines the chosen static spectra and note-local drift.

SuperCollider control Value
Secondary layer triangle, -13 dB; 0 st; 5 cents
Filter 1 Notch, 772 Hz base, -0.8 octave depth
Filter contour 0.02 / 1.1 / 0.2 / 0.3
Filter 2 Lowpass at 6.80 kHz
Pulse width Not used

Sound after step 2 — WebM/Opus

Next: Round the signal with saturation →

Step 03 / 5

Round the signal with saturation

Set ~soundStage = 3 in the full script. Use +2.4 dB drive with 70% shaped signal and -3 dB output trim. The smooth curve is tanh(input × 3 × drive.dbamp) / 3; the other portion stays clean. Louder peaks enter its curved region more strongly, adding harmonics and rounding the envelope. This interprets the source saturation curve rather than implementing its proprietary transfer function.

SuperCollider control Value
Drive / output 2.4 / -3 dB
Shaped mix 70%
Input DC removal LeakDC, coefficient 0.995

Sound after step 3 — WebM/Opus

Next: Add filtered stereo echoes →

Step 04 / 5

Add filtered stereo echoes

Set ~soundStage = 4 in the full script. Use 267 ms left and 267 ms right, 24% feedback and 18% wet. Inject the centered input on the left and cross-feed the filtered echoes so later repeats alternate sides. Filter each echo around 1800 Hz, with a 3.5-octave interval between highpass and lowpass cutoffs. Feedback values are updated once per server processing block, adding that small delay to the recirculating path. Held notes leave older colors behind the current tone.

SuperCollider control Value
Times 267 / 267 ms
Feedback / wet 24% / 18%
Routing Crossed, left input
Filter center / width 1800 Hz / 3.5 octaves
Time LFO 0 Hz, ±0%

Sound after step 4 — WebM/Opus

Next: Set the final width and gain →

Step 05 / 5

Set the final width and gain

Set ~soundStage = 5 in the full script. Use 5.27 dB gain after the effects. Scale the side signal by 1, preserving the center. Apply LeakDC DC removal with coefficient 0.995. The fixed ~soundOutputScale gain follows the complete effect chain at every stage. The effects Synth reads the stereo bus after the note group, and continues through note releases.

SuperCollider control Value
Final gain 5.27 dB
Width 1 × side
Bass side cutoff Off
DC removal LeakDC, coefficient 0.995

Sound after step 5 — WebM/Opus

Audio & settings ↓

Audio & settings

Audio recordings and settings for this tutorial.

Full SuperCollider script

The complete Coral Crown instrument uses stock SuperCollider units. Set ~soundStage from 1 to 5 and evaluate the entire block again to select a cumulative stage. Wait for the ready message; ~soundNote.(60, 0.8, 1) plays MIDI 60 at velocity 0.8 with a one-second held duration. Held duration controls when release begins, while each source's decay and modulation continue independently. ~soundStop.() frees the active instrument and its effects. This block replaces the previously installed PlayGrid instrument in the same interpreter.

(
~soundStage = 5;
~soundOutputScale = 0.8468908;
~soundRelease = 0.3;
~soundNames = (motion: \pgCoralCrownMotion, voice: \pgCoralCrownVoice, effects: \pgCoralCrownEffects);
~pgWave = { |freq, amplitude=1, phase=0, partials=#[1]|
    Mix(partials.collect { |weight, i|
        var harmonic = freq * (i + 1);
        SinOsc.ar(harmonic.clip(0.01, 22000), phase * 2pi * (i + 1)) * weight * (harmonic < 22000)
    }) * amplitude;
};
~pgTriangle = { |freq, phase=0|
    var partials = Array.fill(31, { |i|
        var n = i + 1;
        if(n.odd) { ((-1) ** ((n - 1) / 2)) * 8 / (pi.squared * n.squared) } { 0 }
    });
    ~pgWave.(freq, 1, phase, partials);
};
~soundDefs = [
    SynthDef(\pgCoralCrownMotion, { |out=0| Out.kr(out, DC.kr(0)) }),
    SynthDef(\pgCoralCrownVoice, { |out=0, midi=60, velocity=0.8, gate=1, startMidi=60|
        var stage = ~soundStage;
    var aL = 0, aR = 0, aSub = 0, aV0 = 0, aV1 = 0, aV2 = 0, aW0 = 0, aW1 = 0;
    var aW2 = 0, iHz = 0, iVelocity = 0, kAmp = 0, kCut = 0, kFilter = 0, kGain = 0, kJ0 = 0;
    var kJ1 = 0, kJ2 = 0;
    iHz = (midi).midicps;
    iVelocity = (velocity).clip(0, 1);
    kJ0 = (SinOsc.kr(0.1, 0.0 * 2pi) * 0);
    aV0 = (Saw.ar((iHz * (2 ** (((0 - 6.0) + kJ0) / 1200)))) * ((0 - 9.0)).dbamp);
    if((stage >= 2)) {
    aW0 = (~pgTriangle.((iHz * (2 ** ((0 / 12) + ((0 - 1.0) / 1200)))), 0.0) * ((0 - 13.0)).dbamp);
    aV0 = (aV0 + aW0);
    };
    kJ1 = (SinOsc.kr(0.13, 0.3333333333333333 * 2pi) * 0);
    aV1 = (Saw.ar((iHz * (2 ** ((0.0 + kJ1) / 1200)))) * ((0 - 9.0)).dbamp);
    if((stage >= 2)) {
    aW1 = (~pgTriangle.((iHz * (2 ** ((0 / 12) + (5.0 / 1200)))), 0.3333333333333333) * ((0 - 13.0)).dbamp);
    aV1 = (aV1 + aW1);
    };
    kJ2 = (SinOsc.kr(0.16, 0.6666666666666666 * 2pi) * 0);
    aV2 = (Saw.ar((iHz * (2 ** ((6.0 + kJ2) / 1200)))) * ((0 - 9.0)).dbamp);
    if((stage >= 2)) {
    aW2 = (~pgTriangle.((iHz * (2 ** ((0 / 12) + (11.0 / 1200)))), 0.6666666666666666) * ((0 - 13.0)).dbamp);
    aV2 = (aV2 + aW2);
    };
    aL = ((((aV0 * 0.8) + (aV1 * 0.5)) + (aV2 * 0.20000000000000007)) / 1.5);
    aR = ((((aV0 * 0.2) + (aV1 * 0.5)) + (aV2 * 0.8)) / 1.5);
    if((stage >= 2)) {
    aSub = (SinOsc.ar((iHz * 0.5), 0 * 2pi) * ((0 - 18.0)).dbamp);
    aL = (aL + aSub);
    aR = (aR + aSub);
    };
    if((stage >= 2)) {
    kFilter = EnvGen.kr(Env([0, 1, 0.2, 0], [0.02, 1.1, 0.3], \lin, releaseNode: 2), gate);
    kCut = ((772.0 * (2 ** (((0 - 0.8) * kFilter) + ((0.0 * (midi - 60)) / 12))))).clip(30, 18000);
    aL = BRF.ar(aL, (kCut).clip(20, 18000), ((kCut / 1.2) / kCut).clip(0.001, 4));
    aL = LPF.ar(aL, (6800.0).clip(20, 18000));
    aR = BRF.ar(aR, (kCut).clip(20, 18000), ((kCut / 1.2) / kCut).clip(0.001, 4));
    aR = LPF.ar(aR, (6800.0).clip(20, 18000));
    };
    kAmp = EnvGen.kr(Env([0, 1, 0.6309573444801932, 0], [0.0044, 0.582, 0.186], \lin, releaseNode: 2), gate);
    kGain = ((kAmp * ((0 - 6.0)).dbamp) * (0.4 + (0.6 * iVelocity)));
    aL = (aL * kGain);
    aR = (aR * kGain);
    Out.ar(out, [aL, aR]);
        EnvGen.kr(Env.asr(0.0001, 1, 0.3), gate, doneAction: 2);
    }),
    SynthDef(\pgCoralCrownEffects, { |in=0, out=0|
        var stage = ~soundStage;
        var outputScale = ~soundOutputScale;
        var input = In.ar(in, 2);
    var feedback = LocalIn.ar(2);
    var aCleanL = 0, aCleanR = 0, aDelFbL = 0, aDelFbR = 0, aDelSendL = 0, aDelSendR = 0, aDelTimeL = 0, aDelTimeR = 0;
    var aEchoL = 0, aEchoR = 0, aEndMid = 0, aEndSide = 0, aL = 0, aR = 0, aShapeL = 0, aShapeR = 0;
    var kDelCenter = 0, kDelMotion = 0;
    aL = input[0];
    aR = input[1];
    if((stage >= 3)) {
    aCleanL = LeakDC.ar(aL, 0.995);
    aShapeL = ((((aCleanL * 3) * (2.4).dbamp)).tanh / 3);
    aL = (((aCleanL * 0.30000000000000004) + (aShapeL * 0.7)) * ((0 - 3.0)).dbamp);
    aCleanR = LeakDC.ar(aR, 0.995);
    aShapeR = ((((aCleanR * 3) * (2.4).dbamp)).tanh / 3);
    aR = (((aCleanR * 0.30000000000000004) + (aShapeR * 0.7)) * ((0 - 3.0)).dbamp);
    };
    if((stage >= 4)) {
    aDelFbL = feedback[0];
    aDelFbR = feedback[1];
    kDelMotion = 0;
    aDelTimeL = K2A.ar((267.0 * (1 + (0.0 * kDelMotion))));
    aDelTimeR = K2A.ar((267.0 * (1 - (0.0 * kDelMotion))));
    aDelSendL = ((aL + aR) * 0.5);
    aDelSendR = 0;
    aEchoL = DelayC.ar((aDelSendL + (aDelFbR * 0.24)), 2200 / 1000, (aDelTimeL / 1000).clip(0.00002, 2200 / 1000));
    aEchoR = DelayC.ar((aDelSendR + (aDelFbL * 0.24)), 2200 / 1000, (aDelTimeR / 1000).clip(0.00002, 2200 / 1000));
    kDelCenter = (1800.0 * (2 ** (0.0 * kDelMotion)));
    aEchoL = HPF.ar(aEchoL, ((kDelCenter / (2 ** 1.75))).clip(20, 18000));
    aEchoL = LPF.ar(aEchoL, ((18000).min((kDelCenter * (2 ** 1.75)))).clip(20, 18000));
    aEchoR = HPF.ar(aEchoR, ((kDelCenter / (2 ** 1.75))).clip(20, 18000));
    aEchoR = LPF.ar(aEchoR, ((18000).min((kDelCenter * (2 ** 1.75)))).clip(20, 18000));
    aDelFbL = aEchoL;
    aDelFbR = aEchoR;
    aL = ((aL * 0.8200000000000001) + (aEchoL * 0.18));
    aR = ((aR * 0.8200000000000001) + (aEchoR * 0.18));
    };
    if((stage >= 5)) {
    aEndMid = ((aL + aR) * 0.5);
    aEndSide = (((aL - aR) * 0.5) * 1.0);
    aL = ((aEndMid + aEndSide) * (5.27).dbamp);
    aL = LeakDC.ar(aL, 0.995);
    aR = ((aEndMid - aEndSide) * (5.27).dbamp);
    aR = LeakDC.ar(aR, 0.995);
    };
    LocalOut.ar([aDelFbL, aDelFbR].collect { |channel| channel + DC.ar(0) });
    Out.ar(out, [((aL * 1) * outputScale), ((aR * 1) * outputScale)]);
    })
];
~soundStop = {
    if(~cirrusGroup.notNil) { ~cirrusGroup.free; ~cirrusGroup = nil };
    if(~cirrusAudio.notNil) { ~cirrusAudio.free; ~cirrusAudio = nil };
    if(~cirrusMotion.notNil) { ~cirrusMotion.free; ~cirrusMotion = nil };
    if(~pgGroup.notNil) { ~pgGroup.free; ~pgGroup = nil };
    if(~pgAudio.notNil) { ~pgAudio.free; ~pgAudio = nil };
    if(~pgMotion.notNil) { ~pgMotion.free; ~pgMotion = nil };
};
~soundInstall = {
    s.waitForBoot {
        ~soundStop.();
        ~soundDefs.do { |definition| definition.add };
        s.sync;
        ~pgAudio = Bus.audio(s, 2);
        ~pgMotion = Bus.control(s, 1);
        ~pgGroup = Group.head(s);
        ~pgLastMidi = 60;
        Synth.head(~pgGroup, ~soundNames.motion, [\out, ~pgMotion]);
        ~pgVoices = Group.tail(~pgGroup);
        Synth.tail(~pgGroup, ~soundNames.effects, [\in, ~pgAudio]);
        "Coral Crown ready".postln;
    };
};
~soundNote = { |midi=60, velocity=0.8, hold=1|
    var note = Synth.head(~pgVoices, ~soundNames.voice, [
        \out, ~pgAudio, \midi, midi, \velocity, velocity.clip(0, 1),
        \startMidi, ~pgLastMidi
    ]);
    ~pgLastMidi = midi;
    SystemClock.sched(hold, { note.set(\gate, 0); nil });
    note;
};
if(~soundOffline != true) { ~soundInstall.() };
)