Adds a simple overlay which keeps a control button bright as long as the user is holding it down.

Deprecated in favor of the shared controllers/auto-bind implementation.

Watches for an Ableton Push controller to be connected, and as soon as it is, binds it to the specified show using bind-to-show. If that controller ever gets disconnected, it will be re-bound once it reappears. Returns a watcher structure which can be passed to deactivate if you would like to stop it watching for reconnections. The underlying controller mapping, once bound, can be accessed through the watcher’s :controller key.

If you have more than one Ableton Push that might beconnected, or have renamed how it appears in your list of MIDI devices, you need to supply a value after :device-filter which identifies the ports to be used to communicate with the Push you want this function to use. The values returned by afterglow.midi/open-inputs-if-needed! and afterglow.midi/open-outputs-if-needed! will be searched, and the first port that matches using filter-devices will be used.

Once bound, the controller will be identified in the user interface (for the purposes of linking it to the web cue grid) as “Ableton Push”. If you would like to use a different name (for example, if you are lucky enough to have more than one Push), you can pass in a custom value after :display-name.

If you want the user interface to be refreshed at a different rate than the default of fifteen times per second, pass your desired number of milliseconds after :refresh-interval.

Deprecated in favor of the shared controllers/bind-to-show implementation.

Establish a connection to the Ableton Push, for managing the given show.

Initializes the display, and starts the UI updater thread. Since SysEx messages are required for updating the display, if you are on a Mac, you must install CoreMIDI4J to provide a working implementation. (If you need to work with Java 1.6, you can instead use mmj, but that is no longer developed, and does not support connecting or disconnecting MIDI devices after Java has started.)

If you have more than one Ableton Push connected, or have renamed how it appears in your list of MIDI devices, you need to supply a value after :device-filter which identifies the ports to be used to communicate with the Push you want this function to use. The values returned by afterglow.midi/open-inputs-if-needed! and afterglow.midi/open-outputs-if-needed! will be searched, and the first port that matches with filter-devices will be used.

The controller will be identified in the user interface (for the purposes of linking it to the web cue grid) as “Ableton Push”. If you would like to use a different name (for example, if you are lucky enough to have more than one Push), you can pass in a custom value after :display-name.

If you want the user interface to be refreshed at a different rate than the default of fifteen times per second, pass your desired number of milliseconds after :refresh-interval.

Calculate the numeric value that corresponds to a particular named state for the specified button, and (if supported and supplied), a named color.

Clears a line of the text display.

Clears the text display and all illuminated buttons and pads.

The control values and modes for a labeled button which changes color. These are added to the monochrome states (except for off) to obtain the color and brightness/behavior.

The labeled buttons which send and respond to Control Change events.

Deactivates a controller interface, killing its update thread and removing its MIDI listeners. If :disconnected is passed with a true value, it means that the controller has already been removed from the MIDI environment, so no effort will be made to clear its display or take it out of User mode.

In general you will not need to call this function directly; it will be dispatched to via controllers/deactivate when that is called with a controller binding implementation from this namespace. It is also called automatically when one of the controllers being used disappears from the MIDI environment.

Check whether the controller is in a particular mode, identified by a control button number or keyword.

Create a graphical gauge with an indicator that fills a line. The default range is from zero to a hundred, and the default size is 17 characters, or a full display cell.

Create a graphical gauge with an indicator that moves along a line. The default range is from zero to a hundred, and the default size is 17 characters, or a full display cell.

The control values and modes for a labeled button which does not change color.

The color of buttons that are completely off.

Because the Push registers multiple ports with the MIDI environment, we need to be sure to bind only to the User port. This filter is used with filter-devices to screen out any port that does not seem to be the User port. If port names are assigned differently on your operating system, you may need to change this (and please open a Pull Request); this filter seems to work for Mac OS X and Windows.

Set one of the labeled buttons to a particular state, and, if supported, color. If the state is already a number, it is used as-is, otherwise it is calculated using button-state.

Sets a line of the text display.

Set the color of one of the 64 touch pads to a specific RGB color.

Deprecated in favor of new set-pad-color implementation.

Set the color of one of the 64 touch pads to the closest approximation available for a desired color. This was the first implementation that was discovered, but there is now a much more powerful way to specify an exact color using a SysEx message.

Set the velocity of one of the 64 touch pads.

Set the color of one of the 8 second-row touch pads (right above the 8x8 pad of larger, velocity sensitive, pads) to the closest approximation available for a desired color.

Set one of the top-row pads to a particular state and color. If state is already a number, it is used as-is, otherwise it is calculated using top-pad-state.

Illuminates all buttons with text labels, for development assistance.

Convert a midi velocity to its signed equivalent, to translate encoder rotations, which are twos-complement seven bit numbers.

The byte values which draw special-purpose characters on the Push display.

Calculate the numeric value that corresponds to a particular named state for the specified top-row pad, and (if supplied), named color.

The mode to which we should return the touch strip when we are shutting down.

The mode to which we should set the touch strip when the user is editing a hue.

The mode to which we should set the touch strip when the user is editing a pan-style control.

The mode to which we should set the touch strip when the user is editing a level-style control.

Given a target color, calculate the MIDI note velocity which will achieve the closest approximation available on an Ableton Push pad, using the thoughtful hue palette provided by Ableton:

Update a batch of characters within the display to be rendered on the next update.