<?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.uldl" module="jit" category="Jitter Utilities">
	<digest>
		Internet upload/download
	</digest>
	<description>
		The <o>jit.uldl</o> object provides asynchronous file upload and download. Download is possible from <b>http://</b>, <b>https://</b>, <b>ftp://</b>, and <b>file:///</b> URLs. Upload is only possible to <b>ftp://</b> URLs.
	</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="INLET_TYPE">
			<digest>
				messages in
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
		<inlet id="1" type="INLET_TYPE">
			<digest>
				messages in
			</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="0" matrixoutputcount="1">
		<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="abort">
			<arglist />
			<digest>
				Abort an upload/download
			</digest>
			<description>
				Aborts a download or upload operation in progress.
			</description>
		</method>
		<method name="download">
			<arglist>
				<arg name="URL" optional="1" type="symbol" />
			</arglist>
			<digest>
				Begin downloading
			</digest>
			<description>
				Begins a download operation from the URL specified in the argument. Any data is downloaded to the default path or the directory specified by the <at>defaultdir</at> attribute. If no argument is given, download begins from the URL specified by the <at>url_dl</at> attribute. If the argument <i>matrix</i> is given, data will be downloaded to a Jitter matrix, and output via the <o>jit.uldl</o> object's left (matrix) outlet.
			</description>
		</method>
		<method name="upload">
			<arglist>
				<arg name="local-file" type="symbol" />
				<arg name="URL" optional="1" type="symbol" />
			</arglist>
			<digest>
				Begin uploading
			</digest>
			<description>
				Begins an upload operation from the local file specified by the first argument, to the URL specified in the second argument. If no second argument is given, upload is to the URL specified by the <at>url_ul</at> attribute.
			</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="defaultdir" get="1" set="1" type="symbol" size="1">
			<digest>
				Default download directory
			</digest>
			<description>
				The default download directory (default = default path)
			</description>
		</attribute>
		<attribute name="convert" get="1" set="1" type="int" size="1">
			<digest>
				Convert line breaks to Macintosh-style line breaks
			</digest>
			<description>
				When the flag is set (the default), the <o>jit.uldl</o> object will convert the line breaks in downloaded data (DOS or Unix-style) to Macintosh-style line breaks.
			</description>
		</attribute>
		<attribute name="dir_list" get="1" set="1" type="int" size="1">
			<digest>
				List remote directories flag
			</digest>
			<description>
				List remote directories flag (FTP-only, default = 0)
				<br />
				When the flag is set, the <o>jit.uldl</o> object will attempt to list the contents of a remote directory, if the URL specifies one. This feature is only available for FTP URLs.
				<p />
				WINDOWS USERS: This functionality is not currently available.
			</description>
		</attribute>
		<attribute name="dirlist" get="1" set="1" type="int" size="1">
			<digest>
				List remote directories flag
			</digest>
			<description>
				List remote directories flag (FTP-only, default = 0)
				<br />
				Duplicates the functionality of the dir_list attribute.
			</description>
		</attribute>
		<attribute name="passive" get="1" set="1" type="int" size="1">
			<digest>
				FTP passive mode flag
			</digest>
			<description>
				When the flag is set (the default) FTP connections will be made using passive mode.
			</description>
		</attribute>
		<attribute name="password" get="1" set="1" type="symbol" size="1">
			<digest>
				Password, if required
			</digest>
			<description>
				The password, if required
			</description>
		</attribute>
		<attribute name="percent" get="1" set="1" type="int" size="1">
			<digest>
				Upload/download percent report flag
			</digest>
			<description>
				Upload/download percent report flag (default = 0)
				<br />
				When the flag is set, the periodic indications of a download operation's progress (as a floating point number between 0 and 1) are reported from the right outlet.
			</description>
		</attribute>
		<attribute name="report" get="1" set="1" type="int" size="1">
			<digest>
				Upload/download status report flag
			</digest>
			<description>
				The upload/download status report flag (default = 0)
				<br />
				When the flag is set, periodic status data is sent out the right outlet during data transfer operations.
			</description>
		</attribute>
		<attribute name="url_dl" get="1" set="1" type="symbol" size="1">
			<digest>
				Download URL
			</digest>
			<description>
				The download URL (default = [none])
			</description>
		</attribute>
		<attribute name="url_ul" get="1" set="1" type="symbol" size="1">
			<digest>
				Upload URL
			</digest>
			<description>
				The upload URL (default = [none])
			</description>
		</attribute>
		<attribute name="urldl" get="1" set="1" type="symbol" size="1">
			<digest>
				Download URL
			</digest>
			<description>
				The download URL (default = [none])
			</description>
		</attribute>
		<attribute name="urlul" get="1" set="1" type="symbol" size="1">
			<digest>
				Upload URL
			</digest>
			<description>
				The upload URL (default = [none])
			</description>
		</attribute>
		<attribute name="username" get="1" set="1" type="symbol" size="1">
			<digest>
				Username, if needed for upload and download
			</digest>
			<description>
				The username, if needed for upload and download (default = [none])
			</description>
		</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.uldl.png" />
	</examplelist>
	<!--SEEALSO-->
	<seealsolist>
		<seealso name="jit.qt.movie">
			Play or edit a QuickTime movie
		</seealso>
		<seealso name="jit.textfile">
			Read and write a matrix as an ASCII text file
		</seealso>
	</seealsolist>
</c74object>
