<?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="levelmeter~" module="msp" category="MSP U/I">
	<digest>
		RMS level meter
	</digest>
	<description>
		Use the <o>levelmeter~</o> when you need a signal level-meter with ballistics. The <o>meter~</o> object provides metering in a simpler and more compact form.
	</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="INLET_TYPE">
			<digest>
				signal to be monitored
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
	</inletlist>
	<!--OUTLETS-->
	<outletlist>
		<outlet id="0" type="OUTLET_TYPE">
			<digest>
				volume unit (dB)
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
	</outletlist>
	<palette category="Audio" action="levelmeter~" pic="levelmeter~.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>
				Display and output the most recent RMS amplitude
			</digest>
			<description>
				The RMS amplitude most recently calculated for an input signal is displayed and output by the needle of the on-screen level meter.
			</description>
		</method>
		<method name="int">
			<arglist>
				<arg name="input" optional="0" type="int" />
			</arglist>
			<digest>
				Set and output a dB value
			</digest>
			<description>
				An <m>int</m> sets dB value displayed and output by <o>levelmeter~</o>.
			</description>
		</method>
		<method name="clear">
			<arglist />
			<digest>
				Clear the memory
			</digest>
			<description>
				The word <m>clear</m> clears the FB delay stage memory.
			</description>
		</method>
		<method name="mode">
			<arglist>
				<arg name="operational-mode" optional="0" type="int" />
			</arglist>
			<digest>
				Set the operational mode of the <o>levelmeter~</o> object
			</digest>
			<description>
				The word <m>mode</m> followed by an integer between 0 and 5 will set the operational mode of <o>levelmeter~</o> as follows:
				<br />
				0 = &quot;fast&quot;(no ballistics or dB-offset)
				<br />
				1 = &quot;VU&quot; (attack = 330; release = 330; dB-offset = -20)
				<br />
				2 = &quot;DIN 45 406(IEC PPM type IIb)&quot;(attack = 10; release = 1500; dB-offset = -14)
				<br />
				3 = &quot;BBC (IEC PPM type IIa)&quot; (attack = 10; release = 3000; dB-offset = -14)
				<br />
				4 = &quot;Nordic (IEC PPM type I)&quot; (attack = 5; release = 2000; dB-offset = -14)
				<br />
				5 = &quot;EBU Digital&quot; (attack = 0; release = 1500; dB-offset = -14)
				<br />
				(Object defaults to &quot;fast&quot; mode.)
			</description>
		</method>
		<method name="signal">
			<arglist />
			<digest>
				Display the RMS amplitude of a signal
			</digest>
			<description>
				The RMS amplitude of the incoming signal is displayed by the needle of the on-screen level meter.
			</description>
		</method>
	</methodlist>
	<!--ATTRIBUTES-->
	<attributelist>
		<attribute name="attack" get="1" set="1" type="atom_long" size="1">
			<digest>
				Object attack time
			</digest>
			<description>
				The word <m>attack</m>, followed by a number, sets the <o>levelmeter~</o> object attack time, in milliseconds. The default is 0.
			</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="0" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Attack Time" />
				<attribute name="save" get="1" set="1" type="int" size="1" value="1" />
			</attributelist>
		</attribute>
		<attribute name="bgcolor" get="1" set="1" type="float" size="4">
			<digest>
				Background Color
			</digest>
			<description>
				Sets the background color in RGBA format.
			</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="legacydefault" get="1" set="1" type="float" size="4" value="0.94 0.94 0.94 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="coolcolor" get="1" set="1" type="float" size="4">
			<digest>
				Lower “cool” range color
			</digest>
			<description>
				Sets the RGBA values for the color for the lower “cool” range of the <o>levelmeter~</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.70588 0.82353 0.39126 1." />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Cool Color" />
				<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="fgcolor" 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="hotcolor" get="1" set="1" type="float" size="4">
			<digest>
				Hot Color
			</digest>
			<description>
				Sets the RGBA values for the color for the hot “overload” range of the <o>levelmeter~</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.86275 0.39126 0.39126 1." />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Hot Color" />
				<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>levelmeter~</o> display. The minimum update interval is 10 milliseconds, the maximum is 2 seconds, and the default is 100 milliseconds. This message also sets the rate at which <o>levelmeter~</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="20" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Polling Interval" />
				<attribute name="save" get="1" set="1" type="int" size="1" value="1" />
			</attributelist>
		</attribute>
		<attribute name="markercolor" get="1" set="1" type="float" size="4">
			<digest>
				Marker Color
			</digest>
			<description>
				Sets the marker color in RGBA format. The <m>markercolor</m> attribute is mapped to the <m>accentcolor</m>  <link module="core" name="maxcolor" type="vignette">style color</link>.
			</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="Marker 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="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" />
				<attribute name="stylemap" get="1" set="1" type="symbol" size="1" value="accentcolor" />
			</attributelist>
		</attribute>
		<attribute name="markers" get="1" set="1" type="int" size="8">
			<digest>
				DeciBel Marker Locations
			</digest>
			<description>
				Sets the numerical location for markers in the <o>levelmeter~</o> display (e.g. -60 -48 -36 -24 -12 -6 0 6 12).
			</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="9" value="-60 -48 -36 -24 -12 -6 0 6 12" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="DeciBel Marker Locations" />
				<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="markersused" get="1" set="1" type="int" size="1">
			<digest>
				Number of Markers Used
			</digest>
			<description>
				Sets the number of markers in the <o>levelmeter~</o> display.
			</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="9" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Number of Markers Used" />
				<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="needlecolor" get="1" set="1" type="float" size="4">
			<digest>
				Needle Color
			</digest>
			<description>
				Sets the RGBA values for the color for the needle of the <o>levelmeter~</o> object. The <m>needlecolor</m> attribute is mapped to the <m>color</m>  <link module="core" name="maxcolor" type="vignette">style color</link>.
			</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="Needle 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="preview" get="1" set="1" type="symbol" size="1" value="diagonal_line" />
				<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="offset" get="1" set="1" type="atom_long" size="1">
			<digest>
				deciBel offset
			</digest>
			<description>
				Sets the <o>levelmeter~</o> object display's deciBel offset.
			</description>
			<attributelist>
				<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="0" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="dB Offset" />
				<attribute name="save" get="1" set="1" type="int" size="1" value="1" />
			</attributelist>
		</attribute>
		<attribute name="overloadcolor" 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="range" get="1" set="1" type="atom_long" size="2">
			<digest>
				Display range
			</digest>
			<description>
				Sets the display range of the <o>levelmeter~</o> object. The default range is -40 dB to 12 dB.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Value" />
				<attribute name="default" get="1" set="1" type="atom_long" size="2" value="-60 12" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="DeciBel Range" />
				<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="release" get="1" set="1" type="atom_long" size="1">
			<digest>
				Release time (ms)
			</digest>
			<description>
				Sets the <o>levelmeter~</o> object release time, in milliseconds. The default is 0.
			</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="0" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Release Time" />
				<attribute name="save" get="1" set="1" type="int" size="1" value="1" />
			</attributelist>
		</attribute>
		<attribute name="rounded" 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="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="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="warmcolor" get="1" set="1" type="float" size="4">
			<digest>
				Middle “warm” range color
			</digest>
			<description>
				Sets the RGBA values for the color for the middle “warm” range of the <o>levelmeter~</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.86275 0.58824 0.31373 1." />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Warm Color" />
				<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="levelmeter~.png" caption="levelmeter~ displays and sends out the RMS amplitude of a signal in deciBels" />
	</examplelist>
	<!--SEEALSO-->
	<seealsolist>
		<seealso name="average~" />
		<seealso name="meter~" />
		<seealso name="scope~" />
		<seealso name="14_analysischapter01" module="msp" type="tutorial" />
	</seealsolist>
	<misc name="Output">
		<entry name="float">
			<description>
				The RMS (root mean square) value in deciBels of the signal for the current update interval is sent out the outlet when audio processing is on.
			</description>
		</entry>
	</misc>
</c74object>
