playgrid.ccRead tutorial

Porcelain Steps — 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 3.644688 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.

Ringz supplies damped modal resonances. A source Q is translated to a 60 dB decay time as Q × ln(1000) / (π × frequency). String modes retain stiffness, decay weighting, strike position and pickup weighting. Modal gains and excitation response differ from Tension, Electric, Collision and Csound mode filters; the fixed instrument gain belongs to this SuperCollider version.

LeakDC uses coefficient 0.995. It replaces the longer-window Csound DC blocker, with a different low-frequency response and latency.

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.

Synthesis and effect controls

Stage 1 — Excite the marimba-like mode bank

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. Use a 2 ms mallet pulse with 15% contact noise, lowpassed at 5000 Hz. Feed ratios 1, 4, 10 and 19.9 with progressively shorter decays. The non-harmonic spacing and fast upper-mode decay give a hollow, wooden strike. This four-mode bank interprets Collision's Marimba model; it does not implement the original material or listening-position solver.

SuperCollider control Value
Ratios / weights 1/4/10/19.9; weights 1/0.35/0.12/0.04
T60 per mode 1.5/0.8/0.4/0.2 s
Mallet / resonator / instrument −12 / −6 / −9 dB
Modal scale 0.04
Touch 0.4 + 0.6 × velocity

Stage 2 — Add the quieter upper beam

Set ~soundStage = 2 in the full script. Mix a second set of modes at ratios 2, 5.52 and 10.8, with 450 ms decay and −24 dB gain. The beam adds a short higher edge without replacing the main struck body. The two banks receive the same excitation in parallel, matching the source's 1 + 2 signal-flow idea. Their explicit modal ratios interpret the beam's tuning and inharmonicity.

SuperCollider control Value
Beam ratios / weights 2/5.52/10.8; 1/0.35/0.12
Beam T60 / gain 450 ms / −24 dB
Maximum modal frequency 11000 Hz
Natural tail lifetime 4 s beyond held duration

Stage 3 — Surround the tone with a damped room

Set ~soundStage = 3 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.48459 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.48459
Damping 0.71875
Predelay 12 ms
External room wet 18%
SuperCollider control Value
Room side multiplier 1
Room input cuts Off

Stage 4 — Set the final width and gain

Set ~soundStage = 4 in the full script. Use -4.51 dB gain after the effects. Scale the side signal by 1, preserving the center. Highpass only the side at 160 Hz to focus the lowest frequencies. 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 -4.51 dB
Width 1 × side
Bass side cutoff 160 Hz
DC removal LeakDC, coefficient 0.995

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.