CFbsDevice Class Reference

class CFbsDevice : public CBitmapDevice

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.

CFbsBitmapDevice CFbsScreenDevice

Public Member Functions
~CFbsDevice ()
IMPORT_C TInt AddFile (const TDesC &, TInt &)
IMPORT_C TInt CreateContext ( CFbsBitGc *&)
TInt CreateContext ( CGraphicsContext *&)
IMPORT_C TDisplayMode DisplayMode ()
IMPORT_C TDisplayMode DisplayMode16M ()
IMPORT_C TInt FontHeightInPixels ( TInt , TInt )
IMPORT_C TInt FontHeightInTwips ( TInt , TInt )
IMPORT_C void GetDrawRect ( TRect &)
IMPORT_C TInt GetFontById ( CFont *&, TUid , const TAlgStyle &)
TInt GetFontById ( CFbsFont *&, TUid , const TAlgStyle &)
IMPORT_C TInt GetNearestFontInPixels ( CFont *&, const TFontSpec &)
TInt GetNearestFontInPixels ( CFbsFont *&, const TFontSpec &)
IMPORT_C TInt GetNearestFontInTwips ( CFont *&, const TFontSpec &)
TInt GetNearestFontInTwips ( CFbsFont *&, const TFontSpec &)
IMPORT_C TInt GetNearestFontToDesignHeightInPixels ( CFont *&, const TFontSpec &)
TInt GetNearestFontToDesignHeightInPixels ( CFbsFont *&, const TFontSpec &)
IMPORT_C TInt GetNearestFontToDesignHeightInTwips ( CFont *&, const TFontSpec &)
TInt GetNearestFontToDesignHeightInTwips ( CFbsFont *&, const TFontSpec &)
IMPORT_C TInt GetNearestFontToMaxHeightInPixels ( CFont *&, const TFontSpec &, TInt )
TInt GetNearestFontToMaxHeightInPixels ( CFbsFont *&, const TFontSpec &, TInt )
IMPORT_C TInt GetNearestFontToMaxHeightInTwips ( CFont *&, const TFontSpec &, TInt )
TInt GetNearestFontToMaxHeightInTwips ( CFbsFont *&, const TFontSpec &, TInt )
CGraphicsAccelerator * GraphicsAccelerator ()
IMPORT_C TInt NumTypefaces ()
CFbsBitGc::TGraphicsOrientation Orientation ()
IMPORT_C TBool RectCompare (const TRect &, const CFbsDevice &, const TRect &)
IMPORT_C TInt RegisterLinkedTypeface (const CLinkedTypefaceSpecification &, TInt &)
IMPORT_C void ReleaseFont ( CFont *)
IMPORT_C void RemoveFile ( TInt )
IMPORT_C TInt SetCustomPalette (const CPalette *)
IMPORT_C TInt SetDrawDeviceOffset (const TPoint &)
IMPORT_C TInt SetScalingFactor (const TPoint &, TInt , TInt , TInt , TInt )
IMPORT_C TSize SizeInPixels ()
IMPORT_C void TypefaceSupport ( TTypefaceSupport &, TInt )
Protected Member Functions
CFbsDevice ()
void CancelSprite ()
void DoGetScanLine ( TDes8 &, const TPoint &, TInt , TDisplayMode )
void DrawingBegin ( TBool )
void DrawingBegin (const CFbsBitmap *, TBool )
void DrawingEnd ( TBool )
void DrawingEnd (const CFbsBitmap *, TBool )
TInt GetNearestFbsFont ( CFbsFont *&, const TFontSpec &)
TSpriteBase * HideSprite ()
TSpriteBase * HideSprite (const TRect &, const TRegion *)
void ReadLineDiffMode ( TInt , TInt , TInt , TAny *, TDisplayMode )
void SetBits ()
TBool SetOrientation ( CFbsBitGc::TGraphicsOrientation )
void ShowSprite ( TSpriteBase *)
void ShowSprite ( TSpriteBase *, const TRect &, const TRegion *)
void TruncateRect ( TRect &)
Inherited Functions
CBase::CBase()
CBase::Delete(CBase *)
CBase::Extension_(TUint,TAny *&,TAny *)
CBase::operator new(TUint)
CBase::operator new(TUint,TAny *)
CBase::operator new(TUint,TLeave)
CBase::operator new(TUint,TLeave,TUint)
CBase::operator new(TUint,TUint)
CBase::~CBase()
CBitmapDevice::CreateBitmapContext(CBitmapContext *&)
CBitmapDevice::GetPixel(TRgb &,const TPoint &)const
CBitmapDevice::GetScanLine(TDes8 &,const TPoint &,TInt,TDisplayMode)const
CGraphicsDevice::GetPalette(CPalette *&)const
CGraphicsDevice::PaletteAttributes(TBool &,TInt &)const
CGraphicsDevice::SetPalette(CPalette *)
CGraphicsDevice::SizeInTwips()const
Protected Attributes
TUint8 * iBitBltMaskedBuffer
CFbsDrawDevice * iDrawDevice
RFbsSession * iFbs
CGraphicsAccelerator * iGraphicsAccelerator
CFbsBitGc::TGraphicsOrientation iOrientation
TBool iScreenDevice
TInt iSpare
CFbsTypefaceStore * iTypefaceStore

Constructor & Destructor Documentation

CFbsDevice()

CFbsDevice ( ) [protected]

~CFbsDevice()

IMPORT_C ~CFbsDevice ( )

Frees all resources owned by the object prior to its destruction.

Member Functions Documentation

AddFile(const TDesC &, TInt &)

IMPORT_C TInt AddFile ( const TDesC & aName,
TInt & aId
) [virtual]

Adds a font file to the device's typeface store. The specified font file must be accessible to any process, i.e. not located inside an application's private directory.

Parameters

const TDesC & aName The name of the font file.
TInt & aId On return, the UID value of the font file.

CancelSprite()

void CancelSprite ( ) const [protected, inline, virtual]

This method has been deprecated. Sprites are no longer supported in BitGDI. Calling this method has no effect.

CreateContext(CFbsBitGc *&)

IMPORT_C TInt CreateContext ( CFbsBitGc *& aGc )

Creates a font and bitmap server graphics context for the device and activates it.

It is the responsibility of the caller to delete the graphics context when it is no longer needed.

Parameters

CFbsBitGc *& aGc On return, contains a pointer to the graphics context.

CreateContext(CGraphicsContext *&)

TInt CreateContext ( CGraphicsContext *& aGc ) [inline, virtual]

Creates a font and bitmap server graphics context for the device and activates it.

It is the responsibility of the caller to delete the graphics context when it is no longer needed.

Parameters

CGraphicsContext *& aGc On return, contains a pointer to the graphics context.

DisplayMode()

IMPORT_C TDisplayMode DisplayMode ( ) const [virtual]

Gets the device's display mode.

DisplayMode16M()

IMPORT_C TDisplayMode DisplayMode16M ( ) [static]

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. TDisplayMode

DoGetScanLine(TDes8 &, const TPoint &, TInt, TDisplayMode)

void DoGetScanLine ( TDes8 & aBuf,
const TPoint & aPixel,
TInt aLength,
TDisplayMode aDispMode
) [protected]

The method gets a scanline and puts the scanline data into aBuf.

Parameters

TDes8 & aBuf The destination buffer. It should be with enough length to collect requested scanline data.
const TPoint & aPixel The first pixel of the requested scanline data
TInt aLength The length in pixels of requested data
TDisplayMode aDispMode requested scanline should be converted regarding aDispMode parameter

DrawingBegin(TBool)

void DrawingBegin ( TBool  = EFalse ) [protected, inline, virtual]

Parameters

TBool  = EFalse

DrawingBegin(const CFbsBitmap *, TBool)

void DrawingBegin ( const CFbsBitmap * aBitmap,
TBool aAlways = EFalse
) [protected]

An overloaded version of DrawingBegin(TBool) . Similarly to that method, calls to DrawingBegin(const CFbsBitmap*, TBool) must be paired with a subsequent call to DrawingEnd(const CFbsBitmap*, TBool) . Also, code must not leave between a DrawingBegin(const CFbsBitmap*, TBool) - DrawingEnd(const CFbsBitmap*, TBool) pair. CFbsBitmapDevice::DrawingBegin()

Parameters

const CFbsBitmap * aBitmap An additional parameter compared to the basic overload. aBitmap is a pointer to a CFbsBitmap object to be frozen. If a null pointer is given then the method panics.
TBool aAlways = EFalse Not used.

DrawingEnd(TBool)

void DrawingEnd ( TBool  = EFalse ) [protected, inline, virtual]

Parameters

TBool  = EFalse

DrawingEnd(const CFbsBitmap *, TBool)

void DrawingEnd ( const CFbsBitmap * aBitmap,
TBool aAlways = EFalse
) [protected]

This must always be called after DrawingBegin(const CFbsBitmap*, TBool) . Like DrawingBegin(const CFbsBitmap*, TBool) it will panic in debug builds if passed a null pointer. CFbsBitmapDevice::DrawingEnd()

Parameters

const CFbsBitmap * aBitmap A pointer to a CFbsBitmap object to be unfrozen.
TBool aAlways = EFalse Not used.

FontHeightInPixels(TInt, TInt)

IMPORT_C TInt FontHeightInPixels ( TInt aTypefaceIndex,
TInt aHeightIndex
) const [virtual]

Gets the height, in pixels, of the specified typeface at one of its defined heights.

This is an implementation of CBitMapDevice::FontHeightInPixels().

Parameters

TInt aTypefaceIndex
TInt aHeightIndex

FontHeightInTwips(TInt, TInt)

IMPORT_C TInt FontHeightInTwips ( TInt aTypefaceIndex,
TInt aHeightIndex
) const [virtual]

Gets the height of a font in twips.

This is an implementation of CGraphicsDevice::FontHeightInTwips() .

Parameters

TInt aTypefaceIndex
TInt aHeightIndex

GetDrawRect(TRect &)

IMPORT_C void GetDrawRect ( TRect & aRect ) const

Gets logical coordinates of the drawing rectangle. If the device is not scaled, logocal coordinates of the drawing rectangle are the same as its physical coordinates.

Parameters

TRect & aRect Upon return aRect contains drawing rectangle logical coordinates.

GetFontById(CFont *&, TUid, const TAlgStyle &)

IMPORT_C TInt GetFontById ( CFont *& aFont,
TUid aFileId,
const TAlgStyle & aStyle
)

Gets a specific bitmap font, identified by its UID, from the device's typeface store.

When the font is no longer needed, call ReleaseFont() .

Parameters

CFont *& aFont On return, set to point to the font.
TUid aFileId The UID identifying the bitmap font.
const TAlgStyle & aStyle Algorithmic style for the font.

GetFontById(CFbsFont *&, TUid, const TAlgStyle &)

TInt GetFontById ( CFbsFont *& aFont,
TUid aFileId,
const TAlgStyle & aStyle
) [inline]

Gets a specific bitmap font, identified by its UID, from the device's typeface store.

When the font is no longer needed, call ReleaseFont() .

Parameters

CFbsFont *& aFont On return, set to point to the font.
TUid aFileId The UID identifying the bitmap font.
const TAlgStyle & aStyle Algorithmic style for the font.

GetNearestFbsFont(CFbsFont *&, const TFontSpec &)

TInt GetNearestFbsFont ( CFbsFont *& aFont,
const TFontSpec & aFontSpec
) [protected]

Parameters

CFbsFont *& aFont
const TFontSpec & aFontSpec

GetNearestFontInPixels(CFont *&, const TFontSpec &)

IMPORT_C TInt GetNearestFontInPixels ( CFont *& aFont,
const TFontSpec & aFontSpec
) [virtual]

Creates a client-side font from those available in the device's typeface store that most closely matches a font specification.

When the font is no longer needed, call ReleaseFont() .

Note that this deprecated function is replaced by the new GetNearestFontToDesignHeightInPixels() yielding (virtually) the same result. However clients are strongly encouraged to use the new GetNearestFontToMaxHeightInPixels() function instead. This will guarantee that every character within any given text string will fit within the given amount of pixels, whereas the design height is an aesthetic unit decided by the font designer without strict physical meaning, which may result in cropped characters.

Parameters

CFont *& aFont On return, points to the font which most closely matches the specified font.
const TFontSpec & aFontSpec An absolute font specification. Its iHeight member is interpreted as being in pixels.

GetNearestFontInPixels(CFbsFont *&, const TFontSpec &)

TInt GetNearestFontInPixels ( CFbsFont *& aFont,
const TFontSpec & aFontSpec
) [inline]

Creates a client-side FBSERV font from those available in the device's typeface store that most closely matches a font specification.

When the font is no longer needed, call ReleaseFont() .

This function is replaced by GetNearestFontToDesignHeightInPixels() .

Parameters

CFbsFont *& aFont On return, points to the font which most closely matches the specified font.
const TFontSpec & aFontSpec An absolute font specification. Its iHeight member is interpreted as being in pixels.

GetNearestFontInTwips(CFont *&, const TFontSpec &)

IMPORT_C TInt GetNearestFontInTwips ( CFont *& aFont,
const TFontSpec & aFontSpec
) [virtual]

Provides access to a client-side font object in the device's typeface store that most closely matches a font specification.

When the font is no longer needed, call ReleaseFont() .

Note that this deprecated function is replaced by the new GetNearestFontToDesignHeightInTwips() yielding (virtually) the same result. However clients are strongly encouraged to use the new GetNearestFontToMaxHeightInTwips() function instead. This will guarantee that every character within any given text string will fit within the given amount of twips, whereas the design height is an aesthetic unit decided by the font designer without strict physical meaning, which may result in cropped characters.

Parameters

CFont *& aFont On return, points to the font which most closely matches the specified font.
const TFontSpec & aFontSpec An absolute font specification. Its iHeight member is interpreted as being in twips.

GetNearestFontInTwips(CFbsFont *&, const TFontSpec &)

TInt GetNearestFontInTwips ( CFbsFont *& aFont,
const TFontSpec & aFontSpec
) [inline]

Creates a client-side FBSERV font from those available in the device's typeface store that most closely matches a font specification.

When the font is no longer needed, call ReleaseFont() .

This function is replaced by GetNearestFontToDesignHeightInTwips() .

Parameters

CFbsFont *& aFont On return, points to the font which most closely matches the specified font.
const TFontSpec & aFontSpec An absolute font specification. Its iHeight member is interpreted as being in twips.

GetNearestFontToDesignHeightInPixels(CFont *&, const TFontSpec &)

IMPORT_C TInt GetNearestFontToDesignHeightInPixels ( CFont *& aFont,
const TFontSpec & aFontSpec
) [virtual]

Creates a client-side font from those available in the device's typeface store that most closely matches a font specification.

When the font is no longer needed, call ReleaseFont() .

This new function replaces the deprecated GetNearestFontInPixels() yielding (virtually) the same result. However clients are strongly encouraged to use the new GetNearestFontToMaxHeightInPixels() function instead. This will guarantee that every character within any given text string will fit within the given amount of pixels, whereas the design height is an aesthetic unit decided by the font designer without strict physical meaning, which may result in cropped characters.

Parameters

CFont *& aFont On return, points to the font which most closely matches the specified font.
const TFontSpec & aFontSpec An absolute font specification. Its iHeight member is interpreted as being in pixels.

GetNearestFontToDesignHeightInPixels(CFbsFont *&, const TFontSpec &)

TInt GetNearestFontToDesignHeightInPixels ( CFbsFont *& aFont,
const TFontSpec & aFontSpec
) [inline]

Creates a client-side FBSERV font from those available in the device's typeface store that most closely matches a font specification.

When the font is no longer needed, call ReleaseFont() .

This function replaces GetNearestFontInPixels() .

Parameters

CFbsFont *& aFont On return, points to the font which most closely matches the specified font.
const TFontSpec & aFontSpec An absolute font specification. Its iHeight member is interpreted as being in pixels.

GetNearestFontToDesignHeightInTwips(CFont *&, const TFontSpec &)

IMPORT_C TInt GetNearestFontToDesignHeightInTwips ( CFont *& aFont,
const TFontSpec & aFontSpec
) [virtual]

Creates a client-side font from those available in the device's typeface store that most closely matches a font specification.

When the font is no longer needed, call ReleaseFont() .

This new function replaces the deprecated GetNearestFontInTwips() yielding (virtually) the same result. However clients are strongly encouraged to use the new GetNearestFontToMaxHeightInTwips() function instead. This will guarantee that every character within any given text string will fit within the given amount of twips, whereas the design height is an aesthetic unit decided by the font designer without strict physical meaning, which may result in cropped characters.

Parameters

CFont *& aFont On return, points to the font which most closely matches the specified font.
const TFontSpec & aFontSpec An absolute font specification. Its iHeight member is interpreted as being in twips.

GetNearestFontToDesignHeightInTwips(CFbsFont *&, const TFontSpec &)

TInt GetNearestFontToDesignHeightInTwips ( CFbsFont *& aFont,
const TFontSpec & aFontSpec
) [inline]

Creates a client-side FBSERV font from those available in the device's typeface store that most closely matches a font specification.

When the font is no longer needed, call ReleaseFont() .

This function replaces GetNearestFontInTwips() .

Parameters

CFbsFont *& aFont On return, points to the font which most closely matches the specified font.
const TFontSpec & aFontSpec An absolute font specification. Its iHeight member is interpreted as being in twips.

GetNearestFontToMaxHeightInPixels(CFont *&, const TFontSpec &, TInt)

IMPORT_C TInt GetNearestFontToMaxHeightInPixels ( CFont *& aFont,
const TFontSpec & aFontSpec,
TInt aMaxHeight
) [virtual]

Creates a client-side font from those available in the device's typeface store that most closely matches a font specification.

When the font is no longer needed, call ReleaseFont() .

The font and bitmap server returns a pointer to the nearest matching font from those available. Matches to max height of font - this does its best to return a font that will fit within the maximum height specified (but note that variations due to hinting algorithms may rarely result in this height being exceeded by up to one pixel). Problems can also be encountered with bitmap fonts where the typeface exists but doesn't have a font small enough.

Parameters

CFont *& aFont On return, the pointer is set to point to the device font which most closely approximates to the required font specification.
const TFontSpec & aFontSpec An absolute font specification.
TInt aMaxHeight The maximum height in pixels within which the font must fit - this overrides the height specified in aFontSpec. If maximum height is greater than 1024 pixels, the function returns KErrTooBig. And returns KErrArgument if equals to 1 pixel.

GetNearestFontToMaxHeightInPixels(CFbsFont *&, const TFontSpec &, TInt)

TInt GetNearestFontToMaxHeightInPixels ( CFbsFont *& aFont,
const TFontSpec & aFontSpec,
TInt aMaxHeight
) [inline]

Creates a client-side FBSERV font from those available in the device's typeface store that most closely matches a font specification.

When the font is no longer needed, call ReleaseFont() .

The font and bitmap server returns a pointer to the nearest matching font from those available. Matches to max height of font - this does its best to return a font that will fit within the maximum height specified (but note that variations due to hinting algorithms may rarely result in this height being exceeded by up to one pixel). Problems can also be encountered with bitmap fonts where the typeface exists but doesn't have a font small enough.

Parameters

CFbsFont *& aFont On return, the pointer is set to point to the device font which most closely approximates to the required font specification.
const TFontSpec & aFontSpec An absolute font specification.
TInt aMaxHeight The maximum height in pixels within which the font must fit - this overrides the height specified in aFontSpec.

GetNearestFontToMaxHeightInTwips(CFont *&, const TFontSpec &, TInt)

IMPORT_C TInt GetNearestFontToMaxHeightInTwips ( CFont *& aFont,
const TFontSpec & aFontSpec,
TInt aMaxHeight
) [virtual]

Creates a client-side font from those available in the device's typeface store that most closely matches a font specification.

When the font is no longer needed, call ReleaseFont() .

The font and bitmap server returns a pointer to the nearest matching font from those available. Matches to max height of font - this does its best to return a font that will fit within the maximum height specified (but note that variations due to hinting algorithms may rarely result in this height being exceeded by up to one pixel). Problems can also be encountered with bitmap fonts where the typeface exists but doesn't have a font small enough.

Parameters

CFont *& aFont On return, the pointer is set to point to the device font which most closely approximates to the required font specification.
const TFontSpec & aFontSpec An absolute font specification.
TInt aMaxHeight The maximum height in twips within which the font must fit - this overrides the height specified in aFontSpec. If maximum height is greater than 1024 pixels, the function returns KErrTooBig. And returns KErrArgument if equals to 1 pixel.

GetNearestFontToMaxHeightInTwips(CFbsFont *&, const TFontSpec &, TInt)

TInt GetNearestFontToMaxHeightInTwips ( CFbsFont *& aFont,
const TFontSpec & aFontSpec,
TInt aMaxHeight
) [inline]

Creates a client-side FBSERV font from those available in the device's typeface store that most closely matches a font specification.

When the font is no longer needed, call ReleaseFont() .

The font and bitmap server returns a pointer to the nearest matching font from those available. Matches to max height of font - this does its best to return a font that will fit within the maximum height specified (but note that variations due to hinting algorithms may rarely result in this height being exceeded by up to one pixel). Problems can also be encountered with bitmap fonts where the typeface exists but doesn't have a font small enough.

Parameters

CFbsFont *& aFont On return, the pointer is set to point to the device font which most closely approximates to the required font specification.
const TFontSpec & aFontSpec An absolute font specification.
TInt aMaxHeight The maximum height in twips within which the font must fit - this overrides the height specified in aFontSpec.

GraphicsAccelerator()

CGraphicsAccelerator * GraphicsAccelerator ( ) const [inline]

Gets a pointer to the 2D graphics accelerator owned by the device. If one is available, it is used to accelerate various CFbsBitGc graphics operations.

CFbsBitmapDevice::NewL()

HideSprite()

TSpriteBase * HideSprite ( ) const [protected, inline, virtual]

This method has been deprecated. Sprites are no longer supported in BitGDI. Calling this method has no effect.

HideSprite(const TRect &, const TRegion *)

TSpriteBase * HideSprite ( const TRect & ,
const TRegion *
) const [protected, inline, virtual]

This method has been deprecated. Sprites are no longer supported in BitGDI. Calling this method has no effect.

Parameters

const TRect &
const TRegion *

NumTypefaces()

IMPORT_C TInt NumTypefaces ( ) const [virtual]

Gets the number of typefaces supported by the device.

Orientation()

CFbsBitGc::TGraphicsOrientation Orientation ( ) const [inline]

Gets the device's orientation. The orientation can be set using CFbsBitGc::SetOrientation() .

ReadLineDiffMode(TInt, TInt, TInt, TAny *, TDisplayMode)

void ReadLineDiffMode ( TInt ,
TInt ,
TInt ,
TAny * ,
TDisplayMode
) const [protected]

RectCompare(const TRect &, const CFbsDevice &, const TRect &)

IMPORT_C TBool RectCompare ( const TRect & aSourceRect,
const CFbsDevice & aDevice,
const TRect & aDeviceRect
) const

Compares two rectangles, including their contents.

This function is intended for use by test code only.

Parameters

const TRect & aSourceRect The first rectangle to be compared (in this device).
const CFbsDevice & aDevice The font and bitmap server device in which the second rectangle is found.
const TRect & aDeviceRect The second rectangle to be compared.

RegisterLinkedTypeface(const CLinkedTypefaceSpecification &, TInt &)

IMPORT_C TInt RegisterLinkedTypeface ( const CLinkedTypefaceSpecification & aLinkedTypefaceSpec,
TInt & aId
)
Function to add a CLinkedTypefaceSpecification to the font and bitmap server typeface store.
capability
ECapabilityWriteDeviceData
CLinkedTypefaceSpecification

Parameters

const CLinkedTypefaceSpecification & aLinkedTypefaceSpec
TInt & aId

ReleaseFont(CFont *)

IMPORT_C void ReleaseFont ( CFont * aFont )

Marks the specified font as no longer needed by the user of the device.

As fonts can be shared between applications, this function does not delete the copy of the font from RAM unless the font is only being used by this device.

Parameters

CFont * aFont A pointer to the font to be released.

RemoveFile(TInt)

IMPORT_C void RemoveFile ( TInt aId = 0 ) [virtual]

Decrements the reference count of a file which was added using AddFile() , and removes the file from the typeface store if the reference count reaches zero.

If zero is passed as parameter, then an attempt is made to remove all font objects from the device's typeface store provided none of the fonts in the store are currently accessed, otherwise it has no effect.

Parameters

TInt aId = 0 The UID value of the font file to be removed. The default is 0.

SetBits()

void SetBits ( ) [protected, inline, virtual]

Sets the bit level.

SetCustomPalette(const CPalette *)

IMPORT_C TInt SetCustomPalette ( const CPalette * aPalette )

Sets the variable 8 bits per pixel colour palette, replacing the system default one. Only the entries in the system default palette which have corresponding entries in aPalette are overwritten, i.e. if aPalette contains fewer than 256 colours, some will remain unchanged. If aPalette has more than 256 entries, the additional entries are ignored.

Parameters

const CPalette * aPalette The custom palette.

SetDrawDeviceOffset(const TPoint &)

IMPORT_C TInt SetDrawDeviceOffset ( const TPoint & aOrigin )

Used to set an offset

Parameters

const TPoint & aOrigin The offset to give

SetOrientation(CFbsBitGc::TGraphicsOrientation)

TBool SetOrientation ( CFbsBitGc::TGraphicsOrientation aOrientation ) [protected]

Parameters

CFbsBitGc::TGraphicsOrientation aOrientation

SetScalingFactor(const TPoint &, TInt, TInt, TInt, TInt)

IMPORT_C TInt SetScalingFactor ( const TPoint & aOrigin,
TInt aFactorX,
TInt aFactorY,
TInt aDivisorX,
TInt aDivisorY
)

Sets scaling factor by which the drawing device should scale the drawing images. If you want to un-scale the device, call SetScalingFactor() with Origin (0,0), factorX = 1, factorY = 1, divisorX = 1, divisorY = 1.

Note: The existing graphics acceleration interface does not have support for scaling.

Note: All graphics contexts, already created by the scaled device, should be re-activated calling CFbsBitGc::Activate() .

Parameters

const TPoint & aOrigin Specifies physical coordinates of the new scaling origin of the drawing device. The drawing device maps the logical point [0, 0] to the "aOrigin" physical point .
TInt aFactorX Scaling factor for the X-axis of the screen device.
TInt aFactorY Scaling factor for the y-axis of the screen device.
TInt aDivisorX Not used. Should be set to 1.
TInt aDivisorY Not used. Should be set to 1.

ShowSprite(TSpriteBase *)

void ShowSprite ( TSpriteBase * ) const [protected, inline, virtual]

This method has been deprecated. Sprites are no longer supported in BitGDI. Calling this method has no effect.

Parameters

TSpriteBase *

ShowSprite(TSpriteBase *, const TRect &, const TRegion *)

void ShowSprite ( TSpriteBase * ,
const TRect & ,
const TRegion *
) const [protected, inline, virtual]

This method has been deprecated. Sprites are no longer supported in BitGDI. Calling this method has no effect.

Parameters

TSpriteBase *
const TRect &
const TRegion *

SizeInPixels()

IMPORT_C TSize SizeInPixels ( ) const [virtual]

Gets the size of the device, in pixels.

TruncateRect(TRect &)

void TruncateRect ( TRect & aRect ) [protected]

Parameters

TRect & aRect

TypefaceSupport(TTypefaceSupport &, TInt)

IMPORT_C void TypefaceSupport ( TTypefaceSupport & aTypefaceSupport,
TInt aTypefaceIndex
) const [virtual]

Gets information about an indexed typeface.

CGraphicsDevice::TypefaceSupport()

Parameters

TTypefaceSupport & aTypefaceSupport Provides information about the typeface, including its name and attributes.
TInt aTypefaceIndex The index of the requested typeface in the device's typeface store; between zero and NumTypefaces() 1 inclusive.

Member Data Documentation

TUint8 * iBitBltMaskedBuffer

TUint8 * iBitBltMaskedBuffer [protected]

CFbsDrawDevice * iDrawDevice

CFbsDrawDevice * iDrawDevice [protected]

RFbsSession * iFbs

RFbsSession * iFbs [protected]

CGraphicsAccelerator * iGraphicsAccelerator

CGraphicsAccelerator * iGraphicsAccelerator [protected]

CFbsBitGc::TGraphicsOrientation iOrientation

CFbsBitGc::TGraphicsOrientation iOrientation [protected]

TBool iScreenDevice

TBool iScreenDevice [protected]

TInt iSpare

TInt iSpare [protected]

CFbsTypefaceStore * iTypefaceStore

CFbsTypefaceStore * iTypefaceStore [protected]