<?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="ezdac~" module="msp" category="MSP I/O, MSP U/I">
	<digest>
		Audio output and on/off button
	</digest>
	<description>
		<o>ezdac~</o> works as a user interface version of the <o>dac~</o> object. It appears as a button which can be clicked with the mouse to turn audio on or off.
	</description>
	<!--METADATA-->
	<metadatalist>
		<metadata name="author">
			Cycling '74
		</metadata>
		<metadata name="tag">
			MSP
		</metadata>
		<metadata name="tag">
			MSP I/O
		</metadata>
		<metadata name="tag">
			MSP U/I
		</metadata>
	</metadatalist>
	<!--INLETS-->
	<inletlist>
		<inlet id="0" type="signal">
			<digest>
				(signal) start/stop, Audio Out Ch 1
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
		<inlet id="1" type="signal">
			<digest>
				(signal) Audio Out Ch 2
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
	</inletlist>
	<palette category="Audio" action="ezdac~" pic="ezdac~.svg" />
	<!--OUTLETS-->
	<!--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="int">
			<arglist>
				<arg name="on/off-flag" optional="0" type="int" />
			</arglist>
			<digest>
				Enable/disable audio processing
			</digest>
			<description>
				A non-zero number turns on audio processing in all loaded patches. <m>0</m> turns off audio processing in all loaded patches.
			</description>
		</method>
		<method name="list">
			<arglist>
				<arg name="output-channel-designations" optional="0" type="list" />
			</arglist>
			<digest>
				Set the logical output channels for each signal inlet
			</digest>
			<description>
				<m>list</m> comprised of integers, sets the logical output channels for each signal inlet in order from left to right.
			</description>
		</method>
		<method name="(mouse)">
			<digest>
				Click to enable/disable audio processing
			</digest>
			<description>
				Clicking on <o>ezdac~</o> toggles audio processing on or off. Audio on is represented by the object being highlighted.
			</description>
		</method>
		<method name="local">
			<arglist>
				<arg name="behavioral" optional="0" type="int" />
			</arglist>
			<digest>
				Enable audio processing in local patch and subpatches only
			</digest>
			<description>
				The word <m>local</m>, followed by <m>1</m>, makes a click to turn on an <o>ezdac~</o> object equivalent to sending it the <m>startwindow message</m>. The message <m>local 0</m> returns the <o>ezdac~</o> object to its default mode where a click to turn it on is equivalent to the <m>start</m> message.
			</description>
		</method>
		<method name="open">
			<arglist />
			<digest>
				Open the Audio Status window
			</digest>
			<description>
				Opens the Audio Status window. The window is also brought to the front.
			</description>
		</method>
		<method name="set">
			<arglist>
				<arg name="output-channel-designation" optional="0" type="int" />
			</arglist>
			<digest>
				Set the output channel for signal inlet where the <m>set</m> message was received
			</digest>
			<description>
				In any inlet: The word <m>set</m>, followed by a number, sets the logical output channel for the signal inlet in which the <m>set</m> message was received. For instance, sending <m>set 3</m> to the left inlet of <o>ezdac~</o> makes the signal coming in the left inlet output to logical output channel 3.
				<br />
				<br />
				Note that if the audio is on and you use the <m>set</m> message to change a <o>ezdac~</o> to use logical channels that are not currently in use, no sound will be heard from these channels until the audio is turned off and on again.
			</description>
		</method>
		<method name="signal">
			<arglist />
			<digest>
				Function depends on inlet
			</digest>
			<description>
				In left inlet: The signal is sent to audio output channel 1. The signal in each inlet must be between -1 and 1 to avoid clipping by the DAC.
				<br />
				<br />
				In right inlet: The signal is sent to audio output channel 2.
			</description>
		</method>
		<method name="start">
			<arglist />
			<digest>
				Turn on audio processing in all loaded patches.
			</digest>
			<description>
				Turns on audio processing in all loaded patches.
			</description>
		</method>
		<method name="startwindow">
			<arglist />
			<digest>
				Enable audio processing in local patch and subpatches only
			</digest>
			<description>
				Turns on audio processing only in the patch in which this <o>ezdac~</o> is located, and in subpatches of that patch. Turns off audio processing in all other patches.
			</description>
		</method>
		<method name="stop">
			<arglist />
			<digest>
				Turns off audio processing in all loaded patches.
			</digest>
			<description>
				Turns off audio processing in all loaded patches.
			</description>
		</method>
		<method name="wclose">
			<arglist />
			<digest>
				Close the Audio Status window
			</digest>
			<description>
				Closes the Audio Status window.
			</description>
		</method>
	</methodlist>
	<!--ATTRIBUTES-->
	<attributelist>
		<attribute name="bgcolor" get="1" set="1" type="float" size="4">
			<digest>
				Button background color
			</digest>
			<description>
				Sets the color of the <o>ezdac~</o> button background in RGBA format.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Color" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Background Color" />
				<attribute name="paint" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="preview" get="1" set="1" type="symbol" size="1" value="button_background" />
				<attribute name="save" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="set" get="1" set="1" type="pointer" size="1" value="pointer" />
				<attribute name="style" get="1" set="1" type="symbol" size="1" value="rgba" />
			</attributelist>
		</attribute>
		<attribute name="border" get="1" set="1" type="atom" size="1">
			<digest>
				Border color
			</digest>
			<description>
				Border size in pixels
			</description>
			<attributelist>
				<attribute name="invisible" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="obsolete" get="1" set="1" type="int" size="1" value="1" />
			</attributelist>
		</attribute>
		<attribute name="bordercolor" get="1" set="1" type="atom" size="1">
			<digest>
				Border color
			</digest>
			<description>
				Sets the border color in RGBA format.
			</description>
			<attributelist>
				<attribute name="invisible" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="obsolete" get="1" set="1" type="int" size="1" value="1" />
			</attributelist>
		</attribute>
		<attribute name="color" get="1" set="1" type="float" size="4">
			<digest>
				On Color
			</digest>
			<description>
				TEXT_HERE
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Color" />
				<attribute name="introduced" get="1" set="1" type="symbol" size="1" value="7.0.0" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="On Color" />
				<attribute name="paint" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="preview" get="1" set="1" type="symbol" size="1" value="circle_fill" />
				<attribute name="save" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="set" get="1" set="1" type="pointer" size="1" value="pointer" />
				<attribute name="style" get="1" set="1" type="symbol" size="1" value="rgba" />
			</attributelist>
		</attribute>
		<attribute name="elementcolor" get="1" set="1" type="float" size="4">
			<digest>
				Off Color
			</digest>
			<description>
				TEXT_HERE
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Color" />
				<attribute name="introduced" get="1" set="1" type="symbol" size="1" value="7.0.0" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Off Color" />
				<attribute name="paint" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="preview" get="1" set="1" type="symbol" size="1" value="circle_fill" />
				<attribute name="save" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="set" get="1" set="1" type="pointer" size="1" value="pointer" />
				<attribute name="style" get="1" set="1" type="symbol" size="1" value="rgba" />
			</attributelist>
		</attribute>
		<attribute name="local" get="1" set="1" type="int" size="1">
			<digest>
				Toggle audio processing in local patch and subpatches only
			</digest>
			<description>
				Toggles enabling/disabling audio input for the local window only in the patch in which this <o>ezdac~</o> is located, and in subpatches of that patch. Turns off audio processing in all other patches.
			</description>
			<attributelist>
				<attribute name="basic" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Value" />
				<attribute name="default" get="1" set="1" type="int" size="1" value="0" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Switch is Local" />
				<attribute name="paint" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="save" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="style" get="1" set="1" type="symbol" size="1" value="onoff" />
			</attributelist>
		</attribute>
		<attribute name="offgradcolor1" get="1" set="1" type="atom" size="1">
			<digest>
				First gradient button color in off position
			</digest>
			<description>
				Sets the first gradient color used in the <o>ezdac~</o> button in the off position in RGBA format.
			</description>
			<attributelist>
				<attribute name="invisible" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="obsolete" get="1" set="1" type="int" size="1" value="1" />
			</attributelist>
		</attribute>
		<attribute name="offgradcolor2" get="1" set="1" type="atom" size="1">
			<digest>
				Second gradient button color in off position
			</digest>
			<description>
				Sets the second gradient color used in the <o>ezdac~</o> button in the off position in RGBA format.
			</description>
			<attributelist>
				<attribute name="invisible" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="obsolete" get="1" set="1" type="int" size="1" value="1" />
			</attributelist>
		</attribute>
		<attribute name="ongradcolor1" get="1" set="1" type="atom" size="1">
			<digest>
				First gradient button color in on position
			</digest>
			<description>
				Sets the first gradient color used in the <o>ezdac~</o> button in the on position in RGBA format
			</description>
			<attributelist>
				<attribute name="invisible" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="obsolete" get="1" set="1" type="int" size="1" value="1" />
			</attributelist>
		</attribute>
		<attribute name="ongradcolor2" get="1" set="1" type="atom" size="1">
			<digest>
				Second gradient button color in on position
			</digest>
			<description>
				Sets the second gradient color used in the <o>ezdac~</o> button in the on position in RGBA format.
			</description>
			<attributelist>
				<attribute name="invisible" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="obsolete" get="1" set="1" type="int" size="1" value="1" />
			</attributelist>
		</attribute>
		<attribute name="style" get="1" set="1" type="symbol" size="1">
			<digest>
				Style
			</digest>
			<description>
				Sets the <link type="vignette" module="core" name="styles">style</link> to be applied to the object. Styles can be set using the <link type="vignette" module="core" name="format_palette">Format palette</link>.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="symbol" size="1" value="Appearance" />
				<attribute name="introduced" get="1" set="1" type="symbol" size="1" value="7.0.0" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Style" />
				<attribute name="paint" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="save" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="style" get="1" set="1" type="symbol" size="1" value="style" />
			</attributelist>
		</attribute>
	</attributelist>
	<!--EXAMPLE-->
	<examplelist>
		<example img="ezdac~.png" caption="Switch audio on and off, send signal to the audio outputs" />
	</examplelist>
	<!--SEEALSO-->
	<seealsolist>
		<seealso name="adstatus" />
		<seealso name="ezadc~" />
		<seealso name="adc~" />
		<seealso name="04_mspaudioio" module="msp" type="tutorial" />
		<seealso name="05_mspbasicchapter03" module="msp" type="tutorial" />
	</seealsolist>
	<misc name="Output">
		<entry name="Audio">
			<description>
				None. The signal received in the inlet is sent to the corresponding audio output channel.
			</description>
		</entry>
	</misc>
</c74object>
