Inherits CEGUI::Singleton< AnimationManager >, CEGUI::AllocatedObject< AnimationManager >, CEGUI::Singleton< AnimationManager >, and CEGUI::AllocatedObject< AnimationManager >.

Collaboration diagram for CEGUI::AnimationManager:

Public Member Functions
	AnimationManager (void)
	Constructs a new AnimationManager object. More...

	~AnimationManager (void)
	Destructor for AnimationManager objects. More...

void	addInterpolator (Interpolator *interpolator)
	Adds interpolator to be available for Affectors. More...

void	removeInterpolator (Interpolator *interpolator)
	Removes interpolator.

Interpolator *	getInterpolator (const String &type) const
	Retrieves interpolator by type.

Animation *	createAnimation (const String &name="")
	Creates a new Animation definition. More...

void	destroyAnimation (Animation *animation)
	Destroys given animation definition.

void	destroyAnimation (const String &name)
	Destroys given animation definition by name.

void	destroyAllAnimations ()
	Destroys all animations in existence!

Animation *	getAnimation (const String &name) const
	Retrieves animation by name.

bool	isAnimationPresent (const String &name) const
	Examines the list of Animations to see if one exists with the given name. More...

Animation *	getAnimationAtIdx (size_t index) const
	Retrieves animation by index.

size_t	getNumAnimations () const
	Retrieves number of defined animations.

AnimationInstance *	instantiateAnimation (Animation *animation)
	Instantiates given animation. More...

AnimationInstance *	instantiateAnimation (const String &name)
	Instantiates given animation by name. More...

void	destroyAnimationInstance (AnimationInstance *instance)
	Destroys given animation instance.

void	destroyAllInstancesOfAnimation (Animation *animation)
	Destroys all instances of given animation.

void	destroyAllAnimationInstances ()
	Destroys all instances of all animations.

AnimationInstance *	getAnimationInstanceAtIdx (size_t index) const
	Retrieves animation instance at given index.

size_t	getNumAnimationInstances () const
	Retrieves number of animation instances, number of times any animation was instantiated.

void	autoStepInstances (float delta)
	Internal method, gets called by CEGUI::System automatically. More...

void	loadAnimationsFromXML (const String &filename, const String &resourceGroup="")
	Parses an XML file containing animation specifications to create and initialise Animation objects. More...

void	loadAnimationsFromString (const String &source)
	Parses XML source containing animation specifications to create and initialise Animation objects. More...

void	writeAnimationDefinitionToStream (const Animation &animation, OutStream &out_stream) const
	Writes given animation definition to the given OutStream. More...

String	getAnimationDefinitionAsString (const Animation &animation) const
	Writes given animation definition and returns the result as String. More...

	AnimationManager (void)
	Constructs a new AnimationManager object. More...

	~AnimationManager (void)
	Destructor for AnimationManager objects. More...

void	addInterpolator (Interpolator *interpolator)
	Adds interpolator to be available for Affectors. More...

void	removeInterpolator (Interpolator *interpolator)
	Removes interpolator.

Interpolator *	getInterpolator (const String &type) const
	Retrieves interpolator by type.

Animation *	createAnimation (const String &name="")
	Creates a new Animation definition. More...

void	destroyAnimation (Animation *animation)
	Destroys given animation definition.

void	destroyAnimation (const String &name)
	Destroys given animation definition by name.

void	destroyAllAnimations ()
	Destroys all animations in existence!

Animation *	getAnimation (const String &name) const
	Retrieves animation by name.

bool	isAnimationPresent (const String &name) const
	Examines the list of Animations to see if one exists with the given name. More...

Animation *	getAnimationAtIdx (size_t index) const
	Retrieves animation by index.

size_t	getNumAnimations () const
	Retrieves number of defined animations.

AnimationInstance *	instantiateAnimation (Animation *animation)
	Instantiates given animation. More...

AnimationInstance *	instantiateAnimation (const String &name)
	Instantiates given animation by name. More...

void	destroyAnimationInstance (AnimationInstance *instance)
	Destroys given animation instance.

void	destroyAllInstancesOfAnimation (Animation *animation)
	Destroys all instances of given animation.

void	destroyAllAnimationInstances ()
	Destroys all instances of all animations.

AnimationInstance *	getAnimationInstanceAtIdx (size_t index) const
	Retrieves animation instance at given index.

size_t	getNumAnimationInstances () const
	Retrieves number of animation instances, number of times any animation was instantiated.

void	autoStepInstances (float delta)
	Internal method, gets called by CEGUI::System automatically. More...

void	loadAnimationsFromXML (const String &filename, const String &resourceGroup="")
	Parses an XML file containing animation specifications to create and initialise Animation objects. More...

void	loadAnimationsFromString (const String &source)
	Parses XML source containing animation specifications to create and initialise Animation objects. More...

void	writeAnimationDefinitionToStream (const Animation &animation, OutStream &out_stream) const
	Writes given animation definition to the given OutStream. More...

String	getAnimationDefinitionAsString (const Animation &animation) const
	Writes given animation definition and returns the result as String. More...

Static Public Member Functions
static void	setDefaultResourceGroup (const String &resourceGroup)
	Sets the default resource group to be used when loading animation xml data. More...

static const String &	getDefaultResourceGroup ()
	Returns the default resource group currently set for loading animation xml data. More...

static void	setDefaultResourceGroup (const String &resourceGroup)
	Sets the default resource group to be used when loading animation xml data. More...

static const String &	getDefaultResourceGroup ()
	Returns the default resource group currently set for loading animation xml data. More...

Static Public Member Functions inherited from CEGUI::Singleton< AnimationManager >
static AnimationManager &	getSingleton (void)

static AnimationManager &	getSingleton (void)

static AnimationManager *	getSingletonPtr (void)

static AnimationManager *	getSingletonPtr (void)

Static Public Attributes
static const String	XMLSchemaName
	Name of the schema used for loading animation xml files.

Additional Inherited Members
Static Protected Attributes inherited from CEGUI::Singleton< AnimationManager >
static AnimationManager *	ms_Singleton

Constructor & Destructor Documentation

CEGUI::AnimationManager::AnimationManager ( void )

Constructs a new AnimationManager object.

NB: Client code should not create AnimationManager objects - they are of limited use to you! The intended pattern of access is to get a pointer to the GUI system's AnimationManager via the System object, and use that.

CEGUI::AnimationManager::~AnimationManager ( void )

Destructor for AnimationManager objects.

This will properly destroy all remaining AnimationInstance and Animation objects.

References destroyAllAnimations().

CEGUI::AnimationManager::AnimationManager ( void )

Constructs a new AnimationManager object.

NB: Client code should not create AnimationManager objects - they are of limited use to you! The intended pattern of access is to get a pointer to the GUI system's AnimationManager via the System object, and use that.

CEGUI::AnimationManager::~AnimationManager ( void )

Destructor for AnimationManager objects.

This will properly destroy all remaining AnimationInstance and Animation objects.

Member Function Documentation

void CEGUI::AnimationManager::addInterpolator ( Interpolator * interpolator )

Adds interpolator to be available for Affectors.

: CEGUI ships with several basic interpolators that are always available, float, bool, colour, UDim, UVector2, ... but you can add your own custom interpolator if needed! just note that AnimationManager only deletes inbuilt interpolators. It will remove your interpolator if you don't do it yourself, but you definitely have to delete it yourself!

References CEGUI::Interpolator::getType().

void CEGUI::AnimationManager::addInterpolator ( Interpolator * interpolator )

Adds interpolator to be available for Affectors.

: CEGUI ships with several basic interpolators that are always available, float, bool, colour, UDim, UVector2, ... but you can add your own custom interpolator if needed! just note that AnimationManager only deletes inbuilt interpolators. It will remove your interpolator if you don't do it yourself, but you definitely have to delete it yourself!

void CEGUI::AnimationManager::autoStepInstances ( float delta )

Internal method, gets called by CEGUI::System automatically.

Only use if you know what you're doing!

: Steps animation instances with auto stepping enabled forward by given delta.

void CEGUI::AnimationManager::autoStepInstances ( float delta )

Internal method, gets called by CEGUI::System automatically.

Only use if you know what you're doing!

: Steps animation instances with auto stepping enabled forward by given delta.

Animation * CEGUI::AnimationManager::createAnimation ( const String & name = "" )

Creates a new Animation definition.

See also: Animation

References CEGUI::String::empty(), and isAnimationPresent().

Animation* CEGUI::AnimationManager::createAnimation ( const String & name = "" )

Creates a new Animation definition.

See also: Animation

String CEGUI::AnimationManager::getAnimationDefinitionAsString ( const Animation & animation ) const

Writes given animation definition and returns the result as String.

Parameters

animation Animation definition to write

Warning: This is a convenience function and isn't designed to be fast at all! Use the other alternatives if you want performance.

Returns: String containing the resulting XML

References writeAnimationDefinitionToStream().

String CEGUI::AnimationManager::getAnimationDefinitionAsString ( const Animation & animation ) const

Writes given animation definition and returns the result as String.

Parameters

animation Animation definition to write

Warning: This is a convenience function and isn't designed to be fast at all! Use the other alternatives if you want performance.

Returns: String containing the resulting XML

static const String& CEGUI::AnimationManager::getDefaultResourceGroup ( void )

inlinestatic

Returns the default resource group currently set for loading animation xml data.

Returns: String describing the default resource group identifier that will be used when loading Animation xml data.

static const String& CEGUI::AnimationManager::getDefaultResourceGroup ( )

inlinestatic

Returns the default resource group currently set for loading animation xml data.

Returns: String describing the default resource group identifier that will be used when loading Animation xml data.

Referenced by CEGUI::Animation_xmlHandler::getDefaultResourceGroup().

AnimationInstance * CEGUI::AnimationManager::instantiateAnimation ( Animation * animation )

Instantiates given animation.

See also: AnimationInstance

Referenced by instantiateAnimation().

AnimationInstance* CEGUI::AnimationManager::instantiateAnimation ( Animation * animation )

Instantiates given animation.

See also: AnimationInstance

AnimationInstance* CEGUI::AnimationManager::instantiateAnimation ( const String & name )

Instantiates given animation by name.

See also: AnimationInstance

AnimationInstance * CEGUI::AnimationManager::instantiateAnimation ( const String & name )

Instantiates given animation by name.

See also: AnimationInstance

References getAnimation(), and instantiateAnimation().

bool CEGUI::AnimationManager::isAnimationPresent ( const String & name ) const

Examines the list of Animations to see if one exists with the given name.

Parameters

name	String holding the name of the Animation to look for.

Returns: true if an Animation was found with a name matching name. false if no matching Animation was found.

Referenced by createAnimation().

bool CEGUI::AnimationManager::isAnimationPresent ( const String & name ) const

Examines the list of Animations to see if one exists with the given name.

Parameters

name	String holding the name of the Animation to look for.

Returns: true if an Animation was found with a name matching name. false if no matching Animation was found.

void CEGUI::AnimationManager::loadAnimationsFromString ( const String & source )

Parses XML source containing animation specifications to create and initialise Animation objects.

Parameters

source String object holding the XML source to be processed.

void CEGUI::AnimationManager::loadAnimationsFromString ( const String & source )

Parses XML source containing animation specifications to create and initialise Animation objects.

Parameters

source String object holding the XML source to be processed.

References CEGUI::Errors, CEGUI::System::getSingleton(), CEGUI::System::getXMLParser(), CEGUI::XMLParser::parseXMLString(), and XMLSchemaName.

void CEGUI::AnimationManager::loadAnimationsFromXML	(	const String &	filename,
		const String &	resourceGroup = `""`
	)

Parses an XML file containing animation specifications to create and initialise Animation objects.

Parameters

filename	String object holding the filename of the XML file to be processed.
resourceGroup	Resource group identifier to be passed to the resource provider when loading the XML file.

References CEGUI::String::empty(), CEGUI::Errors, CEGUI::System::getSingleton(), CEGUI::System::getXMLParser(), and XMLSchemaName.

void CEGUI::AnimationManager::loadAnimationsFromXML	(	const String &	filename,
		const String &	resourceGroup = `""`
	)

Parses an XML file containing animation specifications to create and initialise Animation objects.

Parameters

filename	String object holding the filename of the XML file to be processed.
resourceGroup	Resource group identifier to be passed to the resource provider when loading the XML file.

static void CEGUI::AnimationManager::setDefaultResourceGroup ( const String & resourceGroup )

inlinestatic

Sets the default resource group to be used when loading animation xml data.

Parameters

resourceGroup String describing the default resource group identifier to be used.

static void CEGUI::AnimationManager::setDefaultResourceGroup ( const String & resourceGroup )

inlinestatic

Sets the default resource group to be used when loading animation xml data.

Parameters

resourceGroup String describing the default resource group identifier to be used.

Referenced by CEGuiBaseApplication::initialiseDefaultResourceGroups().

void CEGUI::AnimationManager::writeAnimationDefinitionToStream	(	const Animation &	animation,
		OutStream &	out_stream
	)		const

Writes given animation definition to the given OutStream.

Parameters

animation	Animation definition to write
out_stream	OutStream (std::ostream based) object where data is to be sent.

void CEGUI::AnimationManager::writeAnimationDefinitionToStream	(	const Animation &	animation,
		OutStream &	out_stream
	)		const

Writes given animation definition to the given OutStream.

Parameters

animation	Animation definition to write
out_stream	OutStream (std::ostream based) object where data is to be sent.

References CEGUI::Animation::writeXMLToStream().

Referenced by getAnimationDefinitionAsString().

Public Member Functions

Static Public Member Functions

Static Public Attributes

Additional Inherited Members

Constructor & Destructor Documentation

Member Function Documentation