<?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="xbendin" module="max" category="MIDI">
	<digest>
		Interpret extra precision MIDI pitch bend values
	</digest>
	<description>
		Acts as a 14-bit pitch bend filter/processor and <link name="xbendin" type="refpage">xbendin2</link> serves as a 2-byte pitch bend filter/processor.
	</description>
	<!--METADATA-->
	<metadatalist>
		<metadata name="author">
			Cycling '74
		</metadata>
		<metadata name="tag">
			Max
		</metadata>
		<metadata name="tag">
			MIDI
		</metadata>
	</metadatalist>
	<!--INLETS-->
	<inletlist>
		<inlet id="0" type="INLET_TYPE">
			<digest>
				Raw MIDI Bytes From midiin
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
		<inlet id="1" type="INLET_TYPE">
			<digest>
				Raw MIDI Bytes From midiin
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
	</inletlist>
	<!--OUTLETS-->
	<outletlist>
		<outlet id="0" type="OUTLET_TYPE">
			<digest>
				MSB of Pitch Bend
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
		<outlet id="1" type="OUTLET_TYPE">
			<digest>
				LSB of Pitch Bend
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
	</outletlist>
	<!--ARGUMENTS-->
	<objarglist>
		<objarg name="channel" optional="1" type="int">
			<digest>
				MIDI channel
			</digest>
			<description>
				The number specifies a MIDI channel on which to recognize pitch bend messages. If there is no argument, <o>xbendin</o> recognizes pitch bend messages on all channels, and the channel number is sent out the extra outlet on the right.
			</description>
		</objarg>
		<objarg name="xbendin2" optional="1" type="symbol">
			<digest>
				Additional outlet
			</digest>
			<description>
				Normally, <o>xbendin</o> sends pitch bend values out the left outlet as 14-bit values. If the object is called <link name="xbendin" type="refpage">xbendin2</link>, however, there will be an additional outlet. The most significant data byte of the message is sent out the leftmost outlet, and the least significant data byte is sent out the second outlet.
			</description>
		</objarg>
	</objarglist>
	<!--MESSAGES-->
	<methodlist>
		<method name="int">
			<arglist>
				<arg name="input" optional="0" type="int" />
			</arglist>
			<digest>
				Evaluate as pitch bend data
			</digest>
			<description>
				The numbers are individual bytes of a MIDI message stream, received from an object such as <o>midiin</o> or <o>seq</o>. MIDI pitch bend messages are recognized by <o>xbendin</o>, and the pitch bend data is sent out in full precision.
			</description>
		</method>
	</methodlist>
	<!--ATTRIBUTES-->
	<!--EXAMPLE-->
	<examplelist>
		<example img="xbendin.png" caption="Pitch bend values are sent out as a single number or as two separate bytes" />
	</examplelist>
	<!--SEEALSO-->
	<seealsolist>
		<seealso name="bendin" />
		<seealso name="midiin" />
		<seealso name="xbendout" />
	</seealsolist>
	<misc name="Output">
		<entry name="int">
			<description>
				The pitch bend value is sent out the left outlet of <o>xbendin</o> as a single 14-bit value. If the object is called <link name="xbendin" type="refpage">xbendin2</link>, there is an additional outlet. The most significant 7 bits are sent out the leftmost outlet, and the least significant (extra precision) 7 bits are sent out the second outlet. If there is no channel number specified as an argument (omni on), <o>xbendin</o> will have an extra outlet on the right, which will output the channel number of the incoming pitch bend message.
			</description>
		</entry>
	</misc>
</c74object>
