CEGUI::AnimationInstance Class Reference

Defines an 'animation instance' class. More...

Collaboration diagram for CEGUI::AnimationInstance:

Public Member Functions
	AnimationInstance (Animation *definition)
	internal constructor, please use AnimationManager::instantiateAnimation
	~AnimationInstance (void)
Animation *	getDefinition () const
	Retrieves the animation definition that is used in this instance.
void	setTarget (PropertySet *target)
	Sets the target property set - this class will get it's properties affected by the Affectors!
PropertySet *	getTarget () const
	Retrieves the target property set.
void	setEventReceiver (EventSet *receiver)
	Sets event receiver - this class will receive events when something happens to the playback of this animation - it starts, stops, pauses, unpauses, ends and loops.
EventSet *	getEventReceiver () const
	Retrieves the event receiver.
void	setEventSender (EventSet *sender)
	Sets event sender - this class will send events and can affect this animation instance if there are any auto subscriptions defined in the animation definition.
EventSet *	getEventSender () const
	Retrieves the event sender.
void	setTargetWindow (Window *target)
	Helper method, sets given window as target property set, event receiver and event set.
void	setPosition (float position)
	Sets playback position. Has to be higher or equal to 0.0 and lower or equal to Animation definition's duration.
float	getPosition () const
	Retrieves current playback position.
void	setSpeed (float speed)
	Sets playback speed - you can speed up / slow down individual instances of the same animation. 1.0 means normal playback.
float	getSpeed () const
	Retrieves current playback speed.
void	start ()
	Starts this animation instance - sets position to 0.0 and unpauses. More...
void	stop ()
	Stops this animation instance - sets position to 0.0 and pauses.
void	pause ()
	Pauses this animation instance - stops it from stepping forward.
void	unpause ()
	Unpauses this animation instance - allows it to step forward again.
void	togglePause ()
	Pauses the animation if it's running and unpauses it if it isn't.
bool	isRunning () const
	Returns true if this animation instance is currently unpaused, if it is stepping forward.
void	step (float delta)
	Internal method, steps the animation forward by the given delta.
bool	handleStart (const CEGUI::EventArgs &e)
	handler that starts the animation instance
bool	handleStop (const CEGUI::EventArgs &e)
	handler that stops the animation instance
bool	handlePause (const CEGUI::EventArgs &e)
	handler that pauses the animation instance
bool	handleUnpause (const CEGUI::EventArgs &e)
	handler that unpauses the animation instance
bool	handleTogglePause (const CEGUI::EventArgs &e)
	handler that toggles pause on this animation instance
void	savePropertyValue (const String &propertyName)
	Internal method, saves given property (called before it's affected)
void	purgeSavedPropertyValues (void)
const String &	getSavedPropertyValue (const String &propertyName)
void	addAutoConnection (Event::Connection conn)
	Internal method, adds reference to created auto connection. More...
void	unsubscribeAutoConnections ()
	Internal method, unsubscribes auto connections. More...

Static Public Attributes
static const String	EventNamespace
static const String	EventAnimationStarted
	fired when animation instance starts
static const String	EventAnimationStopped
	fired when animation instance stops
static const String	EventAnimationPaused
	fired when animation instance pauses
static const String	EventAnimationUnpaused
	fired when animation instance unpauses
static const String	EventAnimationEnded
	fired when animation instance ends
static const String	EventAnimationLooped
	fired when animation instance loops

Detailed Description

Defines an 'animation instance' class.

Animation classes hold definition of the animation. Whilst this class holds
data needed to use the animation definition - target PropertySet, event
receiver, animation position, ...

You have to define animation first and then instantiate it via
AnimationManager::instantiateAnimation

See Also

Animation

Constructor & Destructor Documentation

CEGUI::AnimationInstance::~AnimationInstance

(

void

)

internal destructor, please use AnimationManager::destroyAnimationInstance

Member Function Documentation

void CEGUI::AnimationInstance::addAutoConnection

(

Event::Connection

conn

)

Internal method, adds reference to created auto connection.

DO NOT USE THIS DIRECTLY

const String& CEGUI::AnimationInstance::getSavedPropertyValue

(

const String &

propertyName

)

retrieves saved value, if it isn't cached already, it retrieves it fresh from the properties

void CEGUI::AnimationInstance::purgeSavedPropertyValues

(

void

)

this purges all saved values forcing this class to gather new ones fresh from the properties

void CEGUI::AnimationInstance::start

(

)

Starts this animation instance - sets position to 0.0 and unpauses.

This also causes base values to be purged!

void CEGUI::AnimationInstance::unsubscribeAutoConnections

(

)

Internal method, unsubscribes auto connections.

DO NOT USE THIS DIRECTLY

Member Data Documentation

const String CEGUI::AnimationInstance::EventNamespace

static

Namespace for animation instance events these are fired on event receiver, not this animation instance!