/*

* 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:  Task monitor engine

 *

*/

#ifndef TSFSWENGINE_H

#define TSFSWENGINE_H

#include <e32base.h>

#include <e32cmn.h>

#include <s32strm.h>

#include <fbs.h>

#include <eikenv.h>

#include <w32std.h>

#include <e32hashtab.h>

#include <apgcli.h>

#include <e32property.h>

#include "tspreviewobserver.h"

#include "tsfswentry.h"

#include "tsfswobservers.h"

class MTsFswEngineObserver;

class CTsFastSwapPreviewProvider;

class CApaWindowGroupName;

class CBitmapRotator;

class CTsRotationTask;

// descriptor big enough to store hex repr of 32-bit integer plus 0x prefix

typedef TBuf<10> TAppUidHexString;

/**

 * Engine for fast swap server.

 * Performs task monitoring, notifications about wg changes are

 * received from the appui.

 */

NONSHARABLE_CLASS( CTsFswEngine ) : public CActive,

        public MTsFswTaskListObserver,

        public MTsFswResourceObserver,

        public MTsFsHiddenAppListObserver,

        public MTsFastSwapPreviewObserver

    {

public:

    /**

     * Creates a new instance.

     * @param   aObserver   ref to observer

     */

    IMPORT_C static CTsFswEngine* NewL( MTsFswEngineObserver& aObserver );

    /**

     * @copydoc NewL

     */

    IMPORT_C static CTsFswEngine* NewLC( MTsFswEngineObserver& aObserver );

    /**

     * Destructor.

     */

    ~CTsFswEngine();

    /**

     * Returns a reference to the current content.

     * Also performs sanity checks, e.g. associates application icons

     * when no screenshot has been received.

     * @return  ref to content array

     */

    IMPORT_C const RTsFswArray& FswDataL();

    /**

     * Tries to close the given app.

     * @param   aWgId   value given by WgId() for an entry in iData

     */

    IMPORT_C void CloseAppL( TInt aWgId );

    /**

     * Brings the given app to foreground.

     * @param   aWgId   value given by WgId() for an entry in iData

     */

    IMPORT_C void SwitchToAppL( TInt aWgId );

    /**

     * Returns the uid of the foreground app or KNullUid.

     * Will never return hidden apps, only those which can

     * also be seen in the array returned by FswDataL.

     *

     * In case of embedded apps the behaviour is controlled

     * by aType: it will return either the uid of the embedded

     * application or the container app.

     *

     * @param   aType   @see CTsFswClient::TTsFswFgAppType

     */

    IMPORT_C TUid ForegroundAppUidL( TInt aType );

    /**

     * Callback for rotation completion. Takes ownership of a given

     * bitmap.

     */

            CFbsBitmap* aBitmap,

            CTsRotationTask* aCompletedTask,

            TInt aError );

private:

    // from CActive

    void RunL();

    TInt RunError( TInt aError );

    void DoCancel();

    // from MTsFswTaskListObserver

    void UpdateTaskList();

    // from MTsFswResourceObserver

    void HandleResourceChange( TInt aType );

    // from MTsFsHiddenAppListObserver

    void HiddenAppListUpdated();

    // from MTsFastSwapPreviewObserver

    void HandleFswPpApplicationChange( TInt aWgId, TInt aFbsHandle );

    void HandleFswPpApplicationUnregistered( TInt aWgId );

    void HandleFswPpApplicationBitmapRotation( TInt aWgId, TBool aClockwise );

    void RotateL( CFbsBitmap& aBitmap, TInt aWgId, TBool aClockwise );

private:

    /**

     * Constructor.

     */

    CTsFswEngine( MTsFswEngineObserver& aObserver );

    /**

     * Performs 2nd phase construction.

     */

    void ConstructL();

    /**

     * Gets the window group list and reconstructs the fsw content.

     * @return   TBool   ETrue if the list has been modified

     */

    TBool CollectTasksL();

    /**

     * Finds out the app uid for the given window group id.

     * @param   aWgId   a valid window group id

     * @return  application uid

     */

    TUid AppUidForWgIdL( TInt aWgId );

    /**

     * Finds out the application name.

     * @param   aWindowName window group name or NULL

     * @param   aAppUId     application uid

     * @param   aWgId       window group id

     * @return  application name, ownership transferred to caller

     */

    HBufC* FindAppNameLC( CApaWindowGroupName* aWindowName,

    /**

     * Makes a copy of the bitmap with the given handle.

     * @param   aFbsHandle          bitmap handle

     * @param   aKeepAspectRatio    if true then aspect ratio is kept

     * @return  CFbsBitmap*     the copy, ownership transferred to caller

     */

    CFbsBitmap* CopyBitmapL( TInt aFbsHandle, TBool aKeepAspectRatio );

    /**

     * Callback for the iUpdateStarter timer.

     * Calls CollectTasksL and notifies the observer if the task list

     * has really been modified.

     */

    static TInt UpdateStarterCallback( TAny* aParam );

    /**

     * Brings the given web widget to foreground.

     * @param   aWidgetIndex    index in the list of running widgets

     */

    void SwitchToWidgetL( TInt aWidgetIndex );

    /**

     * Configues the preview provider with current screen size.

     */

    void SetPreviewParams();

    /**

     * Registers and unregisters window groups to iPreviewProvider

     * if the window group list has been changed.

     */

    void UpdatePreviewContent();

    /**

     * Gets and publishes the foreground app uid to CFW.

     */

    void PublishFgAppUidL();

    /**

     * Close running widget

     * @param aOffset - widget info offset

     */

    // window server session

    RWsSession iWsSession;

    // apparc session

    RApaLsSession iAppArcSession;

    // preview provider instance, own

    CTsFastSwapPreviewProvider* iPreviewProvider;

    // timer to defer content refresh

    CPeriodic* iUpdateStarter;

    // true if web widgets are supported by the system

    TBool iWidgetsSupported;

    // PS property to listen for swi status changes

    RProperty iSwiProp;

    // window group ids returned by last WindowGroupList call

    RArray<TInt> iWgIds;

    // For publishing the foreground app uid to Context Framework    

    TAppUidHexString iFgAppUidStr;

    TUid iFgAppUid;

    // For rotating bitmaps

    RPointerArray<CTsRotationTask> iRotaTasks;

    };

/**

 * Listener for rotation complete event

 */

NONSHARABLE_CLASS( CTsRotationTask ) : public CActive

    {

public:

    CTsRotationTask( CTsFswEngine& aEngine );

    ~CTsRotationTask();

private:

    void RunL();

    void DoCancel();

    CTsFswEngine& iEngine;

    TInt iWgId;

    CFbsBitmap* iBitmap; // owned for the duration of transformation

    CBitmapRotator* iRotator; // owned

    };

#endif