ITAThirdOctaveFilterbankIIR.h

/*
 * ----------------------------------------------------------------
 *
 *		ITA core libs
 *		(c) Copyright Institute of Technical Acoustics (ITA)
 *		RWTH Aachen University, Germany, 2015-2018
 *
 * ----------------------------------------------------------------
 *				    ____  __________  _______
 *				   //  / //__   ___/ //  _   |
 *				  //  /    //  /    //  /_|  |
 *				 //  /    //  /    //  ___   |
 *				//__/    //__/    //__/   |__|
 *
 * ----------------------------------------------------------------
 *
 */

#ifndef IW_ITA_THIRD_OCTAVE_FILTERBANK_IIR
#define IW_ITA_THIRD_OCTAVE_FILTERBANK_IIR

#include <ITADSPDefinitions.h>
#include <ITAThirdOctaveFilterbank.h>
#include <ITAThirdOctaveMagnitudeSpectrum.h>
#include <ITABiquad.h>
#include <ITASampleBuffer.h>

#include <vector>
#include <tbb/concurrent_queue.h>

//! Third octave magnitude filtering using Biquads (IIR filter)
/**
  *
  */
class ITA_DSP_API CITAThirdOctaveFilterbankIIR : public CITAThirdOctaveFilterbank
{
public:
	//! Constructor
	/**
	  * @param[in] dSampleRate Samplingrate
	  * @param[in] iBlockLength Block length
	  */
	CITAThirdOctaveFilterbankIIR( const double dSampleRate, const int iBlockLength );

	virtual inline ~CITAThirdOctaveFilterbankIIR() {};

	//! Filterlatenz in Samples zurückgeben
	int GetLatency() const;

	//! Set magnitudes (in decibel) of filter bank
	/**
	  * @param[in] oMagnitudes Filter magnitudes (dB)
	  * @param[in] bSmoothChangeover If true, switching is smoothed
	  */
	void SetMagnitudes( const CITAThirdOctaveGainMagnitudeSpectrum& oMagnitudes, const bool bSmoothChangeover = true );

	//! Clear all internal accumulators
	void Clear();

	//! Verarbeite Samples (Filtern)
	/**
	  * \param pfInputSamples Eingabesamples (Anzahl = Blocklänge)
	  * \param pfOutputSamples Ausgabesamples (Anzahl = Blocklänge)
	  */
	void Process( const float* pfInputSamples, float* pfOutputSamples );

private:
	//! Interne Datenklasse für das Verarbeiten eines neuen Gain Datensatzes
	class MagnitudeUpdate
	{
	public:
		CITAThirdOctaveGainMagnitudeSpectrum oMags; //! New magnitudes
		int iBlendSamples;				 //!< Anzahl Samples zum Überblenden
	};

	double m_dSampleRate;	  //!< Samplingrate
	int m_iBlockLength;		  //!< Blocklänge
	int m_nBandsInternal;	  //!< Anzahl der internen Bänder
	int m_nBiquadsPerBand;	  //!< Anzahl von Biqads pro Band
	std::vector< CITABiquad > m_vBiquads; //!< Biquads, access: [Band][BiquadNummer]
	tbb::strict_ppl::concurrent_queue< CITAThirdOctaveFilterbankIIR::MagnitudeUpdate > m_vMagnitudesQueue; //!< Liste von neuen Verstärkungsfaktoren
	CITAThirdOctaveGainMagnitudeSpectrum m_oMagnitudesInternal; //!< Interne Verstärkungsfaktoren
	ITASampleBuffer m_sfTempFilterBuf; //!< Intermediate buffer for filter
	ITASampleBuffer m_pfTempOutputBuf; //!< Intermediate buffer for output assembly
};

#endif // IW_ITA_THIRD_OCTAVE_FILTERBANK_IIR