<?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.repos" module="jit" category="Jitter Spatial">
	<digest>
		Reposition spatially
	</digest>
	<description>
		<o>jit.repos</o> performs cell positioning on an input matrix received in its left inlet using the input from a second input matrix received in its right Inlet as a spatial map.
	</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="0" typelink="0" dimlink="1" minplanecount="2" maxplanecount="2" mindimcount="1" maxdimcount="32" ioproc="resamp">
			<types>
				long char
			</types>
		</matrixinput>
		<matrixoutput name="out" planelink="1" typelink="1" dimlink="1" minplanecount="1" maxplanecount="32" mindimcount="1" maxdimcount="32">
			<types>
				char long float32 float64
			</types>
		</matrixoutput>
	</mop>
	<!--MESSAGES-->
	<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="boundmode" get="1" set="1" type="int" size="1">
			<digest>
				Boundary mode
			</digest>
			<description>
				Boundary mode for values outside the range (0, width) (0, height) (default = 3 (clip))
				<br />
				0 = ignore: Values that exceed the limits are ignored.
				<br />
				1 = clear: Values that exceed the limits are set to 0.
				<br />
				2 = wrap: Values that exceed the limits are wrapped around to the opposite limit with a modulo operation.
				<br />
				3 = clip: Values are limited not to exceed width or height.
				<br />
				4 = fold: Values that exceed the limits are folded back in the opposite direction
			</description>
			<attributelist>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Boundmode" />
			</attributelist>
		</attribute>
		<attribute name="interpbits" get="1" set="1" type="int" size="1">
			<digest>
				Number of bits of interpolation for spatial mapping
			</digest>
			<description>
				The number of bits considered as fraction for spatial mapping values (default = 0)
			</description>
			<attributelist>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Interpolation Bits" />
			</attributelist>
		</attribute>
		<attribute name="mode" get="1" set="1" type="int" size="1">
			<digest>
				Offset mode flag
			</digest>
			<description>
				Offset mode flag (default = 0 (absolute offsets))
				<br />
				0 = spatial map values specified as absolute offsets
				<br />
				1 = spatial map specified as relative offsets
			</description>
			<attributelist>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Mode" />
			</attributelist>
		</attribute>
		<attribute name="offset_x" get="1" set="1" type="int" size="1">
			<digest>
				X value offset for spatial map matrix
			</digest>
			<description>
				The offset added to the x values in the spatial map matrix (default = 0)
			</description>
			<attributelist>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Offset X" />
			</attributelist>
		</attribute>
		<attribute name="offset_y" get="1" set="1" type="int" size="1">
			<digest>
				Y value offset for spatial map matrix
			</digest>
			<description>
				The offset added to the y values in the spatial map matrix (default = 0)
			</description>
			<attributelist>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Offset Y" />
			</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.repos.png" />
	</examplelist>
	<!--SEEALSO-->
	<seealsolist>
		<seealso name="jit.mxform2d" />
		<seealso name="jit.plume" />
		<seealso name="jit.rota" />
		<seealso name="jitterchapter39" module="jit" type="tutorial" />
	</seealsolist>
	<discussion>
		The spatial map should be a 2 plane matrix, where plane 0 specifies the x offset and plane 1 specifies the y offset. You can do Fractional repositioning by setting the <at>interpbits</at> attribute to a non-zero value -- the spatial map values are considered to be fixed point values with a fractional component of <at>interpbits</at>.
	</discussion>
</c74object>
