FEAPIExamplePluginSpectral.h

Go to the documentation of this file.

//     /*! \file FEAPIExamplePluginSpectral.h: \brief interface of the CSpectralFeatures class. */
//
//        Copyright (c) 2005-2007, Alexander Lerch, zplane.development GbR
//        All rights reserved.
//
//        Redistribution and use in source and binary forms, with or without 
//        modification, are permitted provided that the following conditions 
//        are met:
//
//        *   Redistributions of source code must retain the above copyright 
//            notice, this list of conditions and the following disclaimer. 
//        *   Redistributions in binary form must reproduce the above 
//            copyright notice, this list of conditions and the following 
//            disclaimer in the documentation and/or other materials 
//            provided with the distribution. 
//        *   Neither the name of the FEAPI development team nor the names 
//            of its contributors may be used to endorse or promote products 
//            derived from this software without specific prior written 
//            permission. 
//
//        THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 
//        "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 
//        LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS 
//        FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE 
//        COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, 
//        INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, 
//        BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 
//        LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER 
//        CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 
//        LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN 
//        ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 
//        POSSIBILITY OF SUCH DAMAGE.
//

#if !defined(SPECTRAL_HEADER_INCLUDED__)
#define SPECTRAL_HEADER_INCLUDED__


#include "FEAPIPluginBase.h"

template <class T>  class CRingBuffer; 
class CzplfFFT_If;

class CSpectralFeatures : public CFeatureExtractBase
{
public:

    CSpectralFeatures ();
    
    virtual ~CSpectralFeatures ();


    // method declaration
    // if you do not intend to use some of these functions, just delete them and the default 
    // values will be returned

    FEAPI_Error_t      SetPluginParameter ( int iParameterIndex, 
                                            float fValue);

    float              GetPluginParameter ( int iParameterIndex);


    int                GetPluginResultLatency (int iResultIndex);

    float              GetPluginProperty (  FEAPI_PluginProperty_t ePluginProperty);

    FEAPI_Error_t      InitializePlugin (   float               fInputSampleRate, 
                                            int                 iNumberOfAudioChannels,
                                            int                 iHostApiMajorVersion,
                                            FEAPI_UserData_t     *pstUserData);

    FEAPI_Error_t      ProcessPlugin (  const float             **ppfInputBuffer, 
                                        const FEAPI_TimeStamp_t *ptFEAPI_TimeStamp,
                                        int                     iNumberOfFrames);

    FEAPI_Error_t      ProcessPluginDone ();


    int                GetPluginSizeOfResult (int iResultIndex);

    FEAPI_Error_t      GetPluginResult (     int iResultIndex, 
                                float *pfResult,
                                FEAPI_TimeStamp_t *ptFEAPI_TimeStamp);


    FEAPI_Error_t      ResetPlugin ();

private:

    struct InternalResults_t
    {
        bool                bHoldsResult;
        float               fResult;
        FEAPI_TimeStamp_t   tTimeStamp;
    };

    void WriteResult (int iResultIdx, float fValue, FEAPI_TimeStamp_t tTimStamp);
    int CalcFreqTable ();

    // remove and add variables acc. your needs
    FEAPI_SignalDescription_t m_stResultDescription;
    FEAPI_TimeStamp_t         *m_ptLocalTimeStamp;


    float   *m_pfParameters,
            *m_pfProcessBuffer,
            **m_ppfFFTHistory,
            *m_pfHelpBuffer,
            *m_pfLogFreqs;

    CRingBuffer<float>  **m_ppCRingBuffer;

    InternalResults_t   **m_ppResults;

    CzplfFFT_If         *m_pFFTInstance;

    int                 m_iSizeOfResultBuffer,
                        m_iMPEG7SetZero;
};

#endif // #if !defined(SPECTRAL_HEADER_INCLUDED__)

---