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]
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, 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
message from the outlet, followed by the number of banks. getname
Arguments
bank_id
[int]
Sends the
message from the outlet, followed by the index (int) and name (symbol) of the specified bank. getparameters
Arguments
bank_id
[int]
Sends the
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]
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 |