<?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.tiffany" module="jit" category="Jitter Special FX">
	<digest>
		Arbitrary rectangular resampling
	</digest>
	<description>
		The <o>jit.tiffany</o> object performs an arbitrary rectangular resampling of a matrix.
	</description>
	<!--METADATA-->
	<metadatalist>
		<metadata name="author">
			Cycling '74
		</metadata>
		<metadata name="tag">
			Jitter
		</metadata>
		<metadata name="tag">
			Jitter Special FX
		</metadata>
	</metadatalist>
	<!--INLETS-->
	<inletlist>
		<inlet id="0" type="matrix">
			<digest>
				in
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
		<inlet id="1" type="matrix">
			<digest>
			</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="1" matrixoutputcount="1">
		<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-->
	<methodlist>
		<method name="x">
			<arglist>
				<arg name="facet-width" optional="1" type="float" />
				<arg name="..." type="literal" />
			</arglist>
			<digest>
				Generate new width values of all facets
			</digest>
			<description>
				Generates new values for the widths of all facets. New values can be specified by an optional float or list of floats, which represent percentages of the <o>jit.tiffany</o> object's display area, or they will be randomly generated within the ranges limited by the <at>xrange</at> attribute.
			</description>
		</method>
		<method name="y">
			<arglist>
				<arg name="facet-height" optional="1" type="float" />
				<arg name="..." type="literal" />
			</arglist>
			<digest>
				Generate new height values of all facets
			</digest>
			<description>
				Generates new values for the height of all facets. New values can be specified by an optional float or list of floats, which represent percentages of the <o>jit.tiffany</o> object's display area, or they will be randomly generated within the ranges limited by the <at>yrange</at> attribute.
			</description>
		</method>
		<method name="xy">
			<arglist>
				<arggroup optional="1">
					<arg name="facet-size" type="float" />
				</arggroup>
				<arg name="..." type="literal" />
			</arglist>
			<digest>
				Generate new height and width values of all facets
			</digest>
			<description>
				Generates new values for the heights and widths of all facets. New values can be specified by an optional float or list of floats, which represent percentages of the <o>jit.tiffany</o> object's display area, or they will be randomly generated within the ranges limited by the <at>xrange</at> and <at>yrange</at> attributes.
			</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="bgcolor" get="1" set="1" type="float" size="32">
			<digest>
				Background color
			</digest>
			<description>
				The background color (default = 0. 0. 0. 0.)
			</description>
			<attributelist>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Background Color" />
			</attributelist>
		</attribute>
		<attribute name="grid" get="1" set="1" type="int" size="1">
			<digest>
				Grid border flag
			</digest>
			<description>
				Grid border flag (default = 1) When the flag is set, a border is drawn for each facet in the grid.
			</description>
			<attributelist>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Grid" />
			</attributelist>
		</attribute>
		<attribute name="xrange" get="1" set="1" type="float" size="1">
			<digest>
				Upper limit for the width of a facet (% of matrix size)
			</digest>
			<description>
				The upward limit for width of a facet as a percentage of the total matrix size (default = 0.2)
			</description>
			<attributelist>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="X Range" />
			</attributelist>
		</attribute>
		<attribute name="xskip" get="1" set="1" type="int" size="1">
			<digest>
				Number of columns to 'skip' when rendering the matrix
			</digest>
			<description>
				The number of columns to 'skip' when rendering an output matrix (default = 0)
			</description>
			<attributelist>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="X Skip" />
			</attributelist>
		</attribute>
		<attribute name="yrange" get="1" set="1" type="float" size="1">
			<digest>
				Upper limit for the height of a facet (% of matrix size)
			</digest>
			<description>
				The upward limit for height of a facet as a percentage of the total matrix size (default = 0.2)
			</description>
			<attributelist>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Y Range" />
			</attributelist>
		</attribute>
		<attribute name="yskip" get="1" set="1" type="int" size="1">
			<digest>
				Number of rows to 'skip' when rendering the matrix
			</digest>
			<description>
				The number of rows to 'skip' when rendering an output matrix (default = 0)
			</description>
			<attributelist>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Y Skip" />
			</attributelist>
		</attribute>
	</attributelist>
	<jitterattributelist>
		<jitterattribute name="outputmode" />
		<jitterattribute name="adapt" />
		<jitterattribute name="out_name" />
		<jitterattribute name="type" />
		<jitterattribute name="dim" />
		<jitterattribute name="planecount" />
	</jitterattributelist>
	<!--EXAMPLE-->
	<examplelist>
		<example img="jit.tiffany.png" />
	</examplelist>
	<!--SEEALSO-->
	<seealsolist>
		<seealso name="jit.resamp">
			Resample spatially
		</seealso>
		<seealso name="jit.rubix">
			Reorder grid of rectangles
		</seealso>
	</seealsolist>
	<discussion>
		The <at>xrange</at> and <at>yrange</at> values represent a percentage of the total matrix size, and are used as an upward limit on facet sizes when jit.tiffany assigns them randomly. The <o>jit.tiffany</o> object will generate random values across the x, y or x and y (respectively) axes, limited by the <at>xrange</at> and <at>yrange</at> attributes unless you explicitly specify values using the <m>x</m>, <m>y</m>, or <m>xy</m> messages. Values you do not specify will be randomly generated.
	</discussion>
</c74object>
