playgrid.ccRead tutorial

Hammered Room Keys — complete SuperCollider settings

Signal flow and implementation

~soundStage is compiled into the SynthDefs. Re-evaluate the complete block after changing it; source and effects are then replaced together. The fixed output multiplier ~soundOutputScale is 1.428573 and applies after the whole chain at every stage. It is separate from any final gain step.

EnvGen supplies the explicit linear or exponential contours. Exponential floors stay positive. Closing the gate begins each release; a separate silent lifetime envelope frees the note after the longest source release. Shared effects continue independently.

MoogFF replaces the ladder filter. Its gain argument is four times the source 0–1 resonance amount, limited to 3.95; it is a different circuit. Cutoffs are limited to 20–18000 Hz.

FreeVerb2 replaces the diffuse room with its own room and damping controls, both dimensionless. The per-stage values below are specific to this algorithm and do not specify a measured decay time or damping frequency.

Saw and Pulse use SuperCollider oscillator implementations and startup phases; they replace the source engines and do not scan proprietary wavetables.

~pgTriangle builds an odd-partial sine sum through harmonic 31. It replaces the source triangle oscillator; components at or above 22 kHz are muted.

Synthesis and effect controls

Stage 1 — Build the struck three-register body

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 a pulse one octave above the note at −7 cents/−6 dB, a triangle two octaves above at −15 dB, and a quiet pulse at the played pitch at −27 dB. These fixed shapes interpret Basic Shapes positions and the colored sub rather than scan the original tables. The amplitude rises in 1 ms, decays over 1.4 s to −42 dB and releases over 250 ms.

SuperCollider control Value
Main source Pulse, octave up, −7 cents, −6 dB
Upper / low layer Triangle +24 st at −15 dB / pulse at −27 dB
Amplitude 1 ms / 1.4 s / −42 dB / 250 ms
Instrument / touch −3 dB / 50%

Stage 2 — Close the strike filter quickly

Set ~soundStage = 2 in the full script. Apply a 1100 Hz ladder lowpass with +3 dB input drive and 0.062 resonance. Track pitch fully and open cutoff by 0.5 octaves under a 1 ms / 250 ms / zero / 100 ms contour. The fast spectral fall is independent of the longer amplitude decay.

SuperCollider control Value
Cutoff / resonance 1100 Hz base / 0.062
Envelope / key tracking 0.5 octaves / full
Filter contour 1 ms / 250 ms / zero / 100 ms

For MoogFF, multiply the stated source resonance amount by four to obtain its 0–4 gain argument (limited to 3.95). The complete script gives this gain expression beside each cutoff.

Stage 3 — Round the signal with saturation

Set ~soundStage = 3 in the full script. Use +22 dB drive with 50% shaped signal and -21 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. A final tanh stage also interprets Soft Clip on the output.

SuperCollider control Value
Drive / output 22 / -21 dB
Shaped mix 50%
Input DC removal Off
Post clip tanh

Stage 4 — 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.935902 and damping is 0.8125. 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.935902
Damping 0.8125
Predelay 8 ms
External room wet 22%
SuperCollider control Value
Room side multiplier 0.8
Room input cuts Off

Connected instrument

The full SuperCollider script contains the complete voice, shared effects, bus ordering and note helper. No external sample or third-party unit is required.