<?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="bline" category="Control">
<!--METADATA-->
<metadatalist>
<metadata name="author">Cycling '74</metadata>
<metadata name="tag">RNBO</metadata>
<metadata name="tag">RNBO Timing</metadata>
<metadata name="tag">RNBO Data</metadata>
</metadatalist>
<digest>Generates ramps using bang</digest>
<description><p>
Generates a linear ramp driven by incoming bang messages. It takes a list of breakpoint segments (and the number of events to span) and outputs a smooth ramp between values.
</p></description>
<!--ARGUMENTS-->
<objarglist>
<objarg name="initial" optional="1" type="number">
<digest>initial value</digest>
<description><p>
The starting value from which to begin stepping. Note that the first bang will not output the initial value, but rather the first linear step in the ramp between the initial value and the target value.
</p></description>
</objarg>
<objarg name="target" optional="1" type="number">
<digest>target value</digest>
<description><p>
The destination value for the ramp. This is the value that will be output on the final step of the ramp.
</p></description>
</objarg>
<objarg name="steps" optional="1" type="number">
<digest>steps</digest>
<description><p>
The number of steps for the ramp. The output of each step is a linear progression from the initial value to the target value.
</p></description>
</objarg>
</objarglist>
<!--OPTIONS-->
<rnbooptionlist>
<option name="initial" size="1" type="number">
<digest>initial value</digest>
<attributelist>
<attribute name="default" type="number" value="0"></attribute>
</attributelist>
<description><p>
The starting value from which to begin stepping. Note that the first bang will not output the initial value, but rather the first linear step in the ramp between the initial value and the target value.
</p></description>
</option>
<option name="steps" size="1" type="number">
<digest>steps</digest>
<attributelist>
<attribute name="default" type="number" value="0"></attribute>
</attributelist>
<description><p>
The number of steps for the ramp. The output of each step is a linear progression from the initial value to the target value.
</p></description>
</option>
<option name="target" size="1" type="number">
<digest>target value</digest>
<attributelist>
<attribute name="default" type="number" value="0"></attribute>
</attributelist>
<description><p>
The destination value for the ramp. This is the value that will be output on the final step of the ramp.
</p></description>
</option>
</rnbooptionlist>
<!--ATTRIBUTES-->
<rnboattributelist>
<attribute name="input" size="1" type="bang, number, list">
<digest>trigger the next value in ramp</digest>
<description><p>
<m>bang</m>
: advance the ramp to the next step in the current segment and output the value.
</p>
<p>
<m>number</m>
: a single number will immediately set bline to the value and output it, stopping the current ramp and clearing any additional segments.
</p>
<p>
<m>list</m>
: a list of values can be used to create multi-segment ramps made of two-value pairs that describe the destination value and the number of steps to reach the value. e.g., 
<m>0. 10 1. 20</m>
 creates a two-segment ramp that will move from the current value to 0. over 10 bangs, then up to 1. over the next twenty.
</p></description>
</attribute>
<attribute name="stop" size="1" type="bang">
<digest>stop</digest>
<description><p>
Clear the current ramp and return the object to its initial state without outputting a new value. If an initial ramp is defined using arguments, the next bang will act as the first event in that ramp. If no initial ramp is defined, the next bang will cause bline to output a value of 0.
</p></description>
</attribute>
</rnboattributelist>
<!--INLETS-->
<rnboinletlist>
<inlet id="inlet_input" name="input" type="bang, number, list">
<digest>trigger the next value in ramp</digest>
<description><p>
<m>bang</m>
: advance the ramp to the next step in the current segment and output the value.
</p>
<p>
<m>number</m>
: a single number will immediately set bline to the value and output it, stopping the current ramp and clearing any additional segments.
</p>
<p>
<m>list</m>
: a list of values can be used to create multi-segment ramps made of two-value pairs that describe the destination value and the number of steps to reach the value. e.g., 
<m>0. 10 1. 20</m>
 creates a two-segment ramp that will move from the current value to 0. over 10 bangs, then up to 1. over the next twenty.
</p></description>
</inlet>
</rnboinletlist>
<!--OUTLETS-->
<rnbooutletlist>
<outlet id="outlet_out1" name="out1" type="number">
<digest>ramp output</digest>
<description><p>
The value of the ramp at the current step.
</p></description>
</outlet>
<outlet id="outlet_out2" name="out2" type="bang">
<digest>bang when bline reaches destination</digest>
<description><p>
Output a bang when bline reaches the destination value. For a multi-segment ramp, output only triggers at the end of the final segment.
</p></description>
</outlet>
</rnbooutletlist>
<!--SEE ALSO-->
<seealsolist>
<seealso name="bline" type="refpage" module="Max"></seealso>
<seealso name="rnbo_button" type="rnborefpage" module="RNBO" display="button"></seealso>
<seealso name="rnbo_counter" type="rnborefpage" module="RNBO" display="counter"></seealso>
<seealso name="rnbo_line~" type="rnborefpage" module="RNBO" display="line~"></seealso>
<seealso name="rnbo_metro" type="rnborefpage" module="RNBO" display="metro"></seealso>
</seealsolist>
</c74object>