MaxDevice

Represents a Max for Live device hosted on a track or rack chain. The MaxDevice class extends Device with hooks specific to M4L — patcher loading, parameter exposure, and inter-device messaging.

MaxDevice

This class represents a Max for Live device. ^{From Live’s runtime docstring.}

Properties

Inherited from LomObject

_live_ptr: int

canonical_parent: Track

Get the canonical parent of the Device. ^{From Live’s runtime docstring.}

Inherited from Device

can_compare_ab: bool

Returns true if the Device has the capability to AB compare. ^{From Live’s runtime docstring.}

can_have_chains: bool

Returns true if the device is a rack. ^{From Live’s runtime docstring.}

can_have_drum_pads: bool

Returns true if the device is a drum rack. ^{From Live’s runtime docstring.}

class_display_name: str

Return const access to the name of the device’s class name as displayed in Live’s browser and device chain ^{From Live’s runtime docstring.}

class_name: str

Return const access to the name of the device’s class. ^{From Live’s runtime docstring.}

is_using_compare_preset_b: bool

Returns whether the Device has loaded the preset in compare slot B. Only relevant if can_compare_ab, otherwise errors. ^{From Live’s runtime docstring.}

type: DeviceType

Return the type of the device. ^{From Live’s runtime docstring.}

view: View

Representing the view aspects of a device. ^{From Live’s runtime docstring.}

audio_inputs: Vector[DeviceIO]

Const access to a list of all audio inputs of the device. ^{From Live’s runtime docstring.}

audio_outputs: Vector[DeviceIO]

Const access to a list of all audio outputs of the device. ^{From Live’s runtime docstring.}

is_active: bool

Return const access to whether this device is active. This will be false bothwhen the device is off and when it’s inside a rack device which is off. ^{From Live’s runtime docstring.}

latency_in_ms: float

Returns the latency of the device in ms. ^{From Live’s runtime docstring.}

latency_in_samples: int

Returns the latency of the device in samples. ^{From Live’s runtime docstring.}

midi_inputs: Vector

Const access to a list of all midi outputs of the device. ^{From Live’s runtime docstring.}

midi_outputs: Vector

Const access to a list of all midi outputs of the device. ^{From Live’s runtime docstring.}

name: str

Return access to the name of the device. ^{From Live’s runtime docstring.}

parameters: ATimeableValueVector

Const access to the list of available automatable parameters for this device. ^{From Live’s runtime docstring.}

Listener Only

bank_parameters_changed

add_bank_parameters_changed_listener · remove_bank_parameters_changed_listener · bank_parameters_changed_has_listener

Fires when the Max for Live device’s bank-parameter mapping reconfigures — parameter rebinding to a different bank slot or a structural change to the bank set. Read the new state via get_bank_count, get_bank_name, and get_bank_parameters.

Methods

Inherited from Device

save_preset_to_compare_ab_slot()

Saves the current state of the device to the compare AB slot. Only relevant if can_compare_ab, otherwise throws. ^{From Live’s runtime docstring.}

store_chosen_bank()

Parameters

• script_index: int
• bank_index: int

Set the selected bank in the device for persistency. ^{From Live’s runtime docstring.}

get_bank_count()

Returns

int

Get the number of parameter banks. This is related to hardware control surfaces. ^{From Live’s runtime docstring.}

get_bank_name()

Parameters

• bank_index: int

Returns

str

Get the name of a parameter bank given by index. This is related to hardware control surfaces. ^{From Live’s runtime docstring.}

get_bank_parameters()

Parameters

• bank_index: int

Returns

list[int]Probed aslisthigh confidence

• M4L maxdevice.md confirms list[int].
• corpus uses parameter_indices = device.get_bank_parameters(bank_index).

Get the indices of parameters of the given bank index. Empty slots are marked as -1. Bank index -1 refers to the best-of bank. This function is related to hardware control surfaces. ^{From Live’s runtime docstring.}

get_value_item_icons()

Parameters

• device_parameter: DeviceParameter

Returns

list[str]Probed aslisthigh confidence

• docstring “list of icon identifier strings”.

Get a list of icon identifier strings for a list parameter’s values.An empty string is given where no icon should be displayed.An empty list is given when no icons should be displayed.This is related to hardware control surfaces. ^{From Live’s runtime docstring.}