<?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="round" module="max" category="Math">
	<digest>
		Round to a value
	</digest>
	<description>
		Calculates and outputs an integer multiple of any given number.
	</description>
	<!--METADATA-->
	<metadatalist>
		<metadata name="author">
			Cycling '74
		</metadata>
		<metadata name="tag">
			Max
		</metadata>
		<metadata name="tag">
			math
		</metadata>
	</metadatalist>
	<!--INLETS-->
	<inletlist>
		<inlet id="0" type="int/float/list">
			<digest>
				Value(s) to be Rounded
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
		<inlet id="1" type="int/float">
			<digest>
				Round to nearest this
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
	</inletlist>
	<!--OUTLETS-->
	<outletlist>
		<outlet id="0" type="OUTLET_TYPE">
			<digest>
				Rounded Value(s)
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
	</outletlist>
	<!--ARGUMENTS-->
	<objarglist>
		<objarg name="multiple" optional="1" type="number">
			<digest>
				Rounding multiple
			</digest>
			<description>
				An argument can be used to specify the value to whose nearest multiple the rounding will be done.
			</description>
		</objarg>
	</objarglist>
	<!--MESSAGES-->
	<methodlist>
		<method name="int">
			<arglist>
				<arg name="input" optional="0" type="int" />
			</arglist>
			<digest>
				Round value, cause output
			</digest>
			<description>
				Value to be rounded, Number values received in the left inlet will be rounded to either the absolute nearest integer multiple or the nearest integer multiple between the value received in this inlet or 0 (see the <m>nearest</m> attribute for more information).
			</description>
		</method>
		<method name="float">
			<arglist>
				<arg name="input" optional="0" type="float" />
			</arglist>
			<digest>
				Round value, cause output
			</digest>
			<description>
				Value to be rounded.
			</description>
		</method>
		<method name="list">
			<arglist>
				<arg name="input" optional="0" type="list" />
			</arglist>
			<digest>
				Round all values, output a list
			</digest>
			<description>
				Values to be rounded.
			</description>
		</method>
		<method name="anything">
			<arglist>
				<arg name="input" optional="0" type="list" />
			</arglist>
			<digest>
				Round value, cause output
			</digest>
			<description>
				Values to be rounded.
			</description>
		</method>
	</methodlist>
	<!--ATTRIBUTES-->
	<attributelist>
		<attribute name="nearest" get="1" set="1" type="int" size="1">
			<digest>
				Nearest value mode
			</digest>
			<description>
				When set to 1 (the default), the <o>round</o> object will round to the nearest multiple of the specified number value.
				<br />
				<br />
				Note: This attribute does not set the rounding step (which is set using <o>round</o> object's right inlet), It specifies that rounding to the nearest number value will occur.
			</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="Behavior" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Round to the nearest Multiple" />
				<attribute name="style" get="1" set="1" type="symbol" size="1" value="onoff" />
			</attributelist>
			<discussion>
				Here are some examples:
				<br />
				<br />
				With the rounding interval set to 3 and the <m>nearest</m> attribute set to 1:
				<br />
				an input value of 5.8 will return 6
				<br />
				an input value of 3.7 will return 3
				<br />
				an input value of -1 will return 0
				<br />
				an input value of -2.7 will return -3
				<br />
				<br />
				With the rounding interval set to 3 and the <m>nearest</m> attribute set to 0:
				<br />
				an input value of 5.8 will return 3
				<br />
				an input value of 3.7 will return 3
				<br />
				an input value of -1 will return 0
				<br />
				an input value of -2.7 will return 0
			</discussion>
		</attribute>
	</attributelist>
	<!--EXAMPLE-->
	<examplelist>
		<example caption="" img="" />
	</examplelist>
	<!--SEEALSO-->
	<seealsolist>
		<seealso name="expr" />
		<seealso name="vexpr" />
		<seealso name="round~" />
	</seealsolist>
	<misc name="Output">
		<entry name="float">
			<description>
				The nearest whole numbers of the input.
			</description>
		</entry>
		<entry name="list">
			<description>
				List of the nearest whole numbers of the input list.
			</description>
		</entry>
	</misc>
</c74object>
