/*
* Copyright (c) 2008 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of "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:
*
* Description:  Effect manager.
*
*/



#ifndef CXNEFFECTMANAGER_H
#define CXNEFFECTMANAGER_H

// System incldues
#include <e32base.h>

// User includes

// Forward declarations
class CXnPluginData;
class CXnViewData;
class CXnNode;

// Constants

// Control effect context ids
#define KGfxContextAddWidget            TUid::Uid( 0x102750F4 )
#define KGfxContextRemoveWidget         TUid::Uid( 0x102750F4 )
#define KGfxContextActivateNextView     TUid::Uid( 0x102750F1 )
#define KGfxContextActivatePrevView     TUid::Uid( 0x102750F2 )
#define KGfxContextBgAppear             TUid::Uid( 0x102750F3 )

// Control effect action ids
#define KGfxControlActionAppear         3
#define KGfxControlActionDisappear      4

// Full screen effect ids
#define KGfxContextOpenWallpaperView    1007
#define KGfxContextCloseWallpaperView   1008

// Class declaration
/**
 *  Struct which holds needed info of effect.
 */
NONSHARABLE_STRUCT( TXnEffect )
    {
    CXnNode* iNode;
    TInt iState;
    TInt iId;
    };

/**
 *  Effect manager.
 *  Handles starting and ending effects.
 *
 *  @since S60 v5.0
 */
NONSHARABLE_CLASS( CXnEffectManager ) : public CBase
    {
public:
    // constructor and destructor

    /**
     * Two-phased constructor.
     * @return new instance of CXnEffectManager.
     */
    static CXnEffectManager* NewL();

    /**
     * Destructor.
     */
    ~CXnEffectManager();

public:
    // new functions
    
    /**
     * Begin handling of fullscreen effect.
     * 
     * @since S60 5.2 
     * @param aId effect id
     * @aView view data
     */
    void BeginFullscreenEffectL( TInt aId, CXnViewData& aView );
    
    /**
     * When UiRendered is called effect is ended and will be drawn
     * 
     * @since S60 5.2 
     */
    void UiRendered();

    /**
     * When UiLayouted is called effect is started if it was not started earlier.
     * 
     * @since S60 5.2
     */
    void UiLayouted();

private:
    // new functions
    
    /**
     * Starts fullscreen effect.
     * 
     * @since S60 5.2
     * @param aEffect effect data
     * @return ETrue if effect started, otherwise EFalse
     */
    TBool DoBeginFullscreenEffect( TXnEffect& aEffect );
    
    /**
     * Removes and destroys effect from effect list.
     * 
     * @since S60 5.2
     * @param aEffect effect data
     */
    void RemoveEffect( TXnEffect* aEffect );
    
private:
    // constructors
    
    /**
     * C++ default constructor
     */
    CXnEffectManager();

    /**
     * 2nd phase constructor 
     */
    void ConstructL();

private: 
    // data
    
    /** List of started effects, owned */
    RPointerArray<TXnEffect> iEffects;    
    };

#endif      // CXNEFFECTMANAGER_H

// End of File