// Copyright (c) 2008-2009 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:

 //

 #ifndef CDISPLAYPOLICY_H

 #define CDISPLAYPOLICY_H

 // INCLUDES

 #include <e32std.h>

 #include <e32base.h>

 #include <graphics/displaycontrolbase.h>

 #include <graphics/displaymapping.h>

 #include <graphics/displayconfiguration.h>

 #include <graphics/wsdisplaypolicy.h>

 // CLASS DECLARATION

 enum TCoordinateSpace;

 class MWsGraphicDrawerEnvironment;

 class MWsScreen;

 class MWsScreenConfigList;

 class MWsIniFile;

 /**

  *  CDisplayPolicy

  * 

  */

 class CDisplayPolicy : public CBase

 	{

 public:

 	enum	TUiScaling

 		{

 		ENone=			0,

 		EInteger=		1,

 		EIsotropic=		2,

 		EAnisotropic=	3		

 		};

 	// Constructors and destructor

 	/**

 	 * Destructor.

 	 */

 	~CDisplayPolicy();

 	/**

 	 * Two-phased constructor.

 	 */

 	static CDisplayPolicy* NewL(MWsGraphicDrawerEnvironment* aEnv,MWsScreen* aScreen,TInt aScreenNumber);

 	/**

 	 * Two-phased constructor.

 	 */

 	static CDisplayPolicy* NewLC(MWsGraphicDrawerEnvironment* aEnv,MWsScreen* aScreen,TInt aScreenNumber);

 	void NewAppModesAvailable();

 	void GetAppModeList();

 	TInt MapCoordinates(TCoordinateSpace aSourceSpace, const TRect& aSource, 

 			TCoordinateSpace aTargetSpace, TRect& aTarget) const;

 	void AddVirtualResolutionCount(TInt& aDisplayCount) const; 

 	TInt AddVirtualResolutions(RArray<MDisplayControlBase::TResolution>& aResolutions) const;

 	MDisplayControlBase::TResolution AppModeToResolution(RArray<MDisplayControlBase::TResolution>& aResolutions,TInt appMode)const;

 	TInt GetSizeModeConfiguration(RArray<MDisplayControlBase::TResolution>& aResolutions,TInt aScreenSizeMode, 

 			TDisplayConfiguration& aConfig, TRect& aSizeModePosition) const;

 	/*

 	 * Used when display is disconnected.

 	 */

 	TInt GetSizeModeConfiguration(TInt aScreenSizeMode,TDisplayConfiguration& aConfig, TRect& aSizeModePosition);

 	TBool SettingConfiguration(const RArray<MDisplayControlBase::TResolution>& aResolutions,

 			TDisplayConfiguration& aConfig)const;

 	TBool PolicyEnabled()const{return (iUiScaling==ENone)?EFalse:ETrue;}

 	void SetCompositionInfo (const TDisplayConfiguration& aCompositionConfig,const TDisplayConfiguration& aUiConfig);

 	void SetSizeModeExtent(TRect& aExtent, TBitFlags32 /*aContext*/);

 	void	AdjustStageBufferSize(const TSize& aOldSize,TSize& aNewSize);

 	void	CalculateMinBufferSize(RArray<MDisplayControlBase::TResolution>& aResolutions, TInt aConnectionStatus);

 	TInt 	SuitableAppMode(MWsDisplayPolicy::TDisplayStatus aSituation);

 	void 	SetLastAppMode(TInt aMode);

 	TSize	GetUiResolution();

 	TSize   GetUiResolutionAsTwips() const;

 	TRect 	GetPolicyAppMode();

 private:

 	class TAppMode

 		{

 	public:

 		TRect	iPixels;	//<Size and pisition in pixels

 		TSize	iTwips;		//<Size in TWips

 		TInt	iFlags;		//<Flags

 		enum	THighFlags	//<Policy flags are per app mode. Lower bits are defined by MWsScreenConfigList::TModeFlags 

 			{		//Currently none

 			};

 		//The app modes are presented based on Normal rotation to calculate correctly with display resolutions

 		//which are always in normal rotation

 		TInt	iOrientations;	//<Index bits via CFbsBitGc::TGraphicsOrientation

 		TInt	iModeIndex;	//<Which screen mode index it refers to

 		};

 	/**

 	 * Constructor for performing 1st stage construction

 	 */

 	CDisplayPolicy();

 	/**

 	 * EPOC default constructor for performing 2nd stage construction

 	 */

 	void ConstructL(MWsGraphicDrawerEnvironment* aEnv,MWsScreen* aScreen,TInt aScreenNumber);

 	TBool FindVirtualMode(const RArray<MDisplayControlBase::TResolution>& aResolutions,

 			const CDisplayPolicy::TAppMode& aAppMode,TSize& aFullAppModeSize,TInt& aIndex,TInt& aBestScale) const;

 	TSize ResolutionSize(RArray<MDisplayControlBase::TResolution>& aResolutions, const TSize aBestAppSize,

 			TInt aIndex, TInt aScale) const;

 	TSize ResolutionSizeFromTwips(RArray<MDisplayControlBase::TResolution>& aResolutions, TInt aAppMode,const TSize& aBestAppSize, 

 			TInt aIndex,TBool aSwapAxis) const;

 	TSize ResolutionSizeFromAssumedTwips(RArray<MDisplayControlBase::TResolution>& aResolutions,const TSize& aBestAppSize,

 			TInt aIndex,TBool aSwapAxis,TInt aScale) const;

 	TBool MatchConfigToResolutions(const RArray<MDisplayControlBase::TResolution>& aResolutions,

 			const TDisplayConfiguration& aConfig, TInt aStartIndex, TInt& aResolutionIndex)const;

 	TBool SetConfigToResolution(TInt aAppMode, MDisplayControlBase::TResolution aResolution, TDisplayConfiguration& aConfig)const;

 	void CenteredAppInUi(const TSize& aUiSize,const TRect& aAppExtent,TRect& aSizeModePosition) const;

 	TInt MapCompositionToUi(const TRect& aSource, TRect& aTarget, TBool aIsReverseMapping) const;

 	void MapUiToApplication(const TRect& aSource, TRect& aTarget, TBool aIsReverseMapping) const;

 	TInt MapUiToDSA(const TRect& aSource, TRect& aTarget, TBool aIsReverseMapping) const;

 	void GetModeInfoL(const MWsScreenConfigList& aList,TInt aIndex,TPoint& aOffset,TSize& aSize,TAppMode& aMode) const;

 	TInt MinSizedModeIndex();

 	/** Used when calculating how to map app mode to hardware resolutions

 		Rounds up when .5

 	*/

 	class TFraction

 		{

 	public:

 		TFraction();

 		TInt operator*(TInt aInt) const;

 	public:

 		TInt iNumer;

 		TInt iDenom;

 		};

 private:

 	RArray<TAppMode>	iAppModes;

 	TInt iUiScaling;

 	MWsIniFile* iScreenIniFile;

 	MWsScreen* iScreen;

 	TSize iUiSizePixels;

 	TRect iAppSizePixels;

 	TSize iAppSizeTwips;

 	TSize iCompositionSizeTwips;

 	TSize iCompositionSizePixels;

 	TSize	iMinUiBufferSize;

 	TInt 	iNumNormalAppModes;

 	TInt	iLastAppMode;

 	TInt 	iConnectionStatus;

 	TInt 	iSmallestAppMode;

 	TSize 	iSmallestAppSize;

 	TDisplayConfiguration::TRotation iLastUiRotation;

 	TDisplayConfiguration::TRotation iLastCompositionRotation;

 	};

 #endif // CDISPLAYPOLICY_H