<?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="mc.number~" module="msp" category="MSP U/I">
	<digest>
		Multichannel signal monitor and constant generator
	</digest>
	<description>
		Use the <o>mc.number~</o> object to display or generate multichannel signal values.
	</description>
	<!--METADATA-->
	<metadatalist>
		<metadata name="author">
			Cycling '74
		</metadata>
		<metadata name="tag">
			MSP
		</metadata>
		<metadata name="tag">
			mc
		</metadata>
	</metadatalist>
	<!--INLETS-->
	<inletlist>
		<inlet id="0" type="multi-channel signal">
			<digest>
				Input to Display
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
		<inlet id="1" type="float">
			<digest>
				Output ramp time in Milliseconds
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
	</inletlist>
	<!--OUTLETS-->
	<outletlist>
		<outlet id="0" type="multi-channel signal">
			<digest>
				Entered or received float values as a multichannel signal
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
		<outlet id="1" type="float">
			<digest>
				Sampled values from incoming signal
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
		<outlet id="2" type="float">
			<digest>
				Output Channel for Signal Value
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
	</outletlist>
	<palette category="Audio" action="number~" pic="number~.svg" />
	<!--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="bang">
			<arglist />
			<digest>
				Does nothing
			</digest>
			<description>
				The <m>bang</m> message currently has no effect.
			</description>
		</method>
		<method name="int">
			<arglist>
				<arg name="input-value or ramp-time" type="int" optional="0" />
			</arglist>
			<digest>
				Function depends on inlet
			</digest>
			<description>
				Converted to <m>float</m>.
			</description>
		</method>
		<method name="float">
			<arglist>
				<arg name="input-value or ramp-time" type="float" optional="0" />
			</arglist>
			<digest>
				Function depends on inlet
			</digest>
			<description>
				In left inlet: The value becomes a constant signal for the currently displayed channel in the multichannel output. When <o>mc.number~</o> is in signal output mode, the value is displayed. If the ramp time is non-zero, the output signal will ramp between its previous value and the newly set value.
				<br />
				In right inlet: Sets a ramp time in milliseconds. The default time is 0.
			</description>
		</method>
		<method name="list">
			<arglist>
				<arg name="input-value" optional="0" type="number" />
				<arg name="ramp-time" optional="0" units="ms" type="int" />
			</arglist>
			<digest>
				Set a signal value and ramp time
			</digest>
			<description>
				The first number sets a constant value for the output signal (see the <m>float</m> message above for details), and the second number sets the ramp time in milliseconds.
			</description>
		</method>
		<method name="allow">
			<arglist>
				<arg name="display-mode-availability" optional="0" type="int" />
			</arglist>
			<digest>
				Set allowable display modes
			</digest>
			<description>
				The word <m>allow</m>, followed by a number, sets what display modes can be used. <m>allow 1</m> restricts <o>mc.number~</o> to signal output display mode. <m>allow 2</m> restricts <o>mc.number~</o> to input monitor display mode. <m>allow 3</m> (the default) premits the use of both modes, and lets you click on the icon at the left side of the object to switch between them.
			</description>
		</method>
		<method name="flags">
			<arglist>
				<arg name="appearance/behavior" optional="0" type="int" />
			</arglist>
			<digest>
				Legacy support
			</digest>
			<description>
				The <m>flags</m> message is provided for legacy support of the <o>mc.number~</o> object; all the original functionality is now provided by object attributes.
			</description>
		</method>
		<method name="ft1">
			<arglist>
				<arg name="ramp time" optional="0" type="float" />
			</arglist>
			<digest>
				Set the ramp time
			</digest>
			<description>
				In right inlet: Sets a ramp time in milliseconds. The default time is 0.
			</description>
		</method>
		<method name="max">
			<arglist>
				<arg name="maximum value" optional="0" type="number" />
			</arglist>
			<digest>
				Sets a maximum output value
			</digest>
			<description>
				The word <m>max</m>, followed by an optional number, sets the maximum value of <o>mc.number~</o> for signal output. The word <m>max</m> with no arguments clears any previously set maximum value.
			</description>
		</method>
		<method name="min">
			<arglist>
				<arg name="minimum value" optional="0" type="number" />
			</arglist>
			<digest>
				Set a minimum output value
			</digest>
			<description>
				The word <m>min</m>, followed by an optional number, sets the minimum value of <o>number~</o> for signal output. The word <m>min</m> with no arguments clears any previously set minimum value.
			</description>
		</method>
		<method name="mode">
			<arglist>
				<arg name="display-mode" optional="0" type="int" />
			</arglist>
			<digest>
				Set the current display mode
			</digest>
			<description>
				The word <m>mode</m>, followed by a number, sets the current display mode, if it is currently allowed (see the <m>allow</m> message). <m>mode 1</m> sets signal output mode. <m>mode 2</m> sets signal input monitor mode.
			</description>
		</method>
		<method name="(mouse)">
			<digest>
				Switch display modes
			</digest>
			<description>
				Click on the icon at the left side of <o>number~</o> to switch between <i>signal monitor mode</i> (wave) and <i>signal output mode</i> (arrow). When in signal output mode, click on the number to highlight it for typing. Scroll on the number to change it. In either mode, click the dots below the number to choose a channel value to display.
			</description>
		</method>
		<method name="set">
			<arglist>
				<arg name="set input" optional="0" type="float" />
			</arglist>
			<digest>
				Display a number without causing output
			</digest>
			<description>
				The word <m>set</m> followed by a number sets the <o>mc.number~</o> object to display that number in signal output mode without causing output.
			</description>
		</method>
		<method name="signal">
			<arglist />
			<digest>
				Multichannel signal input to be displayed and input
			</digest>
			<description>
				<o>mc.number~</o> samples values from a connected multichannel signal at a rate specified by its <at>interval</at> attribute. Sampled values are sent out the middle outlet, preceded by a channel index out the right outlet. When <o>mc.number~</o> is in <i>signal monitor mode</i>, it displays sampled values for the currently selected display channel.
			</description>
		</method>
	</methodlist>
	<!--ATTRIBUTES-->
	<attributelist>
		<attribute name="bgcolor" get="1" set="1" type="float" size="4">
			<digest>
				Background color
			</digest>
			<description>
				TEXT_HERE
			</description>
			<attributelist>
				<attribute name="attr_attr_save" get="1" set="1" type="int" size="1" value="1" />
				<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="Color" />
				<attribute name="dynamiccolor_default" get="1" set="1" type="symbol" size="1" value="bgcolor" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Background Color" />
				<attribute name="legacydefault" get="1" set="1" type="float" size="4" value="0.97 0.97 0.97 1." />
				<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="rect_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="bgcolor2" get="1" set="1" type="atom" size="1">
			<digest>
				TEXT_HERE
			</digest>
			<description>
				TEXT_HERE
			</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>
				TEXT_HERE
			</digest>
			<description>
				TEXT_HERE
			</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="chans" get="1" set="1" type="int" size="1">
			<digest>
				Fixed channel count
			</digest>
			<description>
				When the value of <at>chans</at> is non-zero the <o>mc.number~</o> object displays and outputs a fixed number of channels regardless of the number of channels in a connected multichannel signal. When <at>chans</at> is 0 (the default), the object auto-adapts to the channel count of the connected multichannel signal.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="symbol" size="1" value="Behavior" />
				<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="Channels" />
				<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" />
			</attributelist>
		</attribute>
		<attribute name="color" get="1" set="1" type="float" size="4">
			<digest>
				Channel color
			</digest>
			<description>
				Sets the color of the active channel indicator.
			</description>
			<attributelist>
				<attribute name="attr_attr_save" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="category" get="1" set="1" type="symbol" size="1" value="Color" />
				<attribute name="dynamiccolor_default" get="1" set="1" type="symbol" size="1" value="color" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Channel 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="displaychan" get="1" set="1" type="int" size="1">
			<digest>
				Display channel
			</digest>
			<description>
				The <at>displaychan</at> attribute sets the currently selected channel for display in either signal monitor mode or signal output mode. In addition, the value of <at>displaychan</at> attribute determines the output channel whose value will be set by numbers sent to the object's left inlet.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="symbol" size="1" value="Appearance" />
				<attribute name="default" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Display Channel" />
				<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" />
			</attributelist>
		</attribute>
		<attribute name="ft1" get="1" set="1" type="float" size="1">
			<digest>
				Output signal ramp time
			</digest>
			<description>
				The <at>ft1</at> attribute sets the ramp time of the output signal in milliseconds. The default time is 0.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Value" />
				<attribute name="default" get="1" set="1" type="float" size="1" value="0." />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Ramp Time in Milliseconds" />
				<attribute name="save" get="1" set="1" type="int" size="1" value="1" />
			</attributelist>
		</attribute>
		<attribute name="hbgcolor" get="1" set="1" type="atom" size="1">
			<digest>
				TEXT_HERE
			</digest>
			<description>
				TEXT_HERE
			</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="htextcolor" get="1" set="1" type="atom" size="1">
			<digest>
				TEXT_HERE
			</digest>
			<description>
				TEXT_HERE
			</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="interval" get="1" set="1" type="float" size="1">
			<digest>
				Display update interval
			</digest>
			<description>
				Sets the <o>mc.number~</o> object's display update rate (in milliseconds). This is also the rate at which the connected multichannel signal is sampled and output as float values out the object's middle outlet.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Value" />
				<attribute name="default" get="1" set="1" type="float" size="1" value="100." />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Update Interval in Milliseconds" />
				<attribute name="save" get="1" set="1" type="int" size="1" value="1" />
			</attributelist>
		</attribute>
		<attribute name="maximum" get="1" set="1" type="atom" size="1">
			<digest>
				Maximum display and output value
			</digest>
			<description>
				Sets the maximum value that can be displayed or output.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Value" />
				<attribute name="default" get="1" set="1" type="atom" size="1" value="&lt;none&gt;" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Maximum" />
				<attribute name="order" get="1" set="1" type="int" size="1" value="2" />
				<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" />
			</attributelist>
		</attribute>
		<attribute name="minimum" get="1" set="1" type="atom" size="1">
			<digest>
				Minimum display and output value
			</digest>
			<description>
				Sets the minimum value that can be displayed or output.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Value" />
				<attribute name="default" get="1" set="1" type="atom" size="1" value="&lt;none&gt;" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Minimum" />
				<attribute name="order" get="1" set="1" type="int" size="1" value="1" />
				<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" />
			</attributelist>
		</attribute>
		<attribute name="monitormode" get="1" set="1" type="int" size="1">
			<digest>
				Enable signal monitor mode
			</digest>
			<description>
				The <at>monitormode</at> attribute enables or disables signal monitor mode.
			</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="Mode" />
				<attribute name="default" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Permit Signal Monitor Mode" />
				<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="numdecimalplaces" get="1" set="1" type="int" size="1">
			<digest>
				Number of Decimal Places
			</digest>
			<description>
				Sets the number of decimal places shown for a displayed or entered value.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="symbol" size="1" value="Appearance" />
				<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="Number of Decimal Places" />
				<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" />
			</attributelist>
		</attribute>
		<attribute name="sigoutmode" get="1" set="1" type="int" size="1">
			<digest>
				Enable signal output mode
			</digest>
			<description>
				The <at>sigoutmode</at> attribute enables or disables signal output mode.
			</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="Mode" />
				<attribute name="default" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Permit Signal Output Mode" />
				<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="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="default" get="1" set="1" type="symbol" size="1" value="" />
				<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>
		<attribute name="textcolor" get="1" set="1" type="float" size="4">
			<digest>
				Number value text color
			</digest>
			<description>
				Sets the color for the <o>mc.number~</o> object's number values. The <m>textcolor</m> attribute is mapped to the <m>textcolor_inverse</m>  <link module="core" name="maxcolor" type="vignette">style color</link>.
			</description>
			<attributelist>
				<attribute name="attr_attr_save" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Color" />
				<attribute name="dynamiccolor_default" get="1" set="1" type="symbol" size="1" value="textcolor_inverse" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Text Color" />
				<attribute name="legacydefault" get="1" set="1" type="float" size="4" value="0. 0. 0. 1." />
				<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="set" get="1" set="1" type="pointer" size="1" value="pointer" />
				<attribute name="style" get="1" set="1" type="symbol" size="1" value="rgba" />
				<attribute name="stylemap" get="1" set="1" type="symbol" size="1" value="textcolor_inverse" />
			</attributelist>
		</attribute>
	</attributelist>
	<!--EXAMPLE-->
	<examplelist>
		<example caption="" img="" />
	</examplelist>
	<!--SEEALSO-->
	<seealsolist>
		<seealso name="mc_visualization" module="core" type="vignette" />
		<seealso name="number~" />
		<seealso name="line~" />
		<seealso name="sig~" />
		<seealso name="snapshot~" />
		<seealso name="14_analysischapter01" module="msp" type="tutorial" />
	</seealsolist>
	<discussion>
		The <o>mc.number~</o> object operates in two different modes. Switch modes by clicking on the icon on the left side of the object box.
		<br />
		<br />
		In <i>signal monitor mode</i> (denoted by a wave) it displays the value of the multichannel signal connected to its left inlet. Click one of the dots below the number to select an input channel for display.
		<br />
		<br />
		In <i>signal output mode</i> (denoted by a downward arrow), <o>mc.number~</o> displays a value received in the left inlet or entered into the object box. This number also becomes a constant signal value for a channel in <o>mc.number~</o>'s multichannel signal output. Highlight the object for typing by clicking on the number, or scroll on the number to change its value. Click one of the dots below the number display to select a channel for generating a signal.
	</discussion>
	<misc name="Output">
		<entry name="signal">
			<description>
				Out left outlet: When audio is on, <o>mc.number~</o> outputs a multichannel signal consisting of constant values, set by values in signal output mode or received in its left inlet. If a non-zero ramp time is set, changes in output will ramp from previous to new values over the specified time.
			</description>
		</entry>
		<entry name="float">
			<description>
				Out middle outlet: Samples of the input multichannel signal are sent out at a rate specified by the <at>interval</at> attribute.
			</description>
		</entry>
		<entry name="float">
			<description>
				Out right outlet: Immediately preceding sample output from the middle outlet, <o>mc.number~</o> outputs the channel index of the sampled signal value.
			</description>
		</entry>
	</misc>
</c74object>
