# Hazel Loom — 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 0.9262683 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.

`RLPF` uses reciprocal Q, set to 1 divided by the source Q. It replaces the two-pole resonant lowpass rather than reproduce its nonlinearities.

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

`LocalIn`/`LocalOut` carry all feedback paths in a single multichannel loop. Recirculation adds one server processing block to each delay; changing block size therefore changes short comb/flanger tuning. `DelayC` uses seconds, converted from the millisecond tap values in the design.

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

`~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 drifting triangle cluster

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 five triangle voices spread across ±42 cents, with independent sine drift of ±3.38 cents. Their different phases and slow rates make the held spectrum beat. Use engine gain −10 dB, amplitude attack 1.03 s, decay 2.43 s to −4 dB and release 2.26 s. A −8 dB instrument gain and 50% velocity response follow mild smooth drive. Spacing and motion are explicit SuperCollider choices for the source macros.

| SuperCollider control | Value |
| --- | --- |
| Triangle offsets | −42, −21, 0, +21, +42 cents |
| Drift | ±3.38 cents; 0.12 + abs(offset) × 0.005 Hz |
| A contour | 1.03 / 2.43 / −4 dB / 2.26 s |
| Engine / instrument gain | −10 / −8 dB |

### Stage 2 — Add the slower octave and stereo filtering

Set `~soundStage = 2` in the full script. Enable the octave-up sine at −22 dB and +3.125 cents. Give it an independent 1.10 s attack, 4 s decay to −6 dB and 2.20 s release. Filter the triangle channels at 1550 Hz with Q 1.2; reverse the voice weights across the channels, bias A slightly left and B right. The octave enters later than the main cluster and can remain after its release. This interprets Basic Shapes and SVF rather than scanning the original engines.

| SuperCollider control | Value |
| --- | --- |
| A lowpass | 1550 Hz, Q 1.2 |
| B pitch / level | 2 × note frequency, +3.125 cents / −22 dB |
| B contour | 1.10 / 4.00 / −6 dB / 2.20 s |
| Stereo voice weights | 0.8/0.7/0.5/0.3/0.2, reversed right; sum / 2.5 |

### Stage 3 — Add filtered stereo echoes

Set `~soundStage = 3` in the full script. Use 340 ms left and 470 ms right, 30% feedback and 22% wet. Inject the centered input on the left and cross-feed the filtered echoes so later repeats alternate sides. Filter each echo around 1700 Hz, with a 3-octave interval between highpass and lowpass cutoffs. A shared 0.18 Hz sine moves times by ±2% and the filter center by ±0.04 octaves. 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 | 340 / 470 ms |
| Feedback / wet | 30% / 22% |
| Routing | Crossed, left input |
| Filter center / width | 1700 Hz / 3 octaves |
| Time LFO | 0.18 Hz, ±2% |

### 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.775902 and damping is 0.8. 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.775902 |
| Damping | 0.8 |
| Predelay | 30 ms |
| External room wet | 20% |

| SuperCollider control | Value |
| --- | --- |
| Room side multiplier | 1 |
| Room input cuts | Off |

### Stage 5 — Set the final width and gain

Set `~soundStage = 5` in the full script. Use 9.12 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 | 9.12 dB |
| Width | 1 × side |
| Bass side cutoff | 160 Hz |
| DC removal | LeakDC, coefficient 0.995 |

## Connected instrument

The [full SuperCollider script](/tutorials/hazel-loom/supercollider/#full-supercollider-script) contains the complete voice, shared effects, bus ordering and note helper. No external sample or third-party unit is required.

[Read on playgrid.cc](https://playgrid.cc/tutorials/hazel-loom/supercollider/settings/)
