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

Activates an otherwise-unused button which responds to a control message, causing it to run custom code when pressed and released.

The color for bright amber buttons.

Calculate a touch strip mode byte based on a list of flags (keys in touch-strip-mode-flags).

The number of pixels to keep blank between labels of adjacent buttons.

The number of pixels allocated to each button above or below the graphical display.

Figure out how many pixels wide some text will be in a given font.

Send a System Exclusive message which requests all touch strip LEDs be turned off.

Clear the graphical display.

Clears the graphical display and all illuminated buttons and pads.

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

Create the graphics object we will use to draw in the display, and configure its rendering hints properly.

See if any of the cue grid button states have changed, and list any required updates as tuples of the pad x and y coordinates, corresponding grid pad array index, and the new desired color.

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.

The color gauge tracks will use unless otherwise specified.

Return a dimmed version of a color.

The color for dim amber buttons.

The color for dim green buttons.

The color for dim red buttons.

The color for dim white buttons.

Draw a label under an encoder at the top of the graphical display, with an attributed string so the label can have mixed fonts, colors, etc. Assumes the value will fit in the allocated space.

Draw one of the marks representing a beat on the beat grid.

Draw a graphical gauge with an indicator that covers the left or right half of an arc under a variable value, depending on if the value is true or false. The default color for the track is dim white. The color for the current value area is either red (for no) or green (for yes), and is dimmed when :active? is false. To support animating state changes, a :fraction parameter can be supplied which specifies how far from the opposite state the indicator should be drawn.

Draw a label for a button below the graphical display.

Draw a graphical gauge with an indicator that rides around an circle (starting at the bottom) under a variable value. The default range is from 0 to 360 (for hues), and the default color for both the track and active area is dim white.

Draw an appropriate gauge for a cue variable given its type and value.

Displays the appropriate style of adjustment gauge for variables currently assigned to the encoders over an active cue.

Draw the names of adjustable variables under the appropriate encoders for a cue.

Draw a label under an encoder at the top of the graphical display.

Displays an animated visualization of the cue progress right above the name for cues which support this.

Draw a label under an encoder at the top of the graphical display.

Draw a graphical gauge with an indicator that fills an arc under a variable value. The default range is from zero to a hundred, and the default color for both the track and active area is dim white.

Draw a graphical gauge whose colors are the hues of the color circle, with an indicator that rides around an circle (starting at the bottom) under a variable value.

Draw a mostly meaningless gauge simply to indicate that the encoder is doing something. Used for beat adjustments, for example, which have no reasonable range or location to show.

Draw a graphical gauge with an indicator that extends from the top center of an arc under a variable value. The default range is from zero to a hundred, and the default color for both the track and active area is dim white.

Draw a graphical gauge whose colors are the saturation levels of the specified hue circle, with an indicator like that of a level gauge, under a variable value.

A representation of the state when all 64 of the grid pads are off.

A representation of the state when all eight of the top pads are off.

The height at which to draw the line under an encoder label.

Truncates a string (appending an ellipsis) enough to fit within a given pixel width.

The font used when drawing cue variable values.

The font used when drawing cue variable values.

The font used when drawing labels under encoders.

The font used when drawing metronome values.

Find one of the fonts configured for use on the display by keyword, which should be one of :condensed, :condensed-light, :roboto, or :roboto-medium. The style argument is a java.awt.Font style constant, and size is point size.

Roboto is available in all style variations, Roboto Medium in plain and italic, Condensed only in bold, and condensed light in plain and italic.

The color for bright green buttons.

The number of cue grid LED updates that can be sent before we need to wait and re-synch with the Push 2, to avoid overflowing buffers.

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

Light any custom buttons that have been configured to make it clear they are active. (If the button already has a lightness value, it was not appropriate for it to have been configured as a custom button, so leave it alone.)

Load and register the fonts we will use to draw on the display, if they have not already been.

The background for the grand master section, to mark it as such.

The color for content in the metronome section, to mark it as such.

The background for the metronome section, to mark it as such.

The color for content in the metronome section, to mark it as such.

The color to use for the text explaining that no effects are active.

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.

Capture an animated GIF of the display for documentation purposes. Takes a filename to which the animation should be written. Returns a function which you must call to end the recording and close the file. Defaults to creating an animation which loops, but you can override that by passing false with the optional keyword argument :loop.

The color for bright red buttons.

Send a MIDI System Exclusive command to the Push 2 with the proper prefix. The command argument begins with the Command ID of the desired command, as listed in Table 2.4.2 of the Ableton Push 2 MIDI and Display Interface Manual, followed by its parameter bytes. The SOX byte, Ableton Sysex ID, device ID, and model ID will be prepended, and the EOX byte appended, before sending the command.

Set one of the labeled buttons to a particular color (if it is a monochrome button, the lightness of the color is translated to a control value; otherwise, the palette entry assigned to the button is set to the specified color, and the corresponding velocity is sent.

Set one of the color LEDs that respond to control change values to a particular color. If the color is black, we send a control value of zero. Otherwise, we take over the color palette entry assigned to the LED, and set it to the desired RGB value, then send it a control change with the velocity corresponding to the palette entry we just adjusted.

Since we also have to set a white value, we pass along the white value that was present in the palette we found for this entry when initially binding to the Push 2.

Set one of the pads below the row of display encoders to a particular color.

Set the paint of the supplied graphics context to use the specified color.

Set the color of one of the 64 touch pads to a specific RGB color. If the color is black, we send a note off to the pad. Otherwise, we take over the color palette entry whose velocity matches the note number of the pad, and set it to the desired RGB value, then send it a note with the velocity corresponding to the palette entry we just adjusted.

Since we also have to set a white value, we pass along the white value that was present in the palette we found for this velocity when initially binding to the Push 2.

Set one of the top-row pads (between the grid and the display) to a particular color.

Set the touch strip operating mode.

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 overlay drawn on top of the effects when the show is stopped.

Determines how many pixels wide a string will be in a given font and render context.

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

The values which are combined to set the touch strip into particular modes.

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.

The mode to which we should set the touch strip when we want to be able to individually set LEDs, for example to turn them all off.

Given a list of needed cue grid updates, send at most grid-update-chunk-size of them, and return the remaining list.

The color for bright white buttons.