/*
* Copyright (c) 2010 Ixonos Plc.
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of the "Eclipse Public License v1.0"
* which accompanies this distribution, and is available
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
*
* Initial Contributors:
* Nokia Corporation - Initial contribution
*
* Contributors:
* Ixonos Plc
*
* Description:  
*
*/



#ifndef __CPROCVISUALIZATIONAO_H__
#define __CPROCVISUALIZATIONAO_H__

#include <e32base.h>
#include "AudSong.h"
#include "AudObservers.h"

#include "AudProcessorImpl.h"

class MProcProcessObserver;
class CProcVisProcessor;

class CProcVisualizationAO : public CActive 
    {

public:

    static CProcVisualizationAO* NewL();

    virtual ~CProcVisualizationAO();
        
    /**
    * Starts a clip visualization operation
    * 
    * Can leave with one of the system wide error codes
    *
    * Possible panic code
    * <code>EVisualizationProcessAlreadyRunning</code>
    *
    * @param aClip        song to be visualized
    * @param aSize        size of the visualization array (time resolution)
    * @param aObserver    observer to be notified of progress
    *
    * @return void
    *
    */
    void StartClipVisualizationL(const CAudClipInfo* aClipInfo, TInt aSize, MAudVisualizationObserver& aObserver, TInt aPriority);
    
    /**
    * Cancels a visualization operation
    * 
    * Possible panic code
    * <code>EVisualizationProcessNotRunning</code>
    *
    */    
    void CancelVisualization();
    
    /**
    * Enumeration that represents the state of this object
    */
    enum TVisualizationState 
        {
        EProcGettingClipVisualization = 100,
        EProcVisualizationIdle
        };

protected:
    virtual void RunL();
    virtual void DoCancel();

private:
    
    void ConstructL();

private:
    
    CProcVisualizationAO();

    // visualization observer 
    MAudVisualizationObserver* iObserver;
    
    // visualization processor
    CProcVisProcessor* iProcVisProcessor;
    // visualization state
    TVisualizationState iVisualizationState;
    
    // clipinfo visualized
    const CAudClipInfo* iClipInfo;
    
    // visualization size
    TInt iSize;
    
    // previous progress value sent to the observer
    TInt iPreviousProgressValue;
    };


#endif