A processing class that can perform IIR filtering on an audio signal, using the Transposed Direct Form II digital structure. More...
#include <juce_IIRFilter.h>
Public Types | |
using | CoefficientsPtr = typename Coefficients< NumericType >::Ptr |
A typedef for a ref-counted pointer to the coefficients object. More... | |
using | NumericType = typename SampleTypeHelpers::ElementType< SampleType >::Type |
The NumericType is the underlying primitive type used by the SampleType (which could be either a primitive or vector) More... | |
Public Member Functions | |
Filter () | |
Creates a filter. More... | |
Filter (CoefficientsPtr coefficientsToUse) | |
Creates a filter with a given set of coefficients. More... | |
Filter (const Filter &)=default | |
Filter (Filter &&)=default | |
Filter & | operator= (const Filter &)=default |
Filter & | operator= (Filter &&)=default |
void | prepare (const ProcessSpec &) noexcept |
Called before processing starts. More... | |
template<typename ProcessContext > | |
void | process (const ProcessContext &context) noexcept |
Processes as a block of samples. More... | |
SampleType JUCE_VECTOR_CALLTYPE | processSample (SampleType sample) noexcept |
Processes a single sample, without any locking. More... | |
void | reset () |
Resets the filter's processing pipeline, ready to start a new stream of data. More... | |
void | reset (SampleType resetToValue) |
Resets the filter's processing pipeline to a specific value. More... | |
void | snapToZero () noexcept |
Ensure that the state variables are rounded to zero if the state variables are denormals. More... | |
Public Attributes | |
CoefficientsPtr | coefficients |
The coefficients of the IIR filter. More... | |
Private Member Functions | |
void | check () |
template<typename ProcessContext , bool isBypassed> | |
void | processInternal (const ProcessContext &context) noexcept |
Processes as a block of samples. More... | |
Private Attributes | |
HeapBlock< SampleType > | memory |
size_t | order = 0 |
SampleType * | state = nullptr |
A processing class that can perform IIR filtering on an audio signal, using the Transposed Direct Form II digital structure.
If you need a lowpass, bandpass or highpass filter with fast modulation of its cutoff frequency, you might use the class StateVariableFilter instead, which is designed to prevent artefacts at parameter changes, instead of the class Filter.
{DSP}
using juce::dsp::IIR::Filter< SampleType >::CoefficientsPtr = typename Coefficients<NumericType>::Ptr |
A typedef for a ref-counted pointer to the coefficients object.
using juce::dsp::IIR::Filter< SampleType >::NumericType = typename SampleTypeHelpers::ElementType<SampleType>::Type |
The NumericType is the underlying primitive type used by the SampleType (which could be either a primitive or vector)
juce::dsp::IIR::Filter< SampleType >::Filter | ( | ) |
Creates a filter.
Initially the filter is inactive, so will have no effect on samples that you process with it. Use the setCoefficients() method to turn it into the type of filter needed.
juce::dsp::IIR::Filter< SampleType >::Filter | ( | CoefficientsPtr | coefficientsToUse | ) |
Creates a filter with a given set of coefficients.
|
default |
|
default |
|
private |
Referenced by juce::dsp::IIR::Filter< SampleType >::process().
|
default |
|
default |
|
noexcept |
Called before processing starts.
Referenced by juce::dsp::IIR::Filter< SampleType >::reset().
|
inlinenoexcept |
Processes as a block of samples.
References juce::dsp::IIR::Filter< SampleType >::check(), juce::dsp::IIR::Filter< SampleType >::processInternal(), juce::dsp::IIR::Filter< SampleType >::processSample(), and juce::dsp::IIR::Filter< SampleType >::snapToZero().
|
privatenoexcept |
Processes as a block of samples.
Referenced by juce::dsp::IIR::Filter< SampleType >::process().
|
noexcept |
Processes a single sample, without any locking.
Use this if you need processing of a single value.
Moreover, you might need the function snapToZero after a few calls to avoid potential denormalisation issues.
Referenced by juce::dsp::IIR::Filter< SampleType >::process().
|
inline |
Resets the filter's processing pipeline, ready to start a new stream of data.
Note that this clears the processing state, but the type of filter and its coefficients aren't changed.
References juce::dsp::IIR::Filter< SampleType >::prepare(), and juce::dsp::IIR::Filter< SampleType >::reset().
Referenced by juce::dsp::IIR::Filter< SampleType >::reset().
void juce::dsp::IIR::Filter< SampleType >::reset | ( | SampleType | resetToValue | ) |
Resets the filter's processing pipeline to a specific value.
|
noexcept |
Ensure that the state variables are rounded to zero if the state variables are denormals.
This is only needed if you are doing sample by sample processing.
Referenced by juce::dsp::IIR::Filter< SampleType >::process().
CoefficientsPtr juce::dsp::IIR::Filter< SampleType >::coefficients |
The coefficients of the IIR filter.
It's up to the caller to ensure that these coefficients are modified in a thread-safe way.
If you change the order of the coefficients then you must call reset after modifying them.
Referenced by juce::dsp::IIR::Coefficients< NumericType >::getRawCoefficients().
|
private |
|
private |
|
private |