#include <graphicsaccelerator.h>
| class CGraphicsAccelerator : public CBase |
| Public Member Functions | |
|---|---|
| pure virtual const TGraphicsAcceleratorCaps * | Capabilities() |
| pure virtual TInt | Operation(const TGraphicsOperation &) |
| pure virtual TInt | Operation(const TGraphicsOperation &, TInt, TRect *) |
| pure virtual TInt | Operation(TDes8 &) |
| pure virtual TInt | Operation(TDes8 &, TInt, TRect *) |
| pure virtual void | Reserved_1() |
| pure virtual void | Reserved_2() |
| pure virtual void | Reserved_3() |
| pure virtual void | Reserved_4() |
Abstract base class for 2D graphics accelerators.
This class can be derived from to provide accelerated implementations of some common 2D graphics algorithms. Support for accelerated 2D graphics has been integrated into existing classes in the Graphics API for instance CFbsBitGc, so that existing code does not need to be altered, but a graphics accelerator can be used directly by applications. The accelerated 2D graphics operations may be implemented in software, hardware, or both.
| const TGraphicsAcceleratorCaps * | Capabilities | ( | ) | [pure virtual] |
Returns the capabilities of the graphics accelerator.
Returns: The capabilities of the accelerator.
| TInt | Operation | ( | const TGraphicsOperation & | aOperation | ) | [pure virtual] |
Requests the graphics accelerator to perform a single graphics operation.
| Parameter | Description |
|---|---|
| aOperation | An instance of a TGraphicsOperation-derived class that identifies the graphics operation to be performed. |
Returns: KErrNone if successful, otherwise one of the system error codes. The function should return KErrNotSupported if the accelerator does not support the requested operation.
| TInt | Operation | ( | const TGraphicsOperation & | aOperation, |
| TInt | aNumClipRects, | |||
| 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.
See also: TGraphicsAcceleratorCaps::iClipping
| Parameter | Description |
|---|---|
| aOperation | An instance of a TGraphicsOperation-derived class that identifies the graphics operation to be performed. |
| aNumClipRects | The number of rectangles in the clipping region. |
| aClipRects | A pointer to the first rectangle in the clipping region. |
Returns: KErrNone if successful, otherwise one of the system error codes. The function should return KErrNotSupported if the accelerator does not support the requested operation.
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()].
| Parameter | Description |
|---|---|
| aBuffer | A descriptor which holds a concatenation of graphics operations (TGraphicsOperation-derived objects). |
Returns: 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.
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()].
See also: TGraphicsAcceleratorCaps::iClipping
| Parameter | Description |
|---|---|
| aBuffer | A descriptor which holds a concatenation of graphics operations (TGraphicsOperation objects). |
| aNumClipRects | The number of rectangles in the clipping region. |
| aClipRects | A pointer to the first rectangle in the clipping region. |
Returns: 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.