Package heronarts.lx.midi.surface

Class APC40

java.lang.Object

heronarts.lx.LXComponent

heronarts.lx.midi.surface.LXMidiSurface

heronarts.lx.midi.surface.APC40

All Implemented Interfaces:

LXPath, LXSerializable, LXMidiListener, LXMidiSurface.Bidirectional, LXParameterListener

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

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	APC40.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_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_SOLO
static final int	CLIP_LAUNCH
static final int	CLIP_LAUNCH_COLUMNS
static final int	CLIP_LAUNCH_MAX
static final int	CLIP_LAUNCH_ROWS
static final int	CLIP_STOP
static final int	CLIP_TRACK
final BooleanParameter	clipLaunchEnabled
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_ON_OFF
static final int	DEVICE_RIGHT
final EnumParameter<LXMidiParameterControl.Mode>	faderMode
static final byte	GENERIC_MODE
static final int	LED_BLINK
static final int	LED_GREEN
static final int	LED_GREEN_BLINK
static final int	LED_OFF
static final int	LED_ON
static final int	LED_RED
static final int	LED_RED_BLINK
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_BLINK
static final int	MASTER_FADER
static final int	MASTER_FOCUS
final BooleanParameter	masterFaderEnabled
static final int	METRONOME
static final int	MIDI_OVERDUB
protected final MixerSurface	mixerSurface
static final int	NUDGE_MINUS
static final int	NUDGE_PLUS
static final int	NUM_CHANNELS
static final int	PAN
static final int	PLAY
static final int	REC_QUANTIZE
static final int	RECORD
static final int	SCENE_LAUNCH
static final int	SCENE_LAUNCH_MAX
static final int	SCENE_LAUNCH_NUM
static final int	SEND_A
static final int	SEND_B
static final int	SEND_C
static final int	SHIFT
static final int	STOP
static final int	STOP_ALL_CLIPS
static final int	TAP_TEMPO
static final int	TRACK_KNOB
static final int	TRACK_KNOB_MAX
static final int	TRACK_KNOB_NUM
static final int	TRACK_KNOB_STYLE
static final int	TRACK_KNOB_STYLE_MAX

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
APC40(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.
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, getRemoteControlLength, getRemoteControlStart, getSurfaceName, getSurfaceName, hasRememberFlag, initializeDefaultIO, isRemoteControlAux, 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

CHANNEL_FADER

public static final int CHANNEL_FADER

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

TRACK_KNOB

public static final int TRACK_KNOB

See Also:

• Constant Field Values

TRACK_KNOB_NUM

public static final int TRACK_KNOB_NUM

See Also:

• Constant Field Values

TRACK_KNOB_MAX

public static final int TRACK_KNOB_MAX

See Also:

• Constant Field Values

TRACK_KNOB_STYLE

public static final int TRACK_KNOB_STYLE

See Also:

• Constant Field Values

TRACK_KNOB_STYLE_MAX

public static final int TRACK_KNOB_STYLE_MAX

See Also:

• Constant Field Values

CLIP_LAUNCH

public static final int CLIP_LAUNCH

See Also:

• Constant Field Values

CLIP_LAUNCH_ROWS

public static final int CLIP_LAUNCH_ROWS

See Also:

• Constant Field Values

CLIP_LAUNCH_MAX

public static final int CLIP_LAUNCH_MAX

See Also:

• Constant Field Values

CLIP_LAUNCH_COLUMNS

public static final int CLIP_LAUNCH_COLUMNS

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

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

SEND_A

public static final int SEND_A

See Also:

• Constant Field Values

SEND_B

public static final int SEND_B

See Also:

• Constant Field Values

SEND_C

public static final int SEND_C

See Also:

• Constant Field Values

PLAY

public static final int PLAY

See Also:

• Constant Field Values

STOP

public static final int STOP

See Also:

• Constant Field Values

RECORD

public static final int RECORD

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

TAP_TEMPO

public static final int TAP_TEMPO

See Also:

• Constant Field Values

NUDGE_PLUS

public static final int NUDGE_PLUS

See Also:

• Constant Field Values

NUDGE_MINUS

public static final int NUDGE_MINUS

See Also:

• Constant Field Values

CLIP_TRACK

public static final int CLIP_TRACK

See Also:

• Constant Field Values

DEVICE_ON_OFF

public static final int DEVICE_ON_OFF

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

DETAIL_VIEW

public static final int DETAIL_VIEW

See Also:

• Constant Field Values

REC_QUANTIZE

public static final int REC_QUANTIZE

See Also:

• Constant Field Values

MIDI_OVERDUB

public static final int MIDI_OVERDUB

See Also:

• Constant Field Values

METRONOME

public static final int METRONOME

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_BLINK

public static final int LED_BLINK

See Also:

• Constant Field Values

LED_GREEN

public static final int LED_GREEN

See Also:

• Constant Field Values

LED_GREEN_BLINK

public static final int LED_GREEN_BLINK

See Also:

• Constant Field Values

LED_RED

public static final int LED_RED

See Also:

• Constant Field Values

LED_RED_BLINK

public static final int LED_RED_BLINK

See Also:

• Constant Field Values

LED_YELLOW

public static final int LED_YELLOW

See Also:

• Constant Field Values

LED_YELLOW_BLINK

public static final int LED_YELLOW_BLINK

See Also:

• Constant Field Values

mixerSurface

protected final MixerSurface mixerSurface

masterFaderEnabled

public final BooleanParameter masterFaderEnabled

crossfaderEnabled

public final BooleanParameter crossfaderEnabled

clipLaunchEnabled

public final BooleanParameter clipLaunchEnabled

faderMode

public final EnumParameter<LXMidiParameterControl.Mode> faderMode

Constructor Details

APC40

public APC40(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

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