mappings Reference

Utility object for Mappings

mappings

Description

The mappings object allows you to enable and disable keyboard and MIDI mapping from your Max patcher, as well as some other useful utilities.

Arguments

None.

Attributes

file [symbol] (default: )

The file attribute can be used to specify the current .maxmap file.

Common Box Attributes

Messages

(mouse)

Double-click on the mappings object to open the Mappings Window for the current patcher.

key

Arguments

on/off [int]
A non-zero value for on/off will enable Keyboard Mapping mode. A zero value will disable it.

midi

Arguments

on/off [int]
A non-zero value for on/off will enable MIDI Mapping mode. A zero value will disable it.

open

Open the Mappings Window for the current patcher.

read

Arguments

filename [symbol]
The message read followed by a filename 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.

write

Arguments

filename [symbol]
The message write followed by a filename argument will attempt to write the current mappings to the specified .maxmap file. Without an argument, a Save File dialog will be presented.

See Also

Name Description
midiin
notein
ctlin
bendin
xbendin
key