<?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="mpeparse" module="" category="">
	<digest>
		Interpret raw MPE MIDI data
	</digest>
	<description>
		Separates raw Multidimensional Polyphonic Expression (MPE) MIDI bytes into standard message types.
	</description>
	<!--METADATA-->
	<metadatalist>
		<metadata name="author">
			Cycling '74
		</metadata>
		<metadata name="tag">
			TEXT_HERE
		</metadata>
	</metadatalist>
	<!--INLETS-->
	<inletlist>
		<inlet id="0" type="INLET_TYPE">
			<digest>
				MIDI Message Input
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
		<inlet id="1" type="INLET_TYPE">
			<digest>
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
	</inletlist>
	<!--OUTLETS-->
	<outletlist>
		<outlet id="0" type="OUTLET_TYPE">
			<digest>
				Note-on and Note-off (list: Pitch, Velocity)
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
		<outlet id="1" type="OUTLET_TYPE">
			<digest>
				Poly Key Pressure (list: Key, Value)
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
		<outlet id="2" type="OUTLET_TYPE">
			<digest>
				Control Change (list: Controller Number, Value)
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
		<outlet id="3" type="OUTLET_TYPE">
			<digest>
				Program Change
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
		<outlet id="4" type="OUTLET_TYPE">
			<digest>
				Aftertouch
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
		<outlet id="5" type="OUTLET_TYPE">
			<digest>
				Pitch Bend
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
		<outlet id="6" type="OUTLET_TYPE">
			<digest>
				Voice Number (-1 if Global)
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
		<outlet id="7" type="OUTLET_TYPE">
			<digest>
				Zone First Channel
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
		<outlet id="8" type="OUTLET_TYPE">
			<digest>
				Zone Index (-1 if Global)
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
		<outlet id="9" type="OUTLET_TYPE">
			<digest>
				mpeevent Message (list: mpeevent, Zone First Channel, Zone Index, Voice Number, Channel Number, MIDI Message Number, Data)
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
	</outletlist>
	<!--ARGUMENTS-->
	<objarglist>
		<objarg id="0" name="OBJARG_NAME" type="OBJARG_TYPE" optional="0">
			<digest>
				TEXT_HERE
			</digest>
			<description>
				TEXT_HERE
			</description>
		</objarg>
	</objarglist>
	<!--MESSAGES-->
	<methodlist>
		<method name="bang">
			<arglist />
			<digest>
				Clear partial MIDI messages
			</digest>
			<description>
				Clears the <o>mpeparse</o> object's memory of any partial MPE MIDI message received up to that point.
			</description>
		</method>
		<method name="int">
			<arglist>
				<arg name="byte" optional="0" type="int" />
			</arglist>
			<digest>
				Evaluate and output MPE MIDI messages
			</digest>
			<description>
				Numbers received in the inlet are treated as bytes of a MIDI message (usually from a <o>midiin</o> or <o>polymidiin</o> object). The status byte determines the outlet which will be used to output the data bytes.
			</description>
		</method>
		<method name="float">
			<arglist>
				<arg name="byte" optional="0" type="float" />
			</arglist>
			<digest>
				Evaluate and output MPE MIDI messages
			</digest>
			<description>
				Converted to <m>int</m>.
			</description>
		</method>
		<method name="mpeevent">
			<arglist>
				<arg name="ARG_NAME_0" type="list" optional="0" />
			</arglist>
			<digest>
				TEXT_HERE
			</digest>
			<description>
				TEXT_HERE
			</description>
		</method>
	</methodlist>
	<!--ATTRIBUTES-->
	<attributelist>
		<attribute name="hires" get="1" set="1" type="int" size="1">
			<digest>
				High-resolution Pitch Bend
			</digest>
			<description>
				An integer in the range 0 - 2 sets the range used for pitch bend messages by the <o>mpeparse</o> object.
			</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="default" get="1" set="1" type="int" size="1" value="0" />
				<attribute name="enumvals" get="1" set="1" type="atom" size="3">
					<enumlist>
						<enum name="Off (0-127)">
							<digest>
								Standard 8-bit MIDI pitch bend range (default)
							</digest>
							<description>
								TEXT_HERE
							</description>
						</enum>
						<enum name="Float (-1 to 1)">
							<digest>
								Uses pitch bend messages in the audio signal range
							</digest>
							<description>
								TEXT_HERE
							</description>
						</enum>
						<enum name="14-bit Fixed (-8192 to 8191)">
							<digest>
								Standard 14-bit MIDI high resolution pitch bend range
							</digest>
							<description>
								TEXT_HERE
							</description>
						</enum>
					</enumlist>
				</attribute>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="High-resolution Pitch Bend" />
				<attribute name="style" get="1" set="1" type="symbol" size="1" value="enumindex" />
			</attributelist>
		</attribute>
		<attribute name="index" get="1" set="1" type="int" size="1">
			<digest>
				Output on Nth Note Held Down
			</digest>
			<description>
				Set mpeparse to output only on the specified voice number (from 1 to 15).
			</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="default" get="1" set="1" type="int" size="1" value="0" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Output on Nth Note Held Down" />
			</attributelist>
		</attribute>
		<attribute name="strict" get="1" set="1" type="int" size="1">
			<digest>
				Enforce MPE Scope
			</digest>
			<description>
				TEXT_HERE
			</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="default" get="1" set="1" type="int" size="1" value="0" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Enforce MPE Scope" />
				<attribute name="style" get="1" set="1" type="symbol" size="1" value="onoff" />
			</attributelist>
		</attribute>
	</attributelist>
	<!--EXAMPLE-->
	<examplelist>
		<example caption="" img="" />
	</examplelist>
	<!--SEEALSO-->
	<seealsolist>
		<seealso name="midiin" />
		<seealso name="midiformat" />
		<seealso name="midiparse" />
		<seealso name="mpeconfig" />
		<seealso name="mpeformat" />
		<seealso name="polymidiin" />
	</seealsolist>
	<misc name="Output">
		<entry name="list">
			<description>
				Out leftmost outlet: A note-on/note-off message. The first number is a pitch value and the second number is a velocity value.
				<br />
				<br />
				Out 2nd outlet: A polyphonic key pressure message. The first number is an aftertouch (pressure) value and the second number is a pitch value (key number).
				<br />
				<br />
				Out 3rd outlet: A control message. The first number is a control value and the second number is a controller number.
			</description>
		</entry>
		<entry name="int">
			<description>
				Out 4th outlet: The number is a program change.
				<br />
				<br />
				Out 5th outlet: The number is an aftertouch (channel pressure) value.
				<br />
				<br />
				Out 6th outlet: The number is a pitch bend value.
				<br />
				<br />
				Out 7th outlet: The number is the voice number (-1 if global).
				<br />
				<br />
				Out 8th outlet: The number is the Zone First Channel.
				<br />
				<br />
				Out 9th outlet: The number is the Zone Index (-1 if global).
			</description>
		</entry>
		<entry name="list">
			<description>
				Out rightmost outlet: The MPE Event Message. The MPE event message is a list composed of the symbol <m>mpeevent</m>, followed by 6 integers which specify the Zone First Channel, Zone Index, Voice Number, Channel Number, MIDI Message Number, and Data. This message can be sent to a patch encapsulated in a <o>poly~</o> object using the <o>polymidiin</o> object.
			</description>
		</entry>
	</misc>
</c74object>
