com.jsyn.unitgen

Class FilterBiquadCommon

java.lang.Object

com.jsyn.unitgen.UnitGenerator

com.jsyn.unitgen.UnitFilter

com.jsyn.unitgen.TunableFilter

com.jsyn.unitgen.FilterBiquad

com.jsyn.unitgen.FilterBiquadCommon

All Implemented Interfaces:

UnitSink, UnitSource

Direct Known Subclasses:

FilterBandPass, FilterBandStop, FilterHighPass, FilterLowPass, FilterPeakingEQ

public abstract class FilterBiquadCommon
extends FilterBiquad

Extend this class to create a filter that implements a Biquad filter with a Q port.

Author:

Phil Burk (C) 2009 Mobileer Inc Translated from 'C' to Java by Lisa Tolenti.

Field Summary

Fields

Modifier and Type	Field and Description
protected double	alpha
protected static double	MINIMUM_Q
UnitInputPort	Q

Fields inherited from class com.jsyn.unitgen.FilterBiquad

a0, a1, a2, amplitude, b1, b2, cos_omega, MINIMUM_FREQUENCY, MINIMUM_GAIN, omega, previousFrequency, RATIO_MINIMUM, sin_omega

Fields inherited from class com.jsyn.unitgen.TunableFilter

frequency

Fields inherited from class com.jsyn.unitgen.UnitFilter

input, output

Fields inherited from class com.jsyn.unitgen.UnitGenerator

FALSE, PORT_NAME_AMPLITUDE, PORT_NAME_CUTOFF, PORT_NAME_FREQUENCY, PORT_NAME_FREQUENCY_SCALER, PORT_NAME_INPUT, PORT_NAME_OUTPUT, PORT_NAME_PAN, PORT_NAME_PHASE, PORT_NAME_PRESSURE, PORT_NAME_TIMBRE, PORT_NAME_TIME, synthesisEngine, TRUE, VERY_SMALL_FLOAT

Constructor Summary

Constructors

Constructor and Description
FilterBiquadCommon() No-argument constructor instantiates the Biquad common and adds a Q port to this filter.

Method Summary

Modifier and Type	Method and Description
void	computeBiquadCommon(double ratio, double Q)
protected boolean	isRecalculationNeeded(double frequencyValue, double qValue)
void	recalculate() The recalculate() method checks and ensures that the frequency and Q values are at a minimum.
abstract void	updateCoefficients() Calculate coefficients based on the filter type, eg.

Methods inherited from class com.jsyn.unitgen.FilterBiquad

calculateOmega, generate, performBiquadFilter

Methods inherited from class com.jsyn.unitgen.UnitFilter

getInput, getOutput

Methods inherited from class com.jsyn.unitgen.UnitGenerator

addPort, addPort, autoStop, convertHalfLifeToMultiplier, convertTimeToRate, flattenOutputs, generate, getCircuit, getFramePeriod, getFrameRate, getId, getPortByName, getPorts, getSynthesisEngine, getSynthesizer, getTopUnit, getUnitGenerator, incrementWrapPhase, isEnabled, isStartRequired, printConnections, printConnections, printConnections, pullData, setCircuit, setEnabled, setFrameRate, setPort, setSynthesisEngine, start, start, start, stop, stop, stop

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.jsyn.unitgen.UnitSink

getUnitGenerator, start, start, stop, stop

Methods inherited from interface com.jsyn.unitgen.UnitSource

getUnitGenerator

Field Detail

Q

public UnitInputPort Q

MINIMUM_Q

protected static final double MINIMUM_Q

See Also:

Constant Field Values

alpha

protected double alpha

Constructor Detail

FilterBiquadCommon

public FilterBiquadCommon()

No-argument constructor instantiates the Biquad common and adds a Q port to this filter.

Method Detail

updateCoefficients

public abstract void updateCoefficients()

Calculate coefficients based on the filter type, eg. LowPass.

computeBiquadCommon

public void computeBiquadCommon(double ratio,
                                double Q)

recalculate

public void recalculate()

The recalculate() method checks and ensures that the frequency and Q values are at a minimum. It also only updates the Biquad coefficients if either frequency or Q have changed.

Specified by:

recalculate in class FilterBiquad

isRecalculationNeeded

protected boolean isRecalculationNeeded(double frequencyValue,
                                        double qValue)