/*

* 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

//  INCLUDES

#include <e32base.h>

// CLASS DECLARATION

class CXnPluginData;

class CXnViewData;

class CXnNode;

/**

 *  Struct which holds needed info of effect.

 */

NONSHARABLE_STRUCT( TXnEffect )

    {

    CXnNode* iNode;

    TInt iState;

    TInt iType;

    TInt iId;

    };

/**

 *  Effect manager.

 *  Handles starting and ending effects.

 *

 *  @since S60 v5.0

 */

NONSHARABLE_CLASS( CXnEffectManager ) : public CBase

    {

public:

    /**

     * Two-phased constructor.

     * @return new instance of CXnEffectManager.

     */

    static CXnEffectManager* NewL();

    /**

     * Destructor.

     */

    ~CXnEffectManager();

    /**

     * Begin handling of control effect.

     * @param aId effect id

     * @aPlugin Plugin data

     */

    void BeginControlEffectL( TInt aId, CXnPluginData& aPlugin );

    /**

     * Begin handling of control effect.

     * @param aId effect id

     * @aPlugins Array of plugin datas

     */

    void BeginControlEffectL( TInt aId, RPointerArray<CXnPluginData>& aPlugins );

    /**

     * Begin handling of fullscreen effect.

     * @param aId effect id

     * @aView view data

     */

    void BeginFullscreenEffectL( TInt aId, CXnViewData& aView );

    /**

     * When UiRendered is called effect is ended and will be drawn

     */

    void UiRendered();

    /**

     * When UiLayouted is called effect is started if it was not started earlier.

     */

    void UiLayouted();

private:

    /**

     * Starts fullscreen effect.

     * @param aEffect effect data

     */

    void DoBeginFullscreenEffect( TXnEffect& aEffect );

    /**

     * Starts control effect.

     * @param aEffect effect data

     */

    void DoBeginControlEffect( TXnEffect& aEffect );

    /**

     * Removes and destroys effect from effect list.

     * @param aEffect effect data

     */

    void RemoveEffect( TXnEffect* aEffect );

    /**

     * Return number of ongoing effects of given type.

     * @param aType effect type, fullscreen or control

     * 

     * @return Number of ongoing effects of given type

     */

    TInt EffectCount( TInt aType );

    /**

     * C++ default constructor.

     */

    CXnEffectManager();

    /**

     * By default Symbian 2nd phase constructor is private.

     */

    void ConstructL();

private: // data

    /**

     * List of started effects.

     */

    RPointerArray<TXnEffect> iEffects;

    };

#endif      // CXNEFFECTMANAGER_H

// End of File