Package heronarts.lx.modulation

Class LXParameterModulation

java.lang.Object

heronarts.lx.LXComponent

heronarts.lx.modulation.LXParameterModulation

All Implemented Interfaces:

LXPath, LXSerializable, LXParameterListener

Direct Known Subclasses:

LXCompoundModulation, LXTriggerModulation

public abstract class LXParameterModulation
extends LXComponent

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	LXParameterModulation.CircularDependencyException
static class	LXParameterModulation.InvalidScopeException
static class	LXParameterModulation.ModulationException

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

LXComponent.Author, LXComponent.Description, LXComponent.Hidden, LXComponent.Name, LXComponent.Placeholder, LXComponent.PluginRequired, LXComponent.Renamable, LXComponent.Tags

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

LXSerializable.Utils

Field Summary

Fields

Modifier and Type	Field	Description
final DiscreteColorParameter	clr
final DiscreteColorParameter	color
final BooleanParameter	enabled
protected int	index
protected static final String	KEY_SOURCE
protected static final String	KEY_TARGET
final LXModulationEngine	scope
final LXParameter	source
final LXParameter	target

Fields inherited from class heronarts.lx.LXComponent

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

Fields inherited from interface heronarts.lx.LXPath

DEFAULT_SEPARATOR, ROOT, ROOT_PREFIX, ROOT_SLASH

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	LXParameterModulation(LXModulationEngine scope, LXParameter source, LXParameter target)

Method Summary

Modifier and Type	Method	Description
void	dispose()	Invoked when a component is being removed from the system and will no longer be used at all.
int	getIndex()
String	getLabel()	Accessor for the user-facing label of this component.
protected static LXParameter	getParameter(LX lx, LXModulationEngine scope, JsonObject obj)
LXParameter	getTarget()
static JsonObject	move(JsonObject obj, LXModulationEngine scope, Map<String,String> pathChanges, LXComponent moved)
void	save(LX lx, JsonObject obj)	Serializes the LX component.
LXParameterModulation	setIndex(int index)

Methods inherited from class heronarts.lx.LXComponent

addArray, addChild, addInternalParameter, addInternalParameters, addLegacyInternalParameter, addLegacyParameter, addParameter, addParameter, addParameters, assertDisposed, contains, copyParameters, getCategory, getChild, getComponentDescription, getComponentName, getComponentName, getComponentName, getDescription, getId, getLX, getOscAddress, getOscLabel, getOscPath, getParameter, getParameters, getParent, getPath, handleOscMessage, hasParameter, isSnapshotControl, isValidOscParameter, load, loadParameters, loadPreset, onParameterChanged, 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.LXPath

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

Field Details

index

protected int index

scope

public final LXModulationEngine scope

source

public final LXParameter source

target

public final LXParameter target

color

public final DiscreteColorParameter color

clr

public final DiscreteColorParameter clr

enabled

public final BooleanParameter enabled

KEY_SOURCE

protected static final String KEY_SOURCE

See Also:

• Constant Field Values

KEY_TARGET

protected static final String KEY_TARGET

See Also:

• Constant Field Values

Constructor Details

LXParameterModulation

protected LXParameterModulation(LXModulationEngine scope,
 LXParameter source,
 LXParameter target)
                         throws LXParameterModulation.ModulationException

Throws:

LXParameterModulation.ModulationException

Method Details

setIndex

public LXParameterModulation setIndex(int index)

getIndex

public int getIndex()

getTarget

public LXParameter getTarget()

getLabel

public String getLabel()

Description copied from class: LXComponent

Accessor for the user-facing label of this component. Objects that implement the LXComponent.Renamable interface may allow the user to change this value.

Specified by:

getLabel in interface LXPath

Overrides:

getLabel in class LXComponent

Returns:

Label for this component

getParameter

protected static LXParameter getParameter(LX lx,
 LXModulationEngine scope,
 JsonObject obj)

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 LXComponent

save

public void save(LX lx,
 JsonObject obj)

Description copied from class: LXComponent

Serializes the LX component. By default, all internal and user-facing parameters are serialized, as well as any explicitly registered child components. Note that child arrays are not serialized, or any other dynamic components. Subclasses may override to perform more saving, and are expected to call super.save(lx, obj) at the appropriate time.

Specified by:

save in interface LXSerializable

Overrides:

save in class LXComponent

Parameters:

lx - LX instance

obj - Object to serialize into

move

public static JsonObject move(JsonObject obj,
 LXModulationEngine scope,
 Map<String,String> pathChanges,
 LXComponent moved)