| Trilobite 1.4 User Guide | © Darwin Arts L.L.C., 2016

# ADSR Envelope Module

The ADSR Envelope Module implements a conventional signal-triggered linear Attack, Decay, Sustain, Release envelope and serves a dual purpose: it exports both its envelope shape over time as a Signal and an envelope-scaled version of the input signal. The envelope is triggered when the Input Trigger Signal reaches an amplitude threshold, at which point the Attack segment begins. One key aspect of the ADSR Envelope generated is that the Sustain Segment lasts from the end of the Attack Segment until the trigger signal falls to zero, at which time the Release Segment begins. The Release Segment gradually decreases in amplitude over the designated amount of time until the envelope reaches a rest state, at which time only zeros are exported.

For a key to understanding the tables on this page, see the Module Types page.

## Adding Input Ports

Adding input ports is not enabled for this module.

## Static Parameters

  # | Title | Type | Description
  0 | Attack | Floating-point | Specifies the time, in seconds, of the Attack Segment. Range [0.001, 2.0], LINEAR
  1 | Decay | Floating-point | Specifies the time, in seconds, of the Decay Segment. Range [0.001, 2.0], LINEAR
  2 | Release | Floating-point | Specifies the time, in seconds, of the Release Segment. Range [0.001, 15.0], LINEAR
  3 | Sustain Ratio | Floating-point | Specifies the Sustain Segment amplitude value, as a ratio of the peak attack value, which is always 1.0. Range [0.01, 0.999], LINEAR
  4 | Trigger Threshold | Floating-point | Specifies the amplitude level of the input Trigger Signal which will start the Envelope Attack Segment. Range [0.01, 0.999], LINEAR

## Input Ports

  # | Title | Description | Input Scalar Used | Parameter Scalar Used
  0 | Input Signal | The input signal which will be amplitude modulated. | NO | NO
  1 | Input Trigger Signal | The signal routed to this port will trigger an envelope attack if its amplitude reaches the threshold specified by Parameter 4 above, but only if an envelope is not already active. | NO | YES

## Output Ports

  # | Title | Description
  0 | Output Scaled | Exposes a envelope-modulated version of the input signal.
  1 | Output Envelope | Exposes the pure ADSR envelope, as triggered by appropriate peaks in the Input Trigger Signal.