<?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.fprint" module="jit" category="Jitter Utilities">
	<digest>
		Read/write a matrix as a text file
	</digest>
	<description>
		Imports or exports a single matrix from or to a text file.
	</description>
	<!--METADATA-->
	<metadatalist>
		<metadata name="author">
			Cycling '74
		</metadata>
		<metadata name="tag">
			Jitter
		</metadata>
		<metadata name="tag">
			Jitter Utilities
		</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="read">
			<arglist>
				<arg name="filename" optional="1" type="symbol" />
			</arglist>
			<digest>
				Read a matrix from a text file
			</digest>
			<description>
				Open and read a single matrix from a text file. The optional argument specifies the filename. The <o>jit.fprint</o> object expects text files to be formatted in the same fashion in which it writes them. Attempting to read unformatted text files will likely return an error.
			</description>
		</method>
		<method name="write">
			<arglist>
				<arg name="filename" optional="1" type="symbol" />
			</arglist>
			<digest>
				Write a matrix to a text file
			</digest>
			<description>
				Create a new text file for writing. The optional argument specifies a filename. The text file is not written until a matrix is received by the <o>jit.fprint</o> object. After a write attempt, the message <m>write</m> followed by two <m>int</m> arguments will be sent from the object's right outlet. The first int indicates the success (1) or failure (0) of the write operation, and the second int indicates the number of bytes written to the file (if any).
			</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="default_dir" get="1" set="1" type="symbol" size="1">
			<digest>
				Default directory
			</digest>
			<description>
				Equivalent to <m>defaultdir</m>.
			</description>
		</attribute>
		<attribute name="defaultdir" get="1" set="1" type="symbol" size="1">
			<digest>
				Default directory
			</digest>
			<description>
				The default directory for writing files (default = default path)
			</description>
		</attribute>
		<attribute name="coldelim" get="1" set="1" type="symbol" size="1">
			<digest>
				Column delimiter
			</digest>
			<description>
				The column delimiter (default = tab)
			</description>
			<attributelist>
				<attribute name="basic" get="1" set="1" type="atom" size="1" value="1" />
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Behavior" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Column Delimiter" />
			</attributelist>
		</attribute>
		<attribute name="planedelim" get="1" set="1" type="symbol" size="1">
			<digest>
				Matrix plane delimiter
			</digest>
			<description>
				The matrix plane delimiter (default = space)
			</description>
			<attributelist>
				<attribute name="basic" get="1" set="1" type="atom" size="1" value="1" />
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Behavior" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Plane Delimiter" />
			</attributelist>
		</attribute>
		<attribute name="precision" get="1" set="1" type="int" size="1">
			<digest>
				Floating-point precision
			</digest>
			<description>
				The number of characters of floating-point precision (default = 6)
			</description>
			<attributelist>
				<attribute name="basic" get="1" set="1" type="atom" size="1" value="1" />
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Behavior" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Precision (Decimal Places)" />
			</attributelist>
		</attribute>
		<attribute name="rowdelim" get="1" set="1" type="symbol" size="1">
			<digest>
				Row delimiter
			</digest>
			<description>
				The row delimiter (default = carriage return)
			</description>
			<attributelist>
				<attribute name="basic" get="1" set="1" type="atom" size="1" value="1" />
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Behavior" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Row Delimiter" />
			</attributelist>
		</attribute>
		<attribute name="writemode" get="1" set="1" type="int" size="1">
			<digest>
				Data write mode
			</digest>
			<description>
				Data write mode (default = 0 (integer))
				<br />
				0 = integers used when writing matrix values
				<br />
				1 = floats used when writing matrix values
			</description>
			<attributelist>
				<attribute name="basic" get="1" set="1" type="atom" size="1" value="1" />
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Behavior" />
				<attribute name="enumvals" get="1" set="1" type="atom" size="2">
					<enumlist>
						<enum name="Integer">
							<digest>
								TEXT_HERE
							</digest>
							<description>
								TEXT_HERE
							</description>
						</enum>
						<enum name="Floating-Point">
							<digest>
								TEXT_HERE
							</digest>
							<description>
								TEXT_HERE
							</description>
						</enum>
					</enumlist>
				</attribute>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Write Mode" />
				<attribute name="style" get="1" set="1" type="symbol" size="1" value="enumindex" />
			</attributelist>
		</attribute>
	</attributelist>
	<jitterattributelist>
		<jitterattribute name="outputmode" />
		<jitterattribute name="out_name" />
		<jitterattribute name="type" />
		<jitterattribute name="dim" />
		<jitterattribute name="planecount" />
	</jitterattributelist>
	<!--EXAMPLE-->
	<examplelist>
		<example img="jit.fprint.png" />
	</examplelist>
	<!--SEEALSO-->
	<seealsolist>
		<seealso name="jit.print" />
		<seealso name="jit.textfile" />
	</seealsolist>
</c74object>
