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

live.remote~

Realtime control of device parameters

Description

The live.remote~ object allows to remote-control Lives DeviceParameter objects in realtime. 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 live_set master_track mixer_device volume.

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 id 0 to the right inlet of live.remote~.

Arguments

None.

Inlets

Name Description
Left inlet

value (signal/float)

Gets the value of the device parameter object selected by the right inlet. For valid ranges look at the min and max properties of the DeviceParameter. The value curve is linear to the parameter's GUI control in Live.
Right inlet

id nn

Gets object id message id nn to select the DeviceParameter object to control.
id 0 means no object, i.e. the remote stops controlling the DeviceParameter. This is also the initial state.

Messages

float value [float]
A floating point number value received in the left inlet will be applied to the selected Live DeviceParameter, if any. Obviously not in realtime.
int value [int]
An integer number value received in the left inlet will be applied to the selected Live DeviceParameter, if any. Not in realtime, though.
signal Signal input values received in the left inlet will be applied to the selected Live DeviceParameter, if any, in realtime.
id nn Sets the current object when sent to the right inlet. The message has no effect if the id is no a DeviceParameter.

Information for box attributes common to all objects

Examples

See Also

Name Description
Live API Overview
Live Object Model
live.object Perform operations on Live objects
live.observer Monitor changes in Live objects
live.path Navigate to objects in the Live application