Package heronarts.lx.audio

Class BandFilter

java.lang.Object

heronarts.lx.LXComponent

heronarts.lx.LXRunnableComponent

heronarts.lx.modulator.LXModulator

heronarts.lx.audio.BandFilter

All Implemented Interfaces:

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

Direct Known Subclasses:

BandGate

@LXCategory("Audio")
@Global("Band Filter")
@Device("Band Filter")
public class BandFilter
extends LXModulator
implements LXNormalizedParameter, LXOscComponent

Nested Class Summary

Nested classes/interfaces inherited from class heronarts.lx.modulator.LXModulator

LXModulator.Device, LXModulator.Global, LXModulator.Placeholder

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

LXComponent.Description, LXComponent.Hidden, LXComponent.Name, LXComponent.PluginRequired, LXComponent.Renamable

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

LXNormalizedParameter.OscMode

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

LXParameter.Collection, LXParameter.Formatter, LXParameter.Monitor, LXParameter.MultiMonitor, LXParameter.Polarity, LXParameter.Units

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

LXSerializable.Utils

Field Summary

Fields

Modifier and Type	Field	Description
final BoundedParameter	attack	Meter attack time, in milliseconds
protected double	averageNorm
final BoundedParameter	gain	Gain of the meter, in decibels
final BoundedParameter	maxFreq	Maximum frequency for the band
final GraphicMeter	meter
final BoundedParameter	minFreq	Minimum frequency for the band
final BoundedParameter	range	Range of the meter, in decibels.
final BoundedParameter	release	Meter release time, in milliseconds
final BoundedParameter	slope	dB/octave slope applied to the equalizer

Fields inherited from class heronarts.lx.modulator.LXModulator

crashed, midiFilter, midiSource

Fields inherited from class heronarts.lx.LXRunnableComponent

runMs, running, trigger

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

Constructor	Description
BandFilter(LX lx)
BandFilter(String label, GraphicMeter meter)	Constructs a gate that monitors a specified frequency band
BandFilter(String label, LX lx)

Method Summary

Modifier and Type	Method	Description
protected double	computeValue(double deltaMs)	Implementation method to advance the modulator's internal state.
double	getBand(int i)
double	getNormalized()	Gets the value of the parameter in a normalized space from 0 to 1
void	onParameterChanged(LXParameter p)	Subclasses are free to override this if desired.
BandFilter	setFrequencyRange(float minHz, float maxHz)	Sets range of frequencies to look at
LXNormalizedParameter	setNormalized(double value)	Sets the value or the parameter in normalized space from 0 to 1

Methods inherited from class heronarts.lx.modulator.LXModulator

autostart, disableAutoStart, getCrash, getCrashStackTrace, getFormatter, getIndex, getOscAddress, getOscPath, getPath, getPolarity, getUnits, getValue, isMappingSource, loop, onSetValue, run, setComponent, setFormatter, setIndex, setMappingSource, setPolarity, setUnits, setValue, setValue, updateValue

Methods inherited from class heronarts.lx.LXRunnableComponent

isRunning, onReset, onStart, onStop, onTrigger, postRun, reset, start, stop, toggle, trigger

Methods inherited from class heronarts.lx.LXComponent

addArray, addChild, addInternalParameter, addLegacyInternalParameter, addLegacyParameter, addParameter, addParameter, addParameters, assertDisposed, contains, copyParameters, dispose, getCategory, getChild, getComponentDescription, getComponentName, getComponentName, getComponentName, getDescription, getId, getLabel, getLX, getOscLabel, getParameter, getParameters, getParent, handleOscMessage, hasParameter, isValidOscParameter, load, loadParameters, loadPreset, removeParameter, removeParameter, removeParameter, removeParameter, save, 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.parameter.LXNormalizedParameter

getBaseNormalized, getBaseNormalizedf, getExponent, getNormalizedf, getOscMode, getValueFromNormalized, isWrappable

Methods inherited from interface heronarts.lx.osc.LXOscComponent

getOscAddress, handleOscMessage

Methods inherited from interface heronarts.lx.parameter.LXParameter

dispose, getBaseValue, getBaseValuef, getFormatter, getLabel, getParentParameter, getPolarity, getUnits, getValue, getValuef, isMappable, reset, setComponent, setFormatter, setMappable, setValue

Methods inherited from interface heronarts.lx.LXPath

getCanonicalLabel, getCanonicalLabel, getCanonicalLabel, getCanonicalLabel, getCanonicalLabel, getCanonicalPath, getCanonicalPath, getDescription, getParent, getPath, isDescendant

Field Details

gain

public final BoundedParameter gain

Gain of the meter, in decibels

range

public final BoundedParameter range

Range of the meter, in decibels.

attack

public final BoundedParameter attack

Meter attack time, in milliseconds

release

public final BoundedParameter release

Meter release time, in milliseconds

slope

public final BoundedParameter slope

dB/octave slope applied to the equalizer

minFreq

public final BoundedParameter minFreq

Minimum frequency for the band

maxFreq

public final BoundedParameter maxFreq

Maximum frequency for the band

meter

public final GraphicMeter meter

averageNorm

protected double averageNorm

Constructor Details

BandFilter

public BandFilter(LX lx)

BandFilter

public BandFilter(String label,
 LX lx)

BandFilter

public BandFilter(String label,
 GraphicMeter meter)

Constructs a gate that monitors a specified frequency band

Parameters:

label - Label

meter - GraphicEQ object to drive this gate

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 LXRunnableComponent

Parameters:

p - Parameter that has a value change

setFrequencyRange

public BandFilter setFrequencyRange(float minHz,
 float maxHz)

Sets range of frequencies to look at

Parameters:

minHz - Minimum frequency

maxHz - Maximum frequency

Returns:

this

getBand

public double getBand(int i)

computeValue

protected double computeValue(double deltaMs)

Description copied from class: LXModulator

Implementation method to advance the modulator's internal state. Subclasses must provide and update value appropriately.

Specified by:

computeValue in class LXModulator

Parameters:

deltaMs - Number of milliseconds to advance by

Returns:

Computed value

setNormalized

public LXNormalizedParameter 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