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

plugmultiparam

Define an array of plug-in parameters

Description

Note: plug-in building for hosts other than Ableton Live is no longer supported. For more information to help you make the transition to creating plug-ins in Max for Live, see Max for Live for Pluggo Developers.

The plugmultiparam object lets you define three or more parameters that are displayed and changed by a single object. However, these parameters will be hidden from the "Parameters" view in the plug-in window; they can only be changed by creating a Max user interface. Primarily, plugmultiparam was designed to be used in conjunction with the multislider object; it can also work with the plugstore object, or simply a set of cleverly organized pack and unpack objects.

Arguments

None.

Messages

bang Sends the currently stored values out the object's left outlet.
int parameter-index [int]
 The value at the specified parameter-index is sent out the object's right outlet.
float parameter-index [float]
 Converted to int.
list parameter-values [list]
 Interpreted as a set of values to be assigned to the object's parameters, starting at the lowest-numbered parameter. If the list is longer than the number of parameters defined by the object, the extra elements are ignored. The values of the list are constrained to be within the minimum and maximum arguments of the object.
poke arguments [list]
 The word poke, followed by a number that specifies a parameter and a value, sets the parameter value.
setmessage message [symbol]
 The word setmessage, followed by a symbol, changes the message that sets individual values when they change (for example, because the stored program was changed). The default select message is useful in conjunction with the multislider object.

Information for box attributes common to all objects

Output

any message: Out left outlet: The plugmultiparam object also produces a message to set individual values in the collection using the following format

[message name] [index] [value]

By default, the message name is select
list: Out left outlet: The left outlet produces the current values as a list when the object receives a bang message.

Examples

See Also

Name Description
plugconfig Configure the behavior of a plug-in
plugmidiin Receive MIDI events from a plug-in host
plugmidiout Send MIDI messages to a plug-in host
plugmod Modify plug-in parameter values in other plug-ins
plugmorph Generate parameter values created by morphing between other presets
plugstore Store multiple plug-in parameter values
pp Define a plug-in parameter
pptempo Define plug-in tempo and sync parameters
pptime Define time-based plug-in parameter
plugin~ Define a Max for Live device's audio inputs
plugout~ Define a plug-in's audio outputs