TokenDelay.hxx

Go to the documentation of this file.

/*
 * Copyright (c) 2001-2004 MUSIC TECHNOLOGY GROUP (MTG)
 *                         UNIVERSITAT POMPEU FABRA
 *
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 *
 */

// TokenDelay.hxx

#ifndef _TokenDelay_
#define _TokenDelay_

#include "Processing.hxx"
#include "InControl.hxx"
#include "InPort.hxx"
#include "OutPort.hxx"
#include "Component.hxx"
#include "Enum.hxx"
#include <string>
#include <deque>

#include "Array.hxx"

namespace CLAM  
{


class TokenDelayConfig : public ProcessingConfig 
{
public:
        DYNAMIC_TYPE_USING_INTERFACE (TokenDelayConfig, 2, ProcessingConfig);
        DYN_ATTRIBUTE (0, public, unsigned, Delay);
        DYN_ATTRIBUTE (1, public, unsigned, MaxDelay );
protected:
        void DefaultInit(void)
        {
                AddDelay();
                AddMaxDelay();
                UpdateData();
                SetDelay(0);
                SetMaxDelay(1);  
        }

};

template <class T> class TokenDelay : public Processing
{

private:
        TokenDelayConfig mConfig;
        // Ports and control
        InPort<T> mInput;
        OutPort<T> mOutput;
        InControl mDelayControl;

public:
        TokenDelay(const TokenDelayConfig& cfg = TokenDelayConfig() ) :
                mInput ("In", this),
                mOutput ("Out", this),
                mDelayControl("Delay Control", this),
                mCapacity(0)
        {
                Configure(cfg);
        }
        virtual ~TokenDelay<T>() {};
        
        bool ConcreteConfigure(const ProcessingConfig& c);

        virtual const ProcessingConfig &GetConfig() const { return mConfig;}
        virtual bool Do(void);

        virtual bool Do(const T & in, T& out);

        

        void Debug() const;
        void FulfillsInvariant() const;

        const char *GetClassName() const {return "TokenDelay";}

        TSize RealDelay() const {
                return mTokenQueue.size();
        } 

        unsigned MaxDelay() const {
                return mCapacity;
        }

        unsigned GivenDelay() {

                return CastDelayControlValue(mDelayControl.GetLastValue());
        }       

private:
        virtual void Discard(T* toDiscard);

        unsigned CastDelayControlValue(TControlData readControlValue);
        void UpdateBuffersToDelay();
        void WriteNewSample(const T& in);
        void ReadCurrentSample(T& out);
        
// Implementation Details:

        std::vector<T> mTokenQueue;
        unsigned mReadPointer;
        unsigned mWritePointer;
        unsigned mCapacity;
        unsigned mGivenDelay;
        unsigned mLastDelay;

};



// Class implementation


#include "Err.hxx"

template <class T> 
void TokenDelay<T>::Discard(T* toDiscard) {
        CLAM_ASSERT(toDiscard, "TokenDelay: Discarding a null pointer");
        delete toDiscard;
}
        
template <class T> 
bool TokenDelay<T>::ConcreteConfigure(const ProcessingConfig& c)
{
        CopyAsConcreteConfig(mConfig, c);
        mCapacity = mConfig.GetMaxDelay();
        mDelayControl.DoControl(TControlData(mConfig.GetDelay()));
        mGivenDelay = CastDelayControlValue(mDelayControl.GetLastValue());
        mTokenQueue.resize(mCapacity);
        mWritePointer = 0;
        mReadPointer = -mGivenDelay;
        return true;
}


template <class T> 
bool TokenDelay<T>::Do(void)
{
        Do(mInput.GetData(), mOutput.GetData());
        mInput.Consume();
        mOutput.Produce();
        return false;
}

template <class T>
unsigned TokenDelay<T>::CastDelayControlValue(TControlData readControlValue) {
        if (readControlValue > mCapacity) return mCapacity;
        if (readControlValue < 0) return 0;
        return unsigned(readControlValue);
}

template <class T> 
bool TokenDelay<T>::Do(const T& in, T& out)
// implementation using the supervised-mode Do
{
        // @todo debug
        mLastDelay = mGivenDelay;
        mGivenDelay = CastDelayControlValue(mDelayControl.GetLastValue());
        // If the value is different make the difference efective
        if (mLastDelay != mGivenDelay)
                UpdateBuffersToDelay();
        WriteNewSample(in);
        ReadCurrentSample(out);
        return true;
}

template <class T> 
void TokenDelay<T>::WriteNewSample(const T& in)
{
        mTokenQueue[mWritePointer] = in;
        mWritePointer++;
        if(mWritePointer==mCapacity) mWritePointer=0;

}


template <class T>
void TokenDelay<T>::ReadCurrentSample(T& out)
{
        CLAM_DEBUG_ASSERT(mReadPointer>0, "Trying to read outside buffer");
        int oldReadPointer = mReadPointer;
        mReadPointer++;
        if(mReadPointer==mCapacity) mReadPointer=0;
        out = mTokenQueue[oldReadPointer];
}



// Delay change
template <class T> 
void TokenDelay<T>::UpdateBuffersToDelay()
{
        mWritePointer =  mReadPointer + CastDelayControlValue(mGivenDelay);
        if(mWritePointer>=mCapacity) mWritePointer-=mCapacity;
        return;
}


template <class T> 
void TokenDelay<T>::Debug() const
{
        /*
        unsigned real = RealDelay();
        unsigned size = mVector.size();
        unsigned cap = mVector.capacity();

        std::cout << "\n-- " << mConfig.GetClassName() << "\n-- (first,last)=(" << mFirst <<","<< mLast <<")\n-- "\
                << "(given,real delay)=("<< mGivenDelay <<"," << real << ")\n-- (vector size,capacity;mCapacity)=("\
                << size <<","<< cap <<";"<< mCapacity <<")\n-- (mInstantToken,mVector[mFirst])=("<< mInstantToken\
                <<","<< mVector[mFirst] <<")\n";
        */

}

template <class T> 
void TokenDelay<T>::FulfillsInvariant() const
{/*
        unsigned real = RealDelay();
        
        if (mVector.capacity() < mCapacity) throw Err("TokenDelay : invariant not fullfilled!: vector capacity < req. capacity");
        if (real && mFirst==mLast) throw Err("TokenDelay : invariant not fullfilled!: there is a 'real' delay and mFirst==mLast");
        if (real > mCapacity) throw Err("TokenDelay : invariant not fullfilled!: real delay > mCapacity");
        if (mGivenDelay > mCapacity) throw Err("TokenDelay : invariant not fullfilled!: given (by control) delay > mCapacity");
        if (mFirst <0 || mLast<0 || mCapacity <= 0)  throw Err("TokenDelay : invariant not fullfilled!: some very bad thing...");
*/
}

// Control Enumeration

class ETokenDelayControls
: public Enum
{

public:
        ETokenDelayControls() : Enum( ValueTable(), delay ) { } 
        ETokenDelayControls( tValue v ) : Enum( ValueTable(), v ) { } 
        ETokenDelayControls( std::string s ) : Enum( ValueTable(), s ) { } 
        ~ETokenDelayControls() { } 
        Component* Species() const
        {
                return new ETokenDelayControls;
        }

        typedef enum 
        { 
                delay = 0
        } tEnum;
        static tEnumValue * ValueTable()
        {
                static tEnumValue sEnumValues[] =
                {
                        { delay, "delay" },
                        { 0, NULL }
                };
                return sEnumValues;
        }

};

}; //namespace CLAM



#endif //_TokenDelay_

---