/**

 * Copyright (c) 2007-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:

 *

 */

 /**

  @file

 */

 #ifndef __SURFACE_UTILITY__

 #define __SURFACE_UTILITY__

 #include <e32base.h>

 #include <graphics/surface.h>

 #include <graphics/surfacemanager.h>

 #include <graphics/surfaceupdateclient.h>

 #define ENABLE_TEST_LOGGING

 #define ALPHA_FIX_24BIT	0xffU //This forces a non-zero value into the X byte of 16MU color values

 #if defined(ENABLE_TEST_LOGGING)

 #define LOG(X)	RDebug::Printf X

 #else

 #define LOG(X)

 #endif

 class TRgb;

 class CFbsBitmap;

 class CSurfaceUtility : public CBase

 	{

 public:

 	static CSurfaceUtility* NewL(CSurfaceUtility* aClone=NULL);

 	virtual ~CSurfaceUtility();

 	TSize SurfaceSize(const TSurfaceId& aSurface);

 	void CreateSurfaceFromFileL(const TDesC& aFileName, TSurfaceId& aSurface);

 	TSurfaceId CreateSurfaceL(const TSize& aSize, TUidPixelFormat aPixelFormat, TInt aStride, TInt aBuffers = 1);

 	TInt BytesPerPixelL(TUidPixelFormat aPixelFormat);

 	void FillSurfaceL(TSurfaceId& aSurface, const TRgb& aColor);

 	void FillChunkL(TSurfaceId& aSurface, RChunk& aChunk, const TRgb& aColor, TInt aBufferNumber);

 	void FillRectangleL(TSurfaceId& aSurface, const TPoint& aStartPos, const TSize& aSize, const TRgb& aColor);

 	void FillRectangleNoUpdateL(TSurfaceId& aSurface, const TPoint& aStartPos, const TSize& aSize, const TRgb& aColor);

 	void GridFillSurfaceL(TSurfaceId& aSurface, const TRgb& aColor, const TRgb& aLines);

 	void PatternFillSurfaceL(TSurfaceId& aSurface);

 	void FanFillSurfaceL(TSurfaceId& aSurface, const TRgb& aColor, const TRgb& aLinesTL,const TRgb& aLinesBR);

 	void LineFillSurfaceL(TSurfaceId& aSurface, const TRgb& aBackColor, const TRgb& aLineColor, TInt aPosition);

 	CFbsBitmap* EquivalentBitmapL(TSurfaceId& aSurface, CFbsBitmap* aCopyTo=NULL);

 	void DestroySurface(TSurfaceId& aSurface);

 	TBool DestroyAll();

 	void SubmitUpdate(TInt aScreenNumber, const TSurfaceId& aSurface, const TRegion* aRegion, TInt aBufferNumber = 0);

 	void MapAndSubmitUpdateL(RChunk& aChunk, TInt aScreenNumber, const TSurfaceId& aSurface, const TRegion* aRegion);

 	void MapSurfaceL(const TSurfaceId& aSurface, RChunk& aChunk);

 	void CopyBitmapFromFileToSurfaceL(const TDesC& aFileName, TSurfaceId& aSurface);

 	void CopyBitmapSurfaceL(const CFbsBitmap* aBitmap, TSurfaceId& aSurface);

 	void CopyBitmapToSurfaceL(TSurfaceId& aSurface, const CFbsBitmap& aBitmap);

 private:

 	CSurfaceUtility(CSurfaceUtility* aClone);

 	void ConstructL();

 private:

 	RSurfaceManager iManager;

 	RSurfaceUpdateSession iSurfaceUpdateSession;

 	//This local object wraps the array operations in a heap switch

 	//The reason for providing this wrapper is to allow threads to share the surface manager surface ID list.

 	//In particular, the next test can attempt to release the previous test's surfaces if it paniced. 

 	//Note that the presumption is that the owning thread will be paused, 

 	//so there will be no thread interlock issues with it's heap manager.

 	class RHeapSurfaceArray

 		{

 		public:

 		typedef RArray<TSurfaceId>	Array;

 		RHeapSurfaceArray(RHeapSurfaceArray* aUseExternalArray=NULL);

 		//Emulation of RArray entrypoints. Add more stub methods if required...

 		TSurfaceId& operator[](TUint aIndex);

 		void Close();

 		TInt Count() const;

 		inline void Reset();

 		void AppendL(const TSurfaceId &anEntry);

 		TInt Find(const TSurfaceId &anEntry) const;

 		void Remove(TInt anIndex);

 		private:

 		static void PopHeap(void* mainheap);

 		static void SwitchHeapLC(RHeap* aNewHeap);

 		Array iLocalArray;

 		Array* iUseArray;

 		RHeap &iExternalHeapRef;

 		}	iSurfaces;

 	};

 #endif // __SURFACE_UTILITY__