A newer version of Max is available. Click here to access the latest version of this document.
Device Parameters in Max for Live
Parameters are settings of Max for Live devices you want to store and/or automate in Live. In some cases, a parameter may be set once and never change. In other cases, you'll want to use Max objects to interact with parameter values by clicking and moving the mouse, by receiving MIDI data mapped to a parameter, or via Live automation.
There are two ways to add parameters to your device: using the Live UI objects or using pattr objects with parameter mode enabled.
The Parameters Window shows all parameters currently associated with a device, and permits you to change parameter attributes in a single place. You can also change parameter attributes for individual objects by using the Parameter tab of the inspector.
Live UI Objects
Max for Live includes user interface objects designed to work with the parameter system whose names all begin with live.. These objects have some special abilities:
In other respects, the Live UI objects act like ordinary Max user interface objects.
Parameter Data Types
Parameters used in Max for Live can be one of four types:
Working with Integer values outside of the 0 - 255 range
Although parameter value will be stored as a floating-point number, it will be displayed as an integer.


Setting an initial state for a Live UI object

Setting an initial state for a standard Max UI object

Parameter Modulation
Parameters can be modulated by clip envelopes in Live according to one of four modes:

Enabling Parameter Modulation

Parameter Names
Max for Live provides several ways to name a parameter in a device, each of which is an Attribute. that can be set using an object's Inspector. These names can be set separately or linked together, and they serve several useful purposes.
You can use a single name for all three of these attributes by checking the Link to Scripting Name attribute in the object's Inspector. You may find this to be a simple approach to managing paramter naming.

Setting the display name for a parameter
Note: If your short name is too long, it will be automatically truncated. If you are using a live.slider or live.gain~ object, you can use resize the object manually by clicking in the lower right-hand corner of the object and dragging. If you are using a live.dial object, you should enter a new horizontal value for the Patching Rectangle or Presentation Rectangle attributes using the object's Inspector.

Naming automatable parameters
Setting the display name for a parameter
Note: If your short name is too long, it will be automatically truncated. If you are using a live.slider or live.gain~ object, you can use resize the object manually by clicking in the lower right-hand corner of the object and dragging. If you are using a live.dial object, you should enter a new horizontal value for the Patching Rectangle or Presentation Rectangle attributes using the object's Inspector.

Custom unit styles
Max for Live provides a variety of options for setting unit styles that a UI object displays. If you want to use specify some other unit of measurement for display, you can create a custom unit style.
Setting a custom unit style

Controlling a parameter's visibility