<?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="degrade~" module="msp" category="MSP Modifiers">
	<digest>
		Signal quality reducer
	</digest>
	<description>
		<o>degrade~</o> takes any given signal and reduces the sampling rate and bit-depth as specified/desired.
	</description>
	<!--METADATA-->
	<metadatalist>
		<metadata name="author">
			Cycling &quot;74
		</metadata>
		<metadata name="tag">
			MSP
		</metadata>
		<metadata name="tag">
			MSP Modifiers
		</metadata>
	</metadatalist>
	<!--INLETS-->
	<inletlist>
		<inlet id="0" type="signal">
			<digest>
				(signal) Input
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
		<inlet id="1" type="float / signal">
			<digest>
				(float) Sampling-Rate Ratio
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
		<inlet id="2" type="int / signal">
			<digest>
				(int) Resolution in bits
			</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="resampling-frequency-ratio" optional="1" type="float">
			<digest>
				Resampling frequency ratio
			</digest>
			<description>
				The first argument sets the resampling frequency ratio, as described above. If this argument is not supplied, the default value is 1.0.
			</description>
		</objarg>
		<objarg name="number-of-quantization-bits" optional="1" type="int">
			<digest>
				Number of quantization bits
			</digest>
			<description>
				The second argument sets the number of bits used to quantize the input signal. If this argument is not supplied, the default value is 24.
			</description>
		</objarg>
	</objarglist>
	<!--MESSAGES-->
	<methodlist>
		<method name="int">
			<arglist>
				<arg name="number-of-quantization-bits" type="int" optional="0" />
			</arglist>
			<digest>
				Set the number of quantization bits
			</digest>
			<description>
				In right inlet: The number of bits used to quantize the input signal. This value must be in the range 1-52. Fewer bits mean lower signal quality.
			</description>
		</method>
		<method name="float">
			<arglist>
				<arg name="resampling-frequency-ratio" type="float" optional="0" />
			</arglist>
			<digest>
				Set the frequency ratio at which the signal is resampled
			</digest>
			<description>
				In middle inlet: The ratio of frequency at which the input signal is resampled, effectively reducing its sampling rate. This ratio is the resampling rate divided by the system sampling rate. For example, if MSP&quot;s current sampling rate is 44100 Hz, and the ratio is 0.75, the effective sampling rate of the output signal will be 33075 Hz.
			</description>
		</method>
		<method name="signal">
			<arglist />
			<digest>
				The signal to be degraded
			</digest>
			<description>
				In left inlet: The signal to be degraded.
			</description>
		</method>
	</methodlist>
	<!--ATTRIBUTES-->
	<!--EXAMPLE-->
	<examplelist>
		<example img="degrade~.png" caption="Change a signal's effective sampling rate and bit depth" />
	</examplelist>
	<!--SEEALSO-->
	<seealsolist>
		<seealso name="downsamp~" />
		<seealso name="round~" />
	</seealsolist>
	<misc name="Output">
		<entry name="signal">
			<description>
				The output signal is the input signal after being resampled and quantized. Note that this object deliberately does not use any interpolation when resampling, nor any dithering when quantizing. It is intended for creating &quot;low-fi&quot; effects.
				<br />
				<br />
				Note: Use caution when listening to the output of this object. Quantizing to a small number of bits can create very loud, noisy signals.
			</description>
		</entry>
	</misc>
</c74object>
