Default constructor. Developers should use the other constructor overload.

Constructs a new screen device attached to a particular window server session.

Destructor.

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.

CBitmapDevice::AddFile()

Completes construction of the object.

This method invokes Construct(TInt aDefaultScreenNumber) with default Screen number.

Completes construction of the object.

Saves the entire screen to a bitmap.

This function always causes a flush of the window server buffer.

Saves a region of the screen to a bitmap.

This function always causes a flush of the window server buffer.

Creates a graphics context for this device.

This function always causes a flush of the window server buffer.

CGraphicsDevice::CreateContext()

Creates a graphics context for this device.

This function always causes a flush of the window server buffer.

CGraphicsDevice::CreateContext()

Gets the current screen mode index.

This function always causes a flush of the window server buffer.

Gets the device's display mode.

This function always causes a flush of the window server buffer.

CGraphicsDevice::DisplayMode()

Gets the height of the specified font in pixels.

The value returned is rounded up or down to the nearest font height in pixels.

The specified font is the one with height index number aHeightIndex of the typeface with index number aTypefaceIndex.

CBitmapDevice::FontHeightInPixels()

Gets the height in twips of the specified font.

The value returned is rounded up or down to the nearest font height in twips.

The specified font is the one with height index number aHeightIndex of the typeface with index number aTypefaceIndex.

CGraphicsDevice::FontHeightInTwips()

Used for testing purposes only.

Gets the scale for the current screen mode.

This function always causes a flush of the window server buffer.

Gets the current screen mode's scaled origin.

The formula used is (A+B-1)/B

where:

The result obtained is the scaled origin of the present screen mode.

Gets the origin for the current screen mode

This function always causes a flush of the window server buffer.

Gets the current screen size (in both pixels and twips) and rotation.

This function always causes a flush of the window server buffer.

Gets the current screen size (in pixels) and the rotation.

This function always causes a flush of the window server buffer.

Gets a font by its bitmap UID.

Within a font file each font has its own UID. An algorithmic style is not part of the actual font description, but is applied to it. For example algorithmic bolding applies an algorithm to increase the apparent weight of each character in the font. Note that the algorithm is applied blindly, and that a typeface may already have a style e.g. it may already be bold or italic. Thus a bold face will appear extra-bold if algorithmic bolding is applied to it. Algorithmic effects are not necessarily a substitute for typeface design and should be used with care.

Interface Extension capability Use of this interface going forward will allow the published client interface to be dynamically extended. Note that the pointer returned is only good for the lifetime of the called CBase derived object.

Gets the nearest font to that specified for use by a bitmapped graphics device.

This function is replaced by GetNearestFontToDesignHeightInPixels()

The font and bitmap server returns a pointer to the nearest matching font from those available, in aFont.

CBitmapDevice::GetNearestFontInPixels()

Gets the nearest font, in twips, to that in the specified font specification.

This function is replaced by GetNearestFontToDesignHeightInTwips()

The font and bitmap server returns a pointer to the nearest matching font from those available, in aFont.

MGraphicsDeviceMap::GetNearestFontInTwips()

Gets the nearest font in pixels to that specified.

The font and bitmap server returns a pointer to the nearest matching font from those available. Matches to design height of font - this gives no guarantees on the actual physical size of the font.

This function replaces GetNearestFontInTwips

CBitmapDevice::GetNearestFontToDesignHeightInPixels()

Gets the nearest font in twips to that specified.

The font and bitmap server returns a pointer to the nearest matching font from those available. Matches to design height of font - this gives no guarantees on the actual physical size of the font.

This function replaces GetNearestFontInTwips

MGraphicsDeviceMap::GetNearestFontToDesignHeightInTwips()

Gets the nearest font in pixels to that specified.

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.

CBitmapDevice::GetNearestFontToMaxHeightInPixels()

Gets the nearest font, in twips, to that specified.

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.

MGraphicsDeviceMap::GetNearestFontToMaxHeightInTwips()

Gets the screen device's palette.

This function always causes a flush of the window server buffer.

CFbsScreenDevice::GetPalette()

Gets the RGB colour of an individual pixel on a screen device.

This function always causes a flush of the window server buffer.

CBitmapDevice::GetPixel()

Gets the list of valid rotations for a particular screen size.

The list is initialised in wsini.ini.

This function always causes a flush of the window server buffer.

SetCurrentRotations()

Gets a scanline into a buffer.

The pixels are converted from the current screen display mode format to the format of the specified device display mode.

By specifying the start pixel and number of pixels either the whole or a portion of a row of screen pixels may be copied.

This function always causes a flush of the window server buffer.

CBitmapDevice::GetScanLine()

Gets the display mode of the screen for the specified screen mode

This function always causes a flush of the window server buffer.

Get the origin of the screen for the specified screen mode.

This function always causes a flush of the window server buffer.

Gets the scale for the specified screen mode.

This function always causes a flush of the window server buffer.

Gets the specfied screen mode's scaled origin.

The functionality is same as CWsScreenDevice::GetCurrentScreenModeScaledOrigin() .

It always causes a flush of the window server buffer.

Get the screen rotation and size, in both pixels and twips, for the specified screen mode.

This function always causes a flush of the window server buffer.

Get the screen rotation and size (in pixels) for the specified screen mode.

This function always causes a flush of the window server buffer.

Get device's screen number

CWsScreenDevice::Construct( TInt aDefaultScreenNumber )

Gets the available screen size modes.

This function retrieves all available screen size modes which are supported by the server.

Translates a specified pixel value to a twips value.

Translates a twips to a pixel value.

MGraphicsDeviceMap::HorizontalTwipsToPixels()

Returns whether the current screen size mode is dynamic or not.

IsModeDynamic

Returns whether the given screen size mode is dynamic or not. Dynamic screen size modes may change their size in pixels and/or twips and other attributes at run time, so they must not be cached. Static size mode attributes will not change at run time, but may not make full use of the display. Invalid size modes shall return EFalse.

Gets the number of available screen modes.

Each mode has a different size, and one or more possible rotations/orientations.

This function always causes a flush of the window server buffer.

Gets the number of typefaces supported by the screen device.

CGraphicsDevice::NumTypefaces()

Gets the attributes of the device's palette.

This function always causes a flush of the window server buffer.

CFbsScreenDevice::PaletteAttributes()

Gets the active area for the pointing device.

This is a device-dependent parameter, and will typically depend on the screen size and other factors.

This function always causes a flush of the window server buffer.

Compares two areas of the screen to see if they have the same content.

If there are any sprites on the screen they are not included in the comparison.

This function always causes a flush of the window server buffer.

Compares two areas of the screen to see if they have the same content.

This function always causes a flush of the window server buffer.

Releases a specified font.

This function is used to indicate that the specified font is no longer needed for use by the screen device. As fonts can be shared between applications, this function does not delete the copy of the font from RAM, unless the font was only being used by this device.

MGraphicsDeviceMap::ReleaseFont()

Removes a font file from the font store.

CBitmapDevice::RemoveFile()

Gets the current screen mode enforcement settings.

The global screen mode enforcement setting defines the requirements that a group window must meet to be displayed. The requirements may have been set in wsini.ini, or using SetScreenModeEnforcement() .

This function always causes a flush of the window server buffer.

Sets the application's screen mode; this also sets all the attributes of the screen mode.

Note: although this API was added in Symbian OS v8.0, the functionality is only available from Symbian OS v8.1 onwards.

Sets the screen rotation that should be used with a particular screen size.

After calling this function, whenever you change into the screen size specified by aMode you will have the rotation aRotation. The setting remains in force until it is explicitly changed using this function.

Panics if the specified rotation is not allowed by the given screen mode.

Used for testing purposes only.

Sets the custom palette.

This function always causes a flush of the window server buffer.

Sets the screen device's palette.

This function always causes a flush of the window server buffer.

Use of this function is deprecated. SetCustomPalette() should be used instead.

Sets the current screen mode.

Note that this function is only useful for testing. This is because the screen mode normally reflects the state of real hardware, e.g. whether the cover is open or closed on a phone that supports screen flipping.

This function always causes a flush of the window server buffer.

Sets the screen mode enforcement requirements.

This global setting defines the requirements that a group window must meet to be displayed. The value may be set using this function, but is more likely to be defined in wsini.ini.

Sets the current screen size in twips and pixels, and the rotation for the screen device.

Sets the current screen size in pixels, and the rotation for the screen device.

This function always causes a flush of the window server buffer.

Gets the size of the screen device area in pixels.

This function always causes a flush of the window server buffer.

CGraphicsDevice::SizeInPixels()

Gets the size of the screen device area in twips.

This function always causes a flush of the window server buffer.

CGraphicsDevice::SizeInTwips()

Helper member fn to access the movable typeface store.

Gets typeface information for a particular typeface index number.

This information is returned in aTypefaceSupport, and includes: the typeface name and typeface attributes (in a TTypeface object), the number of font heights, the maximum and minimum font heights and whether it is a scalable typeface.

CGraphicsDevice::TypefaceSupport()

Translates a vertical dimension of a screen device in pixels into twips.

MGraphicsDeviceMap::VerticalPixelsToTwips()

Translates a vertical dimension of a screen device in twips into pixels.

Whether or not to include sprites when comparing areas of the screen