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:

• CGraphicsAccelerator::Capabilities()

TClipCaps

Description

Clipping capabilities. Used by the iClipping member.

See also:

• CGraphicsAccelerator::Operation()

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

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.

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.

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.

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:

• TGopFillPattern

EPatternSizeAny There is no restriction on the dimensions of bitmap patterns.

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

TPolygonCaps

Description

Bit flags for how self-crossing polygons are filled.

See also:

• CGraphicsContext::TFillRule

EPolygonFillAlternate Only areas with odd winding numbers are filled. EPolygonFillWinding All areas with a winding number greater than zero are filled.

TInt iStructureSize;

Description

The size of this class in bytes.

TInt iVersion;

Description

The version number of the API.

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.

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:

• TDisplayMode

TUint iClipping;

Description

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

See also:

• TClipCaps

TMaskBitmapCaps iMaskType;

Description

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

See also:

• TMaskBitmapCaps

TUint iTransparency;

Description

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

See also:

• TTransparencyType

TUint iAlphaChannel;

Description

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

See also:

• TAlphaChannelCaps

TUint iAlphaBitmap;

Description

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

See also:

• TAlphaBitmapCaps

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:

• TPatternSizeCaps

TUint iPattern;

Description

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

See also:

• TPatternCaps

TUint iPolygon;

Description

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

See also:

• TPolygonCaps

TUint iReserved;

Description

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