<?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="lookup~" category="Sampling">
<!--METADATA-->
<metadatalist>
<metadata name="author">Cycling '74</metadata>
<metadata name="tag">RNBO</metadata>
<metadata name="tag">RNBO Sampling</metadata>
</metadatalist>
<digest>Index a buffer object using a signal, for waveshaping.</digest>
<description><p>
Use signals as a Transfer function multichannel lookup table for a 
<o objname="rnbo_buffer~">buffer~</o>
.
</p></description>
<!--ARGUMENTS-->
<objarglist>
<objarg name="buffername" optional="0" type="symbol">
<digest>Buffer to use.</digest>
<description><p>
The named 
<o objname="rnbo_buffer~">buffer~</o>
 to lookup sample values from.
</p></description>
</objarg>
<objarg name="channels" optional="1" type="Index">
<digest>Number of channels to read.</digest>
<description><p>
The number of channels from the 
<o objname="rnbo_buffer~">buffer~</o>
 to lookup sample values from.
</p></description>
</objarg>
</objarglist>
<!--OPTIONS-->
<rnbooptionlist>
<option name="boundmode" size="1" type="enum">
<digest>Set the bound mode for input</digest>
<attributelist>
<attribute name="enumvals">
<enumlist get="1" set="1" type="atom">
<enum name="fold"></enum>
<enum name="clamp"></enum>
<enum name="clip"></enum>
<enum name="wrap"></enum>
<enum name="mirror"></enum>
<enum name="ignore"></enum>
</enumlist>
</attribute>
<attribute name="default" type="enum" value="clamp"></attribute>
</attributelist>
<description><p>
Set the bound mode for input values that are outside the range of the index.(default = "clamp")
</p></description>
</option>
<option name="buffername" size="1" type="symbol">
<digest>Buffer to use.</digest>
<description><p>
The named 
<o objname="rnbo_buffer~">buffer~</o>
 to lookup sample values from.
</p></description>
</option>
<option name="channelmode" size="1" type="enum">
<digest>channelmode</digest>
<attributelist>
<attribute name="enumvals">
<enumlist get="1" set="1" type="atom">
<enum name="fold"></enum>
<enum name="clamp"></enum>
<enum name="clip"></enum>
<enum name="wrap"></enum>
<enum name="mirror"></enum>
<enum name="ignore"></enum>
</enumlist>
</attribute>
<attribute name="default" type="enum" value="clamp"></attribute>
</attributelist>
<description><p>
Setting channel mode determines how channels will offset outside the number of channels. (default = "clamp"). The mode will implement when the channel offset value is greater than or less than the number of channels set by the 
<m>channels</m>
 attribute.
</p></description>
</option>
<option name="channels" size="1" type="Index">
<digest>Number of channels to read.</digest>
<attributelist>
<attribute name="default" type="Index" value="1"></attribute>
</attributelist>
<description><p>
The number of channels from the 
<o objname="rnbo_buffer~">buffer~</o>
 to lookup sample values from.
</p></description>
</option>
<option name="indexmode" size="1" type="enum">
<digest>indexmode</digest>
<attributelist>
<attribute name="enumvals">
<enumlist get="1" set="1" type="atom">
<enum name="phase"></enum>
<enum name="samples"></enum>
<enum name="signal"></enum>
<enum name="lookup"></enum>
<enum name="wave"></enum>
</enumlist>
</attribute>
<attribute name="default" type="enum" value="lookup"></attribute>
</attributelist>
<description><p>
Sets how 
<o objname="rnbo_lookup~">lookup~</o>
 scales and indexes sample position values of a named 
<o objname="rnbo_buffer~">buffer~</o>
. (default : "lookup")
</p></description>
</option>
<option name="interp" size="1" type="enum">
<digest>interp</digest>
<attributelist>
<attribute name="enumvals">
<enumlist get="1" set="1" type="atom">
<enum name="linear"></enum>
<enum name="cubic"></enum>
<enum name="spline"></enum>
<enum name="cosine"></enum>
<enum name="step"></enum>
<enum name="none"></enum>
</enumlist>
</attribute>
<attribute name="default" type="enum" value="linear"></attribute>
</attributelist>
<description><p>
Set an interpolation function values for input sample values. (default = "linear")
</p></description>
</option>
</rnbooptionlist>
<!--ATTRIBUTES-->
<rnboattributelist>
<attribute name="buffer" size="1" type="number">
<digest>If multiple buffer names are declared to be used, this sets the currently active buffer using an index [0 based].</digest>
<attributelist>
<attribute name="default" type="number" value="0"></attribute>
</attributelist>

</attribute>
<attribute name="offset" size="1" type="auto">
<digest>Channel offset (zero-based).</digest>
<description><p>
In the right inlet, setting an integer value will increment or decrement the output of the channels read from the 
<o objname="rnbo_buffer~">buffer~</o>
. For example, an integer value of 2 to the right inlet of 
<o objname="rnbo_lookup~">lookup~</o>
 will read channel 1 from a 
<o objname="rnbo_buffer~">buffer~</o>
, and output the signal out the third outlet of channel 3.
</p>
<p>
 A negative value will decrement the offset value.
</p></description>
</attribute>
<attribute name="value" size="1" type="auto">
<digest>Value to lookup (between -1.0 and 1.0).</digest>
<description><p>
In the left inlet, a signal value between -1.0 and 1.0 sets the position value to lookup
the sample value. The range of -1.0 to 1.0 is scaled and bound to the sample length of the 
<o objname="rnbo_buffer~">buffer~</o>
.
</p></description>
</attribute>
</rnboattributelist>
<!--INLETS-->
<rnboinletlist>
<inlet id="inlet_value" name="value" type="auto">
<digest>Value to lookup (between -1.0 and 1.0).</digest>
<description><p>
In the left inlet, a signal value between -1.0 and 1.0 sets the position value to lookup
the sample value. The range of -1.0 to 1.0 is scaled and bound to the sample length of the 
<o objname="rnbo_buffer~">buffer~</o>
.
</p></description>
</inlet>
<inlet id="inlet_offset" name="offset" type="auto">
<digest>Channel offset (zero-based).</digest>
<description><p>
In the right inlet, setting an integer value will increment or decrement the output of the channels read from the 
<o objname="rnbo_buffer~">buffer~</o>
. For example, an integer value of 2 to the right inlet of 
<o objname="rnbo_lookup~">lookup~</o>
 will read channel 1 from a 
<o objname="rnbo_buffer~">buffer~</o>
, and output the signal out the third outlet of channel 3.
</p>
<p>
 A negative value will decrement the offset value.
</p></description>
</inlet>
</rnboinletlist>
<!--OUTLETS-->
<rnbooutletlist>
<outlet id="outlet_out" name="out" type="signal">
<digest>Sampled value.</digest>
<description><p>
The signal value at the lookup position.
</p></description>
</outlet>
<outlet id="outlet_outindex" name="outindex" type="signal">
<digest>Index (in samples).</digest>

</outlet>
</rnbooutletlist>
<!--SEE ALSO-->
<seealsolist>
<seealso name="rnbo_buffer~" type="rnborefpage" module="RNBO" display="buffer~"></seealso>
<seealso name="rnbo_sample~" type="rnborefpage" module="RNBO" display="sample~"></seealso>
<seealso name="rnbo_dim" type="rnborefpage" module="RNBO" display="dim"></seealso>
<seealso name="rnbo_channels" type="rnborefpage" module="RNBO" display="channels"></seealso>
</seealsolist>
</c74object>