<?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. Rather, use the _ref.xml files found in the 'edits' folder.-->
<c74object name="mc.cell" module="msp" category="MC">
	<digest>
		Format messages from a <o>jit.cellblock</o> for use with MC objects
	</digest>
	<description>
		The <o>mc.cell</o> objects takes a &lt;column row value&gt; message from the left outlet of the <o>jit.cellblock</o> object and produces a corresponding <m>setvalue</m> message for use with MC objects to set a value for a specific channel. Since <o>jit.cellblock</o> column numbers are 0-relative and MC channel numbers are 1-relative, <o>mc.cell</o> adds 1 to the incoming column number.
	</description>
	<!--METADATA-->
	<metadatalist>
		<metadata name="author">
			Cycling '74
		</metadata>
		<metadata name="tag">
			MSP
		</metadata>
		<metadata name="tag">
			MC
		</metadata>
	</metadatalist>
	<!--INLETS-->
	<inletlist>
		<inlet id="0" type="list">
			<digest>
				Column, Row, Value
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
		<inlet id="1" type="list">
			<digest>
				Column, Row, Value
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
	</inletlist>
	<!--OUTLETS-->
	<outletlist>
		<outlet id="0" type="OUTLET_TYPE">
			<digest>
				setvalue Message Output
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
	</outletlist>
	<!--ARGUMENTS-->
	<objarglist>
	</objarglist>
	<!--MESSAGES-->
	<methodlist>
		<method name="list">
			<arglist>
				<arg name="column" type="int" optional="0" />
				<arg name="row" type="int" optional="0" />
				<arg name="value" type="number" optional="0" />
			</arglist>
			<digest>
				column row value
			</digest>
			<description>
				<o>mc.cell</o> accepts a list in the form &lt;col-number row-number value&gt; and outputs a message in the form <m>setvalue</m>&lt;col-number+1 value&gt;.
			</description>
		</method>
	</methodlist>
	<!--ATTRIBUTES-->
	<attributelist>
		<attribute name="columns" get="1" set="1" type="int" size="1">
			<digest>
				Number of Columns
			</digest>
			<description>
				Offsets the cell values for each row after the first by the specified number of <at>columns</at>. Typically this should be set to the same number of columns as the <o>jit.cellblock</o> feeding <o>mc.cell</o>. The default value for <at>columns</at> is 0, which causes no offset.
			</description>
			<attributelist>
				<attribute name="basic" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Number of Columns" />
			</attributelist>
		</attribute>
		<attribute name="constant" get="1" set="1" type="int" size="1">
			<digest>
				Constant Channel
			</digest>
			<description>
				When set, applies the specified channel to any incoming data, overriding the channel supplied by the input list.
			</description>
			<attributelist>
				<attribute name="basic" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Constant Channel" />
			</attributelist>
		</attribute>
		<attribute name="message" get="1" set="1" type="symbol" size="1">
			<digest>
				Message Prefix
			</digest>
			<description>
				Inserts any message after the column and before the value of all lists output by <o>mc.cell</o>. Useful for setting the value of an interal attribute of an MC object. Output lists are formatted as <m>setvalue</m>&lt;olumn message value&gt;.
			</description>
			<attributelist>
				<attribute name="basic" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Message Prefix" />
				<attribute name="style" get="1" set="1" type="symbol" size="1" value="text_onesymbol" />
			</attributelist>
		</attribute>
		<attribute name="numeric" get="1" set="1" type="int" size="1">
			<digest>
				Numeric Values Only
			</digest>
			<description>
				Enable the <at>numeric</at> attribute to filter out non-numeric text (defaults to on). When off, cells will pass non-numeric values as well. Non-numeric text could be useful for entering the name of a <o>buffer~</o> object or media file.
			</description>
			<attributelist>
				<attribute name="basic" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="default" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Numeric Values Only" />
				<attribute name="style" get="1" set="1" type="symbol" size="1" value="onoff" />
			</attributelist>
		</attribute>
		<attribute name="row" get="1" set="1" type="int" size="1">
			<digest>
				Selected Row Only
			</digest>
			<description>
				Use the <at>row</at> attribute to specify a row to read into the <o>mc.cell</o> object.
			</description>
			<attributelist>
				<attribute name="basic" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Selected Row Only" />
			</attributelist>
		</attribute>
	</attributelist>
	<!--EXAMPLE-->
	<examplelist>
		<example caption="" img="" />
	</examplelist>
	<!--SEEALSO-->
	<seealsolist>
		<seealso name="jit.cellblock" />
		<seealso name="mc_topic" module="topics" type="vignette" />
	</seealsolist>
</c74object>
