playgrid.ccRead tutorial

Tutorial 116 / SuperCollider

Build Quartz Trail in SuperCollider

Build Quartz Trail in SuperCollider with modal electric keys, explicit envelopes and the sound-shaping chain explained in the guide.

5 stepsModal Electric KeysSuperCollider

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

Strike the tone-bar modes

Select ~soundStage = 1 and evaluate the full script at the end of this guide. Wait for the instrument-ready message before playing.

Set ~soundStage = 1 in the full script. A hammer pulse rises in 0.3 ms and then falls over 0.0018 seconds. Add 10% contact noise and lowpass the excitation at 4240 Hz, with velocity darkening gentler strikes. Modes at ratios 1 and 2.01 decay over 2.8 and 1.8 seconds. The contact duration and bandwidth give the two electric-key sounds different attacks. These resonances interpret Electric's tone bar and hammer rather than simulate its complete mechanics.

SuperCollider control Value
Mode ratios / weights 1 / 2.01; weights 0.75 / 0.18
Modal T60 2.8 / 1.8 s
Strike bandwidth 4240 × (0.5 + 0.5 × velocity) Hz
Modal scale 0.02
Instrument / touch −12 dB / velocity^1.6

Sound after step 1 — WebM/Opus

Next: Blend the brighter tine and pickup response →

Step 02 / 5

Blend the brighter tine and pickup response

Set ~soundStage = 2 in the full script. Add modes near ratios 6.98 and 10.03 with 1.36 s and 0.7 s decays. Weight them 0.45 and 0.15, then multiply by the tine blend 0.33. They put a brief bell-like edge above the tone bar. A velocity-dependent tanh curve interprets pickup nonlinearity before the shared effects. Pickup distance, symmetry, damping and release macros are not directly modeled; the script specifies its own contact, resonance and tail behavior.

SuperCollider control Value
Tine ratios / decays 6.98 / 10.03; 1.36 / 0.70 s
Tine blend 0.33
Pickup curve tanh(tone × (1 + 2 × velocity)) / (1 + 2 × velocity)
Tail lifetime 6 s beyond held duration

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 +1.8 dB drive with 45% shaped signal and -2 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 1.8 / -2 dB
Shaped mix 45%
Input DC removal LeakDC, coefficient 0.995

Sound after step 3 — WebM/Opus

Next: Surround the tone with a damped room →

Step 04 / 5

Surround the tone with a damped room

Set ~soundStage = 4 and evaluate the full block. Feed the preceding signal into FreeVerb2, using its fully wet output and the dry/wet routing shown in the script. The room continues after individual note envelopes release. Predelay separates the initial articulation from the diffuse tail; the external wet mix controls how far that tail moves forward.

The SuperCollider room value is 0.444426 and damping is 0.71875. These dimensionless settings are choices for this algorithm, rather than equivalent values for Ableton decay or Csound feedback and damping. More damping darkens the circulating highs. Any input filters and mid/side width changes in this stage retain their own explicit settings in the full script.

SuperCollider room control Value
FreeVerb2 internal mix 1, wet output only
Room 0.444426
Damping 0.71875
Predelay 12 ms
External room wet 14%
SuperCollider control Value
Room side multiplier 1
Room input cuts Off

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 11.7 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 11.7 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 Quartz Trail 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.7144075;
~soundRelease = 6;
~soundNames = (motion: \pgQuartzTrailMotion, voice: \pgQuartzTrailVoice, effects: \pgQuartzTrailEffects);

~soundDefs = [
    SynthDef(\pgQuartzTrailMotion, { |out=0| Out.kr(out, DC.kr(0)) }),
    SynthDef(\pgQuartzTrailVoice, { |out=0, midi=60, velocity=0.8, gate=1, startMidi=60|
        var stage = ~soundStage;
    var aExc = 0, aHit = 0, aL = 0, aNoise = 0, aR = 0, aTine1 = 0, aTine2 = 0, aTone = 0;
    var aTone1 = 0, aTone2 = 0, iHz = 0, iVelocity = 0;
    iHz = (midi).midicps;
    iVelocity = (velocity).clip(0, 1);
    aHit = EnvGen.ar(Env([0, 1, 0, 0], [0.0003, 0.0018, 1], \lin));
    aNoise = WhiteNoise.ar(1);
    aExc = OnePole.ar((aHit * (1 + (0.1 * aNoise))), (-2pi * ((4240.0 * (0.5 + (0.5 * iVelocity)))).clip(20, 18000) / SampleRate.ir).exp);
    aTone1 = Ringz.ar(aExc, (iHz).clip(20, 11000), (((((3.14159265 * iHz) * 2.8) / (1000).log) * 1000.log) / (pi * iHz)).clip(0.0001, 60));
    aTone2 = Ringz.ar(aExc, ((11000).min((iHz * 2.01))).clip(20, 11000), (((((3.14159265 * (11000).min((iHz * 2.01))) * 1.8) / (1000).log) * 1000.log) / (pi * (11000).min((iHz * 2.01)))).clip(0.0001, 60));
    aTone = (((aTone1 * 0.75) + (aTone2 * 0.18)) * 0.02);
    if((stage >= 2)) {
    aTine1 = Ringz.ar(aExc, ((11000).min((iHz * 6.98))).clip(20, 11000), (((((3.14159265 * (11000).min((iHz * 6.98))) * 1.36) / (1000).log) * 1000.log) / (pi * (11000).min((iHz * 6.98)))).clip(0.0001, 60));
    aTine2 = Ringz.ar(aExc, ((11000).min((iHz * 10.03))).clip(20, 11000), (((((3.14159265 * (11000).min((iHz * 10.03))) * 0.7) / (1000).log) * 1000.log) / (pi * (11000).min((iHz * 10.03)))).clip(0.0001, 60));
    aTone = (aTone + ((((aTine1 * 0.45) + (aTine2 * 0.15)) * 0.02) * 0.33));
    };
    aTone = (((aTone * (1 + (2 * iVelocity)))).tanh / (1 + (2 * iVelocity)));
    aL = ((aTone * ((0 - 12)).dbamp) * (iVelocity ** 1.6));
    aR = aL;
    Out.ar(out, [aL, aR]);
        EnvGen.kr(Env.asr(0.0001, 1, 6), gate, doneAction: 2);
    }),
    SynthDef(\pgQuartzTrailEffects, { |in=0, out=0|
        var stage = ~soundStage;
        var outputScale = ~soundOutputScale;
        var input = In.ar(in, 2);
    var aCleanL = 0, aCleanR = 0, aEndMid = 0, aEndSide = 0, aL = 0, aR = 0, aRoomInL = 0, aRoomInR = 0;
    var aRoomL = 0, aRoomMid = 0, aRoomPreL = 0, aRoomPreR = 0, aRoomR = 0, aRoomSide = 0, aShapeL = 0, aShapeR = 0;
    var room15 = 0;
    aL = input[0];
    aR = input[1];
    if((stage >= 3)) {
    aCleanL = LeakDC.ar(aL, 0.995);
    aShapeL = ((((aCleanL * 3) * (1.8).dbamp)).tanh / 3);
    aL = (((aCleanL * 0.55) + (aShapeL * 0.45)) * ((0 - 2.0)).dbamp);
    aCleanR = LeakDC.ar(aR, 0.995);
    aShapeR = ((((aCleanR * 3) * (1.8).dbamp)).tanh / 3);
    aR = (((aCleanR * 0.55) + (aShapeR * 0.45)) * ((0 - 2.0)).dbamp);
    };
    if((stage >= 4)) {
    aRoomInL = aL;
    aRoomPreL = DelayN.ar(aRoomInL, 0.012, 0.012);
    aRoomInR = aR;
    aRoomPreR = DelayN.ar(aRoomInR, 0.012, 0.012);
    room15 = FreeVerb2.ar(aRoomPreL, aRoomPreR, 1, 0.444426, 0.71875);
    aRoomL = room15[0];
    aRoomR = room15[1];
    aRoomMid = ((aRoomL + aRoomR) * 0.5);
    aRoomSide = (((aRoomL - aRoomR) * 0.5) * 1);
    aL = ((aL * 0.86) + ((aRoomMid + aRoomSide) * 0.14));
    aR = ((aR * 0.86) + ((aRoomMid - aRoomSide) * 0.14));
    };
    if((stage >= 5)) {
    aEndMid = ((aL + aR) * 0.5);
    aEndSide = (((aL - aR) * 0.5) * 1.0);
    aL = ((aEndMid + aEndSide) * (11.7).dbamp);
    aL = LeakDC.ar(aL, 0.995);
    aR = ((aEndMid - aEndSide) * (11.7).dbamp);
    aR = LeakDC.ar(aR, 0.995);
    };
    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]);
        "Quartz Trail 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.() };
)