<?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="console" module="max" category="System">
	<digest>
		Console Output in Patcher
	</digest>
	<description>
		Mirror and filter messages to the Max window in your patcher.
	</description>
	<!--METADATA-->
	<metadatalist>
		<metadata name="author">
			Cycling '74
		</metadata>
		<metadata name="tag">
			TEXT_HERE
		</metadata>
	</metadatalist>
	<!--INLETS-->
	<inletlist>
		<inlet id="0" type="INLET_TYPE">
			<digest>
				Change Filter Attributes
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
		<inlet id="1" type="INLET_TYPE">
			<digest>
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
	</inletlist>
	<!--OUTLETS-->
	<outletlist>
		<outlet id="0" type="OUTLET_TYPE">
			<digest>
				Object Name
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
		<outlet id="1" type="OUTLET_TYPE">
			<digest>
				Message
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
		<outlet id="2" type="int">
			<digest>
				Message Type
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
	</outletlist>
	<!--ARGUMENTS-->
	<objarglist>
		<objarg id="0" name="OBJARG_NAME" type="OBJARG_TYPE" optional="0">
			<digest>
				TEXT_HERE
			</digest>
			<description>
				TEXT_HERE
			</description>
		</objarg>
	</objarglist>
	<!--MESSAGES-->
	<methodlist>
		<method name="clear">
			<arglist />
			<digest>
				Clear the Max Console
			</digest>
			<description>
				Sending the clear message to any <m>console</m> object will clear the entire contents of the Max console window.
			</description>
		</method>
		<method name="write">
			<arglist>
				<arg name="filepath" type="symbol" optional="1" />
			</arglist>
			<digest>
				Save Console Contents to Disk
			</digest>
			<description>
				Sending the message <m>write</m> to any console object will write the entire contents of the Max console to a text file, ignoring any filters. An optional argument allows you to specify the filepath. If no filepath is provided, a file browser window will open allowing you to specify the write location.
			</description>
		</method>
	</methodlist>
	<!--ATTRIBUTES-->
	<attributelist>
		<attribute name="classfilter" get="1" set="1" type="atom" size="1">
			<digest>
				Object Class Filter
			</digest>
			<description>
				Setting the <m>classfilter</m> causes the <o>console</o> object to only report messages from the object class specified. For example, <m>@classfilter print</m> will output anything reveived by print objects, but nothing else.
			</description>
			<attributelist>
				<attribute name="basic" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="category" get="1" set="1" type="symbol" size="1" value="Filters" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Object Class Filter" />
			</attributelist>
		</attribute>
		<attribute name="patcherfilter" get="1" set="1" type="atom" size="1">
			<digest>
				Patcher Filter
			</digest>
			<description>
				The <at>patcherfilter</at> attribute can be set to the name of any patcher to restrict output to console messages generated by that patch. You can set the patcherfilter to &quot;thispatcher&quot; to restrict output to messages generated by the patcher containing the <o>console</o> object.
			</description>
			<attributelist>
				<attribute name="basic" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="category" get="1" set="1" type="symbol" size="1" value="Filters" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Patcher Filter" />
			</attributelist>
		</attribute>
		<attribute name="showonlyerrors" get="1" set="1" type="int" size="1">
			<digest>
				Show Only Errors
			</digest>
			<description>
				Restrict output of the <o>console</o> object to error type essages only.
			</description>
			<attributelist>
				<attribute name="basic" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="category" get="1" set="1" type="symbol" size="1" value="Filters" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Show Only Errors" />
				<attribute name="style" get="1" set="1" type="symbol" size="1" value="onoff" />
			</attributelist>
		</attribute>
		<attribute name="textfilter" get="1" set="1" type="atom" size="1">
			<digest>
				Text Filter
			</digest>
			<description>
				The <at>textfilter</at> attribute requires a single word or string of words. When set, it filters by message contents, passing messages that match the entire filter string. Filter strings can be multi-element and do not require quotations. For example, <m>textfilter foo bar</m> will not find things with foo OR bar, it will find things with “foo bar”. Filtering includes the name of the object reporting the message.
			</description>
			<attributelist>
				<attribute name="basic" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="category" get="1" set="1" type="symbol" size="1" value="Filters" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Text Filter" />
			</attributelist>
		</attribute>
	</attributelist>
	<!--EXAMPLE-->
	<examplelist>
		<example caption="" img="" />
	</examplelist>
	<!--SEEALSO-->
	<seealsolist>
		<seealso name="print">
			Print any message in the Max Console
		</seealso>
		<seealso name="max_window" module="core" type="vignette" />
		<seealso name="console_preferences" module="core" type="vignette" />
	</seealsolist>
	<discussion>
		Conceptually it’s helpful to remember that there is a global list of all messages to the Max window. When you click the X in the Max window it clears everything. This is also what the clear message to console does. Similarly, the write message will write all the data regardless of the filter settings.
	</discussion>
</c74object>
