Symbian
 Developer Library

DEVELOPER LIBRARY

[Index] [Glossary] [Previous] [Next]



Location: bmpancli.h
Link against: bmpanim.lib

Class RBitmapAnim

class RBitmapAnim : public RAnim

Support

Supported from 6.0

Description

Enables a client to package animation data, and send it to the window server for display.

Before using RBitmapAnim, a client must instantiate an RAnimDll. This provides a reference to the window server DLL that runs the animation specified through the RBitmapAnim() object. To complete construction, call ConstructL().

Derivation

RAnimClient-side handle to a server-side animation class
RBitmapAnimEnables a client to package animation data, and send it to the window server for display

Defined in RBitmapAnim:
ConstructL(), DisplayFrameL(), RBitmapAnim(), SetAttributesL(), SetBackgroundFrameL(), SetBitmapAnimDataL(), SetFlashL(), SetFrameArrayL(), SetFrameIntervalL(), SetFrameL(), SetNumberOfCyclesL(), SetPlayModeL(), SetPositionL(), StartL(), StopL()

Inherited from RAnim:
Close(), Command(), CommandReply(), Construct(), Destroy()


Construction and destruction


RBitmapAnim()

RBitmapAnim(RAnimDll& aAnimDll);

Description

Constructor.

Parameters

RAnimDll& aAnimDll

A reference to the DLL that runs the animation


ConstructL()

void ConstructL(const RWindowBase& aWindow);

Description

Completes construction of an animation object.

This must be done after calling RBitmapAnim(), and before an application attempts any other communication with the server.

Parameters

const RWindowBase& aWindow

A reference to the container control window that will hold the animation.

[Top]


Member functions


DisplayFrameL()

void DisplayFrameL(TInt aIndex);

Description

Sets the animation frame to display.

How this visually appears depends on whether the animation is already running:

Parameters

TInt aIndex

The frame to display.


SetBitmapAnimDataL()

void SetBitmapAnimDataL(const CBitmapAnimClientData& aBitmapAnimData);

Description

Specifies the animation object to play and sends it to the animation server.

To start the animation, you must subsequently call StartL().

Parameters

const CBitmapAnimClientData& aBitmapAnimData

The animation object to play


SetFlashL()

void SetFlashL(TBool aFlash);

Description

Sets or unsets the animation to be drawn flashing.

Parameters

TBool aFlash

ETrue to draw the animation flashing, otherwise EFalse.


SetFrameIntervalL()

void SetFrameIntervalL(TInt aFrameIntervalInMilliSeconds);

Description

Specifies the number of milliseconds for which each frame in the animation is displayed.

This is not used for any frames in the animation that specify their own interval.

Parameters

TInt aFrameIntervalInMilliSeconds

The number of milliseconds for which each frame in the animation is displayed


SetPlayModeL()

void SetPlayModeL(CBitmapAnimClientData::TPlayMode aPlayMode);

Description

Sets the current animation's play mode.

Parameters

CBitmapAnimClientData::TPlayMode aPlayMode

The animation's play mode.


StartL()

void StartL();

Description

Starts the animation.

You must first specify an animation with SetBitmapAnimDataL().

If you have specified CBitmapAnimClientData::ECycle or CBitmapAnimClientData::EBounce as the animation's play mode, but have not specified the number of cycles using SetNumberOfCyclesL(), you must call StopL() to stop the animation.


StopL()

void StopL();

Description

Stops the animation.


SetNumberOfCyclesL()

void SetNumberOfCyclesL(TInt aNumberOfCycles);

Description

Sets how many times the animation is played.

If the play mode is CBitmapAnimClientData::EBounce, the number of cycles must be at least two to ensure a complete animation routine is played.

Parameters

TInt aNumberOfCycles

The number of times to play the animation.


SetPositionL()

void SetPositionL(TPoint aPosition);

Description

Sets the animation's position relative to the animation window.

Parameters

TPoint aPosition

The animation's position relative to the animation window

[Top]


Internal members


SetAttributesL()

private: void SetAttributesL(const CBitmapAnimClientData& aBitmapAnimData);

Description

This member is internal and not intended for use.


SetBackgroundFrameL()

private: void SetBackgroundFrameL(const CBitmapFrameData& aFrame);

Description

This member is internal and not intended for use.


SetFrameArrayL()

private: void SetFrameArrayL(const CArrayPtrFlat<CBitmapFrameData>& aFrameArray);

Description

This member is internal and not intended for use.


SetFrameL()

private: void SetFrameL(const CBitmapFrameData& aFrame, TInt aOpCode);

Description

This member is internal and not intended for use.