Struct Adsr 

pub struct Adsr { /* private fields */ }

ADSR Envelope Generator

A classic Attack-Decay-Sustain-Release envelope with gate and retrigger inputs. Outputs normal and inverted envelope signals, plus end-of-cycle trigger.

Segment timing

The decay and release parameters denote the true duration of their respective segments (peak→sustain and current-level→zero), not the time to traverse the full 0..1 span. Per-sample rates are therefore scaled by the span actually traversed: decay_rate = (1 - sustain) / (decay_time · fs) and release_rate = release_start_level / (release_time · fs), where release_start_level is captured at the instant the gate falls.

Curve shape

The shape input selects the segment curve: 0V (default) gives classic linear ramps; a high level (> GATE_THRESHOLD_V, e.g. 5V) selects an exponential one-pole approach toward each stage’s target (attack→1, decay→ sustain, release→0) using env_coef with the stage time as the time constant.

Retrigger semantics

A retrigger (or a fresh gate) restarts the contour at the Attack stage but continues from the current level — it does not reset the level to zero. Retriggering during Sustain therefore ramps back up from the sustain level rather than restarting from silence.

Implementations

impl Adsr

pub fn new(sample_rate: f64) -> Self

Trait Implementations

impl Default for Adsr

fn default() -> Self

Returns the “default value” for a type.

impl GraphModule for Adsr

fn port_spec(&self) -> &PortSpec

Returns the module’s port specification

fn tick(&mut self, inputs: &PortValues, outputs: &mut PortValues)

Process one sample given port values

fn reset(&mut self)

Reset internal state

fn set_sample_rate(&mut self, sample_rate: f64)

Set sample rate

fn type_id(&self) -> &'static str

Get module type identifier for serialization

fn process_block( &mut self, inputs: &BlockPortValues, outputs: &mut BlockPortValues, frames: usize, )

Process a block of samples (optional optimization).

fn breaks_feedback_cycle(&self) -> bool

Whether this module breaks a feedback cycle in the patch graph.

fn params(&self) -> &[ParamDef]

Get parameter definitions for UI binding.

fn get_param(&self, _id: ParamId) -> Option<f64>

Get a parameter value.

fn set_param(&mut self, _id: ParamId, _value: f64)

Set a parameter value.

fn serialize_state(&self) -> Option<Value>

Available on crate feature alloc only.

Serialize module state (alloc feature only)

fn deserialize_state(&mut self, _state: &Value) -> Result<(), String>

Available on crate feature alloc only.

Deserialize module state (alloc feature only)

fn introspect(&self) -> Option<&dyn ModuleIntrospection>

Available on crate feature alloc only.

Downcast this module to its ModuleIntrospection view, if it exposes one.

fn introspect_mut(&mut self) -> Option<&mut dyn ModuleIntrospection>

Available on crate feature alloc only.

Mutable companion to introspect, used to set internal parameters.

impl ModuleIntrospection for Adsr

Available on crate feature alloc only.

fn param_infos(&self) -> Vec<ParamInfo>

Get all parameter descriptors for this module

fn get_param_info(&self, id: &str) -> Option<ParamInfo>

Get a specific parameter by its ID

fn set_param_by_id(&mut self, _id: &str, _value: f64) -> bool

Set a parameter value by its ID