--- a/epoc32/include/bitdev.h Tue Nov 24 13:55:44 2009 +0000
+++ b/epoc32/include/bitdev.h Tue Mar 16 16:12:26 2010 +0000
@@ -1,1 +1,255 @@
-bitdev.h
+// Copyright (c) 1997-2009 Nokia Corporation and/or its subsidiary(-ies).
+// All rights reserved.
+// This component and the accompanying materials are made available
+// under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members
+// which accompanies this distribution, and is available
+// at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
+//
+// Initial Contributors:
+// Nokia Corporation - initial contribution.
+//
+// Contributors:
+//
+// Description:
+//
+
+#ifndef __BITDEV_H__
+#define __BITDEV_H__
+
+#include <fbs.h>
+#include <bitbase.h>
+#include <bitstd.h>
+#include <graphicsaccelerator.h>
+
+/**
+Used by RectCompare()
+@internalComponent
+*/
+enum {EScanBufSize=0x80};
+
+class CFbsDrawDevice;
+class TSurfaceId;
+
+/**
+Screen device orientations.
+@internalTechnology
+@prototype
+*/
+enum TDeviceOrientation
+ {
+ EDeviceOrientationNormal = 1,
+ EDeviceOrientation90CW = 2,
+ EDeviceOrientation180 = 4,
+ EDeviceOrientation270CW = 8
+ };
+
+/** Abstract base class for graphics devices to which bitmaps and fonts can be
+drawn.
+
+The class implements the pure virtual CBitmapDevice functions and additionally
+provides:
+
+support for creating and enquiring about fonts
+
+comparing two device rectangles
+
+creating a graphics context for the device.
+
+CFbsBitmapDevice and CFbsScreenDevice are derived fom this class.
+
+@see CFbsBitmapDevice
+@see CFbsScreenDevice
+@publishedAll
+@released
+*/
+class CFbsDevice : public CBitmapDevice
+ {
+ friend class CFbsBitGc;
+public:
+ IMPORT_C ~CFbsDevice();
+ IMPORT_C TInt CreateContext(CFbsBitGc*& aGc);
+ inline TInt CreateContext(CGraphicsContext*& aGc);
+ IMPORT_C TDisplayMode DisplayMode() const;
+ IMPORT_C TSize SizeInPixels() const;
+ IMPORT_C TBool RectCompare(const TRect& aSourceRect,const CFbsDevice& aDevice,const TRect& aDeviceRect) const;
+ IMPORT_C TInt AddFile(const TDesC& aName,TInt& aId);
+ IMPORT_C void RemoveFile(TInt aId=0);
+ IMPORT_C virtual TInt GetNearestFontInTwips(CFont*& aFont, const TFontSpec& aFontSpec);
+ IMPORT_C virtual TInt GetNearestFontInPixels(CFont*& aFont, const TFontSpec& aFontSpec);
+ IMPORT_C virtual TInt GetNearestFontToDesignHeightInTwips(CFont*& aFont, const TFontSpec& aFontSpec);
+ IMPORT_C virtual TInt GetNearestFontToDesignHeightInPixels(CFont*& aFont, const TFontSpec& aFontSpec);
+ IMPORT_C virtual TInt GetNearestFontToMaxHeightInTwips(CFont*& aFont, const TFontSpec& aFontSpec, TInt aMaxHeight);
+ IMPORT_C virtual TInt GetNearestFontToMaxHeightInPixels(CFont*& aFont, const TFontSpec& aFontSpec, TInt aMaxHeight);
+ IMPORT_C TInt GetFontById(CFont*& aFont,TUid aFileId,const TAlgStyle& aStyle);
+ inline TInt GetNearestFontInTwips(CFbsFont*& aFont, const TFontSpec& aFontSpec);
+ inline TInt GetNearestFontInPixels(CFbsFont*& aFont, const TFontSpec& aFontSpec);
+ inline TInt GetNearestFontToDesignHeightInTwips(CFbsFont*& aFont, const TFontSpec& aFontSpec);
+ inline TInt GetNearestFontToDesignHeightInPixels(CFbsFont*& aFont, const TFontSpec& aFontSpec);
+ inline TInt GetNearestFontToMaxHeightInTwips(CFbsFont*& aFont, const TFontSpec& aFontSpec, TInt aMaxHeight);
+ inline TInt GetNearestFontToMaxHeightInPixels(CFbsFont*& aFont, const TFontSpec& aFontSpec, TInt aMaxHeight);
+ inline TInt GetFontById(CFbsFont*& aFont,TUid aFileId,const TAlgStyle& aStyle);
+ IMPORT_C void ReleaseFont(CFont* aFont);
+ IMPORT_C TInt FontHeightInTwips(TInt aTypefaceIndex,TInt aHeightIndex) const;
+ IMPORT_C TInt FontHeightInPixels(TInt aTypefaceIndex,TInt aHeightIndex) const;
+ IMPORT_C TInt NumTypefaces() const;
+ IMPORT_C void TypefaceSupport(TTypefaceSupport& aTypefaceSupport,TInt aTypefaceIndex) const;
+ IMPORT_C TInt SetCustomPalette(const CPalette* aPalette);
+ inline CGraphicsAccelerator* GraphicsAccelerator() const;
+ inline CFbsBitGc::TGraphicsOrientation Orientation() const;
+ IMPORT_C static TDisplayMode DisplayMode16M();
+ IMPORT_C TInt SetScalingFactor(const TPoint& aOrigin,
+ TInt aFactorX, TInt aFactorY,
+ TInt aDivisorX, TInt aDivisorY);
+ IMPORT_C void GetDrawRect(TRect& aRect) const;
+ IMPORT_C TInt RegisterLinkedTypeface(const CLinkedTypefaceSpecification& aLinkedTypefaceSpec, TInt& aId);
+protected:
+ CFbsDevice();
+ virtual void DrawingBegin(TBool /*aAlways*/ = EFalse) {}
+ virtual void DrawingEnd(TBool /*aAlways*/ = EFalse) {}
+
+ /**
+ Sets the bit level.
+ */
+ virtual void SetBits() {}
+
+ /**
+ Cancels drawing the sprite.
+ */
+ virtual void CancelSprite() const {}
+
+ /**
+ Hides the sprite over the whole screen.
+ @return TSpriteBase* A pointer to the hidden sprite. NULL in default implementation.
+ */
+ virtual TSpriteBase* HideSprite() const {return(NULL);}
+
+ /**
+ Hides the sprite within a particular region.
+ @param aRect A rectangle within the clipping region.
+ @param aClippingRegion The clipping region.
+ @return TSpriteBase* A pointer to the hidden sprite. NULL in default implementation.
+ */
+ virtual TSpriteBase* HideSprite(const TRect&,const TRegion*) const {return(NULL);}
+
+ /**
+ Shows the specified sprite over the whole screen.
+ @param aSprite The sprite which is to be shown.
+ */
+ virtual void ShowSprite(TSpriteBase*) const {}
+
+ /**
+ Shows the specified sprite within a particular region.
+ @param aSprite The sprite which is to be shown.
+ @param aRect A rectangle within the clipping region.
+ @param aClippingRegion The clipping region
+ */
+ virtual void ShowSprite(TSpriteBase*,const TRect&,const TRegion*) const {}
+ TInt GetNearestFbsFont(CFbsFont*& aFont,const TFontSpec& aFontSpec);
+ void DoGetScanLine(TDes8& aBuf,const TPoint& aPixel,TInt aLength,TDisplayMode aDispMode);
+ void ReadLineDiffMode(TInt,TInt,TInt,TAny*,TDisplayMode) const;
+ void TruncateRect(TRect& aRect);
+ TBool SetOrientation(CFbsBitGc::TGraphicsOrientation aOrientation);
+ void DrawingBegin(const CFbsBitmap* aBitmap, TBool aAlways = EFalse);
+ void DrawingEnd(const CFbsBitmap* aBitmap, TBool aAlways = EFalse);
+protected:
+ CFbsDrawDevice* iDrawDevice;
+ RFbsSession* iFbs;
+ CFbsTypefaceStore* iTypefaceStore;
+ TInt iSpare;
+ TBool iScreenDevice;
+ TUint8* iBitBltMaskedBuffer;
+ CGraphicsAccelerator* iGraphicsAccelerator;
+ CFbsBitGc::TGraphicsOrientation iOrientation;
+ };
+
+/** A graphics device interface that provides direct access to the screen, without
+the mediation of the window server.
+
+The interface adds sprite support to the CFbsDevice base class.
+@publishedAll
+@released
+*/
+class CFbsScreenDevice : public CFbsDevice
+ {
+public:
+ IMPORT_C static CFbsScreenDevice* NewL(const TDesC& aLibname,TDisplayMode aDispMode);
+ IMPORT_C static CFbsScreenDevice* NewL(const TDesC& aLibname,TDisplayMode aDispMode, TRgb aWhite);
+ IMPORT_C static CFbsScreenDevice* NewL(TInt aScreenNo, TDisplayMode aDispMode);
+ IMPORT_C virtual ~CFbsScreenDevice();
+ IMPORT_C void GetScanLine(TDes8& aBuf,const TPoint& aStartPixel,TInt aLength,TDisplayMode aDispMode) const;
+ IMPORT_C void GetPixel(TRgb& aColor,const TPoint& aPixel) const;
+ IMPORT_C TInt HorizontalPixelsToTwips(TInt aPixels) const;
+ IMPORT_C TInt VerticalPixelsToTwips(TInt aPixels) const;
+ IMPORT_C TInt HorizontalTwipsToPixels(TInt aTwips) const;
+ IMPORT_C TInt VerticalTwipsToPixels(TInt aTwips) const;
+ IMPORT_C void SetAutoUpdate(TBool aValue);
+ IMPORT_C void DrawSpriteBegin();
+ IMPORT_C void DrawSpriteEnd();
+ IMPORT_C void CancelSprite() const;
+ IMPORT_C TSpriteBase* HideSprite() const;
+ IMPORT_C TSpriteBase* HideSprite(const TRect& aRect,const TRegion* aClippingRegion) const;
+ IMPORT_C void ShowSprite(TSpriteBase* aSprite) const;
+ IMPORT_C void ShowSprite(TSpriteBase* aSprite,const TRect& aRect,const TRegion* aClippingRegion) const;
+ IMPORT_C void ChangeScreenDevice(CFbsScreenDevice* aOldDevice);
+ IMPORT_C void PaletteAttributes(TBool& aModifiable,TInt& aNumEntries) const;
+ IMPORT_C void SetPalette(CPalette* aPalette);
+ IMPORT_C TInt GetPalette(CPalette*& aPalette) const;
+ IMPORT_C void Update();
+ IMPORT_C void Update(const TRegion& aRegion);
+ IMPORT_C TSize SizeInTwips() const;
+ IMPORT_C RHardwareBitmap HardwareBitmap();
+ IMPORT_C const TUint32* Bits() const;
+ IMPORT_C TInt Stride() const;
+ IMPORT_C TInt ScreenNo() const;
+ IMPORT_C TUint DeviceOrientationsAvailable() const; //< @internalTechnology
+ IMPORT_C TBool SetDeviceOrientation(TDeviceOrientation aOrientation) const; //< @internalTechnology
+ IMPORT_C void GetSurface(TSurfaceId& aSurface) const; //< @internalTechnology
+ IMPORT_C TDeviceOrientation DeviceOrientation() const; //< @internalTechnology
+private:
+ CFbsScreenDevice(TInt aScreenNo);
+ void ConstructL(TInt aScreenNo, TDisplayMode aDispMode);
+private:
+ TSpriteBase* iSprite;
+ TBool iSpriteDraw;
+ TInt iScreenNo;
+ };
+
+/** A graphics device to which a bitmap managed by the font and bitmap server can
+be drawn.
+
+The class specialises the bitmap graphics device interface CBitmapDevice for
+drawing to in-memory bitmaps.
+@publishedAll
+@released
+*/
+class CFbsBitmapDevice : public CFbsDevice
+ {
+public:
+ IMPORT_C static CFbsBitmapDevice* NewL(CFbsBitmap* aFbsBitmap);
+ IMPORT_C static CFbsBitmapDevice* NewL(CFbsBitmap* aFbsBitmap,const TDesC& aLibname);
+ IMPORT_C virtual ~CFbsBitmapDevice();
+ IMPORT_C TInt Resize(const TSize& aSize);
+ IMPORT_C virtual void GetScanLine(TDes8& aBuf,const TPoint& aStartPixel,TInt aLength,TDisplayMode iDispMode) const;
+ IMPORT_C virtual void GetPixel(TRgb& aColor,const TPoint& aPixel) const;
+ IMPORT_C virtual TInt HorizontalPixelsToTwips(TInt aPixels) const;
+ IMPORT_C virtual TInt VerticalPixelsToTwips(TInt aPixels) const;
+ IMPORT_C virtual TInt HorizontalTwipsToPixels(TInt aTwips) const;
+ IMPORT_C virtual TInt VerticalTwipsToPixels(TInt aTwips) const;
+ IMPORT_C virtual TSize SizeInTwips() const;
+ IMPORT_C virtual void PaletteAttributes(TBool& aModifiable,TInt& aNumEntries) const;
+ IMPORT_C virtual void SetPalette(CPalette* aPalette);
+ IMPORT_C virtual TInt GetPalette(CPalette*& aPalette) const;
+ IMPORT_C virtual void DrawingBegin(TBool aAlways = EFalse);
+ IMPORT_C virtual void DrawingEnd(TBool aAlways = EFalse);
+ IMPORT_C TInt SwapWidthAndHeight();
+private:
+ CFbsBitmapDevice();
+ virtual void SetBits();
+ void ConstructL(CFbsBitmap* aFbsBitmap);
+ void ConstructL(CFbsBitmap* aFbsBitmap,const TDesC& aLibname);
+private:
+ CFbsBitGcBitmap* iFbsBmp;
+ };
+
+#include <bitdev.inl>
+#endif