<?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="live.meter~" module="m4l" category="M4L U/I">
	<digest>
		Live-style visual peak level indicator
	</digest>
	<description>
		<o>live.meter~</o> is a simple mono Live-style signal level meter that can be attached to any signal whose level is between -1 and 1 (other signals should be scaled first).
	</description>
	<!--METADATA-->
	<metadatalist>
		<metadata name="author">
			Cycling '74
		</metadata>
		<metadata name="tag">
			Live
		</metadata>
	</metadatalist>
	<!--INLETS-->
	<inletlist>
		<inlet id="0" type="float/signal">
			<digest>
				Input to Meter
			</digest>
			<description>
				(signal) Input Between 0-1 to Meter
			</description>
		</inlet>
	</inletlist>
	<!--OUTLETS-->
	<outletlist>
		<outlet id="0" type="float">
			<digest>
				Amplitude (in dB)
			</digest>
			<description>
				Peak Value For Each Metering Interval
			</description>
		</outlet>
	</outletlist>
	<palette category="Live" action="live.meter~" pic="live.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="signal-value" optional="0" type="int" />
			</arglist>
			<digest>
				Display an input value
			</digest>
			<description>
				Converted to <m>float</m>.
			</description>
		</method>
		<method name="float">
			<arglist>
				<arg name="signal-value" optional="0" type="float" />
			</arglist>
			<digest>
				Display an input value
			</digest>
			<description>
				When no signal is connected to the <o>live.meter~</o> object's inlet, a float number 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="db">
			<arglist>
				<arg name="db-value" optional="0" type="float" />
			</arglist>
			<digest>
				Display a deciBel input value
			</digest>
			<description>
				The word <m>db</m>, followed by a floating point number that specficies a deciBel value, will set the <o>live.meter~</o> object to react as though a signal with that dB peak-value has been passed to its input. Corresponding LEDs will light up and the value will be passed out the outlet.
			</description>
		</method>
		<method name="signal">
			<arglist />
			<digest>
				Display peak amplitude of the signal
			</digest>
			<description>
				The peak amplitude of the incoming signal is displayed by the on-screen level meter.
			</description>
		</method>
	</methodlist>
	<!--ATTRIBUTES-->
	<attributelist>
		<attribute name="active" get="1" set="1" type="int" size="1">
			<digest>
				Active mode enable
			</digest>
			<description>
				Enables (1) or disables (0) the meter display.
			</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="1" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Enabled" />
				<attribute name="paint" 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="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="category" get="1" set="1" type="atom" size="1" value="Color" />
				<attribute name="defaultname" get="1" set="1" type="float" size="4" value="0. 0.019608 0.078431 1." />
				<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="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="clip_size" get="1" set="1" type="int" size="1">
			<digest>
				Clip Size
			</digest>
			<description>
				Sets the clipping range for the display. The options are Normal or Extended.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Appearance" />
				<attribute name="default" get="1" set="1" type="int" size="1" value="0" />
				<attribute name="enumvals" get="1" set="1" type="atom" size="2">
					<enumlist>
						<enum name="Normal">
							<digest>
								TEXT_HERE
							</digest>
							<description>
								TEXT_HERE
							</description>
						</enum>
						<enum name="Extended">
							<digest>
								TEXT_HERE
							</digest>
							<description>
								TEXT_HERE
							</description>
						</enum>
					</enumlist>
				</attribute>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Clip Size" />
				<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="enumindex" />
			</attributelist>
		</attribute>
		<attribute name="coldcolor" get="1" set="1" type="float" size="4">
			<digest>
				Cold signal color
			</digest>
			<description>
				Sets the Cold signal color in RGBA format.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Color" />
				<attribute name="defaultname" get="1" set="1" type="float" size="4" value="0.047059 0.972549 0.392157 1." />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Cold Signal Color" />
				<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="display_range" get="1" set="1" type="float" size="2">
			<digest>
				Display Range (dB)
			</digest>
			<description>
				Sets the display range of the meter in dB.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Appearance" />
				<attribute name="default" get="1" set="1" type="float" size="2" value="-70. 6." />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Display Range (dB)" />
				<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>
				Warning signal color
			</digest>
			<description>
				Sets the Warning signal color in RGBA format.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Color" />
				<attribute name="defaultname" get="1" set="1" type="float" size="4" value="1. 0.756863 0.039216 1." />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Warning Signal Color" />
				<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="inactivecoldcolor" get="1" set="1" type="float" size="4">
			<digest>
				Inactive Cold signal color
			</digest>
			<description>
				Sets the Cold signal (inactive) color in RGBA format.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Color" />
				<attribute name="defaultname" get="1" set="1" type="float" size="4" value="0.509804 0.509804 0.509804 1." />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Inactive Cold Signal Color" />
				<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" />
				<attribute name="style" get="1" set="1" type="symbol" size="1" value="rgba" />
			</attributelist>
		</attribute>
		<attribute name="inactivewarmcolor" get="1" set="1" type="float" size="4">
			<digest>
				Inactive Warm signal color
			</digest>
			<description>
				Sets the Warm signal (inactive) color in RGBA format.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Color" />
				<attribute name="defaultname" get="1" set="1" type="float" size="4" value="0.584314 0.584314 0.584314 1." />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Inactive Warm Signal Color" />
				<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="interval" get="1" set="1" type="int" size="1">
			<digest>
				Sets the maximum update-time interval, in milliseconds, of the <o>live.meter~</o> display.
			</digest>
			<description>
				Sets the maximum update-time interval, in milliseconds, of the <o>live.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. The
				<a>
					threshold_db
				</a>
				or
				<a>
					threshold_linear
				</a>
				attributes are used to limit the refresh and the output, depending on the setting of the
				<a>
					mode
				</a>
				attribute.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Appearance" />
				<attribute name="default" get="1" set="1" type="int" size="1" value="20" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Maximum Refresh Interval in Milliseconds" />
				<attribute name="save" get="1" set="1" type="int" size="1" value="1" />
			</attributelist>
		</attribute>
		<attribute name="mode" get="1" set="1" type="int" size="1">
			<digest>
				Mode
			</digest>
			<description>
				Sets the display and output mode of the <o>live.meter~</o> object.
			</description>
			<attributelist>
				<attribute name="default" get="1" set="1" type="int" size="1" value="0" />
				<attribute name="enumvals" get="1" set="1" type="atom" size="2">
					<enumlist>
						<enum name="deciBel">
							<digest>
								TEXT_HERE
							</digest>
							<description>
								TEXT_HERE
							</description>
						</enum>
						<enum name="Linear">
							<digest>
								TEXT_HERE
							</digest>
							<description>
								TEXT_HERE
							</description>
						</enum>
					</enumlist>
				</attribute>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Mode" />
				<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="enumindex" />
			</attributelist>
		</attribute>
		<attribute name="orientation" get="1" set="1" type="int" size="1">
			<digest>
				Meter display orientation
			</digest>
			<description>
				Sets the orientation of the meter display. The options are Horizontal or Vertical
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Appearance" />
				<attribute name="default" get="1" set="1" type="int" size="1" value="0" />
				<attribute name="enumvals" get="1" set="1" type="atom" size="2">
					<enumlist>
						<enum name="Vertical">
							<digest>
								TEXT_HERE
							</digest>
							<description>
								TEXT_HERE
							</description>
						</enum>
						<enum name="Horizontal">
							<digest>
								TEXT_HERE
							</digest>
							<description>
								TEXT_HERE
							</description>
						</enum>
					</enumlist>
				</attribute>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Orientation" />
				<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="enumindex" />
			</attributelist>
		</attribute>
		<attribute name="overloadcolor" get="1" set="1" type="float" size="4">
			<digest>
				Overload signal color
			</digest>
			<description>
				Sets the Overload signal color in RGBA format.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Color" />
				<attribute name="defaultname" get="1" set="1" type="float" size="4" value="1. 0.039216 0.039216 1." />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Overload Signal Color" />
				<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="threshold_db" get="1" set="1" type="float" size="1">
			<digest>
				Redraw Threshold (dB)
			</digest>
			<description>
				When the <o>live.meter~</o> object's
				<a>
					mode
				</a>
				attribute is set to 0, this attribute sets the refresh threshold in deciBels. If the signal peak delta is greater than the threshold value, the object will be redrawn and the value sent out the outlet.
			</description>
			<attributelist>
				<attribute name="default" get="1" set="1" type="float" size="1" value="1." />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Redraw Threshold (dB)" />
				<attribute name="save" get="1" set="1" type="int" size="1" value="1" />
			</attributelist>
		</attribute>
		<attribute name="threshold_linear" get="1" set="1" type="float" size="1">
			<digest>
				Redraw Threshold (Linear)
			</digest>
			<description>
				When the <o>live.meter~</o> object's
				<a>
					mode
				</a>
				attribute is set to 1, this attribute sets the refresh threshold in deciBels. If the signal peak delta is greater than the threshold value, the object will be redrawn and the value sent out the outlet.
			</description>
			<attributelist>
				<attribute name="default" get="1" set="1" type="float" size="1" value="0.01" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Redraw Threshold (Linear)" />
				<attribute name="save" get="1" set="1" type="int" size="1" value="1" />
			</attributelist>
		</attribute>
		<attribute name="warmcolor" get="1" set="1" type="float" size="4">
			<digest>
				Warm signal color
			</digest>
			<description>
				Sets the Warm signal color in RGBA format.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Color" />
				<attribute name="defaultname" get="1" set="1" type="float" size="4" value="0.764706 0.972549 0.392157 1." />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Warm Signal Color" />
				<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="live.meter~.png" />
	</examplelist>
	<!--SEEALSO-->
	<seealsolist>
		<seealso name="average~" />
		<seealso name="meter~" />
		<seealso name="scope~" />
	</seealsolist>
	<discussion>
		The visual output of the <o>live.meter~</o> shows the current signal level, the recent peak level, and provides a red &quot;over&quot; indicator if the signal is greater than or equal to 1. You can change the redrawing interval with the Interval attribute, and the orientation of the meter is set using the Orientation attribute.
	</discussion>
</c74object>
