Symaptic: os/graphics/windowing/windowserver/nga/SERVER/openwfc/screen.h@260cb5ec6c19

     1 // Copyright (c) 2004-2010 Nokia Corporation and/or its subsidiary(-ies).

     2 // All rights reserved.

     3 // This component and the accompanying materials are made available

     4 // under the terms of "Eclipse Public License v1.0"

     5 // which accompanies this distribution, and is available

     6 // at the URL "http://www.eclipse.org/legal/epl-v10.html".

     7 //

     8 // Initial Contributors:

     9 // Nokia Corporation - initial contribution.

    10 //

    11 // Contributors:

    12 //

    13 // Description:

    14 // Defines the screen class (was in scrdev.h)

    15 //

    16 //

    18 #ifndef __SCREEN_H__

    19 #define __SCREEN_H__

    21 #include <e32std.h>

    22 #include <e32base.h>

    23 #include <graphics/surface.h>

    24 #include <hal_data.h>

    25 #include <graphics/wsscene.h>

    26 #include <graphics/wsdisplaypolicy.h>

    28 #include "W32STD.H"

    29 #include "w32cmd.h"

    30 #include "wstypes.h"

    31 #include <graphics/WSGRAPHICDRAWERINTERFACE.H>

    32 #include "panics.h"

    34 #include "wsdisplaychangeao.h"

    37 class CWsDirectScreenAccess;

    39 class CWsWindowGroup;

    40 class CWsWindow;

    41 class CWsRootWindow;

    42 class CWsClientWindow;

    43 class CDebugBar;

    44 class CScreenRedraw;

    45 class CWsSpriteManager;

    46 class CWindowElementSet;

    47 class CActiveComposer;

    48 class CRegisteredSurfaceMap;

    49 class MWsScene;

    50 class MWsElement;

    51 class MWsScreenDevice;

    52 class MWsDisplayMapping;

    53 class MWsDisplayControl;

    54 class MWsTextCursor;

    55 class CGraphicsDeviceMap;

    56 class TDisplayConfiguration;

    57 #if defined(__WINS__) && defined(_DEBUG)

    58 class CDebugOsbWin;

    59 #endif

    61 enum TAnimType

    62 	{

    63 	EWindowAnim			= 0x01,

    64 	ESpriteAnim			= 0x02,

    65 	ETextCursor			= 0x04,

    66 	EWindowSprite   	= 0x08,

    67 	EFloatingSprite 	= 0x10,

    68 	EFloatingSpriteAnim = 0x20,

    69 	ECrpAnim			= 0x40,

    70 	};

    72 _LIT(KWSERVIniFileVarChangeTracking, "CHANGETRACKING");

    74 class CScreen : public CBase, public MWsScreen, public MWsScreenConfigList, public MWsScreenConfig, public MWsWindowTree

    75 	{

    76 public:

    77 	enum {EGetScanLineBufLen=0x100};	// Buffer of for returning result of GetScanLine

    78 	enum TDisplayScreen

    79 		{

    80 		EBlankScreenOnRotation = 0x1,

    81  		EAutoClear = 0x2,

    82  		EHasDynamicSizeModes = 0x04,

    83 		EChangeTracking = 0x8,

    84 		};

    86 	/**

    87 	The fallback map is an array of 32 bit integers sufficiently large to store a single bit for any

    88 	possible orientation and size of the screen, with the pixel rows padded to the end of the int.

    89 	*/

    90 	class CFallbackMap : public CBase

    91 		{

    92 	public:

    93 		static CFallbackMap * NewL(CScreen* aScreen);

    94 		~CFallbackMap();

    96 		void Prepare();

    97 		TBool FillRegion(const TRegion& aRegion);

    98 		TBool FillRect(const TRect& aRect);

    99 		TInt Count() const;

   100 		const TRect * Rect() const;

   101 		const RRegion * Region() const;

   102 		TInt Resize(const TSize& aSize);

   104 	private:

   105 		CFallbackMap(CScreen* aScreen);

   106 		void ConstructL();

   108 	public:

   109 		CScreen* iScreen;

   110 		RRegionBuf<1> iRegion;

   111 		TInt iCount;

   112 		TInt iMapSize; // size in padded TInts

   113 		TInt * iMap;

   114 		};

   115 public:

   116 	CScreen();

   117 	~CScreen();

   118 	void ConstructL( const TRect& aDigitiserArea, TInt aScreenNumber);

   119 	void AbortAllDirectDrawing(RDirectScreenAccess::TTerminationReasons aReason);

   120 	void AddDirect(CWsDirectScreenAccess& aDirect);

   121 	void RemoveDirect(CWsDirectScreenAccess& aDirect);

   122 	void AbortDSAs(RDirectScreenAccess::TTerminationReasons aReason,TSglQue<CWsDirectScreenAccess>& aDirects);

   123 	void ReleaseDsaScreenDevice();

   124 	void AcquireDsaScreenDeviceL();

   125 	void CreateDsaScreenDeviceIfSupportedL(TDisplayMode aScreenMode);

   126 	TBool DoCreateDsaScreenDevice(TDisplayMode aScreenMode);

   127 #if defined(_DEBUG)

   128 	TBool IsDirectOnQueue(const CWsDirectScreenAccess* aDirect);

   129 #endif

   131 	inline CWsWindowGroup* FocusWindowGroup();

   132 	void KillForegroundSession();

   133 	void ResetFocus(CWsWindowGroup *aClosingWindow);

   134 	inline TBool BlankScreenOnRotation();

   135 	inline TBool AutoClear();

   136 	void RemoveFromDefaultOwningList(CWsWindowGroup *aDestroyedGroup);

   137 	void SetDefaultOwningWindow(CWsWindowGroup *aGroup);

   138 	inline CWsWindowGroup *DefaultOwningWindowGroup();

   139 	const MWsScreenDevice& ScreenDevice() const;

   140 	const CGraphicsDeviceMap& DeviceMap() const;

   141 	inline const TSurfaceId& DsaSurface() const;

   142 	inline CWsRootWindow* RootWindow() const;

   143 	inline TInt ScreenNumber() const;

   144 	void UpdateDsa();

   145 	inline TDisplayMode DefaultDisplayMode(const TInt aMode) const;

   146 	TDisplayMode FirstDefaultDisplayMode() const;

   147 	void MaxNumColors(TInt& aColors,TInt& aGrays);

   148 	TInt ColorModesFlag();

   149 	inline void GetFadingParams(TUint8& aBlackMap,TUint8& aWhiteMap) const;

   150 	inline void SetFadingParams(TUint8 aBlackMap,TUint8 aWhiteMap);

   151 	void GetScanLine(const TWsSdCmdGetScanLine *aGetScanLine);

   153 	TBool SetScreenModeEnforcement(TInt aMode);

   154 	inline TInt ScreenSizeMode() const;

   155 	void SetPointerCursorArea(TInt aMode,const TRect& aRect);

   156 	inline TRect GetPointerCursorArea(TInt aMode) const;

   157 	CFbsBitGc::TGraphicsOrientation Orientation() const;

   158 	void CycleDisplaySize();

   159 	TBool UpdateOrientation(MWsScene::TSceneRotation* aOldRotation = NULL);

   160 	void doSetScreenMode(TInt aMode,TBool aInsideStartup=EFalse);

   161 	inline TSize CurrentScreenSize() const;

   162 	TRect DrawableArea() const;

   163 	void CycleOrientation();

   164 	TClientPanic SetModeRotation(TInt aMode,CFbsBitGc::TGraphicsOrientation aRotation);

   165 	void LoadScreenSizesL(TSize aScreenSize);

   166 	void LoadScreenSizeProperties(TDisplayMode aDefaultDisplayMode);

   167 	void SetDigitiserAreas(const TSize& aUiSize);

   168 	inline TInt NumScreenSizeModes() const;

   169 	inline const TSizeMode& ScreenSizeModeData() const;

   170 	inline const TSizeMode& ScreenSizeModeData(TInt aMode) const;

   171 	inline TScreenModeEnforcement SizeEnforcementMode() const;

   172 	void GetScreenSizeAndRotation(TPixelsTwipsAndRotation &aSar, TInt aScreenMode);

   173 	void GetScreenSizeAndRotation(TPixelsAndRotation &aSar, TInt aScreenMode);

   174 	void SetCurrentScreenModeAttributes(const TSizeMode &aModeData);

   175 	TPoint PhysicalToLogical(TPoint aPhysicalPt);

   176 	void IncContrast();

   177 	void DecContrast();

   178 	void IncBrightness();

   179 	void DecBrightness();

   180 	inline TBool IsValidScreenSizeMode(TInt aMode) const;

   181 	TInt GetScreenSizeModeListL();

   182 	// called by CWsGc when it is implementing MWsGc

   183 	const TTime& Now() const;

   184 	void ScheduleAnimation(TAnimType aType, const TRect& aRect,const TTimeIntervalMicroSeconds& aFromNow,const TTimeIntervalMicroSeconds& aFreq,const TTimeIntervalMicroSeconds& aStop, CWsWindow* aWindow);

   185 	TBool IsScheduled(TAnimType aType, const TRect& aRect, CWsWindow* aWindow) const;

   186 	// redraw scheduling code

   187 	void AddRedrawRegion(const TRegion& aRegion, TBool aSchedule = ETrue, TRedrawDepth aDepth = ERedrawAll);

   188 	void ScheduleRender(const TTimeIntervalMicroSeconds& aFromNow);

   189 	void DoRedrawNow();

   190 	void RedrawNowIfPending();

   191 	void ScheduleRegionUpdate(const TRegion* aDefinitelyDirty);

   192 // implementing MWsScreen

   193 	void OnAnimation(TRequestStatus* aFinished);

   194 	void Redraw();

   195 	TBool RedrawInvalid(const TArray<TGraphicDrawerId>& aInvalid);

   196 	inline TBool BackLightFlag();

   197 // implementing interface extension

   198 	TAny* ResolveObjectInterface(TUint aTypeId);

   200 // implementing MWsScreenConfig... this might be better as RS interface, but half methods are in here!

   201 	TSize ScreenModeSizeInPixels() const;

   202 	TInt Stride() const;

   203 	TInt SizeMode() const;

   204 	TSize ScalingFactor() const;

   205 	TPoint Origin() const;

   206 	TPoint ScaledOrigin() const;

   208 // implementing MWsScreenConfigList

   209 	TInt	GetScreenSizeModeList(RArray<TInt>&aList) const;

   210 	TDisplayMode DisplayModeL(TInt aIndex) const;

   211 	TSize ScreenModeSizeInPixelsL(TInt aIndex) const;

   212 	/** Get screen size in twips for current screen size mode as defined in wsini */

   213 	TSize ScreenModeSizeInTwipsL(TInt aIndex) const;

   214 	CFbsBitGc::TGraphicsOrientation OrientationL(TInt aIndex) const;

   215 	TInt AvailableOrientationsL(TInt aIndex) const;

   216 	TSize ScalingFactorL(TInt aIndex) const;

   217 	TPoint OriginL(TInt aIndex) const;

   218 	TPoint ScaledOriginL(TInt aIndex) const;

   219 	TInt ModeFlagsL(TInt aIndex) const;

   221 //implementing MWsWindowTree

   222 	void SendTree() const;

   224 // other public methods

   226 	TDisplayMode DisplayMode() const;

   227 	TSize SizeInPixels() const;

   228 	TSize SizeInTwips() const;

   229 	TSize DSASizeInPixels() const;

   230 	inline CWindowElementSet& WindowElements() const;

   231  	inline MWsElement& UiElement() const;

   232 	void ElementAdded();

   233 	void ElementRemoved();

   234 	//check if the current display mode has alpha

   235 	inline TBool HasAlpha() const;

   236 	//list of session and surface id

   237 	CRegisteredSurfaceMap* SurfaceMap();

   239 	void DiscardAllSchedules();

   240 	inline CDebugBar * DebugBar();

   241 	inline CFallbackMap * FallbackMap();

   242 	inline CWsSpriteManager* SpriteManager() const;

   243 	TBool IsQuickFadeScheduled( CWsWindow* aWin ) const;

   244 	void RemoveFromQuickFadeList( CWsWindow* aWin );

   245 	void AcceptFadeRequest( CWsWindow* aWin, TBool	aFadeOn );

   246 	TBool HasVisibleDirectOnQueue();

   247 	TBool IsDSAClientWindow( const CWsClientWindow* aWin ) const;

   248 	MWsTextCursor* RenderStageTextCursor() const;

   249 	void ClearDsaSurface(const TRect& area, const TRgb& color);

   250 	void PositionUiElements(const TRect& aExtent,	const TRect& aViewport);

   251 	TInt SetConfiguration(const TDisplayConfiguration& aConfig);

   252 	TInt UpdateConfiguration(const TDisplayConfiguration& aConfig);

   253 	void UpdateDynamicScreenModes();

   254 	void RecalculateModeTwips(const TDisplayConfiguration* aConfig = NULL);

   255 	inline void IncreaseDisplaySpinner();

   256 	inline void IncreaseConfigSpinner();

   257 	inline TInt DisplaySpinner();

   258 	inline TInt ConfigSpinner();

   259 	TInt AddNotificationClient(CWsClient *aClient);

   260 	void RemoveNotificationClient(CWsClient *aClient);

   261 	TInt FindNotificationClient (CWsClient *aClient);

   262 	TInt GetNotificationClients(RPointerArray<CWsClient>& aClientsArray);

   263 	inline MWsDisplayPolicy* DisplayPolicy();

   264 	inline MWsDisplayMapping* DisplayMapping();

   266 	//CR1577

   267 	inline TBool ChangeTracking() const;

   268 	inline MWsWindowTreeObserver* WindowTreeObserver() const;

   269 	inline MWsDrawAnnotationObserver* DrawAnnotationObserver() const;

   270 	inline MWsWindowVisibilityNotifier* WindowVisibilityNotifier() const;

   271 	void ScheduleWindow(CWsWindow* aWindow);

   272 	void RemoveFromScheduledList(CWsWindow* aWindow);

   273 	void RemoveFromTimedDrawList(CWsWindow* aWindow);

   274 	void SetupVisibleRegionTracking(CWsWindow& aWindow, TBool aRegister) const;

   276 	TBool IsAnimating() const;

   278 private:

   279 	class TInternalSizeMode: public TSizeMode

   280 		{

   281 	public:

   282 		inline TInternalSizeMode(){}

   283 		inline TInternalSizeMode(TSize& aSize)

   284 			:	TSizeMode(aSize), iFlags(0)

   285 			{	}

   286 		TInt iFlags;

   287 		};

   288 	enum TSyncConsts

   289 		{

   290 		KDSAAbortingImmediateRespAwaitFrameMicrosec = 80000		// 0.08 sec

   291 		};

   292 	void SetInitialScreenSizeModeAndRotation();

   293 	CWsWindowGroup* FindNewFocus(CWsRootWindow* aRootWindow);

   294 	void UpdateCompositionMode();

   295 	void InitializeSceneL();

   296 	void InitializeUiElementsL();

   297 	TInt InitializeDsaSurface();

   298 	void LoadScreenRotationProperties(TInternalSizeMode& aMode, const TInt aModeIndex);

   299 	void LoadScreenTwipsProperties(TInternalSizeMode& aMode, const TInt aModeIndex);

   300 	void CreateFallbackMapL();

   301 	MWsElement* CreateUiElementL(const TRect& aExtent);

   302 	const TInternalSizeMode* ModePtrL(TInt aIndex) const;

   303 	void ApplyRemainingWsiniSettingsL();

   304 private:

   305 	enum

   306 		{

   307 		eTimerCreated=0x1,

   308 		};

   309 	enum TDsaDrawState

   310 		{

   311 		EDsaDrawStateIdle,

   312 		EDsaDrawStateDrawing

   313 		};

   314 private:

   315 	TSglQue<CWsDirectScreenAccess> iDirects;

   316 	RTimer iTimer;

   317 	TRequestStatus iTimerStatus;

   318 	TUint iFlags;

   320 	CScreenRedraw* iRedraw;

   322 	CWsRootWindow* iRootWindow;

   323 	CWsWindowGroup *iCurrentFocus;

   324 	CWsWindowGroup *iDefaultOwningWindow;

   326 	MWsScreenDevice* iScreenDevice;

   327 	CFbsScreenDevice* iDsaDevice;

   328 	CFbsBitGc* iDsaGc;

   329 	CGraphicsDeviceMap* iDeviceMap;

   330 // Size and rotation members

   331 	RPointerArray<TInternalSizeMode> *iModes;

   332 	TInt iScreenSizeMode;

   333 	TScreenModeEnforcement iSizeEnforcementMode;

   334 	TInt iScreenNumber;

   335 	TInt iMaxContrast;

   336 	TInt iMaxBrightness;

   337 	TInt iNumScreenSizeModes;

   338 	TInt iNumSupportedScreenSizeModes;

   339 	TInt iNumberDrawingDsa;

   340 	TBool iBackLightFlag;

   342 	TDsaDrawState iDsaDrawState;

   344 	MWsDisplayMapping* iDisplayMapping;

   345 	MWsDisplayControl* iDisplayControl;

   346 	MWsDisplayPolicy* iDisplayPolicy;

   347 	MWsScene* iScene;

   348 	CWindowElementSet* iWindowElementSet;

   349 	MWsElement* iUiElement;

   350 	TSurfaceId iDsaSurface;

   351 	CRegisteredSurfaceMap* iSurfaceMap;

   353 	CDebugBar* iDebugBar;

   354 	CFallbackMap* iFallbackMap;

   355 	TUint8 iBlackMap;

   356 	TUint8 iWhiteMap;

   357 	CWsSpriteManager* iSpriteManager;

   358 	//The next three interfaces should be provided by renderstages if the screen is to be used in CHANGETRACKING mode

   359 	MWsWindowTreeObserver* iWindowTreeObserver;

   360 	MWsDrawAnnotationObserver* iDrawAnnotationObserver;

   361 	MWsWindowVisibilityNotifier* iWindowVisibilityNotifier;

   363 #if defined(__WINS__) && defined(_DEBUG)

   364 	CDebugOsbWin* iDebugWin;

   365 #endif

   366 	CWsDisplayChangeNotifier* iDisplayChangeNotifier;

   367 	CWsConfigChangeNotifier* iConfigChangeNotifier;

   368 	TInt iDisplayChangeSpinner;

   369 	TInt iConfigChangeSpinner;

   370 	RPointerArray<CWsClient> iWsClientList;

   371 	TRect iDigitiserArea;

   372 	};

   376 //

   377 // inlines			//

   378 //

   380 //

   381 // CScreen

   382 //

   384 inline CWsWindowGroup* CScreen::FocusWindowGroup()

   385 	{return(iCurrentFocus);}

   386 inline TBool CScreen::BlankScreenOnRotation()

   387 	{return(iFlags&EBlankScreenOnRotation);}

   388 inline TBool CScreen::AutoClear()

   389 	{return(iFlags&EAutoClear);}

   390 inline CWsWindowGroup* CScreen::DefaultOwningWindowGroup()

   391 	{return(iDefaultOwningWindow);}

   392 inline const TSurfaceId& CScreen::DsaSurface() const

   393 	{return iDsaSurface;}

   395 inline CWsRootWindow* CScreen::RootWindow() const

   396 	{return iRootWindow;}

   397 inline TInt CScreen::ScreenNumber() const

   398 	{return iScreenNumber;}

   399 //

   400 inline TInt CScreen::ScreenSizeMode() const

   401 	{return(iScreenSizeMode);}

   402 inline TRect CScreen::GetPointerCursorArea(TInt aMode) const

   403 	{return (*iModes)[aMode]->iPointerCursorArea;}

   404 inline TSize CScreen::CurrentScreenSize() const

   405 	{return (*iModes)[iScreenSizeMode]->iScreenSize;}

   406 inline TInt CScreen::NumScreenSizeModes() const

   407 	{return iNumScreenSizeModes;}

   408 inline const TSizeMode& CScreen::ScreenSizeModeData() const

   409 	{return *(*iModes)[iScreenSizeMode];}

   410 inline const TSizeMode& CScreen::ScreenSizeModeData(TInt aMode) const

   411 	{return *(*iModes)[aMode];}

   412 inline TDisplayMode CScreen::DefaultDisplayMode(const TInt aMode) const

   413 	{return (*iModes)[aMode]->iDefaultDisplayMode;}

   414 inline TScreenModeEnforcement CScreen::SizeEnforcementMode() const

   415 	{return iSizeEnforcementMode;}

   416 inline TBool CScreen::IsValidScreenSizeMode(TInt aMode) const

   417 	{return (aMode>=0 && aMode<iModes->Count() && (*iModes)[aMode]!=NULL);}

   418 inline TBool CScreen::BackLightFlag()

   419 	{return iBackLightFlag;}

   421 inline TBool CScreen::HasAlpha() const

   422 	{return (0x3 & (0x1 << (EColor16MAP - DisplayMode())));} //currently it is just EColor16MA Or EColor16MAP

   424 inline CWindowElementSet& CScreen::WindowElements() const

   425 	{

   426 	return *iWindowElementSet;

   427 	}

   429 inline MWsElement& CScreen::UiElement() const

   430     {

   431     return *iUiElement;

   432     }

   434 inline CDebugBar * CScreen::DebugBar()

   435 	{return iDebugBar;}

   436 inline CScreen::CFallbackMap * CScreen::FallbackMap()

   437 	{return iFallbackMap;}

   439 inline void CScreen::GetFadingParams(TUint8& aBlackMap,TUint8& aWhiteMap) const

   440     {aBlackMap=iBlackMap;aWhiteMap=iWhiteMap;}

   441 inline void CScreen::SetFadingParams(TUint8 aBlackMap,TUint8 aWhiteMap)

   442 	{iBlackMap=aBlackMap;iWhiteMap=aWhiteMap;}

   443 inline CWsSpriteManager* CScreen::SpriteManager() const

   444 	{return iSpriteManager;}

   445 inline MWsWindowTreeObserver* CScreen::WindowTreeObserver() const

   446 	{return iWindowTreeObserver;}

   447 inline MWsDrawAnnotationObserver* CScreen::DrawAnnotationObserver() const

   448 	{return iDrawAnnotationObserver;}

   449 inline MWsWindowVisibilityNotifier* CScreen::WindowVisibilityNotifier() const

   450 	{return iWindowVisibilityNotifier;}

   451 inline TBool CScreen::ChangeTracking() const

   452 	{return iFlags&EChangeTracking;}

   453 inline void CScreen::IncreaseDisplaySpinner()

   454 	{iDisplayChangeSpinner++;}

   455 inline void CScreen::IncreaseConfigSpinner()

   456 	{iConfigChangeSpinner++;}

   457 inline TInt CScreen::DisplaySpinner()

   458 	{return iDisplayChangeSpinner;}

   459 inline TInt CScreen::ConfigSpinner()

   460 	{return iConfigChangeSpinner;}

   461 inline MWsDisplayPolicy* CScreen::DisplayPolicy()

   462 	{return iDisplayPolicy;}

   463 inline MWsDisplayMapping* CScreen::DisplayMapping()

   464 	{return iDisplayMapping;}

   465 #endif

author	sl
	Tue, 10 Jun 2014 14:32:02 +0200
changeset 1	260cb5ec6c19
permissions	-rw-r--r--