heronarts.lx.parameter

Class NormalizedParameter

java.lang.Object

heronarts.lx.parameter.NormalizedParameter

All Implemented Interfaces:

LXPath, LXNormalizedParameter, LXParameter

public class NormalizedParameter
extends Object
implements LXNormalizedParameter

Simple normalized parameter which is not listenable.

Nested Class Summary

Nested classes/interfaces inherited from interface heronarts.lx.parameter.LXParameter

LXParameter.Formatter, LXParameter.Polarity, LXParameter.Units

Constructor Summary

Constructors

Constructor and Description
NormalizedParameter(String label)
NormalizedParameter(String label, double value)

Method Summary

Modifier and Type	Method and Description
void	dispose() Invoked when the parameter is done being used and none of its resources are needed anymore.
String	getDescription() Returns a contextual help message explaining the purpose of this parameter to the user, or null if none is available.
double	getExponent() Gets the exponent used for scaling this parameter across its normalized range.
LXParameter.Formatter	getFormatter() Gets the formatter to be used for printing this parameter's value
String	getLabel() Gets the label for this parameter
double	getNormalized() Gets the value of the parameter in a normalized space from 0 to 1
float	getNormalizedf() Gets the value of the parameter in a normalized space as a float
LXComponent	getParent() Returns the component that this object belongs to
String	getPath() Returns the immediate path of this component, relative to its parent
LXParameter.Polarity	getPolarity() Gets the polarity of this parameter.
LXParameter.Units	getUnits() Gets the unit format that this parameter's value stores.
double	getValue() Retrieves the value of the parameter
float	getValuef() Utility helper function to get the value of the parameter as a float.
boolean	isMappable() Whether this parameter should be eligible for mapping via MIDI or modulation control.
NormalizedParameter	reset() A method to reset the value of the parameter, if a default is available.
NormalizedParameter	setComponent(LXComponent component, String path) Sets the component that owns this parameter
NormalizedParameter	setDescription(String description)
NormalizedParameter	setNormalized(double value) Sets the value or the parameter in normalized space from 0 to 1
NormalizedParameter	setValue(double value) Sets the value of the parameter.

Methods inherited from class java.lang.Object

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

Methods inherited from interface heronarts.lx.parameter.LXParameter

setMappable

Methods inherited from interface heronarts.lx.LXPath

get, get, getCanonicalLabel, getCanonicalLabel, getCanonicalPath, getCanonicalPath, getComponent, getComponent, getParameter, getParameter

Constructor Detail

NormalizedParameter

public NormalizedParameter(String label)

NormalizedParameter

public NormalizedParameter(String label,
                           double value)

Method Detail

setComponent

public NormalizedParameter setComponent(LXComponent component,
                                        String path)

Description copied from interface: LXParameter

Sets the component that owns this parameter

Specified by:

setComponent in interface LXParameter

Parameters:

component - Component

path - Path name for parameter

Returns:

this

getParent

public LXComponent getParent()

Description copied from interface: LXPath

Returns the component that this object belongs to

Specified by:

getParent in interface LXPath

Returns:

Parent component of this path object, or null if it is unowned

getPath

public String getPath()

Description copied from interface: LXPath

Returns the immediate path of this component, relative to its parent

Specified by:

getPath in interface LXPath

Returns:

Path of this object relative to its parent component

setDescription

public NormalizedParameter setDescription(String description)

getDescription

public String getDescription()

Description copied from interface: LXParameter

Returns a contextual help message explaining the purpose of this parameter to the user, or null if none is available.

Specified by:

getDescription in interface LXParameter

Returns:

Contextual help string explaining purpose of parameter.

getFormatter

public LXParameter.Formatter getFormatter()

Description copied from interface: LXParameter

Gets the formatter to be used for printing this parameter's value

Specified by:

getFormatter in interface LXParameter

Returns:

Formatter

getUnits

public LXParameter.Units getUnits()

Description copied from interface: LXParameter

Gets the unit format that this parameter's value stores.

Specified by:

getUnits in interface LXParameter

Returns:

Units

getPolarity

public LXParameter.Polarity getPolarity()

Description copied from interface: LXParameter

Gets the polarity of this parameter.

Specified by:

getPolarity in interface LXParameter

Returns:

polarity of this parameter

dispose

public void dispose()

Description copied from interface: LXParameter

Invoked when the parameter is done being used and none of its resources are needed anymore.

Specified by:

dispose in interface LXParameter

reset

public NormalizedParameter reset()

Description copied from interface: LXParameter

A method to reset the value of the parameter, if a default is available. Not necessarily defined for all parameters, may be ignored.

Specified by:

reset in interface LXParameter

Returns:

this

setValue

public NormalizedParameter setValue(double value)

Description copied from interface: LXParameter

Sets the value of the parameter.

Specified by:

setValue in interface LXParameter

Parameters:

value - The value

Returns:

this

getValue

public double getValue()

Description copied from interface: LXParameter

Retrieves the value of the parameter

Specified by:

getValue in interface LXParameter

Returns:

Parameter value

getValuef

public float getValuef()

Description copied from interface: LXParameter

Utility helper function to get the value of the parameter as a float.

Specified by:

getValuef in interface LXParameter

Returns:

Parameter value as float

getLabel

public String getLabel()

Description copied from interface: LXParameter

Gets the label for this parameter

Specified by:

getLabel in interface LXPath

Specified by:

getLabel in interface LXParameter

Returns:

Label of parameter

setNormalized

public NormalizedParameter setNormalized(double value)

Description copied from interface: LXNormalizedParameter

Sets the value or the parameter in normalized space from 0 to 1

Specified by:

setNormalized in interface LXNormalizedParameter

Parameters:

value - The normalized value, from 0 to 1

Returns:

this, for method chaining

getNormalized

public double getNormalized()

Description copied from interface: LXNormalizedParameter

Gets the value of the parameter in a normalized space from 0 to 1

Specified by:

getNormalized in interface LXNormalizedParameter

Returns:

Value of parameter, normalized to range from 0 to 1

getNormalizedf

public float getNormalizedf()

Description copied from interface: LXNormalizedParameter

Gets the value of the parameter in a normalized space as a float

Specified by:

getNormalizedf in interface LXNormalizedParameter

Returns:

Normalized value of parameter, in range from 0 to 1

getExponent

public double getExponent()

Description copied from interface: LXNormalizedParameter

Gets the exponent used for scaling this parameter across its normalized range. Default is 1 which means linear scaling.

Specified by:

getExponent in interface LXNormalizedParameter

Returns:

scaling exponent

isMappable

public boolean isMappable()

Description copied from interface: LXParameter

Whether this parameter should be eligible for mapping via MIDI or modulation control.

Specified by:

isMappable in interface LXParameter

Returns:

true if mappable, false if otherwise