<?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="slide~" module="msp" category="MSP Filters">
	<digest>
		Filter a signal logarithmically
	</digest>
	<description>
		Use the <o>slide~</o> object for envelope following and lowpass filtering.
	</description>
	<!--METADATA-->
	<metadatalist>
		<metadata name="author">
			Cycling '74
		</metadata>
		<metadata name="tag">
			MSP
		</metadata>
		<metadata name="tag">
			MSP Filters
		</metadata>
	</metadatalist>
	<!--INLETS-->
	<inletlist>
		<inlet id="0" type="signal">
			<digest>
				(signal) Input
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
		<inlet id="1" type="float">
			<digest>
				(float) Slide up
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
		<inlet id="2" type="float">
			<digest>
				(float) Slide down
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
	</inletlist>
	<!--OUTLETS-->
	<outletlist>
		<outlet id="0" type="signal">
			<digest>
				(signal) Output
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
	</outletlist>
	<!--ARGUMENTS-->
	<objarglist>
		<objarg name="slide-up" optional="1" type="float">
			<digest>
				Slide up value
			</digest>
			<description>
				Specifies the slide up value. The default is 1. (Also accepts integers for these arguments as well as the associated messages which address these parameter settings.)
			</description>
		</objarg>
		<objarg name="slide-down" optional="1" type="float">
			<digest>
				Slide down value
			</digest>
			<description>
				A second argument specifies the slide down value. The default is 1. (Also accepts integers for these arguments as well as the associated messages which address these parameter settings.)
			</description>
		</objarg>
	</objarglist>
	<!--MESSAGES-->
	<methodlist>
		<method name="int">
			<arglist>
				<arg name="current-output-sample" optional="0" type="int" />
			</arglist>
			<digest>
				Set the current output sample value
			</digest>
			<description>
				Sets the current output sample value (the value from which the next incoming value will smoothly transition from).
			</description>
		</method>
		<method name="float">
			<arglist>
				<arg name="current-output-sample" optional="0" type="float" />
			</arglist>
			<digest>
				Set the current output sample value
			</digest>
			<description>
				Sets the current output sample value (the value from which the next incoming value will smoothly transition from).
			</description>
		</method>
		<method name="ft1">
			<arglist>
				<arg name="slide-up" optional="0" type="float" />
			</arglist>
			<digest>
				Set the slide up value
			</digest>
			<description>
				In middle inlet: Specifies the slide up value to be used when an incoming value is greater than the current value.
			</description>
		</method>
		<method name="ft2">
			<arglist>
				<arg name="slide-down" optional="0" type="float" />
			</arglist>
			<digest>
				Set the slide down value
			</digest>
			<description>
				In right inlet: Specifies the slide down value to be used when an incoming value is less than the current value.
			</description>
		</method>
		<method name="signal">
			<arglist />
			<digest>
				Signal to be filtered
			</digest>
			<description>
				A signal to be filtered. Whenever a new value is received, <o>slide~</o> filters the input signal logarithmically between changes in signal value using the formula:
				<br />
				<br />
				y (n) = y (n-1) + ((x (n) - y (n-1))/slide)
				<br />
				<br />
				A given sample output from <o>slide~</o> is equal to the last sample's value plus the difference between the last sample's value and the input divided by the slide value. Given a slide value of 1, the output will therefore always equal the input. Given a slide value of 10, the output will only change 1/10th as quickly as the input. This can be particularly useful for lowpass filtering or envelope following.
			</description>
		</method>
		<method name="slide_down">
			<arglist>
				<arg name="slide-down" optional="0" type="float" />
			</arglist>
			<digest>
				Set the slide down value
			</digest>
			<description>
				The message <m>slide_down</m> followed by a float will specify the slide-down value to be used when an incoming value is less than the current value.
			</description>
		</method>
		<method name="slide_up">
			<arglist>
				<arg name="slide-up" optional="0" type="float" />
			</arglist>
			<digest>
				Set the slide up value
			</digest>
			<description>
				The message <m>slide_up</m> followed by a float will specify the slide-up value to be used when an incoming value is greater than the current value.
			</description>
		</method>
		<method name="reset">
			<arglist />
			<digest>
				Set the current output sample value to 0
			</digest>
			<description>
				Sets the current output sample value to 0(the next incoming value will smoothly transition from that 0).
			</description>
		</method>
	</methodlist>
	<!--ATTRIBUTES-->
	<!--EXAMPLE-->
	<examplelist>
		<example img="slide~.png" caption="slide~ performs logarithmic smoothing of an input signal" />
	</examplelist>
	<!--SEEALSO-->
	<seealsolist>
		<seealso name="rampsmooth~" />
		<seealso name="audio_filtering" module="core" type="vignette" />
	</seealsolist>
	<discussion>
		The <o>slide~</o> object filters an input signal logarithmically between changes in signal value. The formula is y (n) = y (n-1) + ((x (n) - y (n-1))/slide).
	</discussion>
	<misc name="Output">
		<entry name="signal">
			<description>
				The filtered signal.
			</description>
		</entry>
	</misc>
</c74object>
