sl@0: // Copyright (c) 1995-2009 Nokia Corporation and/or its subsidiary(-ies).
sl@0: // All rights reserved.
sl@0: // This component and the accompanying materials are made available
sl@0: // under the terms of "Eclipse Public License v1.0"
sl@0: // which accompanies this distribution, and is available
sl@0: // at the URL "http://www.eclipse.org/legal/epl-v10.html".
sl@0: //
sl@0: // Initial Contributors:
sl@0: // Nokia Corporation - initial contribution.
sl@0: //
sl@0: // Contributors:
sl@0: //
sl@0: // Description:
sl@0: // Shells for window server screen device
sl@0: // 
sl@0: //
sl@0: 
sl@0: #include <e32std.h>
sl@0: #include <e32hal.h>
sl@0: #include "../SERVER/w32cmd.h"
sl@0: #include "CLIENT.H"
sl@0: #include "w32comm.h"
sl@0: #include "scrdevextension.h"
sl@0: 
sl@0: const TInt KDefaultScreenNumber = 0 ;
sl@0: 
sl@0: EXPORT_C CWsScreenDevice::CWsScreenDevice()
sl@0: /** Default constructor. Developers should use the other constructor overload. */
sl@0: 	{
sl@0: 	}
sl@0: 
sl@0: EXPORT_C CWsScreenDevice::CWsScreenDevice(RWsSession &aWs) : MWsClientClass(aWs.iBuffer)
sl@0: /** Constructs a new screen device attached to a particular window server session.
sl@0: 
sl@0: @param aWs The window server session this screen should be attached to. */
sl@0: 	{
sl@0: 	}
sl@0: 
sl@0: EXPORT_C TInt CWsScreenDevice::CreateContext(CGraphicsContext *&aGc)
sl@0: /** Creates a graphics context for this device.
sl@0: 
sl@0: This function always causes a flush of the window server buffer.
sl@0: 
sl@0: @param aGc On successful return, contains a new graphics context referring 
sl@0: to this screen device. 
sl@0: @return KErrNone if successful, otherwise one of the system-wide error codes. 
sl@0: @see CGraphicsDevice::CreateContext() */
sl@0: 	{
sl@0: 	if ((aGc=new CWindowGc(this))==NULL)
sl@0: 		return(KErrNoMemory);
sl@0: 	TInt err=((CWindowGc *)aGc)->Construct();
sl@0: 	if (err!=KErrNone)
sl@0: 		{
sl@0: 		delete aGc;
sl@0: 		aGc=NULL;
sl@0: 		}
sl@0: 	return(err);
sl@0: 	}
sl@0: 
sl@0: EXPORT_C CWsScreenDevice::~CWsScreenDevice()
sl@0: /** Destructor. */
sl@0: 	{
sl@0: 	if (iBuffer)
sl@0: 		{
sl@0: 		if (iWsHandle)
sl@0: 			Write(EWsSdOpFree);
sl@0: 		}
sl@0: 	if (iExtension)
sl@0: 		{
sl@0: 		delete TypeFaceStore();
sl@0: 		delete iExtension;
sl@0: 		}
sl@0: 	}
sl@0: 
sl@0: #pragma warning(disable : 4710)
sl@0: /** 
sl@0: Completes construction of the object.
sl@0: 
sl@0: This method invokes Construct(TInt aDefaultScreenNumber) with default Screen number.
sl@0: @return KErrNone if successful, otherwise another of the system-wide error codes. 
sl@0: */
sl@0: EXPORT_C TInt CWsScreenDevice::Construct()
sl@0: 	{
sl@0: 	return Construct( KDefaultScreenNumber ) ;
sl@0: 	}
sl@0: 
sl@0: 
sl@0: EXPORT_C TInt CWsScreenDevice::Construct(TInt aDefaultScreenNumber)
sl@0: /** Completes construction of the object.
sl@0: 
sl@0: This function always causes a flush of the window server buffer.
sl@0: @param aDefaultScreenNumber - This is the screen on which an application will start
sl@0: @return KErrNone if successful, otherwise another of the system-wide error 
sl@0: codes. 
sl@0: @panic TW32Panic 17 in debug builds if called on an already constructed object.*/
sl@0: 	{
sl@0: 	__ASSERT_DEBUG(iWsHandle == KNullHandle, Panic(EW32PanicGraphicDoubleConstruction));
sl@0: 	TInt ret;
sl@0: 	TWsClCmdCreateScreenDevice createScreenDevice;
sl@0: 	createScreenDevice.screenNumber = aDefaultScreenNumber;
sl@0: 	createScreenDevice.clientScreenDevicePointer = (TUint)this;
sl@0: 	if ( ( ret=iBuffer->WriteReplyWs(&createScreenDevice,sizeof(createScreenDevice),EWsClOpCreateScreenDevice ) ) < 0 )
sl@0: 		{
sl@0: 		iBuffer=NULL;
sl@0: 		}
sl@0: 	else
sl@0: 		{
sl@0: 		iWsHandle=ret;
sl@0: 		//If the extension fails to allocate then clients will be refused access to the extension interface.
sl@0: 		TRAP(ret,iExtension=new(ELeave) CScrDevExtension(iBuffer,iWsHandle));
sl@0: 		if (ret>=KErrNone)
sl@0: 			{
sl@0: 			TRAP(ret,iExtension->SetTypefaceStore(CFbsTypefaceStore::NewL(this)));
sl@0: 			}
sl@0: 		iDisplaySizeInPixels=SizeInPixels();
sl@0: 		iPhysicalScreenSizeInTwips=SizeInTwips();
sl@0: 		if (iDisplaySizeInPixels.iWidth==0)
sl@0: 			{
sl@0: 			TMachineInfoV1Buf macInfo;
sl@0: 			UserHal::MachineInfo(macInfo);
sl@0: 			iPhysicalScreenSizeInTwips=macInfo().iPhysicalScreenSize;
sl@0: 			iDisplaySizeInPixels=macInfo().iDisplaySizeInPixels;
sl@0: 			}
sl@0: 		}
sl@0: 	return(ret);
sl@0: 	}
sl@0: #pragma warning(default : 4710)
sl@0: 
sl@0: EXPORT_C TDisplayMode CWsScreenDevice::DisplayMode() const
sl@0: /** Gets the device's display mode.
sl@0: 
sl@0: This function always causes a flush of the window server buffer.
sl@0: 
sl@0: @return The device's display mode. 
sl@0: @see CGraphicsDevice::DisplayMode() */
sl@0: 	{
sl@0: 	return((TDisplayMode)WriteReply(EWsSdOpDisplayMode));
sl@0: 	}
sl@0: 
sl@0: EXPORT_C TRect CWsScreenDevice::PointerRect() const
sl@0: /** Gets the active area for the pointing device. 
sl@0: 
sl@0: This is a device-dependent parameter, and will typically depend on the screen 
sl@0: size and other factors.
sl@0: 
sl@0: This function always causes a flush of the window server buffer.
sl@0: 
sl@0: @return The active area, measured in pixels. */
sl@0: 	{
sl@0: 	TPckgBuf<TRect> rectPkg;
sl@0:   	WriteReplyP(&rectPkg,EWsSdOpPointerRect);
sl@0: 	return(rectPkg());
sl@0: 	}
sl@0: 
sl@0: EXPORT_C TSize CWsScreenDevice::SizeInPixels() const
sl@0: /** Gets the size of the screen device area in pixels.
sl@0: 
sl@0: This function always causes a flush of the window server buffer.
sl@0: 
sl@0: @return The x and y dimensions of the screen device area, in pixels. 
sl@0: @see CGraphicsDevice::SizeInPixels() */
sl@0: 	{
sl@0: 	TPckgBuf<TSize> sizePkg;
sl@0:   	WriteReplyP(&sizePkg,EWsSdOpPixelSize);
sl@0: 	return(sizePkg());
sl@0: 	}
sl@0: 
sl@0: EXPORT_C TSize CWsScreenDevice::SizeInTwips() const
sl@0: /** Gets the size of the screen device area in twips.
sl@0: 
sl@0: This function always causes a flush of the window server buffer.
sl@0: 
sl@0: @return The x and y dimensions of the screen device area, in twips. 
sl@0: @see CGraphicsDevice::SizeInTwips() */
sl@0: 	{
sl@0: 	TPckgBuf<TSize> sizePkg;
sl@0:   	WriteReplyP(&sizePkg,EWsSdOpTwipsSize);
sl@0: 	return(sizePkg());
sl@0: 	}
sl@0: 
sl@0: EXPORT_C TInt CWsScreenDevice::HorizontalTwipsToPixels(TInt aTwips) const
sl@0: /** Translates a twips to a pixel value.
sl@0: 
sl@0: @param aTwips The value in twips. 
sl@0: @return The equivalent number of pixels. 
sl@0: @see MGraphicsDeviceMap::HorizontalTwipsToPixels() */
sl@0: 	{
sl@0: 	TInt64 twips=aTwips;
sl@0: 	twips=(twips*iDisplaySizeInPixels.iWidth+(iPhysicalScreenSizeInTwips.iWidth/2))/iPhysicalScreenSizeInTwips.iWidth;
sl@0: 	return I64INT(twips);
sl@0: 	}
sl@0: 
sl@0: EXPORT_C TInt CWsScreenDevice::VerticalTwipsToPixels(TInt aTwips) const
sl@0: /** Translates a vertical dimension of a screen device in twips into pixels.
sl@0: 
sl@0: @param aTwips A vertical dimension of a device in twips. 
sl@0: @return The vertical dimension in pixels. */
sl@0: 	{
sl@0: 	TInt64 twips=aTwips;
sl@0: 	twips=(twips*iDisplaySizeInPixels.iHeight+(iPhysicalScreenSizeInTwips.iHeight/2))/iPhysicalScreenSizeInTwips.iHeight;
sl@0: 	return I64INT(twips);
sl@0: 	}
sl@0: 
sl@0: EXPORT_C TInt CWsScreenDevice::HorizontalPixelsToTwips(TInt aPixels) const
sl@0: /** Translates a specified pixel value to a twips value. 
sl@0: 
sl@0: @param aPixels The value in pixels to be translated. 
sl@0: @return The equivalent number of twips. */
sl@0: 	{
sl@0: 	TInt64 pixels=aPixels;
sl@0: 	pixels=(pixels*iPhysicalScreenSizeInTwips.iWidth+(iDisplaySizeInPixels.iWidth/2))/iDisplaySizeInPixels.iWidth;
sl@0: 	return I64INT(pixels);
sl@0: 	}
sl@0: 
sl@0: EXPORT_C TInt CWsScreenDevice::VerticalPixelsToTwips(TInt aPixels) const
sl@0: /** Translates a vertical dimension of a screen device in pixels into twips.
sl@0: 
sl@0: @param aPixels A vertical dimension of a device in pixels. 
sl@0: @return The vertical dimension in twips. 
sl@0: @see MGraphicsDeviceMap::VerticalPixelsToTwips() */
sl@0: 	{
sl@0: 	TInt64 pixels=aPixels;
sl@0: 	pixels=(pixels*iPhysicalScreenSizeInTwips.iHeight+(iDisplaySizeInPixels.iHeight/2))/iDisplaySizeInPixels.iHeight;
sl@0: 	return I64INT(pixels);
sl@0: 	}
sl@0: 
sl@0: EXPORT_C void CWsScreenDevice::GetPixel(TRgb &aColor,const TPoint &aPixel) const
sl@0: /** Gets the RGB colour of an individual pixel on a screen device.
sl@0: 
sl@0: This function always causes a flush of the window server buffer.
sl@0: 
sl@0: @param aColor On return, contains the RGB colour of the pixel. 
sl@0: @param aPixel The x,y co-ordinates of the pixel. The top left pixel is (0,0).
sl@0: @see CBitmapDevice::GetPixel() */
sl@0: 	{
sl@0: 	aColor.SetInternal(((TUint32)WriteReply(&aPixel,sizeof(aPixel),EWsSdOpPixel)));
sl@0: 	}
sl@0: 
sl@0: EXPORT_C void CWsScreenDevice::GetScanLine(TDes8 &aScanLine,const TPoint &aStartPixel,TInt aPixelLength, TDisplayMode aDispMode) const
sl@0: /** Gets a scanline into a buffer. 
sl@0: 
sl@0: The pixels are converted from the current screen display mode format 
sl@0: to the format of the specified device display mode.
sl@0: 
sl@0: By specifying the start pixel and number of pixels either the whole or a portion 
sl@0: of a row of screen pixels may be copied.
sl@0: 
sl@0: This function always causes a flush of the window server buffer.
sl@0: 
sl@0: @param aScanLine A buffer into which pixels are copied, it must be sufficiently 
sl@0: large to store all the scanline pixels. 
sl@0: @param aStartPixel The (x,y) co-ordinates of the first pixel of the bitmap scanline 
sl@0: to be put into the buffer. 
sl@0: @param aPixelLength The number of pixels to put into the buffer.
sl@0: @param aDispMode The display mode into which to convert the pixels. 
sl@0: @see CBitmapDevice::GetScanLine() */
sl@0: 	{
sl@0: 	TWsSdCmdGetScanLine getScanLine(aStartPixel,aPixelLength,aDispMode);
sl@0: 	WriteReplyP(&getScanLine,sizeof(getScanLine),&aScanLine,EWsSdOpGetScanLine);
sl@0: 	}
sl@0: 
sl@0: EXPORT_C TBool CWsScreenDevice::RectCompare(const TRect &aRect1,const TRect &aRect2) const
sl@0: /** Compares two areas of the screen to see if they have the same content. 
sl@0: 
sl@0: If there are any sprites on the screen they are not included in the comparison.
sl@0: 
sl@0: This function always causes a flush of the window server buffer.
sl@0: 
sl@0: @param aRect1 A rectangle. 
sl@0: @param aRect2 Another rectangle. 
sl@0: @return ETrue if the two screen areas are identical. */
sl@0:  	{
sl@0: 	return RectCompare(aRect1,aRect2,ERemoveSprite);
sl@0: 	}
sl@0: 
sl@0: EXPORT_C TBool CWsScreenDevice::RectCompare(const TRect &aRect1,const TRect &aRect2,TUint aFlags) const
sl@0: /** Compares two areas of the screen to see if they have the same content.
sl@0:  
sl@0: This function always causes a flush of the window server buffer.
sl@0: 
sl@0: @param aRect1 A rectangle. 
sl@0: @param aRect2 Another rectangle.
sl@0: @param aFlags EIncludeSprite to include the sprite in the compare or ERemoveSprite to remove the sprite.
sl@0: @return ETrue if the two screen areas are identical. */
sl@0: 	{
sl@0: 	TWsSdCmdRectCompare rectCompare(aRect1,aRect2,aFlags);
sl@0:  	return(WriteReply(&rectCompare,sizeof(rectCompare),EWsSdOpRectCompare));
sl@0:  	}
sl@0: 
sl@0: EXPORT_C TInt CWsScreenDevice::CopyScreenToBitmap(const CFbsBitmap *aBitmap) const
sl@0: /** Saves the entire screen to a bitmap.
sl@0: 
sl@0: This function always causes a flush of the window server buffer.
sl@0: 
sl@0: @param aBitmap Bitmap to be filled with the screen image. 
sl@0: @return KErrNone if successful, otherwise one of the system-wide error codes. */
sl@0: 	{
sl@0: 	AddToBitmapArray(aBitmap->Handle());
sl@0: 	TWsSdCmdCopyScreenToBitmap rectCompare(aBitmap->Handle());
sl@0: 	return(WriteReply(&rectCompare,sizeof(rectCompare),EWsSdOpCopyScreenToBitmap));
sl@0: 	}
sl@0: 
sl@0: EXPORT_C TInt CWsScreenDevice::CopyScreenToBitmap(const CFbsBitmap *aBitmap, const TRect &aRect) const
sl@0: /** Saves a region of the screen to a bitmap.
sl@0: 
sl@0: This function always causes a flush of the window server buffer.
sl@0: 
sl@0: @param aBitmap Bitmap to be filled with the screen region image. 
sl@0: @param aRect Screen region to be saved. 
sl@0: @return KErrNone if successful, otherwise one of the system-wide error codes. */
sl@0: 	{
sl@0: 	AddToBitmapArray(aBitmap->Handle());
sl@0: 	TWsSdCmdCopyScreenToBitmap2 rectCompare(aRect, aBitmap->Handle());
sl@0: 	return(WriteReply(&rectCompare,sizeof(rectCompare),EWsSdOpCopyScreenToBitmap2));
sl@0: 	}
sl@0: 
sl@0: EXPORT_C TInt CWsScreenDevice::GetNearestFontInTwips(CFont*& aFont,const TFontSpec& aFontSpec)
sl@0: /** Gets the nearest font, in twips, to that in the specified font specification. 
sl@0: 
sl@0: This function is replaced by GetNearestFontToDesignHeightInTwips()
sl@0: 
sl@0: The font and bitmap server returns a pointer to the nearest matching font 
sl@0: from those available, in aFont.
sl@0: 
sl@0: @param aFont On return, this is set to point to the device font closest to the font 
sl@0: specification passed in the second argument.
sl@0: @param aFontSpec An absolute font specification. 
sl@0: @return KErrNone if successful, otherwise another of the system-wide error 
sl@0: codes. 
sl@0: @see MGraphicsDeviceMap::GetNearestFontInTwips()
sl@0: @deprecated */
sl@0: 	{
sl@0: 	return GetNearestFontToDesignHeightInTwips(aFont, aFontSpec);
sl@0: 	}
sl@0: CFbsTypefaceStore* CWsScreenDevice::TypeFaceStore()const
sl@0: /** Helper member fn to access the movable typeface store.
sl@0:  **/
sl@0: 	{
sl@0: 	return iExtension->TypefaceStore();
sl@0: 	}
sl@0: 
sl@0: EXPORT_C TInt CWsScreenDevice::GetNearestFontToDesignHeightInTwips(CFont*& aFont,const TFontSpec& aFontSpec)
sl@0: /** Gets the nearest font in twips to that specified.
sl@0: 
sl@0: The font and bitmap server returns a pointer to the nearest matching font 
sl@0: from those available. Matches to design height of font - this gives no
sl@0: guarantees on the actual physical size of the font.
sl@0: 
sl@0: This function replaces GetNearestFontInTwips
sl@0: 
sl@0: @param aFont On return, the pointer is set to point to the device font which 
sl@0: most closely approximates to the required font specification.
sl@0: @param aFontSpec An absolute font specification. 
sl@0: @return KErrNone, if successful; otherwise, another of the system-wide error 
sl@0: codes.
sl@0: @see MGraphicsDeviceMap::GetNearestFontToDesignHeightInTwips() */
sl@0: 	{
sl@0: 	return TypeFaceStore()->GetNearestFontToDesignHeightInTwips(aFont, aFontSpec);
sl@0: 	}
sl@0: 
sl@0: /** Gets the nearest font, in twips, to that specified. 
sl@0: 
sl@0: The font and bitmap server returns a pointer to the nearest matching font 
sl@0: from those available. Matches to max height of font - this does its best 
sl@0: to return a font that will fit within the maximum height specified (but 
sl@0: note that variations due to hinting algorithms may rarely result in this 
sl@0: height being exceeded by up to one pixel). Problems can also be 
sl@0: encountered with bitmap fonts where the typeface exists but doesn't have 
sl@0: a font small enough.
sl@0: 
sl@0: @param aFont On return, the pointer is set to point to the device font which 
sl@0: most closely approximates to the required font specification.
sl@0: @param aFontSpec An absolute font specification. 
sl@0: @param aMaxHeight The maximum height within which the font must fit - this
sl@0: overrides the height specified in the TFontSpec. 
sl@0: @return KErrNone, if successful; otherwise, another of the system-wide error 
sl@0: codes.
sl@0: @see MGraphicsDeviceMap::GetNearestFontToMaxHeightInTwips() */
sl@0: EXPORT_C TInt CWsScreenDevice::GetNearestFontToMaxHeightInTwips(CFont*& aFont,const TFontSpec& aFontSpec,TInt aMaxHeight)
sl@0: 	{
sl@0: 	return TypeFaceStore()->GetNearestFontToMaxHeightInTwips(aFont, aFontSpec, aMaxHeight);
sl@0: 	}
sl@0: 
sl@0: EXPORT_C TInt CWsScreenDevice::GetNearestFontInPixels(CFont*& aFont,const TFontSpec& aFontSpec)
sl@0: /** Gets the nearest font to that specified for use by a bitmapped graphics device. 
sl@0: 
sl@0: This function is replaced by GetNearestFontToDesignHeightInPixels()
sl@0: 
sl@0: The font and bitmap server returns a pointer to the nearest matching font 
sl@0: from those available, in aFont.
sl@0: 
sl@0: @param aFont On return, this is set to point to the device font that is  
sl@0: closest to the font specification passed in the second argument 
sl@0: @param aFontSpec An absolute font specification 
sl@0: @return KErrNone if successful, otherwise another of the system-wide error 
sl@0: codes. 
sl@0: @see CBitmapDevice::GetNearestFontInPixels()
sl@0: @deprecated */
sl@0: 	{
sl@0: 	return GetNearestFontToDesignHeightInPixels(aFont, aFontSpec);
sl@0: 	}
sl@0: 
sl@0: EXPORT_C TInt CWsScreenDevice::GetNearestFontToDesignHeightInPixels(CFont*& aFont,const TFontSpec& aFontSpec)
sl@0: /** Gets the nearest font in pixels to that specified. 
sl@0: 
sl@0: The font and bitmap server returns a pointer to the nearest matching font 
sl@0: from those available. Matches to design height of font - this gives no
sl@0: guarantees on the actual physical size of the font.
sl@0: 
sl@0: This function replaces GetNearestFontInTwips
sl@0: 
sl@0: @param aFont On return, the pointer is set to point to the device font which 
sl@0: most closely approximates to the required font specification.
sl@0: @param aFontSpec An absolute font specification. 
sl@0: @return KErrNone, if successful; otherwise, another of the system-wide error 
sl@0: codes.
sl@0: @see CBitmapDevice::GetNearestFontToDesignHeightInPixels() */
sl@0: 	{
sl@0: 	return TypeFaceStore()->GetNearestFontToDesignHeightInPixels(aFont, aFontSpec);
sl@0: 	}
sl@0: 
sl@0: /** Gets the nearest font in pixels to that specified. 
sl@0: 
sl@0: The font and bitmap server returns a pointer to the nearest matching font 
sl@0: from those available. Matches to max height of font - this does its best 
sl@0: to return a font that will fit within the maximum height specified (but 
sl@0: note that variations due to hinting algorithms may rarely result in this 
sl@0: height being exceeded by up to one pixel). Problems can also be 
sl@0: encountered with bitmap fonts where the typeface exists but doesn't have 
sl@0: a font small enough.
sl@0: 
sl@0: @param aFont On return, the pointer is set to point to the device font which 
sl@0: most closely approximates to the required font specification.
sl@0: @param aFontSpec An absolute font specification. 
sl@0: @param aMaxHeight The maximum height within which the font must fit - this
sl@0: overrides the height specified in the TFontSpec. 
sl@0: @return KErrNone, if successful; otherwise, another of the system-wide error 
sl@0: codes.
sl@0: @see CBitmapDevice::GetNearestFontToMaxHeightInPixels() */
sl@0: EXPORT_C TInt CWsScreenDevice::GetNearestFontToMaxHeightInPixels(CFont*& aFont,const TFontSpec& aFontSpec,TInt aMaxHeight)
sl@0: 	{
sl@0: 	return TypeFaceStore()->GetNearestFontToMaxHeightInPixels(aFont, aFontSpec, aMaxHeight);
sl@0: 	}
sl@0: 
sl@0: EXPORT_C TInt CWsScreenDevice::NumTypefaces() const
sl@0: /** Gets the number of typefaces supported by the screen device.
sl@0: 
sl@0: @return The number of typefaces supported. 
sl@0: @see CGraphicsDevice::NumTypefaces() */
sl@0: 	{
sl@0: 	return(TypeFaceStore()->NumTypefaces());
sl@0: 	}
sl@0: 
sl@0: EXPORT_C void CWsScreenDevice::TypefaceSupport(TTypefaceSupport& aTypefaceSupport,TInt aTypefaceIndex) const
sl@0: /** Gets typeface information for a particular typeface index number.
sl@0: 
sl@0: This information is returned in aTypefaceSupport, and includes: the typeface 
sl@0: name and typeface attributes (in a TTypeface object), the number of font heights, 
sl@0: the maximum and minimum font heights and whether it is a scalable typeface.
sl@0: 
sl@0: @param aTypefaceSupport On return, if the function executed successfully, 
sl@0: this contains the typeface information.
sl@0: @param aTypefaceIndex A typeface index number, in the range zero to (NumTypefaces() 
sl@0: - 1). 
sl@0: @see CGraphicsDevice::TypefaceSupport() */
sl@0: 	{
sl@0: 	TypeFaceStore()->TypefaceSupport(aTypefaceSupport,aTypefaceIndex);
sl@0: 	}
sl@0: 
sl@0: EXPORT_C TInt CWsScreenDevice::FontHeightInTwips(TInt aTypefaceIndex,TInt aHeightIndex) const
sl@0: /** Gets the height in twips of the specified font. 
sl@0: 
sl@0: The value returned is rounded up or down to the nearest font height in twips.
sl@0: 
sl@0: The specified font is the one with height index number aHeightIndex of the 
sl@0: typeface with index number aTypefaceIndex.
sl@0: 
sl@0: @param aTypefaceIndex A typeface index number, in the range: 0 to (NumTypefaces() - 1). 
sl@0: @param aHeightIndex A font height index number, in the range: 0 to (iNumHeights - 1). 
sl@0: @return The height of the font in twips. 
sl@0: @see CGraphicsDevice::FontHeightInTwips() */
sl@0: 	{
sl@0: 	return(TypeFaceStore()->FontHeightInTwips(aTypefaceIndex,aHeightIndex));
sl@0: 	}
sl@0: 
sl@0: EXPORT_C TInt CWsScreenDevice::FontHeightInPixels(TInt aTypefaceIndex,TInt aHeightIndex) const
sl@0: /** Gets the height of the specified font in pixels.
sl@0: 
sl@0: The value returned is rounded up or down to the nearest font height in pixels.
sl@0: 
sl@0: The specified font is the one with height index number aHeightIndex of the 
sl@0: typeface with index number aTypefaceIndex.
sl@0: 
sl@0: @param aTypefaceIndex A typeface index number, in the range: 0 to (NumTypefaces() - 1). 
sl@0: @param aHeightIndex A font height index number, in the range: 0 to (iNumHeights - 1).
sl@0: @return The height of the font in pixels. 
sl@0: @see CBitmapDevice::FontHeightInPixels() */
sl@0: 	{
sl@0: 	return(TypeFaceStore()->FontHeightInPixels(aTypefaceIndex,aHeightIndex));
sl@0: 	}
sl@0: 
sl@0: EXPORT_C TInt CWsScreenDevice::GetFontById(CFont *&aFont,TUid aUid,const TAlgStyle& aAlgStyle)
sl@0: /** Gets a font by its bitmap UID. 
sl@0: 
sl@0: Within a font file each font has its own UID. An algorithmic style is not 
sl@0: part of the actual font description, but is applied to it. For example algorithmic 
sl@0: bolding applies an algorithm to increase the apparent weight of each character 
sl@0: in the font. Note that the algorithm is applied blindly, and that a typeface 
sl@0: may already have a style e.g. it may already be bold or italic. Thus a bold 
sl@0: face will appear extra-bold if algorithmic bolding is applied to it. Algorithmic 
sl@0: effects are not necessarily a substitute for typeface design and should be 
sl@0: used with care.
sl@0: 
sl@0: @param aFont On a successful return, contains a pointer to the new CFont. 
sl@0: @param aUid UID of the bitmap font. 
sl@0: @param aAlgStyle The algorithmic style to apply. 
sl@0: @return KErrNone if successful, otherwise one of the system-wide error codes. */
sl@0: 	{
sl@0: 	return(TypeFaceStore()->GetFontById(aFont,aUid,aAlgStyle));
sl@0: 	}
sl@0: 
sl@0: EXPORT_C TInt CWsScreenDevice::AddFile(const TDesC& aName,TInt& aId)
sl@0: /** Adds a font file to the device's typeface store. The specified font
sl@0: file must be accessible to any process, i.e. not located inside an
sl@0: application's private directory.
sl@0: 
sl@0: @param aName Name of the font file. 
sl@0: @param aId ID for the font file. 
sl@0: @return KErrNone if successful, otherwise one of the system-wide error codes. 
sl@0: @see CBitmapDevice::AddFile() */
sl@0: 	{
sl@0: 	return(TypeFaceStore()->AddFile(aName, aId));
sl@0: 	}
sl@0: 
sl@0: EXPORT_C void CWsScreenDevice::RemoveFile(TInt aId)
sl@0: /** Removes a font file from the font store.
sl@0: 
sl@0: @param aId The ID of the font file to be removed, default 0. 
sl@0: @see CBitmapDevice::RemoveFile() */
sl@0: 	{
sl@0: 	TypeFaceStore()->RemoveFile(aId);
sl@0: 	}
sl@0: 
sl@0: EXPORT_C void CWsScreenDevice::ReleaseFont(CFont* aFont)
sl@0: /** Releases a specified font.
sl@0: 
sl@0: This function is used to indicate that the specified font is no longer needed 
sl@0: for use by the screen device. As fonts can be shared between applications, 
sl@0: this function does not delete the copy of the font from RAM, unless the font 
sl@0: was only being used by this device.
sl@0: 
sl@0: @param aFont A pointer to the font to be released. 
sl@0: @see MGraphicsDeviceMap::ReleaseFont() */
sl@0: 	{
sl@0: 	TypeFaceStore()->ReleaseFont(aFont);
sl@0: 	}
sl@0: 
sl@0: EXPORT_C void CWsScreenDevice::PaletteAttributes(TBool& aModifiable,TInt& aNumEntries) const
sl@0: /** Gets the attributes of the device's palette.
sl@0:  
sl@0: This function always causes a flush of the window server buffer.
sl@0: 
sl@0: @param aModifiable On return, indicates whether or not the device's palette 
sl@0: is modifiable (true) or fixed (false).
sl@0: @param aNumEntries On return, holds the number of entries in the device's 
sl@0: palette. 
sl@0: @see CFbsScreenDevice::PaletteAttributes() */
sl@0: 	{
sl@0: 	TInt ret=WriteReply(EWsSdOpPaletteAttributes);
sl@0: 	aModifiable=ret&EWsSdSetableBitFlag;
sl@0: 	aNumEntries=ret&(~EWsSdSetableBitFlag);
sl@0: 	}
sl@0: 
sl@0: EXPORT_C void CWsScreenDevice::SetPalette(CPalette* aPalette)
sl@0: /** Sets the screen device's palette.
sl@0: 
sl@0: This function always causes a flush of the window server buffer.
sl@0: 
sl@0: Use of this function is deprecated. SetCustomPalette() should be used instead.
sl@0: 
sl@0: @param aPalette The screen device's new palette. */
sl@0: 	{
sl@0: #if defined(__WINS__)
sl@0: 	__ASSERT_DEBUG(SetCustomPalette(aPalette)==KErrNone,Panic(EW32PanicSilentFail));
sl@0: #endif
sl@0: 	SetCustomPalette(aPalette);
sl@0: 	}
sl@0: 
sl@0: EXPORT_C TInt CWsScreenDevice::SetCustomPalette(const CPalette* aPalette)
sl@0: /** Sets the custom palette.
sl@0:  
sl@0: This function always causes a flush of the window server buffer.
sl@0: 
sl@0: @param aPalette The custom palette.
sl@0: @return KErrNone if sucessful, or one of the system error codes.
sl@0: @panic W32 6 aPalette is NULL.
sl@0: @capability WriteDeviceData */
sl@0: 	{
sl@0: 	__ASSERT_ALWAYS(aPalette,Panic(EW32PanicNullPalette));
sl@0: 	TPtr8 palette(NULL,0);
sl@0: 	CONST_CAST(CPalette*,aPalette)->GetDataPtr(0,aPalette->Entries(),palette);
sl@0: 	TPtr8 empty(NULL,0);
sl@0: 	return WriteReplyByProvidingRemoteReadAccess(&empty, sizeof(empty), &palette, EWsSdOpSetPalette);
sl@0: 	}
sl@0: 
sl@0: EXPORT_C TInt CWsScreenDevice::GetPalette(CPalette*& aPalette) const
sl@0: /** Gets the screen device's palette.
sl@0:  
sl@0: This function always causes a flush of the window server buffer.
sl@0: 
sl@0: @param aPalette On return, contains the screen device's palette. The caller 
sl@0: takes responsibility for discarding the palette.
sl@0: @return KErrNone if successful, otherwise another of the system-wide error 
sl@0: codes. 
sl@0: @see CFbsScreenDevice::GetPalette() */
sl@0: 	{
sl@0: 	TBool modifiable;		//Dummy parameter
sl@0: 	TInt numEntries;
sl@0: 	TInt ret;
sl@0: 	PaletteAttributes(modifiable,numEntries);
sl@0: 	aPalette=NULL;
sl@0: Retry:
sl@0: 	TRAP(ret,aPalette=CPalette::NewL(numEntries));
sl@0: 	if (ret==KErrNone)
sl@0: 		{
sl@0: 		TPtr8 palette(NULL,0);
sl@0: 		aPalette->GetDataPtr(0,numEntries,palette);
sl@0: 		ret=WriteReplyIntP(numEntries,&palette,EWsSdOpGetPalette);
sl@0: 		if (ret!=KErrNone)
sl@0: 			{
sl@0: 			delete aPalette;
sl@0: 			aPalette=NULL;
sl@0: 			if (ret>0)		//The mode of the screen display changed
sl@0: 				{
sl@0: 				numEntries=ret;
sl@0: 				goto Retry;
sl@0: 				}
sl@0: 			}
sl@0: 		}
sl@0: 	return ret;
sl@0: 	}
sl@0: 
sl@0: EXPORT_C void CWsScreenDevice::SetScreenSizeAndRotation(const TPixelsTwipsAndRotation &aSizeAndRotation)
sl@0: /** Sets the current screen size in twips and pixels, and the rotation for the 
sl@0: screen device.
sl@0: 
sl@0: @param aSizeAndRotation The new rotation and the screen size in both pixels 
sl@0: and twips. */
sl@0: 	{
sl@0: 	// Need to reset the cache if the ratio of twip/pixels changes
sl@0: 	// Using multiply as this is much quicker than divide on ARM
sl@0: 	// No need to flush cache if this is a width/height swap
sl@0: 	if((iPhysicalScreenSizeInTwips.iWidth * aSizeAndRotation.iPixelSize.iWidth != aSizeAndRotation.iTwipsSize.iWidth * iDisplaySizeInPixels.iWidth
sl@0: 		|| iPhysicalScreenSizeInTwips.iHeight * aSizeAndRotation.iPixelSize.iHeight != aSizeAndRotation.iTwipsSize.iHeight * iDisplaySizeInPixels.iHeight)
sl@0: 		&& !(aSizeAndRotation.iPixelSize.iHeight == iDisplaySizeInPixels.iWidth
sl@0: 		&& aSizeAndRotation.iPixelSize.iWidth == iDisplaySizeInPixels.iHeight
sl@0: 		&& iPhysicalScreenSizeInTwips.iHeight == aSizeAndRotation.iTwipsSize.iWidth
sl@0: 		&& iPhysicalScreenSizeInTwips.iWidth == aSizeAndRotation.iTwipsSize.iHeight))
sl@0: 		{
sl@0: 		TypeFaceStore()->ReleaseTwipsCache();
sl@0: 		}
sl@0: 	Write(&aSizeAndRotation,sizeof(aSizeAndRotation),EWsSdOpSetScreenSizeAndRotation);
sl@0: 	iDisplaySizeInPixels=aSizeAndRotation.iPixelSize;
sl@0: 	iPhysicalScreenSizeInTwips=aSizeAndRotation.iTwipsSize;
sl@0: 	}
sl@0: 
sl@0: EXPORT_C void CWsScreenDevice::GetDefaultScreenSizeAndRotation(TPixelsTwipsAndRotation &aSizeAndRotation) const
sl@0: /** Gets the current screen size (in both pixels and twips) and rotation.
sl@0: 
sl@0: This function always causes a flush of the window server buffer.
sl@0: 
sl@0: @param aSizeAndRotation The default screen size and rotation, defining screen 
sl@0: size in both pixels and twips. */
sl@0: 	{
sl@0: 	TPckgBuf<TPixelsTwipsAndRotation> sarPkg;
sl@0:   	WriteReplyP(&sarPkg,EWsSdOpGetDefaultScreenSizeAndRotation);
sl@0: 	aSizeAndRotation=sarPkg();
sl@0: 	}
sl@0: 
sl@0: EXPORT_C void CWsScreenDevice::SetScreenSizeAndRotation(const TPixelsAndRotation &aSizeAndRotation)
sl@0: /** Sets the current screen size in pixels, and the rotation for the screen device.
sl@0: 
sl@0: This function always causes a flush of the window server buffer.
sl@0: 
sl@0: @param aSizeAndRotation The new rotation and the screen size in pixels. */
sl@0: 	{
sl@0: 	if(iDisplaySizeInPixels != aSizeAndRotation.iPixelSize
sl@0: 		&& !(aSizeAndRotation.iPixelSize.iHeight == iDisplaySizeInPixels.iWidth
sl@0: 		&& aSizeAndRotation.iPixelSize.iWidth == iDisplaySizeInPixels.iHeight))
sl@0: 		{
sl@0: 		// Reset the twips cache.
sl@0: 		TypeFaceStore()->ReleaseTwipsCache();
sl@0: 		}
sl@0: 	Write(&aSizeAndRotation,sizeof(aSizeAndRotation),EWsSdOpSetScreenSizeAndRotation2);
sl@0: 	iDisplaySizeInPixels=aSizeAndRotation.iPixelSize;
sl@0: 	iPhysicalScreenSizeInTwips=SizeInTwips();
sl@0: 	}
sl@0: 
sl@0: EXPORT_C void CWsScreenDevice::GetDefaultScreenSizeAndRotation(TPixelsAndRotation &aSizeAndRotation) const
sl@0: /** Gets the current screen size (in pixels) and the rotation.
sl@0: 
sl@0: This function always causes a flush of the window server buffer.
sl@0: 
sl@0: @param aSizeAndRotation The default screen size in pixels and the rotation. */
sl@0: 	{
sl@0: 	TPckgBuf<TPixelsAndRotation> sarPkg;
sl@0:   	WriteReplyP(&sarPkg,EWsSdOpGetDefaultScreenSizeAndRotation2);
sl@0: 	aSizeAndRotation=sarPkg();
sl@0: 	}
sl@0: 
sl@0: EXPORT_C TDisplayMode CWsScreenDevice::GetScreenModeDisplayMode(const TInt &aMode) const
sl@0: /** Gets the display mode of the screen for the specified screen mode
sl@0: 
sl@0: This function always causes a flush of the window server buffer.
sl@0: 
sl@0: @param aMode The index of the screen mode for which the display mode is required
sl@0: @return The display mode for the specified screen mode. */
sl@0: 	{
sl@0: 	return STATIC_CAST(TDisplayMode,WriteReplyInt(aMode,EWsSdOpGetScreenModeDisplayMode));
sl@0: 	}
sl@0:  
sl@0: EXPORT_C TPoint CWsScreenDevice::GetDefaultScreenModeOrigin() const
sl@0: /** Gets the origin for the current screen mode
sl@0: 
sl@0: This function always causes a flush of the window server buffer.
sl@0: 
sl@0: @param aOrigin The default offset of the current 
sl@0: screen mode from the physical screen. */
sl@0: 	{
sl@0: 	TPckgBuf<TPoint> pntPkg;
sl@0:   	WriteReplyP(&pntPkg,EWsSdOpGetDefaultScreenModeOrigin);
sl@0: 	return pntPkg();
sl@0: 	}
sl@0: 
sl@0: EXPORT_C TPoint CWsScreenDevice::GetScreenModeOrigin(TInt aMode) const
sl@0: /** Get the origin of the screen for the specified screen mode.
sl@0: 
sl@0: This function always causes a flush of the window server buffer.
sl@0: 
sl@0: @param aMode The index of the screen mode for which the screen origin is required. 
sl@0: @param aOrigin The origin of the specified screen mode. */
sl@0: 	{
sl@0: 	TPckgBuf<TPoint> pntPkg;
sl@0: 	WriteReplyP(&aMode,sizeof(aMode),&pntPkg,EWsSdOpGetScreenModeOrigin);
sl@0: 	return pntPkg();
sl@0: 	}
sl@0: 
sl@0: EXPORT_C TSize CWsScreenDevice::GetScreenModeScale(TInt aMode) const
sl@0: /** Gets the scale for the specified screen mode.
sl@0: 
sl@0: This function always causes a flush of the window server buffer.
sl@0: 
sl@0: @param aMode The index of the screen mode for which the screen scale is required. 
sl@0: @return The scale for the specified screen mode. */
sl@0: 	{
sl@0: 	TPckgBuf<TSize> pntPkg;
sl@0: 	WriteReplyP(&aMode,sizeof(aMode),&pntPkg,EWsSdOpGetScreenModeScale);
sl@0: 	return pntPkg();
sl@0: 	}
sl@0: 
sl@0: EXPORT_C TSize CWsScreenDevice::GetCurrentScreenModeScale() const
sl@0: /** Gets the scale for the current screen mode.
sl@0: 
sl@0: This function always causes a flush of the window server buffer.
sl@0: 
sl@0: @return The scale for the current screen mode. */
sl@0: 	{
sl@0: 	TPckgBuf<TSize> pntPkg;
sl@0: 	WriteReplyP(&pntPkg,EWsSdOpGetCurrentScreenModeScale);
sl@0: 	return pntPkg();
sl@0: 	}
sl@0: 
sl@0: EXPORT_C TPoint CWsScreenDevice::GetCurrentScreenModeScaledOrigin() const
sl@0: /** Gets the current screen mode's scaled origin.
sl@0: 
sl@0: The formula used is (A+B-1)/B
sl@0: 
sl@0: where:
sl@0: 
sl@0: - A is the screen mode origin in physical coordinates,
sl@0: - B is the screen mode scale width.
sl@0: 
sl@0: The result obtained is the scaled origin of the present screen mode.
sl@0: 
sl@0: @return The scaled origin for the current screen mode. */
sl@0: 	{
sl@0: 	TPckgBuf<TPoint> pntPkg;
sl@0: 	WriteReplyP(&pntPkg,EWsSdOpGetCurrentScreenModeScaledOrigin);
sl@0: 	return pntPkg();
sl@0: 	}
sl@0: 
sl@0: EXPORT_C TPoint CWsScreenDevice::GetScreenModeScaledOrigin(TInt aMode) const
sl@0: /** Gets the specfied screen mode's scaled origin.
sl@0: 
sl@0: The functionality is same as CWsScreenDevice::GetCurrentScreenModeScaledOrigin().
sl@0: 
sl@0: It always causes a flush of the window server buffer.
sl@0: 
sl@0: @param aMode The index of the screen mode for which the scaled origin is required. 
sl@0: @return The scaled origin for the specified screen mode. */
sl@0: 	{
sl@0: 	TPckgBuf<TPoint> pntPkg;
sl@0: 	WriteReplyP(&aMode,sizeof(aMode),&pntPkg,EWsSdOpGetScreenModeScaledOrigin);
sl@0: 	return pntPkg();
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: @internalComponent
sl@0: @released
sl@0: 
sl@0: Used for testing purposes only.
sl@0: 
sl@0: @return The present screen mode.
sl@0: */
sl@0: EXPORT_C TSizeMode CWsScreenDevice::GetCurrentScreenModeAttributes() const
sl@0: 	{
sl@0: 	TPckgBuf<TSizeMode> pntPkg;
sl@0: 	WriteReplyP(&pntPkg,EWsSdOpGetCurrentScreenModeAttributes);
sl@0: 	return pntPkg();
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: @internalComponent
sl@0: @released
sl@0: 
sl@0: Used for testing purposes only.
sl@0: 
sl@0: @param aModeAtt Screen size mode to be set.
sl@0: */
sl@0: EXPORT_C void CWsScreenDevice::SetCurrentScreenModeAttributes(const TSizeMode &aModeAtt)
sl@0: 	{
sl@0: 	Write(&aModeAtt,sizeof(aModeAtt),EWsSdOpSetCurrentScreenModeAttributes);
sl@0: 	}
sl@0: 
sl@0: EXPORT_C void CWsScreenDevice::SetAppScreenMode(TInt aMode)
sl@0: /** Sets the application's screen mode; this also sets all the attributes
sl@0: of the screen mode.
sl@0: 
sl@0: Note: although this API was added in Symbian OS v8.0, the functionality is 
sl@0: only available from Symbian OS v8.1 onwards.
sl@0: 
sl@0: @param aMode The index of the application's new screen mode.*/
sl@0: 	{
sl@0: 	WriteInt(aMode,EWsSdOpSetAppScreenMode);
sl@0: 	}
sl@0: 
sl@0: EXPORT_C TInt CWsScreenDevice::NumScreenModes() const
sl@0: /** Gets the number of available screen modes. 
sl@0: 
sl@0: Each mode has a different size, and one or more possible rotations/orientations.
sl@0: 
sl@0: This function always causes a flush of the window server buffer.
sl@0: 
sl@0: @return The number of screen modes. */
sl@0: 	{
sl@0: 	return(WriteReply(EWsSdOpGetNumScreenModes));
sl@0: 	}
sl@0: 
sl@0: EXPORT_C TInt CWsScreenDevice::CurrentScreenMode() const
sl@0: /** Gets the current screen mode index.
sl@0: 
sl@0: This function always causes a flush of the window server buffer.
sl@0: 
sl@0: @return The index into the list of available screen modes of the current screen 
sl@0: mode. */
sl@0: 	{
sl@0: 	return WriteReply(EWsSdOpGetScreenMode);
sl@0: 	}
sl@0: 
sl@0: EXPORT_C void CWsScreenDevice::SetScreenMode(TInt aMode)
sl@0: /**
sl@0: @publishedPartner
sl@0: @released
sl@0: 
sl@0: Sets the current screen mode.
sl@0: 
sl@0: Note that this function is only useful for testing. This is because the screen mode 
sl@0: normally reflects the state of real hardware, e.g. whether the cover is open 
sl@0: or closed on a phone that supports screen flipping.
sl@0:  
sl@0: This function always causes a flush of the window server buffer.
sl@0: 
sl@0: @param aMode The screen mode index, starting from zero.
sl@0: @capability WriteDeviceData */
sl@0: 	{
sl@0: 	WriteInt(aMode,EWsSdOpSetScreenMode);
sl@0: 	iDisplaySizeInPixels=SizeInPixels();
sl@0: 	iPhysicalScreenSizeInTwips=SizeInTwips();
sl@0: 	}
sl@0: 
sl@0: EXPORT_C void CWsScreenDevice::GetScreenModeSizeAndRotation(TInt aMode, TPixelsTwipsAndRotation &aSizeAndRotation) const
sl@0: /** Get the screen rotation and size, in both pixels and twips, for the specified 
sl@0: screen mode.
sl@0:  
sl@0: This function always causes a flush of the window server buffer.
sl@0: 
sl@0: @param aMode The index of the screen mode for which the screen size and rotation 
sl@0: are required. 
sl@0: @param aSizeAndRotation The orientation of the specified screen mode, and its 
sl@0: size in both pixels and twips. */
sl@0: 	{
sl@0: 	TPckgBuf<TPixelsTwipsAndRotation> sarPkg;
sl@0:   	WriteReplyP(&aMode,sizeof(aMode),&sarPkg,EWsSdOpGetScreenModeSizeAndRotation);
sl@0: 	aSizeAndRotation=sarPkg();
sl@0: 	}
sl@0: 
sl@0: EXPORT_C void CWsScreenDevice::GetScreenModeSizeAndRotation(TInt aMode, TPixelsAndRotation &aSizeAndRotation) const
sl@0: /** Get the screen rotation and size (in pixels) for the specified screen mode.
sl@0:  
sl@0: This function always causes a flush of the window server buffer.
sl@0: 
sl@0: @param aMode The index of the screen mode for which the screen size and rotation 
sl@0: are required. 
sl@0: @param aSizeAndRotation The orientation of the specified screen mode, and its 
sl@0: size in pixels. */
sl@0: 	{
sl@0: 	TPckgBuf<TPixelsAndRotation> sarPkg;
sl@0:   	WriteReplyP(&aMode,sizeof(aMode),&sarPkg,EWsSdOpGetScreenModeSizeAndRotation2);
sl@0: 	aSizeAndRotation=sarPkg();
sl@0: 	}
sl@0: 
sl@0: EXPORT_C void CWsScreenDevice::SetCurrentRotations(TInt aMode, CFbsBitGc::TGraphicsOrientation aRotation) const
sl@0: /** 
sl@0: @publishedPartner
sl@0: @released
sl@0: 
sl@0: Sets the screen rotation that should be used with a particular screen size. 
sl@0: 
sl@0: After calling this function, whenever you change into the screen size specified 
sl@0: by aMode you will have the rotation aRotation. The setting remains in force 
sl@0: until it is explicitly changed using this function. 
sl@0: 
sl@0: Panics if the specified rotation is not allowed by the given screen mode.
sl@0: 
sl@0: @param aMode The index of the screen mode the rotation applies to. 
sl@0: @param aRotation The new screen orientation.
sl@0: @see GetRotationsList()
sl@0: @capability WriteDeviceData */
sl@0: 	{
sl@0: 	TWsSdCmdSetScreenRotation screenRotation(aMode,aRotation);
sl@0: 	Write(&screenRotation,sizeof(screenRotation),EWsSdOpSetModeRotation);
sl@0: 	}
sl@0: 
sl@0: EXPORT_C TInt CWsScreenDevice::GetRotationsList(TInt aMode, CArrayFixFlat<TInt> *aRotationList) const
sl@0: /** Gets the list of valid rotations for a particular screen size.
sl@0: 
sl@0: The list is initialised in wsini.ini.
sl@0:  
sl@0: This function always causes a flush of the window server buffer.
sl@0: 
sl@0: @param aMode The index of the screen mode for which the rotation list 
sl@0: is required. 
sl@0: @param aRotationList The list of valid screen orientations. 
sl@0: @return KErrNone if successful, otherwise another of the system-wide error 
sl@0: codes. 
sl@0: @see SetCurrentRotations() */
sl@0: 	{
sl@0: 	TUint modeList=(TUint)WriteReplyInt(aMode,EWsSdOpGetRotationList);
sl@0: 	TUint modeBit=1<<CFbsBitGc::EGraphicsOrientationNormal;
sl@0: 	TBool rots[4];
sl@0: 	TInt rotations=0;
sl@0: 	TInt ii;
sl@0: 	for (ii=0;ii<4;ii++)
sl@0: 		{
sl@0: 		rots[ii]=(modeList&modeBit);
sl@0: 		if (rots[ii])
sl@0: 			++rotations;
sl@0: 		modeBit=modeBit<<1;
sl@0: 		}
sl@0: 	if (!aRotationList)
sl@0: 		return rotations;
sl@0: 	TRAPD(err,aRotationList->ResizeL(rotations));
sl@0: 	if (err!=KErrNone)
sl@0: 		return(err);
sl@0: 	rotations=0;
sl@0: 	for (ii=0;ii<4;ii++)
sl@0: 		{
sl@0: 		if (rots[ii])
sl@0: 			(*aRotationList)[rotations++]=REINTERPRET_CAST(CFbsBitGc::TGraphicsOrientation&,ii);
sl@0: 		}
sl@0: 	return KErrNone;
sl@0: 	}
sl@0: 
sl@0: EXPORT_C TScreenModeEnforcement CWsScreenDevice::ScreenModeEnforcement() const
sl@0: /** Gets the current screen mode enforcement settings.
sl@0: 
sl@0: The global screen mode enforcement setting defines the requirements that a 
sl@0: group window must meet to be displayed. The requirements may have been set 
sl@0: in wsini.ini, or using SetScreenModeEnforcement(). 
sl@0:  
sl@0: This function always causes a flush of the window server buffer.
sl@0: 
sl@0: @return The screen mode enforcement requirements. */
sl@0: 	{
sl@0: 	return((TScreenModeEnforcement)WriteReply(EWsSdOpScreenModeEnforcement));
sl@0: 	}
sl@0: 
sl@0: EXPORT_C void CWsScreenDevice::SetScreenModeEnforcement(TScreenModeEnforcement aMode) const
sl@0: /** 
sl@0: @publishedPartner
sl@0: @released
sl@0: 
sl@0: Sets the screen mode enforcement requirements.
sl@0: 
sl@0: This global setting defines the requirements that a group window must meet 
sl@0: to be displayed. The value may be set using this function, but is more likely 
sl@0: to be defined in wsini.ini. 
sl@0: 
sl@0: @param aMode The screen mode enforcement requirements.
sl@0: @capability WriteDeviceData */
sl@0: 	{
sl@0: 	WriteInt(aMode,EWsSdOpSetScreenModeEnforcement);
sl@0: 	}
sl@0: 
sl@0: EXPORT_C TInt CWsScreenDevice::GetScreenNumber() const
sl@0: /** Get device's screen number 
sl@0: 
sl@0: @return The device's screen number
sl@0: @see CWsScreenDevice::Construct( TInt aDefaultScreenNumber ) */
sl@0: 	{
sl@0: 	return WriteReply(EWsSdOpGetScreenNumber);
sl@0: 	}
sl@0: 
sl@0: /** Gets the available screen size modes.
sl@0: 
sl@0: This function retrieves all available screen size modes which are supported by
sl@0: the server.
sl@0: 
sl@0: @param aModeList On return, the list of available screen size modes.
sl@0: @return The number of supported screen size modes if successful otherwise returns KErrNoMemory if 
sl@0: there is insufficient memory to create the array. */
sl@0: EXPORT_C TInt CWsScreenDevice::GetScreenSizeModeList(RArray<TInt>* aModeList) const
sl@0: 	{
sl@0: 	__ASSERT_ALWAYS(aModeList, Panic(EW32PanicNullArray));
sl@0: 	aModeList->Reset();
sl@0: 	TInt count=WriteReply(EWsSdOpGetNumScreenModes);
sl@0: 	TInt totSize=count*sizeof(TInt);
sl@0: 	TInt* allocMem=static_cast<TInt*>(User::Alloc(totSize));
sl@0: 	if(allocMem==NULL)
sl@0: 		{
sl@0: 		return KErrNoMemory;
sl@0: 		}
sl@0: 	TPtr8 listPtr(reinterpret_cast<TUint8*>(allocMem), totSize);
sl@0: 	count=WriteReplyP(&listPtr, EWsSdOpGetScreenSizeModeList);
sl@0: 	new(aModeList) RArray<TInt>(allocMem, count);
sl@0: 	return count;	
sl@0: 	}	
sl@0: 
sl@0: EXPORT_C TInt CWsScreenDevice::SetBackLight(TBool aBackLight)
sl@0: /** Set back light. 
sl@0: @param aBackLight, ETrue Set the backlight on, EFlase set the backlight off.
sl@0: @capability EikServ SID */
sl@0: 	{
sl@0: 	return(WriteReplyInt(aBackLight,EWsClOpSetBackLight));
sl@0: 	}
sl@0: 
sl@0: /** Interface Extension capability
sl@0: 	Use of this interface going forward will allow the published client interface to be dynamically extended.
sl@0: 	Note that the pointer returned is only good for the lifetime of the called CBase derived object.
sl@0: 
sl@0: 	@param  aInterfaceId	uniqueid or well known id of interface
sl@0: 	@return	pointer to interface object matching this ID or NULL if no match.
sl@0: */
sl@0: EXPORT_C TAny* CWsScreenDevice::GetInterface(TUint aInterfaceId)
sl@0: 	{
sl@0: 	return iExtension->GetInterface(aInterfaceId);
sl@0: 	}
sl@0: 
sl@0: /** Returns whether the given screen size mode is dynamic or not.
sl@0: 	Dynamic screen size modes may change their size in pixels and/or twips 
sl@0: 	and other attributes at run time, so they must not be cached. Static size 
sl@0: 	mode attributes will not change at run time, but may not make full use of the display.
sl@0: 	Invalid size modes shall return EFalse.
sl@0: 
sl@0: 	@param aSizeMode The screen size mode to check.
sl@0: 	@return ETrue if the given screen size mode is dynamic, EFalse otherwise.
sl@0: */
sl@0: EXPORT_C TBool CWsScreenDevice::IsModeDynamic(TInt /*aSizeMode*/) const
sl@0: 	{
sl@0: 	return EFalse;
sl@0: 	}
sl@0: 
sl@0: /** Returns whether the current screen size mode is dynamic or not.
sl@0: 
sl@0: 	@return ETrue if current screen size mode is dynamic, EFalse otherwise.
sl@0: 	@see IsModeDynamic
sl@0: */
sl@0: EXPORT_C TBool CWsScreenDevice::IsCurrentModeDynamic() const
sl@0: 	{
sl@0: 	return EFalse;
sl@0: 	}