<?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="info~" module="msp" category="MSP Sampling">
	<digest>
		Report information about a sample
	</digest>
	<description>
		Use the <o>info~</o> object to report the information in a file read into a <o>buffer~</o> object in response to a <m>bang</m>. If the information is not present, it will be 0. <o>info~</o> does not require that the audio be turned on in order to work. Looping and tuning information is found in AIFF files.
	</description>
	<!--METADATA-->
	<metadatalist>
		<metadata name="author">
			Cycling '74
		</metadata>
		<metadata name="tag">
			MSP
		</metadata>
		<metadata name="tag">
			MSP Sampling
		</metadata>
	</metadatalist>
	<!--INLETS-->
	<inletlist>
		<inlet id="0" type="INLET_TYPE">
			<digest>
				bang Outputs the Information
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
		<inlet id="1" type="INLET_TYPE">
			<digest>
				bang Outputs the Information
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
	</inletlist>
	<!--OUTLETS-->
	<outletlist>
		<outlet id="0" type="OUTLET_TYPE">
			<digest>
				Sampling Rate
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
		<outlet id="1" type="OUTLET_TYPE">
			<digest>
				Sample Instrument Info (list)
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
		<outlet id="2" type="OUTLET_TYPE">
			<digest>
				Sustain Loop Start (msec)
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
		<outlet id="3" type="OUTLET_TYPE">
			<digest>
				Sustain Loop End (msec)
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
		<outlet id="4" type="OUTLET_TYPE">
			<digest>
				Release Loop Start (msec)
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
		<outlet id="5" type="OUTLET_TYPE">
			<digest>
				Release Loop End (msec)
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
		<outlet id="6" type="OUTLET_TYPE">
			<digest>
				Total Time (msec)
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
		<outlet id="7" type="OUTLET_TYPE">
			<digest>
				Most Recent Filename
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
		<outlet id="8" type="OUTLET_TYPE">
			<digest>
				Number of Channel(s)
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
	</outletlist>
	<!--ARGUMENTS-->
	<objarglist>
		<objarg name="buffer-name" optional="0" type="symbol">
			<digest>
				Buffer name
			</digest>
			<description>
				Names the <o>buffer~</o> object for which <o>info~</o> will report information.
			</description>
		</objarg>
	</objarglist>
	<!--MESSAGES-->
	<methodlist>
		<method name="bang">
			<arglist />
			<digest>
				Report of information about a sample in a <o>buffer~</o> object
			</digest>
			<description>
				In left inlet: Causes a report of information about a sample contained in the associated <o>buffer~</o> object.
			</description>
		</method>
		<method name="(mouse)">
			<digest>
				Double-click to open a file buffer display window
			</digest>
			<description>
				Double-clicking on <o>info~</o> opens an editing window where you can view the contents of its associated <o>buffer~</o> object.
			</description>
		</method>
		<method name="set">
			<arglist>
				<arg name="buffer-name" optional="0" type="symbol" />
			</arglist>
			<digest>
				Define the <o>buffer~</o> name to which <o>info~</o> will refer
			</digest>
			<description>
				The word <m>set</m> followed by the name of a <o>buffer~</o> object, sets which <o>buffer~</o> to which <o>info~</o> will refer.
			</description>
		</method>
	</methodlist>
	<!--ATTRIBUTES-->
	<!--EXAMPLE-->
	<examplelist>
		<example img="info~.png" caption="Check sample rate of a sample use other information contained in a sample" />
	</examplelist>
	<!--SEEALSO-->
	<seealsolist>
		<seealso name="buffer~" />
		<seealso name="mstosamps~" />
		<seealso name="sfinfo~" />
		<seealso name="07_samplingchapter03" module="msp" type="tutorial" />
		<seealso name="10_midichapter03" module="msp" type="tutorial" />
	</seealsolist>
	<misc name="Output">
		<entry name="Sample Information">
			<description>
				Most of the information reported by <o>info~</o> is taken from the audio file most recently read into the associated <o>buffer~</o>. If this information is not present, only the sampling rate is sent out the left outlet. No output occurs for any item that's missing from the sound file.
			</description>
		</entry>
		<entry name="float">
			<description>
				Out left outlet: The sampling rate of the sample.
				<br />
				<br />
				Out 3rd outlet: Sustain loop start, in milliseconds.
				<br />
				<br />
				Out 4th outlet: Sustain loop end, in milliseconds.
				<br />
				<br />
				Out 5th outlet: Release loop start, in milliseconds.
				<br />
				<br />
				Out 6th outlet: Release loop end, in milliseconds.
				<br />
				<br />
				Out 7th outlet: Total time of the associated <o>buffer~</o> object, in milliseconds.
				<br />
				<br />
				Out 8th outlet: Name of the most recently read audio file.
			</description>
		</entry>
		<entry name="list">
			<description>
				Out 2nd outlet: Instrument information about the sample, as follows:
				<br />
				<br />
				1. The MIDI pitch of the sample.
				<br />
				<br />
				2. The detuning from the original MIDI note number of the sample, in pitch bend units.
				<br />
				<br />
				3. The lowest MIDI note number to use when playing this sample.
				<br />
				<br />
				4. The highest MIDI note number to use when playing this sample.
				<br />
				<br />
				5. The lowest MIDI velocity to use when playing this sample.
				<br />
				<br />
				6. The highest MIDI velocity to use when playing this sample.
				<br />
				<br />
				7. The gain of the sample (0-127).
			</description>
		</entry>
	</misc>
</c74object>
