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

// This module implements the functions that create the screen class depending

// on the screen type.

// Include files                                                   

// 

//

/**

 @file

*/

/********************************************************************/

#include "BITDRAW.H"

#include <hal.h>

#include "ScreenInfo.h"

#include "scdraw.h"

#include "scdraw.inl"

#include <graphics/gdi/gdiconsts.h>

/**

Creates an instance of CFbsDrawDevice class.

@param aScreenNo Screen number

@param aDispMode Display mode

@param aScreenInfo Screen parameters: video memory address and screen size

@return A pointer to the created CFbsDrawDevice object

@leave System-wide error code including KErrNoMemory

@internalComponent

*/

static CFbsDrawDevice* CreateInstanceL(TInt aScreenNo,

									   TDisplayMode aDispMode,

									   const TScreenInfo& aScreenInfo)

	{

	CFbsDrawDevice* drawDevice = NULL;

	TInt modeCount;

	TInt matchedMode=-1;

	//there is some "ambiguity" about 24 and 32 bit modes... 

	//They are both byte per color component, and both actually have 32 bits per pixel memory use.

	//This ambiguity does not exist between 12 and 16 bit modes,

	//because they are distinct color component patterns (x444, 565)

	//but for now 24 and 32 bit modes are considered equivalent here.

	if (HAL::Get(aScreenNo, HALData::EDisplayNumModes,modeCount)== KErrNone && modeCount>=1)

		{	//If multiple modes are supported then the highest bpp must be found

		TInt reqBpp= TDisplayModeUtils::NumDisplayModeBitsPerPixel(aDispMode);

		TInt reqBpp2=reqBpp;

		if ( reqBpp==24 || reqBpp==32 ) //Best to be specific here. Who knows how likely is 30 or 64 bpp support?

			{

			reqBpp2=32+24 - reqBpp;   //reflect 24<==>32

			//Important compile-time decision embedded here: Only one 32-bit mode is supported

			if(CFbsDrawDevice::DisplayMode16M() != aDispMode)

				{

				User::Leave(KErrNotSupported);

				}

			}

		for (TInt mode=0; mode<modeCount; mode++)

			{

			TInt modeBpp=mode;

			if(HAL::Get(aScreenNo, HALData::EDisplayBitsPerPixel, modeBpp) == KErrNone)

				{

				if (modeBpp==reqBpp || modeBpp==reqBpp2)

					{

					matchedMode=mode;

					break;

					}

				}

			}

		}

	if (matchedMode==-1)

		{	//This is the expected error code

		User::Leave(KErrNotSupported);

		}

	//Switch the display mode, call the constructor of the class defined

	switch(aDispMode)

		{

	/** Monochrome display mode (1 bpp) */

	case EGray2:

		{

		CDrawOneBppScreenBitmap* drawDeviceX = new (ELeave) CDrawOneBppScreenBitmap;

		drawDevice=drawDeviceX;

		CleanupStack::PushL(drawDevice) ;

		User::LeaveIfError(drawDeviceX->ConstructScreen(

	                                                    aScreenNo,

														aScreenInfo.iAddress, 

														aScreenInfo.iSize,matchedMode));

		}

		break;

	/** Four grayscales display mode (2 bpp) */

	case EGray4:

		{

		CDrawTwoBppScreenBitmap* drawDeviceX = new (ELeave) CDrawTwoBppScreenBitmap;

		drawDevice=drawDeviceX;

		CleanupStack::PushL(drawDevice) ;

		User::LeaveIfError(drawDeviceX->ConstructScreen(

	                                                    aScreenNo,

														aScreenInfo.iAddress, 

														aScreenInfo.iSize,matchedMode));

		}

		break;

	/** 16 grayscales display mode (4 bpp) */

	case EGray16:

		{

		CDrawFourBppScreenBitmapGray* drawDeviceX = new (ELeave) CDrawFourBppScreenBitmapGray;

		drawDevice=drawDeviceX;

		CleanupStack::PushL(drawDevice) ;

		User::LeaveIfError(drawDeviceX->ConstructScreen(

	                                                    aScreenNo,

														aScreenInfo.iAddress, 

														aScreenInfo.iSize,matchedMode));

		}

		break;

	/** 256 grayscales display mode (8 bpp) */

	case EGray256:

		{

		CDrawEightBppScreenBitmapGray* drawDeviceX = new (ELeave) CDrawEightBppScreenBitmapGray;

		drawDevice=drawDeviceX;

		CleanupStack::PushL(drawDevice) ;

		User::LeaveIfError(drawDeviceX->ConstructScreen(

	                                                    aScreenNo,

														aScreenInfo.iAddress, 

														aScreenInfo.iSize,matchedMode));

		}

		break;

	/** Low colour EGA 16 colour display mode (4 bpp) */

	case EColor16:

		{

		CDrawFourBppScreenBitmapColor* drawDeviceX = new (ELeave) CDrawFourBppScreenBitmapColor;

		drawDevice=drawDeviceX;

		CleanupStack::PushL(drawDevice) ;

		User::LeaveIfError(drawDeviceX->ConstructScreen(

	                                                    aScreenNo,

														aScreenInfo.iAddress, 

														aScreenInfo.iSize,matchedMode));

		}

		break;

	/** 256 colour display mode (8 bpp) */

	case EColor256:

		{

		CDrawEightBppScreenBitmapColor* drawDeviceX = new (ELeave) CDrawEightBppScreenBitmapColor;

		drawDevice=drawDeviceX;

		CleanupStack::PushL(drawDevice) ;

		User::LeaveIfError(drawDeviceX->ConstructScreen(

	                                                    aScreenNo,

														aScreenInfo.iAddress, 

														aScreenInfo.iSize,matchedMode));

		}

		break;

	/** 4,000 colour display mode (16 bpp) */

	case EColor4K: // 12 Bpp color mode

		{

		CDrawTwelveBppScreenBitmapColor* drawDeviceX = new (ELeave) CDrawTwelveBppScreenBitmapColor;

		drawDevice=drawDeviceX;

		CleanupStack::PushL(drawDevice) ;

		User::LeaveIfError(drawDeviceX->ConstructScreen(

	                                                    aScreenNo,

														aScreenInfo.iAddress, 

														aScreenInfo.iSize,matchedMode));

		}

		break;

	case EColor64K: // 16 Bpp color mode

		{

		CDrawSixteenBppScreenBitmap* drawDeviceX = new (ELeave) CDrawSixteenBppScreenBitmap;

		drawDevice=drawDeviceX;

		CleanupStack::PushL(drawDevice) ;

		User::LeaveIfError(drawDeviceX->ConstructScreen(

	                                                    aScreenNo,

														aScreenInfo.iAddress, 

														aScreenInfo.iSize,matchedMode));

		}

		break;

	case EColor16MU:

		{

		CDrawUTwentyFourBppScreenBitmap* drawDeviceX = new (ELeave) CDrawUTwentyFourBppScreenBitmap;

		drawDevice=drawDeviceX;

		CleanupStack::PushL(drawDevice) ;

		User::LeaveIfError(drawDeviceX->ConstructScreen(

	                                                    aScreenNo,

														aScreenInfo.iAddress, 

														aScreenInfo.iSize,matchedMode));

		}

		break;

	case EColor16MA:

		{

		CDrawThirtyTwoBppScreenBitmapAlpha* drawDeviceX = new (ELeave) CDrawThirtyTwoBppScreenBitmapAlpha;

		drawDevice=drawDeviceX;

		CleanupStack::PushL(drawDevice) ;

		User::LeaveIfError(drawDeviceX->ConstructScreen(

	                                                    aScreenNo,

														aScreenInfo.iAddress, 

														aScreenInfo.iSize,matchedMode));

		}

		break;

	case EColor16MAP:

		{

		CDrawThirtyTwoBppScreenBitmapAlphaPM* drawDeviceX = new (ELeave) CDrawThirtyTwoBppScreenBitmapAlphaPM;

		drawDevice=drawDeviceX;

		CleanupStack::PushL(drawDevice) ;

		User::LeaveIfError(drawDeviceX->ConstructScreen(

	                                                    aScreenNo,

														aScreenInfo.iAddress, 

														aScreenInfo.iSize,matchedMode));

		}

		break;

	default:

		User::Leave(KErrNotSupported);

		}

	CleanupStack::Pop(drawDevice);

	return drawDevice;

	}

/********************************************************************/

/*  Implementation of CFbsDrawDevice class                          */

/********************************************************************/

/**

This function calls the correct constructor in function of the display mode.

@param aInfo, Structure of the LCD info

@param aDispMode, display mode   

@return A pointer to just created screen device, which implements CFbsDrawDevice interface

@deprecated Use CFbsDrawDevice::NewScreenDeviceL(TInt aScreenNo, TDisplayMode aDispMode)

*/

EXPORT_C CFbsDrawDevice* CFbsDrawDevice::NewScreenDeviceL(TScreenInfoV01 aInfo, TDisplayMode aDispMode)

	{

	__ASSERT_ALWAYS(aInfo.iScreenAddressValid, Panic(EScreenDriverPanicInvalidWindowHandle));

	TScreenInfo screenInfo(aInfo.iScreenAddress, aInfo.iScreenSize);

	return ::CreateInstanceL(KDefaultScreenNo, aDispMode, screenInfo);

	}

/**

Creates a new screen device instance, which implements CFbsDrawDevice interface.

The method has to be implemented for each type of supported video hardware.

@param aScreenNo Screen number

@param aDispMode Requested display mode

@return A pointer to just created screen device, which implements CFbsDrawDevice interface

@leave KErrNoMemory Not enough memory

	   KErrNotSupported The requested screen device type is not supported

*/

EXPORT_C CFbsDrawDevice* CFbsDrawDevice::NewScreenDeviceL(TInt aScreenNo,

														  TDisplayMode aDispMode)

	{

	TInt width = 0, height = 0;

	User::LeaveIfError(HAL::Get(aScreenNo, HALData::EDisplayXPixels, width));

	User::LeaveIfError(HAL::Get(aScreenNo, HALData::EDisplayYPixels, height));

	__ASSERT_ALWAYS(width > 0 && height > 0, Panic(EScreenDriverPanicInvalidHalValue));

	TUint8* address = 0;

	TScreenInfo screenInfo(address, TSize(width, height));

	return ::CreateInstanceL(aScreenNo, aDispMode, screenInfo);

	}

/**

 Depending on the current graphics hardware this 

 will return one of the 16M video modes defined in

 TDisplayMode, or ENone if a 16M video mode is not supported.

 The method has to be implemented on all hardware platforms.

 @return a 16M display mode or ENone.

 ENone - it means that current hardware doesn't have 16M color mode.

*/

EXPORT_C TDisplayMode CFbsDrawDevice::DisplayMode16M()

	{

	return EColor16MAP;

	}

/**

Complete construction of the helper object.

@param aScreenNo	The screen number, starting from 0.

@param aPixelFormat	Pixel format UID or 0 for default based on bpp

@return KErrNone or a system wide error value.

*/

TInt CScreenDeviceHelper::Construct(TInt aScreenNo, TUidPixelFormat aPixelFormat, TUint aHalMode)

	{

	iSurface.iInternal[TSurfaceId::TScreenSurfaceUsage::EScreenField] = aScreenNo;		// Screen number

	iSurface.iInternal[TSurfaceId::TScreenSurfaceUsage::EHalField] = aHalMode;			// Rotation and hal mode index

	iSurface.iInternal[TSurfaceId::TScreenSurfaceUsage::ETypeGuidField] = aPixelFormat;	//May be zero for non-GCE modes

	iSurface.iInternal[TSurfaceId::TScreenSurfaceUsage::ETypeClassField] 

			= ((TUint32)(TSurfaceId::EScreenSurface) << TSurfaceId::TScreenSurfaceUsage::ETypeClassShift);	// Type

	iAssignedOrientation = EDeviceOrientationNormal; // Actual rotation is held seperately from surface ID

	TInt val = 0;

	iHasChunk = EFalse;

	TInt ret = HAL::Get(aScreenNo,HALData::EDisplayMemoryHandle,val);

	if (ret == KErrNone)

		{

		__ASSERT_DEBUG(val != 0, Panic(EScreenDriverPanicInvalidHalValue));

		RChunk chunk;

		ret = chunk.SetReturnedHandle(val);

		if (ret != KErrNone)

			{

			return ret;

			}

		iChunk = chunk;

		ret = iChunk.Duplicate(RThread(), EOwnerProcess);

		// Close before checking for errors, as we don't want to leave the

		// temporary chunk handle floating about. 

		chunk.Close();

		if (ret != KErrNone)

			{

			return ret;

			}

		iHasChunk = ETrue;

		}

	// KErrNotSupported is returned if we can't get the Handle because it's not a driver

	// that supports the concept. We don't return that error, since it's perfectly valid

	// to not support this. 

	else if (ret != KErrNotSupported)   

		{

		return ret;

		}

	return iSurfaceUpdateSession.Connect();

	}

CScreenDeviceHelper::~CScreenDeviceHelper()

	{

	iSurfaceUpdateSession.Close();

	iChunk.Close();

	}

void CScreenDeviceHelper::NotifyWhenAvailable(TRequestStatus& aStatus)

	{

	iSurfaceUpdateSession.NotifyWhenAvailable(aStatus);

	}

/**

Implementation of corresponding function in CDrawDevice, utilizing a tracked

update region. Updates the screen from the surface, if the update region is

not empty.

*/

void CScreenDeviceHelper::Update()

	{

	if (iUpdateRegion.IsEmpty())

		return;

	iSurfaceUpdateSession.SubmitUpdate(ScreenNumber(), iSurface, 0, &iUpdateRegion);

	iUpdateRegion.Clear();

	}

/**

Implementation of corresponding function in CDrawDevice, utilizing a tracked

update region. Adds the given region to the update region and updates the

screen.

@param aRegion	Additional region to be updated.

*/

void CScreenDeviceHelper::Update(const TRegion& aRegion)

	{

	if(!aRegion.IsEmpty() && !aRegion.CheckError())

		{

		TInt rcCnt = aRegion.Count();

		for (TInt ii=0; ii < rcCnt; ++ii)

			{

			UpdateRegion(aRegion[ii]);

			}

		}

	Update();

	}

/**

Implementation of corresponding function in CDrawDevice, utilizing a tracked

update region. Adds the given rectangle to the update region.

@param aRect	Rectangle to be added to the update region.

*/

void CScreenDeviceHelper::UpdateRegion(const TRect& aRect)

	{

	if (aRect.IsEmpty())

		{

		// Adding an empty rectangle should have no effect.

		return;

		}

	if (iUpdateRegion.CheckError())

		{

		// Try to ensure the region doesn't keep an error forever.

		iUpdateRegion.Clear();

		}

	TRect bounds(iUpdateRegion.BoundingRect());

	iUpdateRegion.AddRect(aRect);

	// If the region fills up, start again with the old bounding box plus this

	// rectangle.

	if (iUpdateRegion.CheckError())

		{

		iUpdateRegion.Clear();

		iUpdateRegion.AddRect(bounds);

		iUpdateRegion.AddRect(aRect);

		}

	}

/**

Reset the update region to be empty without submitting any outstanding updates.

*/

void CScreenDeviceHelper::ResetUpdateRegion()

	{

	iUpdateRegion.Clear();

	}

/**

This function returns the current surface in use for this screen.

@param aSurface	The identifier to be updated with the current screen surface.

*/

void CScreenDeviceHelper::GetSurface(TSurfaceId& aSid) const

	{

	aSid = iSurface;

	}

/**

This function is used to request the device orientations supported by the

screen device.

@return A bitwise combination of one or more TDeviceOrientation enumerated

values indicating the device orientations that are supported by this device.

*/

TUint CScreenDeviceHelper::DeviceOrientationsAvailable(const TSize& aScreenSize) const

	{

	//All that can be reported here is what the CScreenDevice can support via HAL

	//With generic driver, the runtime can be further restricted by the GCE

	if (	aScreenSize.iWidth	&&	aScreenSize.iWidth==aScreenSize.iHeight	)

		{

		return EDeviceOrientationNormal | EDeviceOrientation90CW |

			EDeviceOrientation180 | EDeviceOrientation270CW;

		}

	//Query base HAL for rotated view support

	TInt	offset1=iSurface.iInternal[TSurfaceId::TScreenSurfaceUsage::EHalField]|TSurfaceId::TScreenSurfaceUsage::EHalFlippedFlag;

	if (	HAL::Get(ScreenNumber(), HALData::EDisplayOffsetBetweenLines, offset1)==KErrNone

		&&	offset1!=0)

		{

		return EDeviceOrientationNormal | EDeviceOrientation90CW |

			EDeviceOrientation180 | EDeviceOrientation270CW;

		}

	else

		return EDeviceOrientationNormal | EDeviceOrientation180;

	}

/**

This function selects the surface and device buffer to use in the screen

driver for this screen. Normal and 180° rotations will generally use the same

surface, while 90° and 270° will use another. The surfaces may have different

width, height, stride and surface ID, so functions that make use of any of

these may be affected after a change in surface orientation, and the return

value should be checked for this reason.

This call does not change the way rendering is performed, but may operate on

the underlying memory using a new shape. The call does not change the display

controller's settings, as this is handled via the GCE. All this changes are the

internal attributes of the screen device and driver objects. A CFbsBitGc object

activated on the device should be reactivated, to update its own attributes, or

drawing may be corrupted.

Note: while TDeviceOrientation values do not directly correspond to 

CFbsBitGc::TGraphicsOrientation values, and cannot be used interchangeably, it

is simple to generate the former from the latter using the left-shift operator

(i.e. device == (1 << graphics)). In particular a device orientation of

90 degrees clockwise is equivalent to a content orientation of 90 degrees anti-

clockwise, which is what TGraphicsOrientation refers to for the equivalent

setting. The letters "CW" in the TDeviceOrientation enumeration refer

to a clockwise device rotation, so EDeviceOrientation90CW is a 90 degree

clockwise rotation of the device.

@param aOrientation	The new device orientation, relative to the normal physical

screen orientation.

@param aNewSize The new pixel dimensions of the surface to be used.

@return ETrue is returned if any of the surface, width, height or stride

attributes of the screen device have changed as a result of the call or EFalse

if none of the attributes have changed.

*/

TBool CScreenDeviceHelper::SetDeviceOrientation(TDeviceOrientation aOrientation, TSize& aNewSize)

	{

	// Check only one orientation bit is set

	if (((TInt)aOrientation - 1) & aOrientation)

		{

		Panic(EScreenDriverPanicInvalidParameter);

		}

	// Check the orientation is supported

	if ((DeviceOrientationsAvailable(aNewSize) & aOrientation) == 0)

		{

		Panic(EScreenDriverPanicInvalidParameter);

		}

	iAssignedOrientation=aOrientation;

	return SetDeviceFlipMode(ConvertFlip(aOrientation),aNewSize);

	}

/** Sets or clears the flipped flag indicating that the width and height have been swapped for a +/-90 deg rotation

 *  Rotation is not required for square displays unless the Hal wants one.

 **/

TBool CScreenDeviceHelper::SetDeviceFlipMode(TBool aFlip, TSize& aNewSize)

	{

	//This is now a private method that doesn't validate aFlip

	TInt newFlipMode= iSurface.iInternal[TSurfaceId::TScreenSurfaceUsage::EHalField];

	if (aFlip)

		{

		newFlipMode|=TSurfaceId::TScreenSurfaceUsage::EHalFlippedFlag;

		}

	else

		{

		newFlipMode&=~TSurfaceId::TScreenSurfaceUsage::EHalFlippedFlag;

		}

	if (newFlipMode == iSurface.iInternal[TSurfaceId::TScreenSurfaceUsage::EHalField])

		{

		// No change to mode requested.

		return EFalse;

		}

	TInt err=0;

	err|=HAL::Get(ScreenNumber(), HALData::EDisplayXPixels, aNewSize.iWidth);

	err|=HAL::Get(ScreenNumber(), HALData::EDisplayYPixels, aNewSize.iHeight);

	__ASSERT_ALWAYS(err==KErrNone,Panic(EScreenDriverPanicInvalidHalValue));

	 if (aNewSize.iWidth==aNewSize.iHeight)

		{	//Attempt optimisation to not flip if the screen is square, so avoid recomposition.