live.remote~
Description
The live.remote~ object allows to remotely control Lives DeviceParameter objects in realtime.
Examples

Discussion
The DeviceParameter object is selected using live.path and its id is put into the right inlet of live.remote~. An example path of a DeviceParameter is .
Integer or float values are send into left inlet of live.remote~, as messages or as an audio signal. The values are applied sample-precise (if sent by the audio thread of Max) with a constant latency of a single audio buffer.
A device parameter is disabled in Live while it is controlled by a live.remote~, just as if it controlled by a Macro parameter (but without the green dot). This means that the automation of the parameter is disabled and the value in the Live set is not changed, no undo steps are created. The envelopes are active, though. To stop controlling a device parameter and to reenable it, send to the right inlet of live.remote~.
Arguments
None.
Attributes
smoothing [float]
Set the ramp time that is used for each incoming event. This also performs an automatic downsampling of any signal you send in. For example, a smoothing value of 1 ms will downsample the signal to 1 ms and send ramp events which output a linear approximation of the initial signal. This attribute defaults to 1 ms.
Common Box Attributes
Inlets
Left inlet
Right inlet
means no object, i.e. the remote stops controlling the DeviceParameter. This is also the initial state.
Messages
float
Arguments
int
Arguments
list
Arguments
delta-time [number]
signal
id nn
Inspector
Persistence
The live.remote~ object has a special entry in its inspector labelled "Use Persistent Mapping". This setting, when enabled, causes the associated with the object to persist when the Live document is saved and restored, and when the Max Device is moved between the Live application and the Max editor, or within the Live Set. Beginning in Live 8.2.2, Live API ids remain persistent between launches of Live, which in conjunction with the feature of live.object, live.observer and live.remote~, makes it possible to create simpler devices which retain their association with elements in the Live user interface.
See Also
Name | Description |
---|---|
Max For Live | Max For Live |
Live API Overview | |
Live Object Model | |
live.object | |
live.observer | |
live.path | |
Using the Live API | |
The LiveAPI JavaScript Object (jsliveapi) |