<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<?xml-stylesheet href="./_c74_ref.xsl" type="text/xsl"?>
<!--This is an automatically generated file. DO NOT EDIT THIS FILE DIRECTLY.-->
<c74object module="rnbo" kind="rnboobject" name="line~" category="Envelopes">
<!--METADATA-->
<metadatalist>
<metadata name="author">Cycling '74</metadata>
<metadata name="tag">RNBO</metadata>
<metadata name="tag">RNBO Functions</metadata>
<metadata name="tag">RNBO Envelopes</metadata>
<metadata name="alias">fade~</metadata>
</metadatalist>
<digest>Linear ramp generator</digest>
<description><p>
Linear signal-ramp generator. The 
<m>fade~</m>
 object is an alias to 
<m>line~</m>
, with the 
<m>keepramp</m>
 attribute set to 'true'.
</p></description>
<!--ARGUMENTS-->
<objarglist>
<objarg name="value" optional="1" type="number">
<digest>Initial value.</digest>
<description><p>
Sets an initial value for the signal output. The default value is 0.
</p></description>
</objarg>
<objarg name="time" optional="1" type="number">
<digest>Ramp time</digest>
<description><p>
Ramp time is the total amount of time (in milliseconds) in which line~ should reach the target value. This value is only used when a single value is input to the leftmost target inlet. Once a ramp has been completed, this value is set to 0 and must be set again. To keep the last received ramp, see the 
<m>keepramp</m>
 attribute (or use fade~ object alias).
</p></description>
</objarg>
</objarglist>
<!--OPTIONS-->
<rnbooptionlist>
<option name="value" size="1" type="number">
<digest>Initial value.</digest>
<attributelist>
<attribute name="default" type="number" value="0"></attribute>
</attributelist>
<description><p>
Sets an initial value for the signal output. The default value is 0.
</p></description>
</option>
</rnbooptionlist>
<!--ATTRIBUTES-->
<rnboattributelist>
<attribute name="keepramp" size="1" type="bool">
<digest>Keep last ramp</digest>
<attributelist>
<attribute name="default" type="bool" value="false"></attribute>
</attributelist>
<description><p>
When enabled, the last received ramp time will be kept and used when a single value is received in the left inlet. The 
<m>fade~</m>
 alias to 
<m>line~</m>
 sets the 
<m>keepramp</m>
 attribute to 'true' by default.
</p></description>
</attribute>
<attribute name="segments" size="1" type="list">
<digest>Target value or target value/ramp time pairs</digest>
<description><p>
In left inlet: The first number specifies a target value and the second number specifies the ramp time (in milliseconds) in which line~ should reach the target value. In the specified amount of time, line~ generates a ramp signal from its current value to the target value.
</p>
<p>
The line~ object  accepts up to 128 target-time pairs in a list, to generate compound ramps. (An example would be 0 1000 1 1000, which would go from the current value to 0 in a second, then to 1 in a second.) Once one of the ramps has reached its target value, the next one starts. A subsequent list, float, or int in the left inlet clears all ramps yet to be generated. To keep the last received ramp, see the 
<m>keepramp</m>
 attribute (or use the fade~ object alias).
</p>
<p>
A list consisting of a number, followed by a value of '0' and up to 128 target-time pairs, will set an initial value for the ramp. An example would be 4.5 0 1 1000 which would set an initial value of 0, a new value of 1, and a target time of 1000 ms.
</p></description>
</attribute>
<attribute name="time" size="1" type="number">
<digest>Ramp time</digest>
<description><p>
Ramp time is the total amount of time (in milliseconds) in which line~ should reach the target value. This value is only used when a single value is input to the leftmost target inlet. Once a ramp has been completed, this value is set to 0 and must be set again. To keep the last received ramp, see the 
<m>keepramp</m>
 attribute (or use fade~ object alias).
</p></description>
</attribute>
</rnboattributelist>
<!--INLETS-->
<rnboinletlist>
<inlet id="inlet_segments" name="segments" type="list">
<digest>Target value or target value/ramp time pairs</digest>
<description><p>
In left inlet: The first number specifies a target value and the second number specifies the ramp time (in milliseconds) in which line~ should reach the target value. In the specified amount of time, line~ generates a ramp signal from its current value to the target value.
</p>
<p>
The line~ object  accepts up to 128 target-time pairs in a list, to generate compound ramps. (An example would be 0 1000 1 1000, which would go from the current value to 0 in a second, then to 1 in a second.) Once one of the ramps has reached its target value, the next one starts. A subsequent list, float, or int in the left inlet clears all ramps yet to be generated. To keep the last received ramp, see the 
<m>keepramp</m>
 attribute (or use the fade~ object alias).
</p>
<p>
A list consisting of a number, followed by a value of '0' and up to 128 target-time pairs, will set an initial value for the ramp. An example would be 4.5 0 1 1000 which would set an initial value of 0, a new value of 1, and a target time of 1000 ms.
</p></description>
</inlet>
<inlet id="inlet_time" name="time" type="number">
<digest>Ramp time</digest>
<description><p>
Ramp time is the total amount of time (in milliseconds) in which line~ should reach the target value. This value is only used when a single value is input to the leftmost target inlet. Once a ramp has been completed, this value is set to 0 and must be set again. To keep the last received ramp, see the 
<m>keepramp</m>
 attribute (or use fade~ object alias).
</p></description>
</inlet>
</rnboinletlist>
<!--OUTLETS-->
<rnbooutletlist>
<outlet id="outlet_out" name="out" type="signal">
<digest>Ramp out</digest>
<description><p>
The current destination value, or a ramp moving toward the destination value according to line~'s currently stored value and the ramp time.
</p></description>
</outlet>
<outlet id="outlet_target" name="target" type="bang">
<digest>Bang when ramp has finished</digest>
<description><ul>
<li>A bang is sent out the right outlet when line~ has finished generating all its ramps.</li>
</ul></description>
</outlet>
</rnbooutletlist>
<!--SEE ALSO-->
<seealsolist>
<seealso name="line~" type="refpage" module="MSP"></seealso>
<seealso name="line" type="refpage" module="Max"></seealso>
<seealso name="rnbo_adsr~" type="rnborefpage" module="RNBO" display="adsr~"></seealso>
<seealso name="rnbo_click~" type="rnborefpage" module="RNBO" display="click~"></seealso>
<seealso name="rnbo_curve~" type="rnborefpage" module="RNBO" display="curve~"></seealso>
<seealso name="rnbo_click~" type="rnborefpage" module="RNBO" display="click~"></seealso>
<seealso name="rnbo_line" type="rnborefpage" module="RNBO" display="line"></seealso>
<seealso name="rnbo_transport" type="rnborefpage" module="RNBO" display="transport"></seealso>
</seealsolist>
</c74object>