CSoftwareGraphicsAccelerator Class Reference

class CSoftwareGraphicsAccelerator : public CGraphicsAccelerator

A factory for creating 2D graphics accelerator objects whose graphics operations are implemented in software.

Objects of derived classes can write to all types of bitmap, not just hardware bitmaps. Note that graphics accelerators may support only a subset of all graphics operations.

Inherits from

Member Functions Documentation

Capabilities()

const TGraphicsAcceleratorCaps *Capabilities()[pure virtual]

Returns the capabilities of the graphics accelerator.

The capabilities of the accelerator.

GenericCapabilities()

IMPORT_C const TGraphicsAcceleratorCaps *GenericCapabilities()[static]

NewL(CFbsBitmap *)

IMPORT_C CSoftwareGraphicsAccelerator *NewL(CFbsBitmap *aBitmap)[static]

Parameters

CFbsBitmap * aBitmap

Operation(const TGraphicsOperation &)

TInt Operation(const TGraphicsOperation &aOperation)[pure virtual]

Requests the graphics accelerator to perform a single graphics operation.

KErrNone if successful, otherwise one of the system error codes. The function should return KErrNotSupported if the accelerator does not support the requested operation.

Parameters

const TGraphicsOperation & aOperationAn instance of a TGraphicsOperation-derived class that identifies the graphics operation to be performed.

Operation(const TGraphicsOperation &, TInt, TRect *)

TInt Operation(const TGraphicsOperation &aOperation,
TIntaNumClipRects,
TRect *aClipRects
)[pure virtual]

Requests the graphics accelerator perform a single graphics operation within a clipping region. This version is of Operation() is only usable if the accelerator capabilities returned by Capabilities() indicate that clipping to a region is supported.

KErrNone if successful, otherwise one of the system error codes. The function should return KErrNotSupported if the accelerator does not support the requested operation.

TGraphicsAcceleratorCaps::iClipping

Parameters

const TGraphicsOperation & aOperationAn instance of a TGraphicsOperation-derived class that identifies the graphics operation to be performed.
TInt aNumClipRectsThe number of rectangles in the clipping region.
TRect * aClipRectsA pointer to the first rectangle in the clipping region.

Operation(TDes8 &)

TInt Operation(TDes8 &aBuffer)[pure virtual]

Requests the graphics accelerator perform one or more graphics operations contained in a buffer.

The underlying implementation may be able to process a group of graphics operations more efficiently than if Operation() was called for each individually.

This function should be implemented as if Operation() was called in turn for each operation contained in the buffer. Each operation should be carried out immediately after the one preceding it. If a method returns an error, the length of aBuffer should be set to indicate the number of operations that have been successfully processed. In this case, the operation in which the error occurred will be indicated by the memory address &aBuffer[aBuffer.Length()].

KErrNone if successful, otherwise one of the system error codes. The function should return KErrNotSupported if the accelerator does not support any of the requested operations.

Parameters

TDes8 & aBufferA descriptor which holds a concatenation of graphics operations (TGraphicsOperation-derived objects).

Operation(TDes8 &, TInt, TRect *)

TInt Operation(TDes8 &aBuffer,
TIntaNumClipRects,
TRect *aClipRects
)[pure virtual]

Requests the graphics accelerator perform one or more graphics operations within a clipping region. This version is of Operation() is only usable if the accelerator capabilities returned by Capabilities() indicate that clipping to a region is supported.

The underlying implementation may be able to process a group of graphics operations more efficiently than if Operation() was called for each individually.

This function should be implemented as if Operation() was called in turn for each operation contained in the buffer. Each operation should be carried out immediately after the one preceding it. If a method returns an error, the length of aBuffer should be set to indicate the number of operations that have been successfully processed. In this case, the operation in which the error occurred will be indicated by the memory address &aBuffer[aBuffer.Length()].

KErrNone if successful, otherwise one of the system error codes. The function should return KErrNotSupported if the accelerator does not support any of the requested operations.

TGraphicsAcceleratorCaps::iClipping

Parameters

TDes8 & aBufferA descriptor which holds a concatenation of graphics operations (TGraphicsOperation objects).
TInt aNumClipRectsThe number of rectangles in the clipping region.
TRect * aClipRectsA pointer to the first rectangle in the clipping region.

Reserved_1()

voidReserved_1()[pure virtual]

Reserved_2()

voidReserved_2()[pure virtual]

Reserved_3()

voidReserved_3()[pure virtual]

Reserved_4()

voidReserved_4()[pure virtual]