# Hammered Room Keys — complete Csound settings

## Note and effect connections

Instrument 1 uses p3 for held seconds, p4 for MIDI pitch and p5 for velocity from 0 to 1. Its left and right outputs accumulate on shared buses. Instrument 90 processes the buses once per control block, clears the inputs and keeps effect memories active through the tails. Envelopes with release segments extend the note automatically. The score is an audible pitch-and-touch example; the synthesis controls are independent of its particular notes.

## Csound interpretation

These are explicit Csound models, not identical implementations of the Ableton devices. Wavetable positions, proprietary oscillator engines, physical-model macros, filter circuits, envelope slopes and effect algorithms can differ. Modulation depths are specified in octaves, cents or milliseconds rather than treated as universally interchangeable matrix values. Controller inputs such as pitch bend, modulation wheel, pressure and per-note expression are not mapped. Independent score notes do not implement Live's monophonic note-priority or legato system. Any pitch memory or drift included in this instrument is described in its steps.



## Signal path and controls

### Stage 1 — Build the struck three-register body

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.

| Csound 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

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.

| Csound 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 |

### Stage 3 — Round the signal with saturation

Use +22 dB drive with 50% shaped signal and -21 dB output trim. The smooth curve is `tanh(input × 3 × ampdb(drive)) / 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.

| Csound 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

Feed the preceding signal through 8 ms predelay into `reverbsc`, with feedback 0.9209, 3000 Hz damping and 22% wet mix. Predelay leaves the initial articulation in front; feedback prolongs the tail, while damping darkens repeated circulation. The source room decay setting is 8.5 seconds, but Csound feedback is not a decay-time control: this is an interpretation of that space, with different diffusion and modulation. 

| Csound control | Value |
| --- | --- |
| Source decay target | 8.5 s (not a measured Csound decay) |
| Predelay / feedback | 8 ms / 0.9209 |
| Damping / wet | 3000 Hz / 22% |
| Room side multiplier | 0.8 |
| Room input cuts | Off |

## Output and signal rates

The script uses 48000 Hz, 16-sample control blocks and stereo output. The fixed output-scale control is `1.390174` and follows the whole chain at every stage, separate from any final gain step. DC-removal blocks, where enabled, use order 2048 to limit low-note attenuation; they add processing delay.

[Build guide and full script](BUILD_GUIDE.md#full-csound-script) · [Starting settings](STARTING_STATE.md)

[Read on playgrid.cc](https://playgrid.cc/tutorials/hammered-room-keys/csound/settings/)
