heronarts.lx.audio

Class GraphicMeter

java.lang.Object

heronarts.lx.LXComponent

heronarts.lx.LXRunnableComponent

heronarts.lx.modulator.LXModulator

heronarts.lx.audio.DecibelMeter

heronarts.lx.audio.GraphicMeter

All Implemented Interfaces:

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

public class GraphicMeter
extends DecibelMeter

A graphic meter splits the signal into frequency bands and computes envelopes for each of the bands independently. It can also give the overall level, just like a normal decibel meter. Since energy is not typically evenly distributed through the spectrum, a slope can be applied to the equalizer to even out the levels, typically something like 4.5 dB/octave is used, though this varies by recording.

Nested Class Summary

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
NormalizedParameter[]	bands
FourierTransform	fft
int	numBands Number of bands in the equalizer
CompoundParameter	slope dB/octave slope applied to the equalizer

Fields inherited from class heronarts.lx.audio.DecibelMeter

attack, attackGain, buffer, gain, LOG_10, range, release, releaseGain

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

Constructor Summary

Constructors

Constructor and Description
GraphicMeter(LXAudioBuffer buffer) Default graphic equalizer with 2 bands per octave
GraphicMeter(LXAudioBuffer buffer, int numBands) Makes a graphic equalizer with a default slope of 4.5 dB/octave
GraphicMeter(LXAudioComponent component)
GraphicMeter(String label, LXAudioBuffer buffer) Default graphic equalizer with 2 bands per octave
GraphicMeter(String label, LXAudioBuffer buffer, int numBands) Makes a graphic equalizer with a default slope of 4.5 dB/octave

Method Summary

Modifier and Type	Method and Description
protected double	computeValue(double deltaMs) Implementation method to advance the modulator's internal state.
double	getAverage(int minBand, int avgBands) Averages the value of a set of bands
float	getAveragef(int minBand, int avgBands) Averages the value of a set of bands
double	getBand(int i)
float	getBandf(int i)
double	getDecibels(int i)
float	getDecibelsf(int i)
int	getNumBands() Number of bands on the meter
float	getRaw(int i) Get most recent raw unsmoothed RMS amplitude of band i
float[]	getSamples() Returns a snapshot of the last raw audio sample buffer frame that was used to compute this meter.
double	getSquare(int i) Gets the squared value of the i-th band
float	getSquaref(int i) Gets the squared value of the i-th band

Methods inherited from class heronarts.lx.audio.DecibelMeter

getDecibels, getDecibelsf, getExponent, getNormalized, getNormalizedf, getPeak, getPeakf, getRaw, getSquare, getSquaref, setBuffer, setNormalized

Methods inherited from class heronarts.lx.modulator.LXModulator

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

Methods inherited from class heronarts.lx.LXRunnableComponent

isRunning, loop, onParameterChanged, onReset, 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, load, loadParameters, removeParameter, removeParameter, save, 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.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

Methods inherited from interface heronarts.lx.osc.LXOscComponent

getOscAddress, handleOscMessage

Field Detail

slope

public final CompoundParameter slope

dB/octave slope applied to the equalizer

numBands

public final int numBands

Number of bands in the equalizer

fft

public final FourierTransform fft

bands

public final NormalizedParameter[] bands

Constructor Detail

GraphicMeter

public GraphicMeter(LXAudioComponent component)

GraphicMeter

public GraphicMeter(LXAudioBuffer buffer)

Default graphic equalizer with 2 bands per octave

Parameters:

buffer - Audio buffer

GraphicMeter

public GraphicMeter(String label,
                    LXAudioBuffer buffer)

Default graphic equalizer with 2 bands per octave

Parameters:

label - Label

buffer - Audio buffer

GraphicMeter

public GraphicMeter(LXAudioBuffer buffer,
                    int numBands)

Makes a graphic equalizer with a default slope of 4.5 dB/octave

Parameters:

buffer - Audio buffer to monitor

numBands - Number of bands

GraphicMeter

public GraphicMeter(String label,
                    LXAudioBuffer buffer,
                    int numBands)

Makes a graphic equalizer with a default slope of 4.5 dB/octave

Parameters:

label - Label

buffer - Audio buffer to monitor

numBands - Number of bands

Method Detail

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.

Overrides:

computeValue in class DecibelMeter

Parameters:

deltaMs - Number of milliseconds to advance by

Returns:

Computed value

getSamples

public float[] getSamples()

Returns a snapshot of the last raw audio sample buffer frame that was used to compute this meter. Note that this is copy of the audio buffer local to the LX thread and this particular meter. The buffer is only updated when the meter is running, once per LX engine loop.

Returns:

Raw audio sample buffer used to compute this meter

getRaw

public float getRaw(int i)

Get most recent raw unsmoothed RMS amplitude of band i

Parameters:

i - Raw band index

Returns:

Raw value of band i

getDecibels

public double getDecibels(int i)

Parameters:

i - Which frequency band to access

Returns:

Level of that band in decibels

getDecibelsf

public float getDecibelsf(int i)

Parameters:

i - Which frequency band to access

Returns:

Level of that band in decibels as a float

getNumBands

public int getNumBands()

Number of bands on the meter

Returns:

Number of bands

getBand

public double getBand(int i)

Parameters:

i - Which frequency band to retrieve

Returns:

The value of the ith frequency band

getBandf

public float getBandf(int i)

Parameters:

i - Which frequency band to retrieve

Returns:

The value of that band, as a float

getSquare

public double getSquare(int i)

Gets the squared value of the i-th band

Parameters:

i - Frequency band

Returns:

Squared normalized value

getSquaref

public float getSquaref(int i)

Gets the squared value of the i-th band

Parameters:

i - Frequency band

Returns:

Squared normalized value as a float

getAverage

public double getAverage(int minBand,
                         int avgBands)

Averages the value of a set of bands

Parameters:

minBand - The first band to start at

avgBands - How many bands to average

Returns:

Average value of all these bands

getAveragef

public float getAveragef(int minBand,
                         int avgBands)

Averages the value of a set of bands

Parameters:

minBand - The first band to start at

avgBands - How many bands to average

Returns:

Average value of all these bands as a float