Symbian^3 Application Developer Library >

CHardwareGraphicsAccelerator Class Reference

class CHardwareGraphicsAccelerator : public CGraphicsAccelerator

A factory for creating 2D graphics accelerator objects whose graphics operations are implemented in hardware, software or a mixture of both.

Objects of derived classes can only write to hardware bitmaps ( RHardwareBitmap ). Note that graphics accelerators may support only a subset of all graphics operations.

RHardwareBitmap

Inherits from

Public Member Functions
const TGraphicsAcceleratorCaps * Capabilities ()
IMPORT_C const TGraphicsAcceleratorCaps * GenericCapabilities ()
IMPORT_C CHardwareGraphicsAccelerator * NewL ( RHardwareBitmap )
TInt Operation (const TGraphicsOperation &)
TInt Operation (const TGraphicsOperation &, TInt , TRect *)
TInt Operation ( TDes8 &)
TInt Operation ( TDes8 &, TInt , TRect *)
void Reserved_1 ()
void Reserved_2 ()
void Reserved_3 ()
void Reserved_4 ()
Inherited Functions
CBase::CBase()
CBase::Delete(CBase *)
CBase::Extension_(TUint,TAny *&,TAny *)
CBase::operator new(TUint)
CBase::operator new(TUint,TAny *)
CBase::operator new(TUint,TLeave)
CBase::operator new(TUint,TLeave,TUint)
CBase::operator new(TUint,TUint)
CBase::~CBase()

Member Functions Documentation

Capabilities()

const TGraphicsAcceleratorCaps * Capabilities ( ) [pure virtual]

Returns the capabilities of the graphics accelerator.

GenericCapabilities()

IMPORT_C const TGraphicsAcceleratorCaps * GenericCapabilities ( ) [static]

Gets the generic capabilities of the accelerator, including the supported display modes for the bitmap passed to NewL() .

Do not use, link against scdv.lib.

NewL(RHardwareBitmap)

IMPORT_C CHardwareGraphicsAccelerator * NewL ( RHardwareBitmap aBitmap ) [static]

Create a new CHardwareGraphicsAccelerator for use with a given hardware bitmap.

Do not use, link against scdv.lib.

Parameters

RHardwareBitmap aBitmap A bitmap that can be drawn by graphics acceleration hardware. It can be any bitmap.

Operation(const TGraphicsOperation &)

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

Requests the graphics accelerator to perform a single graphics operation.

Parameters

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

Operation(const TGraphicsOperation &, TInt, TRect *)

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.

TGraphicsAcceleratorCaps::iClipping

Parameters

const TGraphicsOperation & aOperation An instance of a TGraphicsOperation-derived class that identifies the graphics operation to be performed.
TInt aNumClipRects The number of rectangles in the clipping region.
TRect * aClipRects A 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()].

Parameters

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

Operation(TDes8 &, TInt, TRect *)

TInt Operation ( TDes8 & aBuffer,
TInt aNumClipRects,
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()].

TGraphicsAcceleratorCaps::iClipping

Parameters

TDes8 & aBuffer A descriptor which holds a concatenation of graphics operations (TGraphicsOperation objects).
TInt aNumClipRects The number of rectangles in the clipping region.
TRect * aClipRects A pointer to the first rectangle in the clipping region.

Reserved_1()

void Reserved_1 ( ) [pure virtual]

Reserved_2()

void Reserved_2 ( ) [pure virtual]

Reserved_3()

void Reserved_3 ( ) [pure virtual]

Reserved_4()

void Reserved_4 ( ) [pure virtual]

Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License v1.0.