ADSR
Generate attack-decay-sustain-release envelope curves.
What it does
ADSR watches a trigger signal for a threshold crossing and turns each crossing into a shaped envelope: a ramp to a peak (Attack), a fall to a held level (Decay and Sustain), then a fade to zero once the trigger drops (Release). The classic synthesiser envelope, driving any animatable parameter.
A Number or Boolean input gives one envelope. A Number Array gives one independent envelope per element, such as a particle system's per-point triggers. Each stage's shape bends from linear toward ease-in or ease-out, and an audio-rate buffer is available instead of one value per frame.
When to use it
A one-shot pop or hit reaction to a value crossing a threshold.
Layered or looping envelopes from repeated triggers, where a hit can restart, stack, or top out while still ringing.
Per-point or per-particle triggers, each getting its own envelope.
An audio-rate amplitude envelope rather than one number per frame.
| Parameter | Type | Default |
|---|---|---|
trigger | OneOf([Number, Boolean, NumberArray, Vec3, Color]) | — |
reset | OneOf([Boolean, Number]) | — |
threshold | Number | 0.500 |
edge | String | "Rising" |
retrigger | String | "Restart" |
attack | Number | 0.050 |
peak | Number | 1 |
decay | Number | 0.300 |
sustain | Number | 0 |
release | Number | 0.100 |
attack_curve | Number | 0 |
decay_curve | Number | 0 |
release_curve | Number | 0 |
sample_rate | Number | 0 |
Gotchas
Retrigger controls what happens if the trigger fires again before the envelope has finished. Restart snaps back to Attack. Max layers a new envelope in and keeps the louder of the two. Ignore drops new triggers until the current one goes idle. Add stacks envelopes on top of each other.
Scrubbing the timeline backward resets the envelope's trigger count and phase state. Expect a jump in count and a fresh Attack the next time you land on a rising edge, rather than a continuation.
The envelope output, an audio-rate buffer, only fills once Sample Rate is above 0. At Sample Rate 0 you get value and normalized per frame instead, and envelope stays empty.
A Number Array wired into Trigger drives many envelopes from one node. Each element gets its own Attack, Decay, Sustain, and Release state, and value and normalized come back as matching arrays.
Worked example
Add an ADSR. Wire a Number or Boolean signal into Trigger. Anything that crosses your Threshold fires the envelope.
Set Attack, Decay, Sustain, and Release to shape the hit: short Attack and Decay with Sustain at 0 gives a quick percussive pop.
Bend Attack Curve or Release Curve toward -1 or 1 if linear feels too mechanical.
Take
value(ornormalizedfor a 0-1 range) into the parameter you want to animate: scale, opacity, light intensity.For faster than per-frame, raise Sample Rate and read the
envelopeoutput instead.
See also
Oscillate · State Machine · Delay · Numbers, signals & audio