<?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="mappings" module="max" category="">
	<digest>
		Utility object for Mappings
	</digest>
	<description>
		The <o>mappings</o> object allows you to enable and disable keyboard and MIDI mapping from your Max patcher, as well as some other useful utilities.
	</description>
	<!--METADATA-->
	<metadatalist>
		<metadata name="author">
			Cycling '74
		</metadata>
		<metadata name="tag">
			mappings
		</metadata>
	</metadatalist>
	<!--INLETS-->
	<!--OUTLETS-->
	<!--ARGUMENTS-->
	<objarglist />
	<!--MESSAGES-->
	<methodlist>
		<method name="(mouse)">
			<digest>
				Double-click to open the Mappings Window.
			</digest>
			<description>
				Double-click on the <o>mappings</o> object to open the Mappings Window for the current patcher.
			</description>
		</method>
		<method name="key">
			<arglist>
				<arg name="on/off" type="int" optional="0" />
			</arglist>
			<digest>
				Enable/disable keyboard mapping.
			</digest>
			<description>
				A non-zero value for <m>on/off</m> will enable Keyboard Mapping mode. A zero value will disable it.
			</description>
		</method>
		<method name="midi">
			<arglist>
				<arg name="on/off" type="int" optional="0" />
			</arglist>
			<digest>
				Enable/disable MIDI mapping.
			</digest>
			<description>
				A non-zero value for <m>on/off</m> will enable MIDI Mapping mode. A zero value will disable it.
			</description>
		</method>
		<method name="open">
			<arglist />
			<digest>
				Open the Mappings Window.
			</digest>
			<description>
				Open the Mappings Window for the current patcher.
			</description>
		</method>
		<method name="read">
			<arglist>
				<arg name="filename" type="symbol" optional="0" />
			</arglist>
			<digest>
				Read a Mappings file.
			</digest>
			<description>
				The message <m>read</m> followed by a <m>filename</m> argument will attempt to read the specified .maxmap file and apply the contained mappings to the current patcher. Without an argument, an Open File dialog will be presented.
			</description>
		</method>
		<method name="write">
			<arglist>
				<arg name="filename" type="symbol" optional="0" />
			</arglist>
			<digest>
				Write a Mappings file.
			</digest>
			<description>
				The message <m>write</m> followed by a <m>filename</m> argument will attempt to write the current mappings to the specified .maxmap file. Without an argument, a Save File dialog will be presented.
			</description>
		</method>
	</methodlist>
	<!--ATTRIBUTES-->
	<attributelist>
		<attribute name="file" get="1" set="1" type="symbol" size="1">
			<digest>
				Mappings File
			</digest>
			<description>
				The
				<a>
					file
				</a>
				attribute can be used to specify the current .maxmap file.
			</description>
			<attributelist>
				<attribute name="default" get="1" set="1" type="symbol" size="1" value="" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Mappings File" />
				<attribute name="save" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="style" get="1" set="1" type="symbol" size="1" value="file" />
			</attributelist>
		</attribute>
	</attributelist>
	<!--EXAMPLE-->
	<examplelist>
		<example caption="" img="" />
	</examplelist>
	<!--SEEALSO-->
	<seealsolist>
		<seealso name="midiin" />
		<seealso name="notein" />
		<seealso name="ctlin" />
		<seealso name="bendin" />
		<seealso name="xbendin" />
		<seealso name="key" />
	</seealsolist>
</c74object>
