<?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.textfile" module="jit" category="Jitter Strings">
	<digest>
		Read and write a matrix as an ASCII text file
	</digest>
	<description>
		The <o>jit.textfile</o> object maintains a text buffer, into which a text file or <m>char</m> matrix can be imported. The buffer can also be edited directly by double-clicking on the object to open an editor window. A <m>bang</m> to the object causes the text buffer to be sent out the left outlet as a matrix.
	</description>
	<!--METADATA-->
	<metadatalist>
		<metadata name="author">
			Cycling '74
		</metadata>
		<metadata name="tag">
			Jitter
		</metadata>
		<metadata name="tag">
			Jitter Strings
		</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>
				out2
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
		<outlet id="2" type="matrix">
			<digest>
				dumpout
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
	</outletlist>
	<!--MOP-->
	<mop matrixinputcount="1" matrixoutputcount="2">
		<matrixoutput name="out" planelink="1" typelink="1" dimlink="1" minplanecount="1" maxplanecount="1" mindimcount="1" maxdimcount="32">
			<types>
				char
			</types>
		</matrixoutput>
		<matrixoutput name="out2" planelink="1" typelink="1" dimlink="1" minplanecount="1" maxplanecount="1" mindimcount="1" maxdimcount="32">
			<types>
				char
			</types>
		</matrixoutput>
	</mop>
	<!--MESSAGES-->
	<methodlist>
		<method name="(mouse)">
			<digest>
				Double-click to open an editor window
			</digest>
			<description>
				Double-clicking on the object opens a text editor window with the current contents of the text buffer.
			</description>
		</method>
		<method name="erase">
			<arglist />
			<digest>
				Clear the object's text buffer
			</digest>
			<description>
				Clear the object's text buffer.
			</description>
		</method>
		<method name="line">
			<arglist>
				<arg name="line-number" type="int" />
			</arglist>
			<digest>
				Output a line as a string matrix
			</digest>
			<description>
				Sends the line specified by the argument out the middle outlet of the object as a string matrix (1 dimensional char matrix, 0 terminated) that can be used by the <m>jit.str.</m> set of objects. Line numbering starts at 1.
			</description>
		</method>
		<method name="open">
			<arglist />
			<digest>
				Open a text editor window
			</digest>
			<description>
				Opens the text editor window. Sending this message is equivalent to double-clicking on the object.
			</description>
		</method>
		<method name="outputline">
			<arglist />
			<digest>
				Sends the matrix out the middle outlet
			</digest>
			<description>
				Sends the matrix out the middle outlet. This is equivalent to the <m>outputmatrix</m> message, but uses to the middle outlet rather than the left outlet. (For this object, the <m>outputmatrix</m> message refers only to the left outlet).
			</description>
		</method>
		<method name="read">
			<arglist>
				<arg name="filename" optional="1" type="symbol" />
			</arglist>
			<digest>
				Read in a text file
			</digest>
			<description>
				Reads a text file from disk if a filename is specified. Otherwise, an file dialog box will appear so that a text file can be specified.
			</description>
		</method>
		<method name="wclose">
			<arglist />
			<digest>
				Close the edit window
			</digest>
			<description>
				Closes the editor window, if open.
			</description>
		</method>
		<method name="write">
			<arglist>
				<arg name="filename" optional="1" type="symbol" />
			</arglist>
			<digest>
				Write the text buffer to a disk file
			</digest>
			<description>
				Writes the object's text buffer to a disk file. The optional argument specifies a file name.
			</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="autoclear" get="1" set="1" type="int" size="1">
			<digest>
				Matrix clear following output flag
			</digest>
			<description>
				Matrix clear following output flag (default = 1)
			</description>
			<attributelist>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Auto Clear" />
			</attributelist>
		</attribute>
		<attribute name="defaultdir" get="1" set="1" type="symbol" size="1">
			<digest>
				Default directory for writing files
			</digest>
			<description>
				The default directory for writing files (default = default path)
			</description>
		</attribute>
		<attribute name="convert" get="1" set="1" type="int" size="1">
			<digest>
				Convert line breaks flag
			</digest>
			<description>
				Convert line breaks flag (default = 1) When the flag is set, UNIX/DOS line breaks are converted to Macintosh format when reading a file from disk.
			</description>
		</attribute>
		<attribute name="title" get="1" set="1" type="symbol" size="1">
			<digest>
				Text editor window title
			</digest>
			<description>
				Sets the title for the text editor window
			</description>
		</attribute>
	</attributelist>
	<jitterattributelist>
		<jitterattribute name="outputmode" />
		<jitterattribute name="adapt" />
		<jitterattribute name="out_name" />
		<jitterattribute name="type" />
		<jitterattribute name="dim" />
		<jitterattribute name="planecount" />
		<jitterattribute name="out2_name" />
		<jitterattribute name="out2_type" />
		<jitterattribute name="out2_dim" />
		<jitterattribute name="out2_planecount" />
	</jitterattributelist>
	<!--EXAMPLE-->
	<examplelist>
		<example img="jit.textfile.png" />
	</examplelist>
	<!--SEEALSO-->
	<seealsolist>
		<seealso name="jit.fprint">
			Read and write a single matrix as a formatted text file
		</seealso>
		<seealso name="jit.matrix">
			The Jitter Matrix!
		</seealso>
		<seealso name="text">
			Format numbers as a text file
		</seealso>
		<seealso module="jit" name="jitterchapter20" type="tutorial" />
	</seealsolist>
	<discussion>
		In adapt mode, jit.textfile will analyze the file for carriage returns and deduce the probable width and height of the output matrix (always 1 plane 2 dimensional). String matrices can be output using the <m>line</m> message.
	</discussion>
</c74object>
