Package heronarts.lx.midi.surface

Class APC40Mk2

java.lang.Object

heronarts.lx.LXComponent

heronarts.lx.midi.surface.LXMidiSurface

heronarts.lx.midi.surface.APC40Mk2

All Implemented Interfaces:

LXPath, LXSerializable, LXMidiListener, LXMidiSurface.Bidirectional, LXParameterListener

@Name("Akai APC40 mkII")
@DeviceName("APC40 mkII")
public class APC40Mk2
extends LXMidiSurface
implements LXMidiSurface.Bidirectional

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	APC40Mk2.GridMode

Nested classes/interfaces inherited from class heronarts.lx.midi.surface.LXMidiSurface

LXMidiSurface.Bidirectional, LXMidiSurface.DeviceName, LXMidiSurface.Name

Nested classes/interfaces inherited from class heronarts.lx.LXComponent

LXComponent.Description, LXComponent.Hidden, LXComponent.Placeholder, LXComponent.PluginRequired, LXComponent.Renamable

Nested classes/interfaces inherited from interface heronarts.lx.LXSerializable

LXSerializable.Utils

Field Summary

Fields

Modifier and Type	Field	Description
static final byte	ABLETON_ALTERNATE_MODE
static final byte	ABLETON_MODE
static final int	BANK
static final int	BANK_LEFT
static final int	BANK_RIGHT
static final int	BANK_SELECT_DOWN
static final int	BANK_SELECT_LEFT
static final int	BANK_SELECT_RIGHT
static final int	BANK_SELECT_UP
static final int	CHANNEL_ACTIVE
static final int	CHANNEL_ARM
static final int	CHANNEL_CROSSFADE_GROUP
static final int	CHANNEL_FADER
static final int	CHANNEL_FOCUS
static final int	CHANNEL_KNOB
static final int	CHANNEL_KNOB_MAX
static final int	CHANNEL_KNOB_NUM
static final int	CHANNEL_KNOB_STYLE
static final int	CHANNEL_KNOB_STYLE_MAX
static final int	CHANNEL_SOLO
static final int	CLIP_DEVICE_VIEW
static final int	CLIP_LAUNCH
static final int	CLIP_LAUNCH_COLUMNS
static final int	CLIP_LAUNCH_MAX
static final int	CLIP_LAUNCH_NUM
static final int	CLIP_LAUNCH_ROWS
static final int	CLIP_STOP
static final int	CROSSFADER
final BooleanParameter	crossfaderEnabled
static final int	CUE_LEVEL
static final int	DETAIL_VIEW
static final int	DEVICE_KNOB
static final int	DEVICE_KNOB_MAX
static final int	DEVICE_KNOB_NUM
static final int	DEVICE_KNOB_STYLE
static final int	DEVICE_KNOB_STYLE_MAX
static final int	DEVICE_LEFT
static final int	DEVICE_LOCK
static final int	DEVICE_ON_OFF
static final int	DEVICE_RIGHT
final BooleanParameter	deviceControl
final EnumParameter<LXMidiParameterControl.Mode>	faderMode
static final byte	GENERIC_MODE
static final int	LED_AMBER
static final int	LED_AMBER_DIM
static final int	LED_AMBER_HALF
static final int	LED_CLIP_STOP_BLINK
static final int	LED_CYAN
static final int	LED_GRAY
static final int	LED_GRAY_DIM
static final int	LED_GREEN
static final int	LED_GREEN_HALF
static final int	LED_MODE_BLINK
static final int	LED_MODE_PRIMARY
static final int	LED_MODE_PULSE
static final int	LED_OFF
static final int	LED_ON
static final int	LED_ORANGE_RED
static final int	LED_RED
static final int	LED_RED_HALF
protected static final int	LED_STYLE_BIPOLAR
protected static final int	LED_STYLE_OFF
protected static final int	LED_STYLE_SINGLE
protected static final int	LED_STYLE_UNIPOLAR
static final int	LED_YELLOW
static final int	LED_YELLOW_HALF
static final int	MASTER_FADER
static final int	MASTER_FOCUS
static final int	MASTER_SWATCH
final BooleanParameter	masterFaderEnabled
static final int	METRONOME
protected final MixerSurface	mixerSurface
static final int	NUDGE_MINUS
static final int	NUDGE_PLUS
static final int	NUM_CHANNELS
static final int	PALETTE_SWATCH_COLUMNS
static final int	PALETTE_SWATCH_ROWS
static final int	PAN
final BooleanParameter	performanceLock
static final int	PLAY
static final int	RAINBOW_GRID_COLUMNS
static final int	RAINBOW_GRID_ROWS
static final int	RAINBOW_HUE_STEP
static final int	RECORD
static final int	SCENE_LAUNCH
static final int	SCENE_LAUNCH_MAX
static final int	SCENE_LAUNCH_NUM
static final int	SENDS
static final int	SESSION
static final int	SHIFT
static final int	STOP_ALL_CLIPS
static final int	TAP_TEMPO
static final int	TEMPO
static final int	USER

Fields inherited from class heronarts.lx.midi.surface.LXMidiSurface

connected, destinationDevice, enabled, KEY_CLASS, KEY_NAME, KEY_SETTINGS, KEY_STATE, lx, mutableSettings, mutableState, settings, sourceDevice, state

Fields inherited from class heronarts.lx.LXComponent

childArrays, children, internalParameters, KEY_CHILDREN, KEY_COMPONENT_ID, KEY_ID, KEY_INTERNAL, KEY_PARAMETER_PATH, KEY_PARAMETERS, KEY_PATH, KEY_RESET, label, legacyInternalParameters, legacyParameters, modulationColor, modulationControlsExpanded, modulationsExpanded, parameters, presetFile

Fields inherited from interface heronarts.lx.LXPath

DEFAULT_SEPARATOR, ROOT, ROOT_PREFIX, ROOT_SLASH

Constructor Summary

Constructors

Constructor	Description
APC40Mk2(LX lx, LXMidiInput input, LXMidiOutput output)

Method Summary

Modifier and Type	Method	Description
void	controlChangeReceived(MidiControlChange cc)
void	dispose()	Invoked when a component is being removed from the system and will no longer be used at all.
int	getRemoteControlLength()
int	getRemoteControlStart()
boolean	isRemoteControlAux()
void	noteOffReceived(MidiNote note)
void	noteOnReceived(MidiNoteOn note)
protected void	onEnable(boolean on)	Subclasses may override, invoked automatically when surface is enabled/disabled.
void	onParameterChanged(LXParameter p)	Subclasses are free to override this if desired.
protected void	onReconnect()	Subclasses may override, invoked when the control surface was disconnected but has now reconnected, while still being in the enabled state.

Methods inherited from class heronarts.lx.midi.surface.LXMidiSurface

addSetting, addState, aftertouchReceived, getDeviceName, getDeviceName, getInput, getName, getOutput, getSurfaceName, getSurfaceName, hasRememberFlag, initializeDefaultIO, load, matches, pitchBendReceived, programChangeReceived, save, sendControlChange, sendNoteOn, sendSysex, setRememberFlag, sysexReceived

Methods inherited from class heronarts.lx.LXComponent

addArray, addChild, addInternalParameter, addLegacyInternalParameter, addLegacyParameter, addParameter, addParameter, addParameters, assertDisposed, contains, copyParameters, getCategory, getChild, getComponentDescription, getComponentName, getComponentName, getComponentName, getDescription, getId, getLabel, getLX, getOscAddress, getOscLabel, getOscPath, getParameter, getParameters, getParent, getPath, handleOscMessage, hasParameter, isValidOscParameter, loadParameters, loadPreset, removeParameter, removeParameter, removeParameter, removeParameter, savePreset, setDescription, setParent, toOscQuery, toOscQuery, toOscQuery, toString, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface heronarts.lx.midi.LXMidiListener

midiPanicReceived

Methods inherited from interface heronarts.lx.LXPath

getCanonicalLabel, getCanonicalLabel, getCanonicalLabel, getCanonicalLabel, getCanonicalLabel, getCanonicalPath, getCanonicalPath, isDescendant

Field Details

GENERIC_MODE

public static final byte GENERIC_MODE

See Also:

• Constant Field Values

ABLETON_MODE

public static final byte ABLETON_MODE

See Also:

• Constant Field Values

ABLETON_ALTERNATE_MODE

public static final byte ABLETON_ALTERNATE_MODE

See Also:

• Constant Field Values

LED_STYLE_OFF

protected static final int LED_STYLE_OFF

See Also:

• Constant Field Values

LED_STYLE_SINGLE

protected static final int LED_STYLE_SINGLE

See Also:

• Constant Field Values

LED_STYLE_UNIPOLAR

protected static final int LED_STYLE_UNIPOLAR

See Also:

• Constant Field Values

LED_STYLE_BIPOLAR

protected static final int LED_STYLE_BIPOLAR

See Also:

• Constant Field Values

NUM_CHANNELS

public static final int NUM_CHANNELS

See Also:

• Constant Field Values

CLIP_LAUNCH_ROWS

public static final int CLIP_LAUNCH_ROWS

See Also:

• Constant Field Values

CLIP_LAUNCH_COLUMNS

public static final int CLIP_LAUNCH_COLUMNS

See Also:

• Constant Field Values

PALETTE_SWATCH_ROWS

public static final int PALETTE_SWATCH_ROWS

See Also:

• Constant Field Values

PALETTE_SWATCH_COLUMNS

public static final int PALETTE_SWATCH_COLUMNS

See Also:

• Constant Field Values

MASTER_SWATCH

public static final int MASTER_SWATCH

See Also:

• Constant Field Values

RAINBOW_GRID_COLUMNS

public static final int RAINBOW_GRID_COLUMNS

See Also:

• Constant Field Values

RAINBOW_GRID_ROWS

public static final int RAINBOW_GRID_ROWS

See Also:

• Constant Field Values

RAINBOW_HUE_STEP

public static final int RAINBOW_HUE_STEP

See Also:

• Constant Field Values

CHANNEL_FADER

public static final int CHANNEL_FADER

See Also:

• Constant Field Values

TEMPO

public static final int TEMPO

See Also:

• Constant Field Values

MASTER_FADER

public static final int MASTER_FADER

See Also:

• Constant Field Values

CROSSFADER

public static final int CROSSFADER

See Also:

• Constant Field Values

CUE_LEVEL

public static final int CUE_LEVEL

See Also:

• Constant Field Values

DEVICE_KNOB

public static final int DEVICE_KNOB

See Also:

• Constant Field Values

DEVICE_KNOB_NUM

public static final int DEVICE_KNOB_NUM

See Also:

• Constant Field Values

DEVICE_KNOB_MAX

public static final int DEVICE_KNOB_MAX

See Also:

• Constant Field Values

DEVICE_KNOB_STYLE

public static final int DEVICE_KNOB_STYLE

See Also:

• Constant Field Values

DEVICE_KNOB_STYLE_MAX

public static final int DEVICE_KNOB_STYLE_MAX

See Also:

• Constant Field Values

CHANNEL_KNOB

public static final int CHANNEL_KNOB

See Also:

• Constant Field Values

CHANNEL_KNOB_NUM

public static final int CHANNEL_KNOB_NUM

See Also:

• Constant Field Values

CHANNEL_KNOB_MAX

public static final int CHANNEL_KNOB_MAX

See Also:

• Constant Field Values

CHANNEL_KNOB_STYLE

public static final int CHANNEL_KNOB_STYLE

See Also:

• Constant Field Values

CHANNEL_KNOB_STYLE_MAX

public static final int CHANNEL_KNOB_STYLE_MAX

See Also:

• Constant Field Values

CLIP_LAUNCH

public static final int CLIP_LAUNCH

See Also:

• Constant Field Values

CLIP_LAUNCH_NUM

public static final int CLIP_LAUNCH_NUM

See Also:

• Constant Field Values

CLIP_LAUNCH_MAX

public static final int CLIP_LAUNCH_MAX

See Also:

• Constant Field Values

CHANNEL_ARM

public static final int CHANNEL_ARM

See Also:

• Constant Field Values

CHANNEL_SOLO

public static final int CHANNEL_SOLO

See Also:

• Constant Field Values

CHANNEL_ACTIVE

public static final int CHANNEL_ACTIVE

See Also:

• Constant Field Values

CHANNEL_FOCUS

public static final int CHANNEL_FOCUS

See Also:

• Constant Field Values

CLIP_STOP

public static final int CLIP_STOP

See Also:

• Constant Field Values

DEVICE_LEFT

public static final int DEVICE_LEFT

See Also:

• Constant Field Values

DEVICE_RIGHT

public static final int DEVICE_RIGHT

See Also:

• Constant Field Values

BANK_LEFT

public static final int BANK_LEFT

See Also:

• Constant Field Values

BANK_RIGHT

public static final int BANK_RIGHT

See Also:

• Constant Field Values

DEVICE_ON_OFF

public static final int DEVICE_ON_OFF

See Also:

• Constant Field Values

DEVICE_LOCK

public static final int DEVICE_LOCK

See Also:

• Constant Field Values

CLIP_DEVICE_VIEW

public static final int CLIP_DEVICE_VIEW

See Also:

• Constant Field Values

DETAIL_VIEW

public static final int DETAIL_VIEW

See Also:

• Constant Field Values

CHANNEL_CROSSFADE_GROUP

public static final int CHANNEL_CROSSFADE_GROUP

See Also:

• Constant Field Values

MASTER_FOCUS

public static final int MASTER_FOCUS

See Also:

• Constant Field Values

STOP_ALL_CLIPS

public static final int STOP_ALL_CLIPS

See Also:

• Constant Field Values

SCENE_LAUNCH

public static final int SCENE_LAUNCH

See Also:

• Constant Field Values

SCENE_LAUNCH_NUM

public static final int SCENE_LAUNCH_NUM

See Also:

• Constant Field Values

SCENE_LAUNCH_MAX

public static final int SCENE_LAUNCH_MAX

See Also:

• Constant Field Values

PAN

public static final int PAN

See Also:

• Constant Field Values

SENDS

public static final int SENDS

See Also:

• Constant Field Values

USER

public static final int USER

See Also:

• Constant Field Values

PLAY

public static final int PLAY

See Also:

• Constant Field Values

RECORD

public static final int RECORD

See Also:

• Constant Field Values

SESSION

public static final int SESSION

See Also:

• Constant Field Values

BANK_SELECT_UP

public static final int BANK_SELECT_UP

See Also:

• Constant Field Values

BANK_SELECT_DOWN

public static final int BANK_SELECT_DOWN

See Also:

• Constant Field Values

BANK_SELECT_RIGHT

public static final int BANK_SELECT_RIGHT

See Also:

• Constant Field Values

BANK_SELECT_LEFT

public static final int BANK_SELECT_LEFT

See Also:

• Constant Field Values

SHIFT

public static final int SHIFT

See Also:

• Constant Field Values

METRONOME

public static final int METRONOME

See Also:

• Constant Field Values

TAP_TEMPO

public static final int TAP_TEMPO

See Also:

• Constant Field Values

NUDGE_MINUS

public static final int NUDGE_MINUS

See Also:

• Constant Field Values

NUDGE_PLUS

public static final int NUDGE_PLUS

See Also:

• Constant Field Values

BANK

public static final int BANK

See Also:

• Constant Field Values

LED_OFF

public static final int LED_OFF

See Also:

• Constant Field Values

LED_ON

public static final int LED_ON

See Also:

• Constant Field Values

LED_GRAY

public static final int LED_GRAY

See Also:

• Constant Field Values

LED_CYAN

public static final int LED_CYAN

See Also:

• Constant Field Values

LED_GRAY_DIM

public static final int LED_GRAY_DIM

See Also:

• Constant Field Values

LED_RED

public static final int LED_RED

See Also:

• Constant Field Values

LED_RED_HALF

public static final int LED_RED_HALF

See Also:

• Constant Field Values

LED_ORANGE_RED

public static final int LED_ORANGE_RED

See Also:

• Constant Field Values

LED_GREEN

public static final int LED_GREEN

See Also:

• Constant Field Values

LED_GREEN_HALF

public static final int LED_GREEN_HALF

See Also:

• Constant Field Values

LED_YELLOW

public static final int LED_YELLOW

See Also:

• Constant Field Values

LED_YELLOW_HALF

public static final int LED_YELLOW_HALF

See Also:

• Constant Field Values

LED_AMBER

public static final int LED_AMBER

See Also:

• Constant Field Values

LED_AMBER_HALF

public static final int LED_AMBER_HALF

See Also:

• Constant Field Values

LED_AMBER_DIM

public static final int LED_AMBER_DIM

See Also:

• Constant Field Values

LED_MODE_PRIMARY

public static final int LED_MODE_PRIMARY

See Also:

• Constant Field Values

LED_MODE_PULSE

public static final int LED_MODE_PULSE

See Also:

• Constant Field Values

LED_MODE_BLINK

public static final int LED_MODE_BLINK

See Also:

• Constant Field Values

LED_CLIP_STOP_BLINK

public static final int LED_CLIP_STOP_BLINK

See Also:

• Constant Field Values

mixerSurface

protected final MixerSurface mixerSurface

masterFaderEnabled

public final BooleanParameter masterFaderEnabled

crossfaderEnabled

public final BooleanParameter crossfaderEnabled

deviceControl

public final BooleanParameter deviceControl

performanceLock

public final BooleanParameter performanceLock

faderMode

public final EnumParameter<LXMidiParameterControl.Mode> faderMode

Constructor Details

APC40Mk2

public APC40Mk2(LX lx,
 LXMidiInput input,
 LXMidiOutput output)

Method Details

onParameterChanged

public void onParameterChanged(LXParameter p)

Description copied from class: LXComponent

Subclasses are free to override this if desired. It will automatically fire for any listenable parameter that is registered with this component.

Specified by:

onParameterChanged in interface LXParameterListener

Overrides:

onParameterChanged in class LXMidiSurface

Parameters:

p - Parameter that has a value change

onEnable

protected void onEnable(boolean on)

Description copied from class: LXMidiSurface

Subclasses may override, invoked automatically when surface is enabled/disabled. This is the typical place to send MIDI messages that configure the state and behavior of a MIDI control surface that has different modes or customization available

Overrides:

onEnable in class LXMidiSurface

Parameters:

on - Whether surface is enabled

onReconnect

protected void onReconnect()

Description copied from class: LXMidiSurface

Subclasses may override, invoked when the control surface was disconnected but has now reconnected, while still being in the enabled state.

Overrides:

onReconnect in class LXMidiSurface

noteOnReceived

public void noteOnReceived(MidiNoteOn note)

Specified by:

noteOnReceived in interface LXMidiListener

Overrides:

noteOnReceived in class LXMidiSurface

noteOffReceived

public void noteOffReceived(MidiNote note)

Specified by:

noteOffReceived in interface LXMidiListener

Overrides:

noteOffReceived in class LXMidiSurface

controlChangeReceived

public void controlChangeReceived(MidiControlChange cc)

Specified by:

controlChangeReceived in interface LXMidiListener

Overrides:

controlChangeReceived in class LXMidiSurface

getRemoteControlStart

public int getRemoteControlStart()

Overrides:

getRemoteControlStart in class LXMidiSurface

getRemoteControlLength

public int getRemoteControlLength()

Overrides:

getRemoteControlLength in class LXMidiSurface

isRemoteControlAux

public boolean isRemoteControlAux()

Overrides:

isRemoteControlAux in class LXMidiSurface

dispose

public void dispose()

Description copied from class: LXComponent

Invoked when a component is being removed from the system and will no longer be used at all. This unregisters the component and should free up any resources and parameter listeners. Ideally after this method is called the object should be eligible for garbage collection. Subclasses are generally expected to override this method to handle their particular cleanup work. They should also generally call super.dispose() at the appropriate time to perform the basic cleanup, which may need to happen either before or after cleaning up other objects.

Overrides:

dispose in class LXMidiSurface