#include <graphicsaccelerator.h>
| class CSoftwareGraphicsAccelerator : public CGraphicsAccelerator |
| Public Member Functions | |
|---|---|
| pure virtual const TGraphicsAcceleratorCaps * | Capabilities() |
| IMPORT_C const TGraphicsAcceleratorCaps * | GenericCapabilities() |
| IMPORT_C CSoftwareGraphicsAccelerator * | NewL(CFbsBitmap *) |
| 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() |
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.
| const TGraphicsAcceleratorCaps * | Capabilities | ( | ) | [pure virtual] |
Reimplemented from CGraphicsAccelerator::Capabilities()
Returns the capabilities of the graphics accelerator.
Returns: The capabilities of the accelerator.
| IMPORT_C const TGraphicsAcceleratorCaps * | GenericCapabilities | ( | ) | [static] |
Gets the generic capabilities of the accelerator, including which display modes are supported for the bitmap passed to NewL().
Generic capabilities apply to all software graphics accelerators on the device. The function is static, so it can be used to find out the capabilities of graphics accelerators before deciding on whether or not to create one.
The CGraphicsAccelerator::Capabilities() function provides information about the capabilities of a particular graphics accelerator.
As capabilities may vary depending on the display mode of a bitmap, this method should indicate as supported any features which are only available in some display modes.
Returns: Generic capabilities for software graphics accelerators.
| IMPORT_C CSoftwareGraphicsAccelerator * | NewL | ( | CFbsBitmap * | aBitmap | ) | [static] |
Allocates and constructs an instance of a derived class and initialises its capabilities.
See also: TGraphicsAcceleratorCaps::iDisplayModes
| Parameter | Description |
|---|---|
| aBitmap | The bitmap for the accelerator to draw to. This may be any type of bitmap, including a hardware bitmap. |
Returns: Pointer to the initialised graphics accelerator object.
| TInt | Operation | ( | const TGraphicsOperation & | aOperation | ) | [pure virtual] |
Reimplemented from CGraphicsAccelerator::Operation(const TGraphicsOperation &)
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] | |||
Reimplemented from CGraphicsAccelerator::Operation(const TGraphicsOperation &,TInt,TRect *)
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.
Reimplemented from CGraphicsAccelerator::Operation(TDes8 &)
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.
Reimplemented from CGraphicsAccelerator::Operation(TDes8 &,TInt,TRect *)
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.