TGraphicsAcceleratorCaps Class Reference

#include <graphicsaccelerator.h>

class TGraphicsAcceleratorCaps

Detailed Description

Stores the capabilities of a graphics accelerator.

All of the member enums except TMaskBitmapCaps define flags that are stored as public data of type TUint. Only TMaskBitmapCaps takes sequential values, so its values are mutually exclusive.

An object of this class is returned by CGraphicsAccelerator::Capabilities() or by GenericCapabilities(), which is implemented by CSoftwareGraphicsAccelerator and CHardwareGraphicsAccelerator.

See also: CGraphicsAccelerator::Capabilities()

Member Attribute Documentation

iAlphaBitmap

TUint iAlphaBitmap

Specifies the supported alpha bitmap types. Uses a bit flag for each TAlphaBitmapCaps supported.

See also: TAlphaBitmapCaps

iAlphaChannel

TUint iAlphaChannel

Specifies the capabilities relating to operations that use an alpha channel. Uses a bit flag for each TAlphaChannelCaps supported.

See also: TAlphaChannelCaps

iClipping

TUint iClipping

Indicates whether the Operation() methods which take clipping rectangles as parameters are supported.

See also: TClipCaps

iDisplayModes

TUint iDisplayModes

A bit mask of the supported display modes for the bitmap passed to the graphics accelerator's NewL(). Uses the least significant 11 bits as flags for each TDisplayMode supported. For instance, to check whether the EColor256 display mode is available, use the expression iDisplayModes & (1 << EColor256).

See also: TDisplayMode

iMaskType

TMaskBitmapCaps iMaskType

Specifies the display mode restrictions for bitmap masks. These are mutually exclusive values.

See also: TMaskBitmapCaps

iPattern

TUint iPattern

Specifies the supported bitmap types for fill patterns. Uses a bit flag for each TPatternCaps supported.

See also: TPatternCaps

iPatternSizes

TUint iPatternSizes

Specifies the sizes of bitmaps that can be used in bitmap patterns.

This is a bitmask for each power of 2, or EPatternSizeAny. For example, if bitmaps used in patterns can only have a width or height of 16 pixels then this value should be set to 16. If patterns can have dimensions of 16, 32, 64, 128 or 256, then this value would equal the sum of these, (i.e. bits 4, 5, 6, 7 and 8 would be set). If this value is equal to EPatternSizeAny, there are no restrictions on the size of patterns that can be used.

See also: TPatternSizeCaps

iPolygon

TUint iPolygon

Specifies the supported fill rules for self crossing polygons. Uses a bit flag for each TPolygonCaps supported.

See also: TPolygonCaps

iReserved

TUint iReserved

iReserved[0] specifies the supported rendering orientations.Uses a bit flags for each TOrientationCaps supported.

See also: TOrientationCaps iReserved[1]-iReserved[3] are reserved for future use. All should be set to zero.

iStructureSize

TInt iStructureSize

The size of this class in bytes.

iTransparency

TUint iTransparency

Specifies the transparency types supported. Uses a bit flag for each TTransparencyType supported.

See also: TTransparencyType

iVendorUid

TUid iVendorUid

Optional UID to identify the vendor of the graphics accelerator. This UID can be used to recognise a particular accelerator, enabling code to use any custom graphics operations and capabilities that it knows the accelerator provides.

iVersion

TInt iVersion

The version number of the API.

Member Enumeration Documentation

Enum TAlphaBitmapCaps

Bit flags for the capabilities relating to operations which take an alpha bitmap parameter, for instance TGopBitBltAlphaBitmap. These flags are used by the iAlphaBitmap member.

EnumeratorValueDescription
EAlphaBitmapGray2561

For 256 greyscale bitmaps, the value of each pixel in the alpha bitmap (from 0 to 255) is used as the alpha value.

EAlphaBitmapColor16M2

An EColor16M bitmap may be used as the alpha bitmap. The red, green and blue values for each pixel in this bitmap are used as the alpha values for the red, green and blue components of the corresponding pixel in the source bitmap.

EAlphaBitmapMatchingMode4

The alpha bitmap must have the same display mode as the source bitmap.

Enum TAlphaChannelCaps

Bit flags for the capabilities relating to operations that use an alpha channel (TGopBitBltAlphaChannel and TGopScaledBitBltAlphaChannel). These flags are used by the iAlphaChannel member.

EnumeratorValueDescription
EAlpha44441

The accelerator can draw bitmaps with 4 bits each for the alpha value and the red, green and blue components.

EAlpha88882

The accelerator can draw bitmaps with 8 bits each for the alpha value and the red, green and blue components.

EAlpha15554

The accelerator can draw bitmaps with 1 bit for the alpha value and and 5 bits for the red, green and blue components.

Enum TClipCaps

Clipping capabilities. Used by the iClipping member.

See also: CGraphicsAccelerator::Operation()

EnumeratorValueDescription
EClipToBitmap1
EClipping2

The accelerator supports the Operation() methods which take clipping rectangles as parameters.

See also: CGraphicsAccelerator::Operation()

Enum TMaskBitmapCaps

Enumerates the capabilities relating to operations taking a bitmap mask parameter, for instance TGopBitBltMasked. These are mutually exclusive values used by the iMaskType member.

EnumeratorValueDescription
EMaskBitmapNone0

No masked operations are supported.

EMaskBitmapAnyDisplayMode

The mask bitmap can be in any display mode at all.

EMaskBitmapMatchingDisplayMode

The mask bitmap must be in the same display mode as the destination bitmap.

EMaskBitmapGray2

The mask bitmap must be in EGray2 display mode.

Enum TOrientationCaps

Bit flags for the specifying the supported rendering orientations.

See also: CFbsBitGc::TGraphicsOrientation

EnumeratorValueDescription
EOrientationCapNormal1

Normal orientation is supported.

EOrientationCapRotated902

A 90 degree rotation is supported.

EOrientationCapRotated1804

A 180 degree rotation is supported.

EOrientationCapRotated2708

A 270 degree rotation is supported.

EOrientationCapAllEOrientationCapNormal|EOrientationCapRotated90|EOrientationCapRotated180|EOrientationCapRotated270

All orientations are supported.

Enum TPatternCaps

Bit flags for the capabilities relating to operations that draw a fill pattern using a bitmap, for instance TGopFilledRectWithPatern. They are used in the iPattern member.

EnumeratorValueDescription
EPatternAnyDisplayMode1

The pattern bitmap can be in any display mode.

EPatternMatchingDisplayMode2

The pattern bitmap must be in the same display mode as the destination.

EPatternMustBeSquare4

The pattern bitmap must be square (width==height).

Enum TPatternSizeCaps

Indicates whether there is a restriction on the sizes of bitmaps that can be used in bitmap patterns.

This is one of the possible values for the iPatternSizes member.

See also: TGopFillPattern

EnumeratorValueDescription
EPatternSizeAny0xFFFFFFFF

There is no restriction on the dimensions of bitmap patterns.

Enum TPolygonCaps

Bit flags for how self-crossing polygons are filled.

See also: CGraphicsContext::TFillRule

EnumeratorValueDescription
EPolygonFillAlternate1

Only areas with odd winding numbers are filled.

EPolygonFillWinding2

All areas with a winding number greater than zero are filled.

See also: CGraphicsContext::TFillRule