Class CSpriteAnimation

class CSpriteAnimation : public CAnimation, public MAnimationDataProviderObserver;

Description

Implementation of CAnimation for sprite based animations.

A sprite animation displays the image using a sprite, which is a server side graphic object. This is likely to be more efficient than a basic animation, and requires slightly less work in the client application. However, it also provides less control over the actual rendering of the image.

A sprite animation must be associated with an RWindow. However, no redraw events will be generated for it by the animation, and the client application does not need to take any action once the animation has started. Holding the animation when the sprite is not visible is handled automatically on the server side.

Derivation

• MAnimationDataProviderObserver - Interface from a data provider to an animation

• CBase - Base class for all classes to be instantiated on the heap.

• CAnimation - Pure virtual base class for animations.

• CSpriteAnimation - Implementation of CAnimation for sprite based animations.

Members

Defined in CSpriteAnimation:

• CSpriteAnimation_Reserved2()Reserved for future use
• DataProvider()Provides an CSpriteAnimation DataProvider interface to the client application.
• DataProviderEventL(TInt,TAny *,TInt)Receives an event from a data provider.
• Freeze()Implements CAnimation::Freeze().
• Hold()Implements CAnimation::Hold().
• NewL(CAnimationDataProvider *,const TPoint &,MAnimationObserver *,const CCoeControl *)Two stage constructor.
• NewL(CAnimationDataProvider *,const TPoint &,RWsSession &,RWindow &,MAnimationObserver *)Two stage constructor.
• NewL(CAnimationDataProvider *,const TPoint &,RWsSession &,RWindow &,const TDesC8 &,MAnimationObserver *)Two stage constructor.
• NewL(CAnimationDataProvider *,const TPoint &,const TDesC8 &,MAnimationObserver *,const CCoeControl *)Two stage constructor.
• Pause()Implements CAnimation::Pause().
• Resume()Implements CAnimation::Resume().
• SetHostL(const CCoeControl *)
• SetPosition(const TPoint &)Implements CAnimation::SetPosition(const TPoint &).
• Size()constImplements CAnimation::Size
• Start(const TAnimationConfig &)Implements CAnimation::Start(const TAnimationConfig &).
• Stop()Implements CAnimation::Stop().
• Unfreeze()Implements CAnimation::Unfreeze().
• Unhold()Implements CAnimation::Unhold().
• ~CSpriteAnimation()Destructor.

Inherited from CBase:

• Delete(CBase *)Deletes the specified object.
• Extension_(TUint,TAny *&,TAny *)Extension function
• operator new(TUint)Allocates the object from the heap and then initialises its contents to binary z...
• operator new(TUint,TAny *)Initialises the object to binary zeroes.
• operator new(TUint,TLeave)Allocates the object from the heap and then initialises its contents to binary z...
• operator new(TUint,TLeave,TUint)Allocates the object from the heap and then initialises its contents to binary z...
• operator new(TUint,TUint)Allocates the object from the heap and then initialises its contents to binary z...

Inherited from MAnimationDataProviderObserver:

• MAnimationDataProviderObserver_Reserved1()Reserved for future use
• MAnimationDataProviderObserver_Reserved2()Reserved for future use

See also:

• CAnimationDataProviderPure virtual base class for data providers.

Related Topics

 » Symbian OS v9.4 » Examples » Application Framework example code » AnimExample: An UI application with a toolbar

• Animation example

IMPORT_C static CSpriteAnimation* NewL(CAnimationDataProvider *aDataProvider, const TPoint &aPoint, RWsSession &aWsSession, RWindow &aWindow, MAnimationObserver *aObserver=0);

Description

Two stage constructor.

This creates and returns a new sprite animation.

Parameters

CAnimationDataProvider *aDataProvider The data provider from which the animation contents will be obtained. The animation takes ownership of this object const TPoint &aPoint The starting position of the sprite in the window RWsSession &aWsSession A session with the window server RWindow &aWindow The window in which to draw the animation MAnimationObserver *aObserver An optional receiver of animation events (such as errors)

Return value

CSpriteAnimation * The new object

IMPORT_C static CSpriteAnimation* NewL(CAnimationDataProvider *aDataProvider, const TPoint &aPoint, RWsSession &aWsSession, RWindow &aWindow, const TDesC8 &aDataType, MAnimationObserver *aObserver=0);

Description

Two stage constructor.

This is identical to the other NewL except that it allows an alternative data type to be specified. Unless you are trying to use a custom animator class the other form of constructor should be used.

Parameters

CAnimationDataProvider *aDataProvider The data provider from which the animation contents will be obtained. The animation takes ownership of this object const TPoint &aPoint The starting position of the sprite in the window RWsSession &aWsSession A session with the window server RWindow &aWindow The window in which to draw the animation const TDesC8 &aDataType Overrides the data type specified by the data provider MAnimationObserver *aObserver An optional receiver of animation events (such as errors)

Return value

CSpriteAnimation * The new object

IMPORT_C static CSpriteAnimation* NewL(CAnimationDataProvider *aDataProvider, const TPoint &aPoint, MAnimationObserver *aObserver=0, const CCoeControl *aHost=0);

Description

Two stage constructor.

This creates and returns a new sprite animation.

Parameters

CAnimationDataProvider *aDataProvider The data provider from which the animation contents will be obtained. The animation takes ownership of this object const TPoint &aPoint The starting position of the sprite in the window MAnimationObserver *aObserver An optional receiver of animation events (such as errors) const CCoeControl *aHost

Return value

CSpriteAnimation * The new object

IMPORT_C static CSpriteAnimation* NewL(CAnimationDataProvider *aDataProvider, const TPoint &aPoint, const TDesC8 &aDataType, MAnimationObserver *aObserver=0, const CCoeControl *aHost=0);

Description

Two stage constructor.

This is identical to the other NewL except that it allows an alternative data type to be specified. Unless you are trying to use a custom animator class the other form of constructor should be used.

Parameters

CAnimationDataProvider *aDataProvider The data provider from which the animation contents will be obtained. The animation takes ownership of this object const TPoint &aPoint The starting position of the sprite in the window const TDesC8 &aDataType Overrides the data type specified by the data provider MAnimationObserver *aObserver An optional receiver of animation events (such as errors) const CCoeControl *aHost

Return value

CSpriteAnimation * The new object

IMPORT_C ~CSpriteAnimation();

Description

Destructor.

IMPORT_C TSize Size() const;

Description

Implements CAnimation::Size

Return value

TSize

inline CAnimationDataProvider* DataProvider();

Description

Provides an CSpriteAnimation DataProvider interface to the client application.

Return value

CAnimationDataProvider * iDataProvider A CAnimationDataProvider

virtual void Start(const TAnimationConfig &aConfig);

Description

Implements CAnimation::Start(const TAnimationConfig &).

Parameters

const TAnimationConfig &aConfig Specifies run time attributes of the animation

virtual void Stop();

Description

Implements CAnimation::Stop().

virtual void Pause();

Description

Implements CAnimation::Pause().

virtual void Resume();

Description

Implements CAnimation::Resume().

virtual void Hold();

Description

Implements CAnimation::Hold().

virtual void Unhold();

Description

Implements CAnimation::Unhold().

virtual void SetPosition(const TPoint &aPoint);

Description

Implements CAnimation::SetPosition(const TPoint &).

Parameters

const TPoint &aPoint The new coordinates of the animation (usually the top left corner)

virtual void Freeze();

Description

Implements CAnimation::Freeze().

virtual void Unfreeze();

Description

Implements CAnimation::Unfreeze().

IMPORT_C virtual void SetHostL(const CCoeControl *aHost);

Description

Parameters

const CCoeControl *aHost

protected: virtual void CSpriteAnimation_Reserved2();

Description

Reserved for future use

private: virtual void DataProviderEventL(TInt aEvent, TAny *aData, TInt aDataSize);

Description

Receives an event from a data provider.

Parameters

TInt aEvent The event code. TAny *aData Any data associated with the event. Can be NULL. TInt aDataSize The size in bytes of the item pointed to by aData.