<?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="meter~" module="msp" category="MSP U/I">
	<digest>
		Visual peak level indicator
	</digest>
	<description>
		Use the <o>meter~</o> object to monitor any signal in the range -1 and 1 (other signals should be scaled first).
	</description>
	<!--METADATA-->
	<metadatalist>
		<metadata name="author">
			Cycling '74
		</metadata>
		<metadata name="tag">
			MSP
		</metadata>
		<metadata name="tag">
			MSP U/I
		</metadata>
	</metadatalist>
	<!--INLETS-->
	<inletlist>
		<inlet id="0" type="signal">
			<digest>
				Input Between 0-1 to Meter
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
	</inletlist>
	<!--OUTLETS-->
	<outletlist>
		<outlet id="0" type="OUTLET_TYPE">
			<digest>
				Peak Value For Each Metering Interval
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
	</outletlist>
	<palette category="Audio" action="meter~" pic="meter~.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="int">
			<arglist>
				<arg name="input-peak-value" optional="0" type="int" />
			</arglist>
			<digest>
				Set the meter to display a value
			</digest>
			<description>
				Converted to <m>float</m>. A value will set the meter to react as though a signal with equal amplitude peak-value has been passed to its input. Corresponding LEDs will light up and the peak-level value will be passed out the outlet (0.0 will show silence, 0.0 through 1.0 will light up to any but the overload LED, and anything above 1.0 will light all LEDs including overload).
			</description>
		</method>
		<method name="float">
			<arglist>
				<arg name="input-peak-value" optional="0" type="float" />
			</arglist>
			<digest>
				Set the meter to display a value
			</digest>
			<description>
				A float value will set the meter to react as though a signal with equal amplitude peak-value has been passed to its input. Corresponding LEDs will light up and the peak-level value will be passed out the outlet (0.0 will show silence, 0.0 through 1.0 will light up to any but the overload LED, and anything above 1.0 will light all LEDs including overload).
			</description>
		</method>
		<method name="(mouse)">
			<digest>
				Click and drag to reorient the meter display
			</digest>
			<description>
				When the patcher window is unlocked, you can reorient a <o>meter~</o> from horizontal to vertical by dragging its resize area and changing its shape.
			</description>
			<attributelist>
				<attribute name="documentable" get="1" set="1" type="int" size="1" value="1" />
			</attributelist>
		</method>
		<method name="signal">
			<arglist />
			<digest>
				Display the peak amplitude
			</digest>
			<description>
				The peak amplitude of the incoming signal is displayed by the LEDs of the on-screen level meter.
			</description>
		</method>
	</methodlist>
	<!--ATTRIBUTES-->
	<attributelist>
		<attribute name="bgcolor" get="1" set="1" type="float" size="4">
			<digest>
				Background color
			</digest>
			<description>
				Sets the RGBA values for the background color of the <o>meter~</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="atom" size="1" value="Color" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Background Color" />
				<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="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="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="coldcolor" get="1" set="1" type="float" size="4">
			<digest>
				Cold signal color
			</digest>
			<description>
				Sets the RGBA values for the cold signal color of the <o>meter~</o> object.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Color" />
				<attribute name="default" get="1" set="1" type="float" size="4" value="0. 0.6 0. 1." />
				<attribute name="invisible" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Cold Signal Color" />
				<attribute name="obsolete" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="order" get="1" set="1" type="int" size="1" value="3" />
				<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="rgba" />
			</attributelist>
		</attribute>
		<attribute name="dbperled" get="1" set="1" type="int" size="1">
			<digest>
				dB amount per LED
			</digest>
			<description>
				Sets the amount of signal level in deciBels represented by each LED. By default each LED represents a 3dB change in volume from its neighboring LEDs.
			</description>
			<attributelist>
				<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="3" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="DeciBels per Led" />
				<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="hotcolor" get="1" set="1" type="float" size="4">
			<digest>
				LED hot range color
			</digest>
			<description>
				Sets the RGBA values for the LED color for the upper &quot;hot&quot; range of the <o>meter~</o> object.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Color" />
				<attribute name="default" get="1" set="1" type="float" size="4" value="1. 0.6 0. 1." />
				<attribute name="invisible" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Warning Signal Color" />
				<attribute name="obsolete" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="order" get="1" set="1" type="int" size="1" value="6" />
				<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="rgba" />
			</attributelist>
		</attribute>
		<attribute name="interval" get="1" set="1" type="atom_long" size="1">
			<digest>
				Update interval
			</digest>
			<description>
				Sets the update-time interval, in milliseconds, of the <o>meter~</o> display. The minimum update-interval is 10 milliseconds, the maximum is 2 seconds, and the default is 50 milliseconds. This message also sets the rate at which <o>meter~</o> sends out the peak value received in that time interval.
			</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="atom_long" size="1" value="50" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Refresh Interval in Milliseconds" />
				<attribute name="save" get="1" set="1" type="int" size="1" value="1" />
			</attributelist>
		</attribute>
		<attribute name="monotone" get="1" set="1" type="int" size="1">
			<digest>
				Monotone
			</digest>
			<description>
				Toggles single-color display for level indicators
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Color" />
				<attribute name="default" get="1" set="1" type="int" size="1" value="0" />
				<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="Monotone" />
				<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="nhotleds" get="1" set="1" type="int" size="1">
			<digest>
				Number of &quot;hot&quot; warning LEDs
			</digest>
			<description>
				Sets the total number &quot;hot&quot; warning LEDs displayed on the <o>meter~</o> object (corresponding to the color set by the <m>rgba2</m> message).
			</description>
			<attributelist>
				<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="3" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Number of Hot Leds" />
				<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="ntepidleds" get="1" set="1" type="int" size="1">
			<digest>
				Number of &quot;tepid&quot; mid-range LEDs
			</digest>
			<description>
				Sets the total number &quot;tepid&quot; mid-range LEDs displayed on the <o>meter~</o> object (corresponding to the color set by the <m>rgba5</m> message).
			</description>
			<attributelist>
				<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="3" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Number of Tepid Leds" />
				<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="numleds" get="1" set="1" type="int" size="1">
			<digest>
				Number of LEDS
			</digest>
			<description>
				The word <m>numleds</m>, followed by a number between 10 and 20, sets the total number of LEDs displayed on the <o>meter~</o> object. The range is 10-20 LEDs.
			</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="12" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Total Number of Leds" />
				<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="nwarmleds" get="1" set="1" type="int" size="1">
			<digest>
				Number of &quot;warm&quot; lower-mid-range LEDs
			</digest>
			<description>
				Sets the total number &quot;warm&quot; lower-mid-range LEDs displayed on the <o>meter~</o> object (corresponding to the color set by the <m>rgba4</m> message).
			</description>
			<attributelist>
				<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="3" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Number of Warm Leds" />
				<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="offcolor" get="1" set="1" type="float" size="4">
			<digest>
				Off Color
			</digest>
			<description>
				Sets the color for the &quot;off&quot; level indicators. The <m>offcolor</m> attribute is mapped to the <m>elementcolor</m>  <link module="core" name="maxcolor" type="vignette">style color</link>.
			</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="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="vertical_lines" />
				<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="elementcolor" />
			</attributelist>
		</attribute>
		<attribute name="oncolor" get="1" set="1" type="float" size="4">
			<digest>
				On Color
			</digest>
			<description>
				Sets the color for the &quot;on&quot; level indicators. The <m>oncolor</m> attribute is mapped to the <m>color</m>  <link module="core" name="maxcolor" type="vignette">style color</link>.
			</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="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="vertical_lines" />
				<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="color" />
			</attributelist>
		</attribute>
		<attribute name="overloadcolor" get="1" set="1" type="float" size="4">
			<digest>
				&quot;Over&quot; indicator color
			</digest>
			<description>
				Sets the RGBA values for the LED color for the &quot;over&quot; indicator of the <o>meter~</o> object.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Color" />
				<attribute name="default" get="1" set="1" type="float" size="4" value="1. 0. 0. 1." />
				<attribute name="invisible" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Overload Signal Color" />
				<attribute name="obsolete" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="order" get="1" set="1" type="int" size="1" value="7" />
				<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="rgba" />
			</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>
		<attribute name="tepidcolor" get="1" set="1" type="float" size="4">
			<digest>
				Lower-middle &quot;tepid&quot; range color
			</digest>
			<description>
				Sets the RGBA values for the LED color for the lower-middle &quot;tepid&quot; range of the <o>meter~</o> object.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Color" />
				<attribute name="default" get="1" set="1" type="float" size="4" value="0.6 0.73243 0. 1." />
				<attribute name="invisible" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Tepid Signal Color" />
				<attribute name="obsolete" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="order" get="1" set="1" type="int" size="1" value="4" />
				<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="rgba" />
			</attributelist>
		</attribute>
		<attribute name="warmcolor" get="1" set="1" type="float" size="4">
			<digest>
				Upper-middle &quot;warm&quot; range color
			</digest>
			<description>
				Sets the RGBA values for the LED color for upper-middle &quot;warm&quot; range of the <o>meter~</o> object.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Color" />
				<attribute name="default" get="1" set="1" type="float" size="4" value="0.8545 0.8545 0. 1." />
				<attribute name="invisible" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Warm Signal Color" />
				<attribute name="obsolete" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="order" get="1" set="1" type="int" size="1" value="5" />
				<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="rgba" />
			</attributelist>
		</attribute>
	</attributelist>
	<!--EXAMPLE-->
	<examplelist>
		<example img="meter~.png" caption="meter~ displays and sends out the peak amplitude of a signal" />
	</examplelist>
	<!--SEEALSO-->
	<seealsolist>
		<seealso name="average~" />
		<seealso name="scope~" />
		<seealso name="14_analysischapter01" module="msp" type="tutorial" />
	</seealsolist>
	<discussion>
		Each &quot;LED&quot; on the meter represents a change of 3dB from the previous step, by default. The red &quot;over&quot; LED comes on if the signal is greater than or equal to 1, and lasts for about a second. You can change the redrawing interval with the interval message. Resizing the meter gives its vertical or horizontal orientation, depending on whether its height is greater than its width or vice versa. <o>meter~</o> outputs the peak signal value received every redrawing interval. Additional appearance settings, such as number of LEDs, and their colors can be set using the object's Inspector.
	</discussion>
	<misc name="Output">
		<entry name="float">
			<description>
				The peak (absolute) value received in the previous update interval is sent out the outlet when audio processing is on.
			</description>
		</entry>
	</misc>
</c74object>
