/**

* 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__