curve~
Exponential ramp generator
Description
The curve~ object to produces a signal that goes from an initial value to a destination value over a specified time. Similar to the line~ object, it produces non-linear ramps using a piecewise approximation of an exponential function.
Arguments
value [number]
The first argument is the intitial value where the ramp starts. If a list is sent to this inlet, the first list element and/or argument represents the initial value.
time [number]
The second argument specifies the duration of time in milliseconds to reach the destination value. If a list is sent to this inlet, the second list element and/or argument represents the duration of time. To keep the last received ramp, see the 'keepramp' attribute.
curve [number]
The third argument sets the initial curve parameter. The default value for the curve parameter is 0.
Inlets
dest [list]
In the left inlet, The number is the target value, to be arrived at in the time specified by the number in the middle inlet, ramp's time. If no time has been specified since the last target value, the time is considered to be 0 and the output signal jumps immediately to the target value. To keep the last received ramp, see the 'keepramp' attribute.
time [number]
The second argument specifies the duration of time in milliseconds to reach the destination value. If a list is sent to this inlet, the second list element and/or argument represents the duration of time. To keep the last received ramp, see the 'keepramp' attribute.
curve [number]
The third argument sets the initial curve parameter. The default value for the curve parameter is 0.
Outlets
out [signal]
The current target value, or an exponential curve moving toward the target value according to the most recently received target value, transition time, and curve parameter.
target [bang]
When curve~ has finished generating all of its ramps, a bang is sent out.
Fixed Attributes
These attributes must be set in the object box and determine the behavior of the object at runtime.
value [number] (default: 0)
The first argument is the intitial value where the ramp starts. If a list is sent to this inlet, the first list element and/or argument represents the initial value.
Dynamic Attributes
These attributes can be modified in the code during execution using the set object
curve [number]
The third argument sets the initial curve parameter. The default value for the curve parameter is 0.
dest [list]
In the left inlet, The number is the target value, to be arrived at in the time specified by the number in the middle inlet, ramp's time. If no time has been specified since the last target value, the time is considered to be 0 and the output signal jumps immediately to the target value. To keep the last received ramp, see the 'keepramp' attribute.
keepramp [bool] (default: false)
When enabled, the last received ramp time will be kept and used when a single value is received in the left inlet.
time [number]
The second argument specifies the duration of time in milliseconds to reach the destination value. If a list is sent to this inlet, the second list element and/or argument represents the duration of time. To keep the last received ramp, see the 'keepramp' attribute.
See Also
| Name | Description |
|---|---|
| curve~ | |
| line~ | Linear ramp generator |
| smoothstep~ | Smoothed fade of inputs |
| adsr~ | Attack-Decay-Sustain-Release envelope generator |
| transport | transport |