Ogre::Animation Class Reference
[Animation]

An animation sequence. More...

#include <OgreAnimation.h>

Inheritance diagram for Ogre::Animation:

Public Types
enum	InterpolationMode { IM_LINEAR, IM_SPLINE }
	The types of animation interpolation available. More...
enum	RotationInterpolationMode { RIM_LINEAR, RIM_SPHERICAL }
	The types of rotational interpolation available. More...
typedef map< unsigned short, NodeAnimationTrack * >::type	NodeTrackList
typedef ConstMapIterator < NodeTrackList >	NodeTrackIterator
typedef map< unsigned short, NumericAnimationTrack * > ::type	NumericTrackList
typedef ConstMapIterator < NumericTrackList >	NumericTrackIterator
typedef map< unsigned short, VertexAnimationTrack * >::type	VertexTrackList
typedef ConstMapIterator < VertexTrackList >	VertexTrackIterator
typedef set< ushort >::type	TrackHandleList
	A list of track handles.
Public Member Functions
	Animation (const String &name, Real length)
	You should not use this constructor directly, use the parent object such as Skeleton instead.
virtual	~Animation ()
const String &	getName (void) const
	Gets the name of this animation.
Real	getLength (void) const
	Gets the total length of the animation.
void	setLength (Real len)
	Sets the length of the animation.
NodeAnimationTrack *	createNodeTrack (unsigned short handle)
	Creates a NodeAnimationTrack for animating a Node.
NumericAnimationTrack *	createNumericTrack (unsigned short handle)
	Creates a NumericAnimationTrack for animating any numeric value.
VertexAnimationTrack *	createVertexTrack (unsigned short handle, VertexAnimationType animType)
	Creates a VertexAnimationTrack for animating vertex position data.
NodeAnimationTrack *	createNodeTrack (unsigned short handle, Node *node)
	Creates a new AnimationTrack automatically associated with a Node.
NumericAnimationTrack *	createNumericTrack (unsigned short handle, const AnimableValuePtr &anim)
	Creates a NumericAnimationTrack and associates it with an animable.
VertexAnimationTrack *	createVertexTrack (unsigned short handle, VertexData *data, VertexAnimationType animType)
	Creates a VertexAnimationTrack and associates it with VertexData.
unsigned short	getNumNodeTracks (void) const
	Gets the number of NodeAnimationTrack objects contained in this animation.
NodeAnimationTrack *	getNodeTrack (unsigned short handle) const
	Gets a node track by it's handle.
bool	hasNodeTrack (unsigned short handle) const
	Does a track exist with the given handle?
unsigned short	getNumNumericTracks (void) const
	Gets the number of NumericAnimationTrack objects contained in this animation.
NumericAnimationTrack *	getNumericTrack (unsigned short handle) const
	Gets a numeric track by it's handle.
bool	hasNumericTrack (unsigned short handle) const
	Does a track exist with the given handle?
unsigned short	getNumVertexTracks (void) const
	Gets the number of VertexAnimationTrack objects contained in this animation.
VertexAnimationTrack *	getVertexTrack (unsigned short handle) const
	Gets a Vertex track by it's handle.
bool	hasVertexTrack (unsigned short handle) const
	Does a track exist with the given handle?
void	destroyNodeTrack (unsigned short handle)
	Destroys the node track with the given handle.
void	destroyNumericTrack (unsigned short handle)
	Destroys the numeric track with the given handle.
void	destroyVertexTrack (unsigned short handle)
	Destroys the Vertex track with the given handle.
void	destroyAllTracks (void)
	Removes and destroys all tracks making up this animation.
void	destroyAllNodeTracks (void)
	Removes and destroys all tracks making up this animation.
void	destroyAllNumericTracks (void)
	Removes and destroys all tracks making up this animation.
void	destroyAllVertexTracks (void)
	Removes and destroys all tracks making up this animation.
void	apply (Real timePos, Real weight=1.0, Real scale=1.0f)
	Applies an animation given a specific time point and weight.
void	applyToNode (Node *node, Real timePos, Real weight=1.0, Real scale=1.0f)
	Applies all node tracks given a specific time point and weight to the specified node.
void	apply (Skeleton *skeleton, Real timePos, Real weight=1.0, Real scale=1.0f)
	Applies all node tracks given a specific time point and weight to a given skeleton.
void	apply (Skeleton skeleton, Real timePos, float weight, const AnimationState::BoneBlendMask blendMask, Real scale)
	Applies all node tracks given a specific time point and weight to a given skeleton.
void	apply (Entity *entity, Real timePos, Real weight, bool software, bool hardware)
	Applies all vertex tracks given a specific time point and weight to a given entity.
void	applyToAnimable (const AnimableValuePtr &anim, Real timePos, Real weight=1.0, Real scale=1.0f)
	Applies all numeric tracks given a specific time point and weight to the specified animable value.
void	applyToVertexData (VertexData *data, Real timePos, Real weight=1.0)
	Applies all vertex tracks given a specific time point and weight to the specified vertex data.
void	setInterpolationMode (InterpolationMode im)
	Tells the animation how to interpolate between keyframes.
InterpolationMode	getInterpolationMode (void) const
	Gets the current interpolation mode of this animation.
void	setRotationInterpolationMode (RotationInterpolationMode im)
	Tells the animation how to interpolate rotations.
RotationInterpolationMode	getRotationInterpolationMode (void) const
	Gets the current rotation interpolation mode of this animation.
const NodeTrackList &	_getNodeTrackList (void) const
	Fast access to NON-UPDATEABLE node track list.
NodeTrackIterator	getNodeTrackIterator (void) const
	Get non-updateable iterator over node tracks.
const NumericTrackList &	_getNumericTrackList (void) const
	Fast access to NON-UPDATEABLE numeric track list.
NumericTrackIterator	getNumericTrackIterator (void) const
	Get non-updateable iterator over node tracks.
const VertexTrackList &	_getVertexTrackList (void) const
	Fast access to NON-UPDATEABLE Vertex track list.
VertexTrackIterator	getVertexTrackIterator (void) const
	Get non-updateable iterator over node tracks.
void	optimise (bool discardIdentityNodeTracks=true)
	Optimise an animation by removing unnecessary tracks and keyframes.
void	_collectIdentityNodeTracks (TrackHandleList &tracks) const
	Internal method for collecting identity node tracks.
void	_destroyNodeTracks (const TrackHandleList &tracks)
	Internal method for destroy given node tracks.
Animation *	clone (const String &newName) const
	Clone this animation.
void	_keyFrameListChanged (void)
	Internal method used to tell the animation that keyframe list has been changed, which may cause it to rebuild some internal data.
TimeIndex	_getTimeIndex (Real timePos) const
	Internal method used to convert time position to time index object.
void	setUseBaseKeyFrame (bool useBaseKeyFrame, Real keyframeTime=0.0f, const String &baseAnimName=StringUtil::BLANK)
	Sets a base keyframe which for the skeletal / pose keyframes in this animation.
bool	getUseBaseKeyFrame () const
	Whether a base keyframe is being used for this Animation.
Real	getBaseKeyFrameTime () const
	If a base keyframe is being used, the time of that keyframe.
const String &	getBaseKeyFrameAnimationName () const
	If a base keyframe is being used, the Animation that provides that keyframe.
void	_applyBaseKeyFrame ()
	Internal method to adjust keyframes relative to a base keyframe (.
void	_notifyContainer (AnimationContainer *c)
AnimationContainer *	getContainer ()
	Retrieve the container of this animation.
void *	operator new (size_t sz, const char file, int line, const char func)
	operator new, with debug line info
void *	operator new (size_t sz)
void *	operator new (size_t sz, void *ptr)
	placement operator new
void *	operator new[] (size_t sz, const char file, int line, const char func)
	array operator new, with debug line info
void *	operator new[] (size_t sz)
void	operator delete (void *ptr)
void	operator delete (void ptr, void )
void	operator delete (void ptr, const char , int, const char *)
void	operator delete[] (void *ptr)
void	operator delete[] (void ptr, const char , int, const char *)
Static Public Member Functions
static void	setDefaultInterpolationMode (InterpolationMode im)
	Sets the default animation interpolation mode.
static InterpolationMode	getDefaultInterpolationMode (void)
	Gets the default interpolation mode for all animations.
static void	setDefaultRotationInterpolationMode (RotationInterpolationMode im)
	Sets the default rotation interpolation mode.
static RotationInterpolationMode	getDefaultRotationInterpolationMode (void)
	Gets the default rotation interpolation mode for all animations.
Protected Types
typedef vector< Real >::type	KeyFrameTimeList
	Global keyframe time list used to search global keyframe index.
Protected Member Functions
void	optimiseNodeTracks (bool discardIdentityTracks)
void	optimiseVertexTracks (void)
void	buildKeyFrameTimeList (void) const
	Internal method to build global keyframe time list.
Protected Attributes
NodeTrackList	mNodeTrackList
	Node tracks, indexed by handle.
NumericTrackList	mNumericTrackList
	Numeric tracks, indexed by handle.
VertexTrackList	mVertexTrackList
	Vertex tracks, indexed by handle.
String	mName
Real	mLength
InterpolationMode	mInterpolationMode
RotationInterpolationMode	mRotationInterpolationMode
KeyFrameTimeList	mKeyFrameTimes
bool	mKeyFrameTimesDirty
	Dirty flag indicate that keyframe time list need to rebuild.
bool	mUseBaseKeyFrame
Real	mBaseKeyFrameTime
String	mBaseKeyFrameAnimationName
AnimationContainer *	mContainer
Static Protected Attributes
static InterpolationMode	msDefaultInterpolationMode
static RotationInterpolationMode	msDefaultRotationInterpolationMode

Detailed Description

An animation sequence.

Remarks:: This class defines the interface for a sequence of animation, whether that be animation of a mesh, a path along a spline, or possibly more than one type of animation in one. An animation is made up of many 'tracks', which are the more specific types of animation.

: You should not create these animations directly. They will be created via a parent object which owns the animation, e.g. Skeleton.

Definition at line 89 of file OgreAnimation.h.

Member Typedef Documentation

typedef vector<Real>::type Ogre::Animation::KeyFrameTimeList [protected]

Global keyframe time list used to search global keyframe index.

Definition at line 521 of file OgreAnimation.h.

typedef ConstMapIterator<NodeTrackList> Ogre::Animation::NodeTrackIterator

Definition at line 371 of file OgreAnimation.h.

typedef map<unsigned short, NodeAnimationTrack*>::type Ogre::Animation::NodeTrackList

Definition at line 370 of file OgreAnimation.h.

typedef ConstMapIterator<NumericTrackList> Ogre::Animation::NumericTrackIterator

Definition at line 374 of file OgreAnimation.h.

typedef map<unsigned short, NumericAnimationTrack*>::type Ogre::Animation::NumericTrackList

Definition at line 373 of file OgreAnimation.h.

typedef set<ushort>::type Ogre::Animation::TrackHandleList

A list of track handles.

Definition at line 422 of file OgreAnimation.h.

typedef ConstMapIterator<VertexTrackList> Ogre::Animation::VertexTrackIterator

Definition at line 377 of file OgreAnimation.h.

typedef map<unsigned short, VertexAnimationTrack*>::type Ogre::Animation::VertexTrackList

Definition at line 376 of file OgreAnimation.h.

Member Enumeration Documentation

enum Ogre::Animation::InterpolationMode

The types of animation interpolation available.

Enumerator:

IM_LINEAR	Values are interpolated along straight lines.
IM_SPLINE	Values are interpolated along a spline, resulting in smoother changes in direction.

Definition at line 94 of file OgreAnimation.h.

enum Ogre::Animation::RotationInterpolationMode

The types of rotational interpolation available.

Enumerator:

RIM_LINEAR

Values are interpolated linearly.

This is faster but does not necessarily give a completely accurate result.

RIM_SPHERICAL

Values are interpolated spherically.

This is more accurate but has a higher cost.

Definition at line 103 of file OgreAnimation.h.

Constructor & Destructor Documentation

Ogre::Animation::Animation	(	const String &	name,
		Real	length
	)

You should not use this constructor directly, use the parent object such as Skeleton instead.

Parameters:

	name	The name of the animation, should be unique within it's parent (e.g. Skeleton)
	length	The length of the animation in seconds.

virtual Ogre::Animation::~Animation ( ) [virtual]

Member Function Documentation

void Ogre::Animation::_applyBaseKeyFrame ( )

Internal method to adjust keyframes relative to a base keyframe (.

See also:: setUseBaseKeyFrame) */

void Ogre::Animation::_collectIdentityNodeTracks ( TrackHandleList & tracks ) const

Internal method for collecting identity node tracks.

Remarks:: This method remove non-identity node tracks form the track handle list.

Parameters:

tracks

A list of track handle of non-identity node tracks, where this method will remove non-identity node track handles.

void Ogre::Animation::_destroyNodeTracks ( const TrackHandleList & tracks )

Internal method for destroy given node tracks.

const NodeTrackList& Ogre::Animation::_getNodeTrackList ( void ) const

Fast access to NON-UPDATEABLE node track list.

const NumericTrackList& Ogre::Animation::_getNumericTrackList ( void ) const

Fast access to NON-UPDATEABLE numeric track list.

TimeIndex Ogre::Animation::_getTimeIndex ( Real timePos ) const

Internal method used to convert time position to time index object.

Note:: The time index returns by this function are associated with state of the animation object, if the animation object altered (e.g. create/remove keyframe or track), all related time index will invalidated.

Parameters:

timePos

The time position.

Returns:: The time index object which contains wrapped time position (in relation to the whole animation sequence) and lower bound index of global keyframe time list.

const VertexTrackList& Ogre::Animation::_getVertexTrackList ( void ) const

Fast access to NON-UPDATEABLE Vertex track list.

void Ogre::Animation::_keyFrameListChanged ( void )

Internal method used to tell the animation that keyframe list has been changed, which may cause it to rebuild some internal data.

Definition at line 447 of file OgreAnimation.h.

void Ogre::Animation::_notifyContainer ( AnimationContainer * c )

void Ogre::Animation::apply	(	Entity *	entity,
		Real	timePos,
		Real	weight,
		bool	software,
		bool	hardware
	)

Applies all vertex tracks given a specific time point and weight to a given entity.

Remarks:

Parameters:

	entity	The Entity to which this animation should be applied
	timePos	The time position in the animation to apply.
	weight	The weight at which the animation should be applied (only affects pose animation)
	software	Whether to populate the software morph vertex data
	hardware	Whether to populate the hardware morph vertex data

void Ogre::Animation::apply	(	Skeleton *	skeleton,
		Real	timePos,
		float	weight,
		const AnimationState::BoneBlendMask *	blendMask,
		Real	scale
	)

Applies all node tracks given a specific time point and weight to a given skeleton.

Remarks:: Where you have associated animation tracks with Node objects, you can easily apply an animation to those nodes by calling this method.

Parameters:

	timePos	The time position in the animation to apply.
	weight	The influence to give to this track, 1.0 for full influence, less to blend with other animations.
	blendMask	The influence array defining additional per bone weights. These will be modulated with the weight factor.
	scale	The scale to apply to translations and scalings, useful for adapting an animation to a different size target.

void Ogre::Animation::apply	(	Skeleton *	skeleton,
		Real	timePos,
		Real	weight = `1.0`,
		Real	scale = `1.0f`
	)

Applies all node tracks given a specific time point and weight to a given skeleton.

Remarks:: Where you have associated animation tracks with Node objects, you can easily apply an animation to those nodes by calling this method.

Parameters:

	timePos	The time position in the animation to apply.
	weight	The influence to give to this track, 1.0 for full influence, less to blend with other animations.
	scale	The scale to apply to translations and scalings, useful for adapting an animation to a different size target.

void Ogre::Animation::apply	(	Real	timePos,
		Real	weight = `1.0`,
		Real	scale = `1.0f`
	)

Applies an animation given a specific time point and weight.

Remarks:: Where you have associated animation tracks with objects, you can easily apply an animation to those objects by calling this method.

Parameters:

	timePos	The time position in the animation to apply.
	weight	The influence to give to this track, 1.0 for full influence, less to blend with other animations.
	scale	The scale to apply to translations and scalings, useful for adapting an animation to a different size target.

void Ogre::Animation::applyToAnimable	(	const AnimableValuePtr &	anim,
		Real	timePos,
		Real	weight = `1.0`,
		Real	scale = `1.0f`
	)

Applies all numeric tracks given a specific time point and weight to the specified animable value.

Remarks:: It does not applies to actual attached animable values but rather uses all tracks for a single animable value.

Parameters:

	timePos	The time position in the animation to apply.
	weight	The influence to give to this track, 1.0 for full influence, less to blend with other animations.
	scale	The scale to apply to translations and scalings, useful for adapting an animation to a different size target.

void Ogre::Animation::applyToNode	(	Node *	node,
		Real	timePos,
		Real	weight = `1.0`,
		Real	scale = `1.0f`
	)

Applies all node tracks given a specific time point and weight to the specified node.

Remarks:: It does not consider the actual node tracks are attached to. As such, it resembles the apply method for a given skeleton (see below).

Parameters:

	timePos	The time position in the animation to apply.
	weight	The influence to give to this track, 1.0 for full influence, less to blend with other animations.
	scale	The scale to apply to translations and scalings, useful for adapting an animation to a different size target.

void Ogre::Animation::applyToVertexData	(	VertexData *	data,
		Real	timePos,
		Real	weight = `1.0`
	)

Applies all vertex tracks given a specific time point and weight to the specified vertex data.

Remarks:: It does not apply to the actual attached vertex data but rather uses all tracks for a given vertex data.

Parameters:

	timePos	The time position in the animation to apply.
	weight	The influence to give to this track, 1.0 for full influence, less to blend with other animations.

void Ogre::Animation::buildKeyFrameTimeList ( void ) const [protected]

Internal method to build global keyframe time list.

Animation* Ogre::Animation::clone ( const String & newName ) const

Clone this animation.

Note:: The pointer returned from this method is the only one recorded, thus it is up to the caller to arrange for the deletion of this object.

NodeAnimationTrack* Ogre::Animation::createNodeTrack	(	unsigned short	handle,
		Node *	node
	)

Creates a new AnimationTrack automatically associated with a Node.

Remarks:: This method creates a standard AnimationTrack, but also associates it with a target Node which will receive all keyframe effects.

Parameters:

	handle	Numeric handle to give the track, used for accessing the track later. Must be unique within this Animation.
	node	A pointer to the Node object which will be affected by this track

NodeAnimationTrack* Ogre::Animation::createNodeTrack ( unsigned short handle )

Creates a NodeAnimationTrack for animating a Node.

Parameters:

handle

Handle to give the track, used for accessing the track later. Must be unique within this Animation.

NumericAnimationTrack* Ogre::Animation::createNumericTrack	(	unsigned short	handle,
		const AnimableValuePtr &	anim
	)

Creates a NumericAnimationTrack and associates it with an animable.

Parameters:

	handle	Handle to give the track, used for accessing the track later.
	anim	Animable object link Must be unique within this Animation.

NumericAnimationTrack* Ogre::Animation::createNumericTrack ( unsigned short handle )

Creates a NumericAnimationTrack for animating any numeric value.

Parameters:

handle

Handle to give the track, used for accessing the track later. Must be unique within this Animation.

VertexAnimationTrack* Ogre::Animation::createVertexTrack	(	unsigned short	handle,
		VertexData *	data,
		VertexAnimationType	animType
	)

Creates a VertexAnimationTrack and associates it with VertexData.

Parameters:

	handle	Handle to give the track, used for accessing the track later.
	data	VertexData object link
	animType	The animation type Must be unique within this Animation.

VertexAnimationTrack* Ogre::Animation::createVertexTrack	(	unsigned short	handle,
		VertexAnimationType	animType
	)

Creates a VertexAnimationTrack for animating vertex position data.

Parameters:

	handle	Handle to give the track, used for accessing the track later. Must be unique within this Animation, and is used to identify the target. For example when applied to a Mesh, the handle must reference the index of the geometry being modified; 0 for the shared geometry, and 1+ for SubMesh geometry with the same index-1.
	animType	Either morph or pose animation,

void Ogre::Animation::destroyAllNodeTracks ( void )

Removes and destroys all tracks making up this animation.

void Ogre::Animation::destroyAllNumericTracks ( void )

Removes and destroys all tracks making up this animation.

void Ogre::Animation::destroyAllTracks ( void )

Removes and destroys all tracks making up this animation.

void Ogre::Animation::destroyAllVertexTracks ( void )

Removes and destroys all tracks making up this animation.

void Ogre::Animation::destroyNodeTrack ( unsigned short handle )

Destroys the node track with the given handle.

void Ogre::Animation::destroyNumericTrack ( unsigned short handle )

Destroys the numeric track with the given handle.

void Ogre::Animation::destroyVertexTrack ( unsigned short handle )

Destroys the Vertex track with the given handle.

const String& Ogre::Animation::getBaseKeyFrameAnimationName ( ) const

If a base keyframe is being used, the Animation that provides that keyframe.

Real Ogre::Animation::getBaseKeyFrameTime ( ) const

If a base keyframe is being used, the time of that keyframe.

AnimationContainer* Ogre::Animation::getContainer ( )

Retrieve the container of this animation.

static InterpolationMode Ogre::Animation::getDefaultInterpolationMode ( void ) [static]

Gets the default interpolation mode for all animations.

static RotationInterpolationMode Ogre::Animation::getDefaultRotationInterpolationMode ( void ) [static]

Gets the default rotation interpolation mode for all animations.

InterpolationMode Ogre::Animation::getInterpolationMode ( void ) const

Gets the current interpolation mode of this animation.

Remarks:: See setInterpolationMode for more info.

Real Ogre::Animation::getLength ( void ) const

Gets the total length of the animation.

const String& Ogre::Animation::getName ( void ) const

Gets the name of this animation.

NodeAnimationTrack* Ogre::Animation::getNodeTrack ( unsigned short handle ) const

Gets a node track by it's handle.

NodeTrackIterator Ogre::Animation::getNodeTrackIterator ( void ) const

Get non-updateable iterator over node tracks.

Definition at line 383 of file OgreAnimation.h.

NumericAnimationTrack* Ogre::Animation::getNumericTrack ( unsigned short handle ) const

Gets a numeric track by it's handle.

NumericTrackIterator Ogre::Animation::getNumericTrackIterator ( void ) const

Get non-updateable iterator over node tracks.

Definition at line 390 of file OgreAnimation.h.

unsigned short Ogre::Animation::getNumNodeTracks ( void ) const

Gets the number of NodeAnimationTrack objects contained in this animation.

unsigned short Ogre::Animation::getNumNumericTracks ( void ) const

Gets the number of NumericAnimationTrack objects contained in this animation.

unsigned short Ogre::Animation::getNumVertexTracks ( void ) const

Gets the number of VertexAnimationTrack objects contained in this animation.

RotationInterpolationMode Ogre::Animation::getRotationInterpolationMode ( void ) const

Gets the current rotation interpolation mode of this animation.

Remarks:: See setRotationInterpolationMode for more info.

bool Ogre::Animation::getUseBaseKeyFrame ( ) const

Whether a base keyframe is being used for this Animation.

VertexAnimationTrack* Ogre::Animation::getVertexTrack ( unsigned short handle ) const

Gets a Vertex track by it's handle.

VertexTrackIterator Ogre::Animation::getVertexTrackIterator ( void ) const

Get non-updateable iterator over node tracks.

Definition at line 397 of file OgreAnimation.h.

bool Ogre::Animation::hasNodeTrack ( unsigned short handle ) const

Does a track exist with the given handle?

bool Ogre::Animation::hasNumericTrack ( unsigned short handle ) const

Does a track exist with the given handle?

bool Ogre::Animation::hasVertexTrack ( unsigned short handle ) const

Does a track exist with the given handle?

template<class Alloc >

void Ogre::AllocatedObject< Alloc >::operator delete	(	void *	ptr,
		const char *	,
		int	,
		const char *
	)			`[inherited]`

Definition at line 107 of file OgreMemoryAllocatedObject.h.

template<class Alloc >

void Ogre::AllocatedObject< Alloc >::operator delete	(	void *	ptr,
		void *
	)			`[inherited]`

Definition at line 101 of file OgreMemoryAllocatedObject.h.

template<class Alloc >

void Ogre::AllocatedObject< Alloc >::operator delete ( void * ptr ) [inherited]

Definition at line 95 of file OgreMemoryAllocatedObject.h.

template<class Alloc >

void Ogre::AllocatedObject< Alloc >::operator delete[]	(	void *	ptr,
		const char *	,
		int	,
		const char *
	)			`[inherited]`

Definition at line 118 of file OgreMemoryAllocatedObject.h.

template<class Alloc >

void Ogre::AllocatedObject< Alloc >::operator delete[] ( void * ptr ) [inherited]

Definition at line 112 of file OgreMemoryAllocatedObject.h.

template<class Alloc >

void* Ogre::AllocatedObject< Alloc >::operator new	(	size_t	sz,
		void *	ptr
	)			`[inherited]`

placement operator new

Definition at line 78 of file OgreMemoryAllocatedObject.h.

template<class Alloc >

void* Ogre::AllocatedObject< Alloc >::operator new ( size_t sz ) [inherited]

Definition at line 72 of file OgreMemoryAllocatedObject.h.

template<class Alloc >

void* Ogre::AllocatedObject< Alloc >::operator new	(	size_t	sz,
		const char *	file,
		int	line,
		const char *	func
	)			`[inherited]`

operator new, with debug line info

Definition at line 67 of file OgreMemoryAllocatedObject.h.

template<class Alloc >

void* Ogre::AllocatedObject< Alloc >::operator new[] ( size_t sz ) [inherited]

Definition at line 90 of file OgreMemoryAllocatedObject.h.

template<class Alloc >

void* Ogre::AllocatedObject< Alloc >::operator new[]	(	size_t	sz,
		const char *	file,
		int	line,
		const char *	func
	)			`[inherited]`

array operator new, with debug line info

Definition at line 85 of file OgreMemoryAllocatedObject.h.

void Ogre::Animation::optimise ( bool discardIdentityNodeTracks = true )

Optimise an animation by removing unnecessary tracks and keyframes.

Remarks:: When you export an animation, it is possible that certain tracks have been keyframed but actually don't include anything useful - the keyframes include no transformation. These tracks can be completely eliminated from the animation and thus speed up the animation. In addition, if several keyframes in a row have the same value, then they are just adding overhead and can be removed.

Note:: Since track-less and identity track has difference behavior for accumulate animation blending if corresponding track presenting at other animation that is non-identity, and in normally this method didn't known about the situation of other animation, it can't deciding whether or not discards identity tracks. So there have a parameter allow you choose what you want, in case you aren't sure how to do that, you should use Skeleton::optimiseAllAnimations instead.

Parameters:

discardIdentityNodeTracks

If true, discard identity node tracks.

void Ogre::Animation::optimiseNodeTracks ( bool discardIdentityTracks ) [protected]

void Ogre::Animation::optimiseVertexTracks ( void ) [protected]

static void Ogre::Animation::setDefaultInterpolationMode ( InterpolationMode im ) [static]

Sets the default animation interpolation mode.

Remarks:: Every animation created after this option is set will have the new interpolation mode specified. You can also change the mode per animation by calling the setInterpolationMode method on the instance in question.

static void Ogre::Animation::setDefaultRotationInterpolationMode ( RotationInterpolationMode im ) [static]

Sets the default rotation interpolation mode.

Remarks:: Every animation created after this option is set will have the new interpolation mode specified. You can also change the mode per animation by calling the setInterpolationMode method on the instance in question.

void Ogre::Animation::setInterpolationMode ( InterpolationMode im )

Tells the animation how to interpolate between keyframes.

Remarks:: By default, animations normally interpolate linearly between keyframes. This is fast, but when animations include quick changes in direction it can look a little unnatural because directions change instantly at keyframes. An alternative is to tell the animation to interpolate along a spline, which is more expensive in terms of calculation time, but looks smoother because major changes in direction are distributed around the keyframes rather than just at the keyframe.

: You can also change the default animation behaviour by calling Animation::setDefaultInterpolationMode.

void Ogre::Animation::setLength ( Real len )

Sets the length of the animation.

Note:: Changing the length of an animation may invalidate existing AnimationState instances which will need to be recreated.

void Ogre::Animation::setRotationInterpolationMode ( RotationInterpolationMode im )

Tells the animation how to interpolate rotations.

Remarks:: By default, animations interpolate linearly between rotations. This is fast but not necessarily completely accurate. If you want more accurate interpolation, use spherical interpolation, but be aware that it will incur a higher cost.

: You can also change the default rotation behaviour by calling Animation::setDefaultRotationInterpolationMode.

void Ogre::Animation::setUseBaseKeyFrame	(	bool	useBaseKeyFrame,
		Real	keyframeTime = `0.0f`,
		const String &	baseAnimName = `StringUtil::BLANK`
	)

Sets a base keyframe which for the skeletal / pose keyframes in this animation.

Remarks:: Skeletal and pose animation keyframes are expressed as deltas from a given base state. By default, that is the binding setup of the skeleton, or the object space mesh positions for pose animation. However, sometimes it is useful for animators to create animations with a different starting pose, because that's more convenient, and the animation is designed to simply be added to the existing animation state and not globally averaged with other animations (this is always the case with pose animations, but is activated for skeletal animations via ANIMBLEND_CUMULATIVE).

: In order for this to work, the keyframes need to be 're-based' against this new starting state, for example by treating the first keyframe as the reference point (and therefore representing no change). This can be achieved by applying the inverse of this reference keyframe against all other keyframes. Since this fundamentally changes the animation, this method just marks the animation as requiring this rebase, which is performed at the next Animation 'apply' call. This is to allow the Animation to be re-saved with this flag set, but without having altered the keyframes yet, so no data is lost unintentionally. If you wish to save the animation after the adjustment has taken place, you can (

See also:: _applyBaseKeyFrame)

Parameters:

	useBaseKeyFrame	Whether a base keyframe should be used
	keyframeTime	The time corresponding to the base keyframe, if any
	baseAnimName	Optionally a different base animation (must contain the same tracks)