<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<?xml-stylesheet href="./_c74_ref.xsl" type="text/xsl"?>

<c74object name="mc.bands~" module="msp" category="MSP Filters" kind="patcher">
	<digest>Filter bank for MC</digest>
	<description>
		<o>mc.bands~</o> divides the spectrum of an audio signal into separate bands 
		with each band represented as it's own channel of audio.
	</description>
	
	
	<!--METADATA-->
	<metadatalist>
		<metadata name="author">Cycling '74</metadata>
		<metadata name="tag">MSP</metadata>
		<metadata name="tag">MSP Filters</metadata>
	</metadatalist>
	

	<!--ARGUMENTS-->
	<objarglist>

		<objarg name="number-of-bands" optional="0" type="int">
			<digest>Number of bands</digest>
			<description>
				The number of bands, and thus channels of audio, into which the audio input will be split.
			</description>
		</objarg>

	</objarglist>
	

	<!--MESSAGES-->
	<methodlist>
		
		<method name="signal">
			<arglist />
			<digest>Audio signal to be split</digest>
			<description>
				Audio signal to be split into separate channels for each frequency band.
			</description>
		</method>

		<method name="float">
			<arglist>
				<arg name="parameter" optional="0" type="float" />
			</arglist>
			<digest>
				Function depends on inlet
			</digest>
			<description>
				In 2nd inlet: The lowest frequency, in hertz, for which to create a band of audio.
				<br/><br/>
				In 3rd inlet: The highest frequency, in hertz, for which to create a band of audio.
				<br/><br/>
				In 4th inlet: The number of bands to create, ranging from the low bound to the high bound.
				<br/><br/>
				In 5th inlet: The width of the bands as a percentage. 
							  100% represents the ideal bandwidth for an even crossover between bands.
							  Higher numbers represent narrower bands with a more pronounced gap between the bands.
							  Lower numbers represent wider bands with more overlap.
				<br/><br/>
				Note: Input to any one of the inlets will recalculate the filters graph and may cause a glitch in the audio.
				<br/>
				Changes to the number of bands will require a re-start of the DSP to take effect.
			</description>
		</method>
		
	</methodlist>
	
	
	<!--ATTRIBUTES-->


	<!--SEEALSO-->
	<seealsolist>
		<seealso name="fffb~" />
		<seealso name="mc.reson~" />
	</seealsolist>


</c74object>
