// Copyright (c) 1997-2009 Nokia Corporation and/or its subsidiary(-ies).
// All rights reserved.
// This component and the accompanying materials are made available
// under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members
// which accompanies this distribution, and is available
// at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
//
// Initial Contributors:
// Nokia Corporation - initial contribution.
//
// Contributors:
//
// Description:
//



/**
 @file
 @internalComponent 
*/

#if !defined(__BMPANSRV_H__)
#define __BMPANSRV_H__

#include <e32std.h>
#include <w32adll.h>
#include <bmpanconsts.h>
#include "bmpancli.h"
#include <e32math.h>



enum TBitmapAnimServerPanic
	{
	EAnimationServerPanicIndexOutOfRange,
	EAnimationServerPanicFrameIntervalNegative
	};

// For packaging the new animation position offset
struct SBitmapAnimNewPosition
	{
	TPoint iPosition;
	};

// For packaging the new animation index
struct SBitmapAnimIndexFrame
	{
	TInt iIndex;
	};

// For packaging the number of cycles
struct SBitmapAnimNumberOfCycles
	{
	TInt iCycles;
	};



/**
 TFrameData

 This class is used for packaging the data of one frame.
*/
class TFrameData
	{
public:
	TInt iBitmapHandle;
	TInt iMaskBitmapHandle;
	TPoint iPosition;
	TInt iIntervalInMilliSeconds;			// the time is expressed in ms
	};



/**
 TBmpAnimAttributes

 This class is used for packaging the attriutes of the animation.
*/
class TBmpAnimAttributes
	{
public:
	TBool iFlash;
	TInt iFrameIntervalInMilliSeconds;
	CBitmapAnimClientData::TPlayMode iPlayMode;
	};




/**
 class MBitmapAnimTimerObserver
*/
class MBitmapAnimTimerObserver
	{
public:
	virtual void DisplayNextFrameL()=0;
	};



/**
 class CBitmapAnimTimer

 This class is used to determine when to swap the current frame with the next one.
*/
class CBitmapAnimTimer : public CTimer
	{
public:
	~CBitmapAnimTimer();
	static CBitmapAnimTimer* NewL(MBitmapAnimTimerObserver* aObserver);
	void RunL();
private:
	CBitmapAnimTimer(MBitmapAnimTimerObserver* aObserver);
	void ConstructL();
private:
	MBitmapAnimTimerObserver* iAnimate;
	};



/**
 class MBitmapAnimFlashTimerObserver
*/

class MBitmapAnimFlashTimerObserver
	{
public:
	virtual void FlashFrame(TBool aFlash)=0;
	};



/**
 class CBitmapAnimFlashTimer
*/

class CBitmapAnimFlashTimer : public CTimer
	{
public:
	~CBitmapAnimFlashTimer();
	static CBitmapAnimFlashTimer* NewL(MBitmapAnimFlashTimerObserver* aObserver);
	void DoCancel();
	void RunL();
private:
	CBitmapAnimFlashTimer(MBitmapAnimFlashTimerObserver* aObserver);
	void ConstructL();
private:
	MBitmapAnimFlashTimerObserver* iAnimate;
	TBool iFlash;
	};



/**
 class CBitmapAnimFrameData

 This class encapsulates the information of one frame.
*/

class CBitmapAnimFrameData : public CBase
	{
public:
	static CBitmapAnimFrameData* NewL();
	static CBitmapAnimFrameData* NewLC();
	~CBitmapAnimFrameData();
	void FillFrameDataL(const TFrameData& aFrameDataArg);
	void CheckAndCreateBitmapsL();
	
private:
	CBitmapAnimFrameData();
	void InitialiseMembers();
	
public:
	CFbsBitmap* iBitmap;
	CFbsBitmap* iMaskBitmap;
	TPoint iPosition;
	TTimeIntervalMicroSeconds32 iInterval;
	};



/**
 class CBitmapAnim

 This class encapsulates the enire animation: attributes and frames.
*/

class CBitmapAnim : public CFreeTimerWindowAnim, MBitmapAnimTimerObserver//, MBitmapAnimFlashTimerObserver
	{
public:
	~CBitmapAnim();
	static CBitmapAnim* NewL();
private:
	CBitmapAnim();
private:
	enum TAnimateFlags
		{
//	State
		ERunning				= 0x0001,
		EFlashing				= 0x0002,
		EFrozen					= 0x0004,
//	Play mode
		EPlayModeCycle			= 0x0010,
		EPlayModeBounce			= 0x0020,
		EPlayForwards			= 0x0040,
		EPlayBackwards			= 0x0080,
//	General
		EFlash									= 0x0100,
		EBackgroundBitmapProvided				= 0x0200,
		EWindowContentsInitialized				= 0x0400,
		ENoBitmapWindowRestoring				= 0x0800,
		EChangedBackgroundFramePending			= 0x1000,
		EBackgroundShouldIncludeWindowContents	= 0x2000,
		EDisplayLastFrameWhenFinished			= 0x4000,
		EBackgroundMaskProvided					= 0x8000
		};

private: //Pure Virtual function from CAnim
	virtual void ConstructL(TAny *aArgs, TBool aHasFocus);
	virtual void Command(TInt aOpcode, TAny* aArgs);
	virtual TInt CommandReplyL(TInt aOpcode, TAny *aArgs);
	virtual void Animate(TDateTime* aDateTime);
	virtual void Redraw();
	virtual void FocusChanged(TBool aState);
private: //Pure Virtual function from MEventHandler
	virtual TBool OfferRawEvent(const TRawEvent &aRawEvent);
private: //Pure Virtual function from MBitmapAnimTimerObserver
	virtual void DisplayNextFrameL();
private: //Pure Virtual function from MBitmapAnimFlashTimerObserver
	virtual void FlashFrame(TBool aFlash);
private:
	void AppendFrameL(const TFrameData& aFrameData);
	inline TInt Count() const;
	void DisplayFrame(TInt aPreviousIndex=-1);
	void DrawBitmap(TInt aPreviousIndex=-1, TBool aRedraw=EFalse);
	inline TBool IsFrameDisplayable() const;
	inline TBool IsRunning() const;
	inline TBool IsFrozen() const;
	void ResetAnimation();
	void ClearFrame(TInt aIndex);
	void ClearFrameNow(TInt aIndex);
	void RenderFrameBackground(TInt aIndex);
	TRect CalcFrameRect(TInt aIndex);
	void SetBackgroundFrameL(TFrameData aFrameDataArg);
	void SetFlash(TBmpAnimAttributes aFlash);
	void SetFrameInterval(TBmpAnimAttributes aFrameInterval);
	TInt SetIndexFrame(SBitmapAnimIndexFrame aIndexFrame);
	void SetNumberOfCycles(SBitmapAnimNumberOfCycles aNumberOfCycles);
	void SetPlayMode(TBmpAnimAttributes aPlayMode);
	void SetPosition(SBitmapAnimNewPosition aNewPosition);
	void StartAnimationL();
	void StopAnimation();
	void StoreWindowContentsToBackgroundBitmapL(const TRegion* aRegion);
	void UpdateCurrentIndex();
	inline TRect WindowRect() const;
	CFbsBitmap* CreateRestoringBitmapL(TPoint& aPosition, TInt aPreviousIndex);
	void UpdateBackgroundBitmapIfNeeded(const TRegion* aRegion, TRect aBackgroundBitmapScreenRect);
	static TBool FrameNeedsRedrawing(const TRegion* aRedrawRegion, TRect aFrameScreenRect);
	void ResetFrameArray();
	void ClearFrameData();
	TBool CanDrawNextFrameWithoutErasingPreviousFrameL(TInt aPreviousIndex);
	TBool CompareBitmapsL(CFbsBitmap* aBmp1, CFbsBitmap* aBmp2);
	
private:
	RPointerArray<CBitmapAnimFrameData> iBitmapAnimFrameDataArray;
	CBitmapAnimTimer* iAnimTimer;
	CBitmapAnimFlashTimer* iFlashTimer;
	CBitmapAnimFrameData* iBackgroundFrame;
	CFbsBitmap*  iBackgroundBitmap;
	CFbsBitmapDevice* iBackgroundbitmapDevice;
	CFbsBitGc* iBackgroundbitmapGc;

//
	TInt iDummy;
	TInt iFlags;
	TInt iIndex;
	TInt iNumberOfCycles;
	TPoint iPosition;
	TInt iWindowConfig;
	TTimeIntervalMicroSeconds32 iFrameInterval;
//
	CFbsBitGc* iRestoringGc;	
	};

// Returns the number of frames store in the frame array.
inline TInt CBitmapAnim::Count() const
	{ return iBitmapAnimFrameDataArray.Count(); }

// Returns ETrue every time the index frame is valid, otherwise it returns EFalse.
inline TBool CBitmapAnim::IsFrameDisplayable() const
	{ return ( (iIndex >= 0) && iBitmapAnimFrameDataArray[iIndex]->iBitmap ); }

// Returns ETrue if the animation is running, otherwise it returns EFalse.
inline TBool CBitmapAnim::IsRunning() const
	{ return iFlags&ERunning; }

//Returns ETrue if the animation is frozen (app is not in the foreground)
inline TBool CBitmapAnim::IsFrozen() const
{ return iFlags&EFrozen; }

// Returns the available window rect.
inline TRect CBitmapAnim::WindowRect() const
	{ return TRect(TPoint(0, 0), iWindowFunctions->WindowSize()); }




/**
 CBitmapAnimDll class
*/

class CBitmapAnimDll : public CAnimDll
	{
public:
	CBitmapAnimDll();
	virtual CAnim* CreateInstanceL(TInt aType);
	};


/**
 global functions
*/
GLREF_C void Panic(TBitmapAnimServerPanic aReason);


#endif