Symbian
Symbian OS Library

SYMBIAN OS V9.3

[Index] [Spacer] [Previous] [Next]



Location: GraphicsAccelerator.h

Class TGraphicsAcceleratorCaps

class TGraphicsAcceleratorCaps;

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.

Members

Defined in TGraphicsAcceleratorCaps:
EAlpha1555, EAlpha4444, EAlpha8888, EAlphaBitmapColor16M, EAlphaBitmapGray256, EAlphaBitmapMatchingMode, EClipToBitmap, EClipping, EMaskBitmapAnyDisplayMode, EMaskBitmapGray2, EMaskBitmapMatchingDisplayMode, EMaskBitmapNone, EPatternAnyDisplayMode, EPatternMatchingDisplayMode, EPatternMustBeSquare, EPatternSizeAny, EPolygonFillAlternate, EPolygonFillWinding, TAlphaBitmapCaps, TAlphaChannelCaps, TClipCaps, TMaskBitmapCaps, TPatternCaps, TPatternSizeCaps, TPolygonCaps, iAlphaBitmap, iAlphaChannel, iClipping, iDisplayModes, iMaskType, iPattern, iPatternSizes, iPolygon, iReserved, iStructureSize, iTransparency, iVendorUid, iVersion

See also:


Member enumerations


Enum TClipCaps

TClipCaps

Description

Clipping capabilities. Used by the iClipping member.

See also:

EClipToBitmap

EClipping

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


Enum TMaskBitmapCaps

TMaskBitmapCaps

Description

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

EMaskBitmapNone

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 TAlphaChannelCaps

TAlphaChannelCaps

Description

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

EAlpha4444

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

EAlpha8888

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

EAlpha1555

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


Enum TAlphaBitmapCaps

TAlphaBitmapCaps

Description

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.

EAlphaBitmapGray256

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

EAlphaBitmapColor16M

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.

EAlphaBitmapMatchingMode

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


Enum TPatternSizeCaps

TPatternSizeCaps

Description

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:

EPatternSizeAny

There is no restriction on the dimensions of bitmap patterns.


Enum TPatternCaps

TPatternCaps

Description

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.

EPatternAnyDisplayMode

The pattern bitmap can be in any display mode.

EPatternMatchingDisplayMode

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

EPatternMustBeSquare

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


Enum TPolygonCaps

TPolygonCaps

Description

Bit flags for how self-crossing polygons are filled.

See also:

EPolygonFillAlternate

Only areas with odd winding numbers are filled.

EPolygonFillWinding

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

[Top]


Member data


iStructureSize

TInt iStructureSize;

Description

The size of this class in bytes.


iVersion

TInt iVersion;

Description

The version number of the API.


iVendorUid

TUid iVendorUid;

Description

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.


iDisplayModes

TUint iDisplayModes;

Description

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:


iClipping

TUint iClipping;

Description

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

See also:


iMaskType

TMaskBitmapCaps iMaskType;

Description

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

See also:


iTransparency

TUint iTransparency;

Description

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

See also:


iAlphaChannel

TUint iAlphaChannel;

Description

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

See also:


iAlphaBitmap

TUint iAlphaBitmap;

Description

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

See also:


iPatternSizes

TUint iPatternSizes;

Description

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:


iPattern

TUint iPattern;

Description

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

See also:


iPolygon

TUint iPolygon;

Description

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

See also:


iReserved

TUint iReserved;

Description

Four values reserved for future use. All should be set to zero.