Ramp

A rising Trigger captures Start, End, Shape, Time Mode, and duration, then runs one segment. Retriggering restarts from the captured authored Start. A rising Reset wins over a simultaneous Trigger, cancels the segment without Done, and returns Phase to zero. Before triggering and after Reset, Signal follows the current Start setting. During a segment and after completion, parameter edits wait for the next Trigger; the completed End and Phase 1 are held. Linear interpolates evenly. Exponential uses normalized easing (exp(5 × phase) − 1) / (exp(5) − 1), so either endpoint may be negative or zero. Free duration rounds milliseconds to the nearest sample: the trigger sample emits Start at Phase 0, and completion occurs that many samples later. Zero duration immediately emits End, Phase 1, and Done on the trigger sample. Done is always one sample. Clock mode accumulates forward phase movement only from a wired Clock: Duration in Clock Units means quarter-note beats from Clock, or cycles from Clock Divider. A missing, unavailable, stopped, held, or nonfinite clock pauses the segment. Reconnection, backwards phase movement, or a structured clock reset reanchors timing without advancing; subsequent forward movement resumes. There is no ambient host-tempo fallback. Unrelated graph edits preserve the in-flight segment; loading a patch starts idle at its authored Start. No looping or breakpoint editing is included.

Inputs

Trigger

Rising edge starts or restarts a segment from Start.

ID	trigger
Signal	trigger · event rate
Coercion	Implicit

Reset

Rising edge cancels the segment and returns to Start, without Done.

ID	reset
Signal	trigger · event rate
Coercion	Implicit

Clock

Explicit phase clock used only in Clock mode; loss pauses the segment.

ID	clock
Signal	clock · control rate
Coercion	Implicit

Outputs

Signal

Segment value from Start to End, held at End after completion.

ID	signal
Signal	control · control rate
Range	-1000000 to 1000000
Coercion	Implicit

Phase

Linear normalized progress from 0 to 1, independent of Shape.

ID	phase01
Signal	control · control rate
Unit	phase01
Range	0 to 1 phase01
Coercion	Implicit

Done

One-sample pulse when the segment reaches End.

ID	done
Signal	trigger · event rate
Coercion	Implicit

Parameters

Start

Value at the beginning of each segment and while idle.

ID	start
Type	float
Control	slider
Range or Options	-1000000 to 1000000, step 0.01
Default	0

End

Value reached and held when the segment completes.

ID	end
Type	float
Control	slider
Range or Options	-1000000 to 1000000, step 0.01
Default	1

Shape

Linear interpolation or normalized exponential easing; captured on Trigger.

ID	shape
Type	enum
Control	buttons
Range or Options	Linear (linear), Exponential (exponential)
Default	Linear (linear)

Time Mode

Free uses milliseconds; Clock requires an explicit wired phase clock.

ID	timeMode
Type	enum
Control	buttons
Range or Options	Free (free), Clock (tempoSync)
Default	Free (free)

Free Duration

Free duration in milliseconds, rounded to samples; zero completes immediately.

ID	durationMs
Type	float
Control	slider
Range or Options	0 to 600000 ms, step 1
Default	1000

Duration in Clock Units

Forward clock phase units per segment: beats from Clock, cycles from Clock Divider. Zero completes immediately.

ID	durationBeats
Type	float
Control	slider
Range or Options	0 to 1024, step 0.01
Default	1

Details

Canonical ID	mod.ramp
Category	modulators
Runtime Surface	audio
Runtime Targets	audio-worklet
JUCE Early Access	Supported
Early Access Note	Native-supported in the plugin for the current catalog/runtime support contract.