A newer version of Max is available. Click here to access the latest version of the documentation

amxd~ Reference

Host Max for Live devices

amxd~

Description

Use the amxd~ object to load a Max for Live device and use it in MSP. When the amxd~ object is instantiated as mcs.amxd~ its audio inputs combined into a single multichannel input and its audio outputs are combined into a single multichannel output.

Arguments

devicename [symbol]

Name of the Max for Live device to load.

Attributes

active [int] (default: 1)

Setting active to false will disable audio and MIDI processing.

annotation_name [symbol] (default: )

The string that is prepended to annotations. This shows up in the Info pane in Live, and the clue window in Max.

autosize [int] (default: 1)

Automatically calculate the window size for the Max for Live device on load.

mcisolate [int] (default: 0)

Isolate parameter changes to a specified channel.

parameter_enable [int]

Enables use of this object with Max for Live Parameters and allows for setting initial parameter values in the Max environment.

patchername [symbol] (default: <none>)

Specify the Max for Live device to be loaded

showheader [int] (default: 1)

Show a Header for the Max for Live device.

Common Box Attributes

Snapshot Attributes

Parameter Attributes

Messages

anything

Arguments

Parameter [list]
Control Parameter values with a message consisting of the parameter name and the value e.g.: "Gain -6"

(drag)

Drag a Max for Live .amxd file from the patcher window sidebar or the Finder/Explorer onto an amxd~ object to load the Max for Live device into the object.

(mouse)

Click and drag a Max for Live .amxd file from the patcher window sidebar to create an amxd~ object containing the Max for Live device.

drag_replace

In an unlocked patch, drag any Max for Live device onto the amxd~ object to replace the loaded device.

getinfo

Arguments

parameter-name [symbol]
Get info about a specific parameter out of the 4th outlet.

getparams

Get a list of all available parameters out of the 4th outlet.

getvalue

Arguments

parameter-name [symbol]
Get the value of a specific parameter out of the 4th outlet.

midievent

Arguments

MIDI-message (2 to 4 numbers) [list]
The word midievent, followed by two to four numbers, sends a MIDI event to the Max for Live device. The first three number arguments are the bytes of the MIDI message. The fourth, optional, argument is a detune parameter used for MIDI note messages. The value ranges from -63 to 64 cents, with 0 being the default.

midiin

Arguments

MIDI [int]
In the third inlet, send MIDI messages to the Max for Live device.

open

Arguments

window-coordinates [list]
The open message with no arguments opens a floating window for the Max for Live device. If the window was previously opened, then the edit window location will be brought to the front.

signal

Input to be processed by the Max for Live device. If the device is an instrument plug-in, the input will be ignored.

Snapshot Messages

See Also

Name Description
MC MC
rewire~
vst~
mcs.amxd~