<?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="jit.plume" module="jit" category="Jitter Spatial">
	<digest>
		Displace points based on luminance
	</digest>
	<description>
		<o>jit.plume</o> takes two input matrices and uses an average value of all planes for each cell in a second input (control) matrix to displace the corresponding cell of the first (input) matrix.
	</description>
	<!--METADATA-->
	<metadatalist>
		<metadata name="author">
			Cycling '74
		</metadata>
		<metadata name="tag">
			Jitter
		</metadata>
		<metadata name="tag">
			Jitter Spatial
		</metadata>
	</metadatalist>
	<!--INLETS-->
	<inletlist>
		<inlet id="0" type="matrix">
			<digest>
				in
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
		<inlet id="1" type="matrix">
			<digest>
				in2
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
	</inletlist>
	<!--OUTLETS-->
	<outletlist>
		<outlet id="0" type="matrix">
			<digest>
				out
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
		<outlet id="1" type="matrix">
			<digest>
				dumpout
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
	</outletlist>
	<!--MOP-->
	<mop matrixinputcount="2" matrixoutputcount="1">
		<matrixinput name="in2" planelink="1" typelink="1" dimlink="1" minplanecount="1" maxplanecount="32" mindimcount="1" maxdimcount="32" ioproc="resamp">
			<types>
				char
			</types>
		</matrixinput>
		<matrixoutput name="out" planelink="1" typelink="1" dimlink="1" minplanecount="1" maxplanecount="32" mindimcount="1" maxdimcount="32">
			<types>
				char
			</types>
		</matrixoutput>
	</mop>
	<!--MESSAGES-->
	<methodlist>
		<method name="planeselect">
			<arglist>
				<arg name="plane-list" type="list" />
			</arglist>
			<digest>
				Select planes to average for offset in the input matrix
			</digest>
			<description>
				Chooses which planes on the second matrix (inlet 2) are averaged to offset the first matrix. The <m>planeselect</m> message takes the following arguments:
				<br />
				-2 = Average all planes
				<br />
				-1 = Average all planes except plane 0 (default)
				<br />
				0-x = A single <m>int</m> argument specifies a single plane (no average)
				<br />
				A list of <m>int</m> arguments specifies a multiplane average of the planes listed (e.g., 0 2 3)
			</description>
		</method>
	</methodlist>
	<jittermethodlist>
		<jittermethod name="bang" />
		<jittermethod name="clear" />
		<jittermethod name="exportattrs" />
		<jittermethod name="exportsummary" />
		<jittermethod name="getattributes" />
		<jittermethod name="getstate" />
		<jittermethod name="jit_matrix" />
		<jittermethod name="importattrs" />
		<jittermethod name="outputmatrix" />
		<jittermethod name="summary" />
	</jittermethodlist>
	<!--ATTRIBUTES-->
	<attributelist>
		<attribute name="intervalmode" get="1" set="1" type="int" size="1">
			<digest>
				Interval mode for <i>x_interval</i> 
			</digest>
			<description>
				Interval mode for <i>x_interval</i> only (default = 0 (entire frame))
				<br />
				0 = interval calculated over the entire frame
				<br />
				1 = new interval count for each scanline
			</description>
			<attributelist>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Interval Mode" />
			</attributelist>
		</attribute>
		<attribute name="wrap" get="1" set="1" type="int" size="1">
			<digest>
				Wrap mode
			</digest>
			<description>
				Wrap mode (default = 0 (normal))
				<br />
				0 = normal: Cells displaced off the edge of the frame are disregarded
				<br />
				1 = wrap: Cells displaced off the edge of the frame wrap to the other edge
				<br />
				2 = reflect: Cells displaced off the edge of the frame are reflected
				<br />
				3 = clip: Cells are clipped to the edge of the frame
			</description>
			<attributelist>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Wrap" />
			</attributelist>
		</attribute>
		<attribute name="x_interval" get="1" set="1" type="int" size="1">
			<digest>
				Frequency of displacement calculation along the horizontal axis
			</digest>
			<description>
				The frequency of displacement calculation along the horizontal axis (default = 1)
			</description>
			<attributelist>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="X Intervl" />
			</attributelist>
		</attribute>
		<attribute name="xamount" get="1" set="1" type="int" size="1">
			<digest>
				Horizontal displacement amount
			</digest>
			<description>
				The horizontal amount of displacement (multiplied by luminance) (default = 0)
			</description>
			<attributelist>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="X Amount" />
			</attributelist>
		</attribute>
		<attribute name="xinterval" get="1" set="1" type="int" size="1">
			<digest>
				Frequency of displacement calculation along the horizontal axis
			</digest>
			<description>
				The frequency of displacement calculation along the horizontal axis (default = 1)
			</description>
			<attributelist>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="X Interval" />
			</attributelist>
		</attribute>
		<attribute name="xoffset" get="1" set="1" type="int" size="1">
			<digest>
				Horizontal offset of displacement
			</digest>
			<description>
				The horizontal offset of displacement (default = 0)
			</description>
			<attributelist>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="X Offset" />
			</attributelist>
		</attribute>
		<attribute name="y_interval" get="1" set="1" type="int" size="1">
			<digest>
				Frequency of displacement calculation along the vertical axis
			</digest>
			<description>
				The frequency of displacement calculation along the vertical axis (default = 1)
			</description>
			<attributelist>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Y Interval" />
			</attributelist>
		</attribute>
		<attribute name="yamount" get="1" set="1" type="int" size="1">
			<digest>
				T Vertical displacement amount
			</digest>
			<description>
				The vertical amount of displacement (multiplied by luminance) (default = 0)
			</description>
			<attributelist>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Y Amount" />
			</attributelist>
		</attribute>
		<attribute name="yinterval" get="1" set="1" type="int" size="1">
			<digest>
				Frequency of displacement calculation along the vertical axis
			</digest>
			<description>
				The frequency of displacement calculation along the vertical axis (default = 1)
			</description>
			<attributelist>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Y Interval" />
			</attributelist>
		</attribute>
		<attribute name="yoffset" get="1" set="1" type="int" size="1">
			<digest>
				Vertical displacement offset
			</digest>
			<description>
				The vertical offset of displacement (default = 0)
			</description>
			<attributelist>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Y Offset" />
			</attributelist>
		</attribute>
	</attributelist>
	<jitterattributelist>
		<jitterattribute name="outputmode" />
		<jitterattribute name="adapt" />
		<jitterattribute name="in2_name" />
		<jitterattribute name="in2_type" />
		<jitterattribute name="in2_dim" />
		<jitterattribute name="in2_planecount" />
		<jitterattribute name="out_name" />
		<jitterattribute name="type" />
		<jitterattribute name="dim" />
		<jitterattribute name="planecount" />
	</jitterattributelist>
	<!--EXAMPLE-->
	<examplelist>
		<example img="jit.plume.png" />
	</examplelist>
	<!--SEEALSO-->
	<seealsolist>
		<seealso name="jit.repos" />
	</seealsolist>
</c74object>
