# Build Coral Crown in SuperCollider

A stock-unit SuperCollider interpretation of [the Ableton sound](/tutorials/coral-crown/) and its [Csound version](/tutorials/coral-crown/csound/). Each stage changes the source or its effect chain; oscillator, filter, modal and room algorithms differ across platforms.

[Starting settings](STARTING_STATE.md) · [Complete settings](ALL_PARAMETERS.md). The full runnable script ends this guide.

## Step 1 — 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 |

<audio controls preload="none" aria-label="SuperCollider Coral Crown after step 1"><source src="audio/steps/step-01.webm" type="audio/webm"></audio>

[Sound after step 1 — WebM/Opus](audio/steps/step-01.webm)

## Step 2 — 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 |

<audio controls preload="none" aria-label="SuperCollider Coral Crown after step 2"><source src="audio/steps/step-02.webm" type="audio/webm"></audio>

[Sound after step 2 — WebM/Opus](audio/steps/step-02.webm)

## Step 3 — 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 |

<audio controls preload="none" aria-label="SuperCollider Coral Crown after step 3"><source src="audio/steps/step-03.webm" type="audio/webm"></audio>

[Sound after step 3 — WebM/Opus](audio/steps/step-03.webm)

## Step 4 — 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% |

<audio controls preload="none" aria-label="SuperCollider Coral Crown after step 4"><source src="audio/steps/step-04.webm" type="audio/webm"></audio>

[Sound after step 4 — WebM/Opus](audio/steps/step-04.webm)

## Step 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 |

<audio controls preload="none" aria-label="SuperCollider Coral Crown after step 5"><source src="audio/steps/step-05.webm" type="audio/webm"></audio>

[Sound after step 5 — WebM/Opus](audio/steps/step-05.webm)

## Downloads and settings

[Finished sound — WebM/Opus](audio/coral-crown.webm) · [Complete settings](ALL_PARAMETERS.md) · [Ableton version](/tutorials/coral-crown/) · [Csound version](/tutorials/coral-crown/csound/)

## 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.

```supercollider
(
~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.() };
)
```

[Read on playgrid.cc](https://playgrid.cc/tutorials/coral-crown/supercollider/)
