heronarts.lx.modulator

Class VariableLFO

java.lang.Object

heronarts.lx.LXComponent

heronarts.lx.LXRunnableComponent

heronarts.lx.modulator.LXModulator

heronarts.lx.modulator.LXPeriodicModulator

heronarts.lx.modulator.LXRangeModulator

heronarts.lx.modulator.VariableLFO

All Implemented Interfaces:

LXComponent.Renamable, LXLoopTask, LXPath, LXSerializable, LXWaveshape, LXOscComponent, LXNormalizedParameter, LXParameter, LXParameterListener

public class VariableLFO
extends LXRangeModulator
implements LXWaveshape, LXOscComponent

A sawtooth LFO oscillates from one extreme value to another. When the later value is hit, the oscillator rests to its initial value.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	VariableLFO.ClockMode

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

LXComponent.Placeholder, LXComponent.Renamable

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

LXParameter.Formatter, LXParameter.Polarity, LXParameter.Units

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

LXSerializable.Utils

Field Summary

Fields

Modifier and Type	Field and Description
CompoundParameter	bias
EnumParameter<VariableLFO.ClockMode>	clockMode
CompoundParameter	exp
CompoundParameter	periodCustom Period of the waveform, in ms
CompoundParameter	periodFast
CompoundParameter	periodSlow
CompoundParameter	phase
CompoundParameter	shape
CompoundParameter	skew
ObjectParameter<LXWaveshape>	waveshape Parameter of LXWaveshape objects that select the wave shape used by this LFO.

Fields inherited from class heronarts.lx.modulator.LXPeriodicModulator

looping, tempoDivision, tempoLock, tempoSync

Fields inherited from class heronarts.lx.LXRunnableComponent

runMs, running, trigger

Fields inherited from class heronarts.lx.LXComponent

controlSurfaceSemaphore, KEY_CLASS, KEY_COMPONENT_ID, KEY_ID, KEY_PARAMETER_PATH, KEY_PATH, label, lx, modulationColor

Fields inherited from interface heronarts.lx.modulator.LXWaveshape

DOWN, SIN, SQUARE, TRI, UP

Constructor Summary

Constructors

Constructor and Description
VariableLFO()
VariableLFO(String label)
VariableLFO(String label, LXWaveshape[] waveshapes)
VariableLFO(String label, LXWaveshape[] waveshapes, CompoundParameter period) Constructs a VariableLFO with a custom list of waveshapes

Method Summary

Modifier and Type	Method and Description
double	compute(double basis)
double	computeBase(double basis)
protected double	computeNormalizedBasis(double basis, double normalizedValue) Subclasses determine the basis based on a normalized value from 0 to 1.
protected double	computeNormalizedValue(double deltaMs, double basis) Subclasses implement this which returns their value from a 0-1 scale.
LXWaveshape	getWaveshape()
double	invert(double value, double basisHint)
void	onParameterChanged(LXParameter p) Subclasses are free to override this if desired.

Methods inherited from class heronarts.lx.modulator.LXRangeModulator

computeBasis, computeValue, getExponent, getNormalized, getNormalizedf, onSetValue, setEndValue, setEndValue, setExponent, setNormalized, setRange, setRange, setRangeFromHereTo, setRangeFromHereTo, setStartValue, setStartValue

Methods inherited from class heronarts.lx.modulator.LXPeriodicModulator

computeValue, finished, getBasis, getBasisf, getPeriod, getPeriodf, load, loop, loop, onReset, randomBasis, save, setBasis, setLooping, setPeriod, setPeriod, updateBasis

Methods inherited from class heronarts.lx.modulator.LXModulator

getDescription, getFormatter, getIndex, getOscAddress, getOscPath, getPath, getPolarity, getUnits, getValue, getValuef, run, setComponent, setDescription, setFormatter, setIndex, setPolarity, setUnits, setValue, setValue, updateValue

Methods inherited from class heronarts.lx.LXRunnableComponent

isRunning, onStart, onStop, reset, start, stop, toggle, trigger

Methods inherited from class heronarts.lx.LXComponent

addArray, addChild, addInternalParameter, addParameter, addParameter, contains, copyParameters, dispose, getChild, getComponentName, getComponentName, getComponentName, getId, getLabel, getLX, getOscLabel, getParameter, getParameters, getParent, handleOscMessage, loadParameters, removeParameter, removeParameter, saveParameters, setParent, 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.osc.LXOscComponent

getOscAddress, handleOscMessage

Methods inherited from interface heronarts.lx.parameter.LXParameter

dispose, getDescription, getFormatter, getLabel, getPolarity, getUnits, getValue, getValuef, isMappable, reset, setComponent, setMappable, setValue

Methods inherited from interface heronarts.lx.LXPath

get, get, getCanonicalLabel, getCanonicalLabel, getCanonicalPath, getCanonicalPath, getComponent, getComponent, getParameter, getParameter, getParent, getPath

Field Detail

waveshape

public final ObjectParameter<LXWaveshape> waveshape

Parameter of LXWaveshape objects that select the wave shape used by this LFO. Default options are the waveshapes predefined in LXWaveshape, but you can pass your own.

periodCustom

public final CompoundParameter periodCustom

Period of the waveform, in ms

clockMode

public final EnumParameter<VariableLFO.ClockMode> clockMode

periodFast

public final CompoundParameter periodFast

periodSlow

public final CompoundParameter periodSlow

skew

public final CompoundParameter skew

shape

public final CompoundParameter shape

exp

public final CompoundParameter exp

bias

public final CompoundParameter bias

phase

public final CompoundParameter phase

Constructor Detail

VariableLFO

public VariableLFO()

VariableLFO

public VariableLFO(String label)

VariableLFO

public VariableLFO(String label,
                   LXWaveshape[] waveshapes)

VariableLFO

public VariableLFO(String label,
                   LXWaveshape[] waveshapes,
                   CompoundParameter period)

Constructs a VariableLFO with a custom list of waveshapes

Parameters:

label - LFO label

waveshapes - Optional list of custom LXWaveshape. If null, will use predefined ones in LXWaveshape

period - Optional. Parameter that supplies custom waveform period, in ms. Default goes 100-60000ms.

Method Detail

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 LXPeriodicModulator

Parameters:

p - Parameter that has a value change

getWaveshape

public LXWaveshape getWaveshape()

computeNormalizedValue

protected final double computeNormalizedValue(double deltaMs,
                                              double basis)

Description copied from class: LXRangeModulator

Subclasses implement this which returns their value from a 0-1 scale. This class automatically takes care of scaling to the startValue/endValue range.

Specified by:

computeNormalizedValue in class LXRangeModulator

Parameters:

deltaMs - Milliseconds elapsed

basis - Basis of modulator

Returns:

Modulator value

computeNormalizedBasis

protected final double computeNormalizedBasis(double basis,
                                              double normalizedValue)

Description copied from class: LXRangeModulator

Subclasses determine the basis based on a normalized value from 0 to 1.

Specified by:

computeNormalizedBasis in class LXRangeModulator

Parameters:

basis - Modulator basis

normalizedValue - A normalize value from 0 to 1

Returns:

Computed normalized basis for modulator

compute

public double compute(double basis)

Specified by:

compute in interface LXWaveshape

computeBase

public double computeBase(double basis)

invert

public double invert(double value,
                     double basisHint)

Specified by:

invert in interface LXWaveshape