live.banks Reference

Manage Max for Live Device banks for Push controllers.

live.banks

Description

Create, edit and delete Max for Live Device parameter banks, as displayed on Ableton's Push controllers. Banks are saved with the device, but can be modified in real-time to cause updates on the Push display. For instance, you might want to reveal or hide particular parameters within a bank depending on device state.

Arguments

None.

Attributes

Common Box Attributes

Messages

(mouse)

Double-click to open the Parameter Banks window. Only available in the editor, this feature is disabled inside of Live.

delete

Arguments

bank_id [int]
Delete a parameter bank. Deleting a bank will decrement the index of the banks with higher indices.

edit

Arguments

bank_id [int]
bank_name [symbol]
bank_parameters [list]
Edit a parameter bank, specified by bank_id (0-indexed). To change the bank name, pass a new name as bank_name , or pass - (minus) to use the existing name. The optional list of parameters should be a list of index/name pairs in the form parameter_index parameter_name . For instance, edit 0 newname 0 foo 2 bar 4 - 5 bap would change the name of bank 0 to newname and modify parameter slot 0 to use the parameter foo , slot 2 to use the parameter bar , eliminate the parameter in slot 4, and assign slot 5 to the parameter named bap .

getcount

Sends the count message from the outlet, followed by the number of banks.

getname

Arguments

bank_id [int]
Sends the name message from the outlet, followed by the index (int) and name (symbol) of the specified bank.

getparameters

Arguments

bank_id [int]
Sends the parameters message from the outlet, followed by the index (int) of and a list of parameter names (symbol) in the specified bank.

new

Arguments

bank_id [int]
bank_name [symbol]
bank_parameters [list]
Create a bank at the index specified by bank_id (0-indexed). If a bank already exists at that index, the new bank will be inserted at the specified index and all higher-indexed banks will have their indices incremented. The bank requires a name, specified by bank_name . The list of parameters should be a list of up to 8 symbols, specifying the parameter name for bank slots 0-7. A - (minus) can be used to indicate that a slot should have no parameter associated with it. Note: when creating banks, it is possible to specify indices higher than the bank count. That is, one could start with an empty set of banks and create bank 3 first. In that case, dummy banks will be created in slots 0, 1 and 2. Dummy banks are displayed with grey text in the Parameter Banks window. Editing a dummy bank will cause it to become a 'real' bank. Creating a new bank at the index occupied by a dummy bank will replace the dummy bank in-place, rather than performing an insert.

See Also

Name Description
live.arrows
live.button
live.dial
live.drop
live.gain
live.line
live.numbox
live.slider
live.tab
live.toggle