Represents the state of an animation and the weight of it's influence. More...
#include <OgreAnimationState.h>
Public Types | |
typedef vector< float >::type | BoneBlendMask |
typedef for an array of float values used as a bone blend mask | |
Public Member Functions | |
AnimationState (const String &animName, AnimationStateSet *parent, Real timePos, Real length, Real weight=1.0, bool enabled=false) | |
Normal constructor with all params supplied. | |
AnimationState (AnimationStateSet *parent, const AnimationState &rhs) | |
constructor to copy from an existing state with new parent | |
virtual | ~AnimationState () |
Destructor - is here because class has virtual functions and some compilers would whine if it won't exist. | |
const String & | getAnimationName () const |
Gets the name of the animation to which this state applies. | |
Real | getTimePosition (void) const |
Gets the time position for this animation. | |
void | setTimePosition (Real timePos) |
Sets the time position for this animation. | |
Real | getLength () const |
Gets the total length of this animation (may be shorter than whole animation). | |
void | setLength (Real len) |
Sets the total length of this animation (may be shorter than whole animation). | |
Real | getWeight (void) const |
Gets the weight (influence) of this animation. | |
void | setWeight (Real weight) |
Sets the weight (influence) of this animation. | |
void | addTime (Real offset) |
Modifies the time position, adjusting for animation length. | |
bool | hasEnded (void) const |
Returns true if the animation has reached the end and is not looping. | |
bool | getEnabled (void) const |
Returns true if this animation is currently enabled. | |
void | setEnabled (bool enabled) |
Sets whether this animation is enabled. | |
bool | operator== (const AnimationState &rhs) const |
Equality operator. | |
bool | operator!= (const AnimationState &rhs) const |
void | setLoop (bool loop) |
Sets whether or not an animation loops at the start and end of the animation if the time continues to be altered. | |
bool | getLoop (void) const |
Gets whether or not this animation loops. | |
void | copyStateFrom (const AnimationState &animState) |
Copies the states from another animation state, preserving the animation name (unlike operator=) but copying everything else. | |
AnimationStateSet * | getParent (void) const |
Get the parent animation state set. | |
void | createBlendMask (size_t blendMaskSizeHint, float initialWeight=1.0f) |
create a new blend mask with the given number of entries | |
void | destroyBlendMask () |
destroy the currently set blend mask | |
void | _setBlendMaskData (const float *blendMaskData) |
set the blend mask data (might be dangerous) | |
void | _setBlendMask (const BoneBlendMask *blendMask) |
set the blend mask | |
const BoneBlendMask * | getBlendMask () const |
get the current blend mask (const version, may be 0) | |
bool | hasBlendMask () const |
return whether there is currently a valid blend mask set | |
void | setBlendMaskEntry (size_t boneHandle, float weight) |
set the weight for the bone identified by the given handle | |
float | getBlendMaskEntry (size_t boneHandle) const |
get the weight for the bone identified by the given handle | |
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 *) |
Protected Attributes | |
BoneBlendMask * | mBlendMask |
the blend mask (containing per bone weights) | |
String | mAnimationName |
AnimationStateSet * | mParent |
Real | mTimePos |
Real | mLength |
Real | mWeight |
bool | mEnabled |
bool | mLoop |
Represents the state of an animation and the weight of it's influence.
Definition at line 52 of file OgreAnimationState.h.
typedef vector<float>::type Ogre::AnimationState::BoneBlendMask |
typedef for an array of float values used as a bone blend mask
Definition at line 57 of file OgreAnimationState.h.
Ogre::AnimationState::AnimationState | ( | const String & | animName, | |
AnimationStateSet * | parent, | |||
Real | timePos, | |||
Real | length, | |||
Real | weight = 1.0 , |
|||
bool | enabled = false | |||
) |
Normal constructor with all params supplied.
Ogre::AnimationState::AnimationState | ( | AnimationStateSet * | parent, | |
const AnimationState & | rhs | |||
) |
constructor to copy from an existing state with new parent
virtual Ogre::AnimationState::~AnimationState | ( | ) | [virtual] |
Destructor - is here because class has virtual functions and some compilers would whine if it won't exist.
void Ogre::AnimationState::_setBlendMask | ( | const BoneBlendMask * | blendMask | ) |
set the blend mask
void Ogre::AnimationState::_setBlendMaskData | ( | const float * | blendMaskData | ) |
set the blend mask data (might be dangerous)
void Ogre::AnimationState::addTime | ( | Real | offset | ) |
Modifies the time position, adjusting for animation length.
void Ogre::AnimationState::copyStateFrom | ( | const AnimationState & | animState | ) |
Copies the states from another animation state, preserving the animation name (unlike operator=) but copying everything else.
animState | Reference to animation state which will use as source. |
void Ogre::AnimationState::createBlendMask | ( | size_t | blendMaskSizeHint, | |
float | initialWeight = 1.0f | |||
) |
create a new blend mask with the given number of entries
In addition to assigning a single weight value to a skeletal animation, it may be desirable to assign animation weights per bone using a 'blend mask'.
blendMaskSizeHint | The number of bones of the skeleton owning this AnimationState. | |
initialWeight | The value all the blend mask entries will be initialised with (negative to skip initialisation) |
void Ogre::AnimationState::destroyBlendMask | ( | ) |
destroy the currently set blend mask
const String& Ogre::AnimationState::getAnimationName | ( | ) | const |
Gets the name of the animation to which this state applies.
const BoneBlendMask* Ogre::AnimationState::getBlendMask | ( | ) | const |
get the current blend mask (const version, may be 0)
Definition at line 148 of file OgreAnimationState.h.
float Ogre::AnimationState::getBlendMaskEntry | ( | size_t | boneHandle | ) | const |
get the weight for the bone identified by the given handle
Definition at line 154 of file OgreAnimationState.h.
bool Ogre::AnimationState::getEnabled | ( | void | ) | const |
Returns true if this animation is currently enabled.
Real Ogre::AnimationState::getLength | ( | ) | const |
Gets the total length of this animation (may be shorter than whole animation).
bool Ogre::AnimationState::getLoop | ( | void | ) | const |
Gets whether or not this animation loops.
Definition at line 107 of file OgreAnimationState.h.
AnimationStateSet* Ogre::AnimationState::getParent | ( | void | ) | const |
Get the parent animation state set.
Definition at line 116 of file OgreAnimationState.h.
Real Ogre::AnimationState::getTimePosition | ( | void | ) | const |
Gets the time position for this animation.
Real Ogre::AnimationState::getWeight | ( | void | ) | const |
Gets the weight (influence) of this animation.
bool Ogre::AnimationState::hasBlendMask | ( | ) | const |
return whether there is currently a valid blend mask set
Definition at line 150 of file OgreAnimationState.h.
bool Ogre::AnimationState::hasEnded | ( | void | ) | const |
Returns true if the animation has reached the end and is not looping.
void Ogre::AllocatedObject< Alloc >::operator delete | ( | void * | ptr, | |
void * | ||||
) | [inherited] |
Definition at line 101 of file OgreMemoryAllocatedObject.h.
void Ogre::AllocatedObject< Alloc >::operator delete | ( | void * | ptr, | |
const char * | , | |||
int | , | |||
const char * | ||||
) | [inherited] |
Definition at line 107 of file OgreMemoryAllocatedObject.h.
void Ogre::AllocatedObject< Alloc >::operator delete | ( | void * | ptr | ) | [inherited] |
Definition at line 95 of file OgreMemoryAllocatedObject.h.
void Ogre::AllocatedObject< Alloc >::operator delete[] | ( | void * | ptr, | |
const char * | , | |||
int | , | |||
const char * | ||||
) | [inherited] |
Definition at line 118 of file OgreMemoryAllocatedObject.h.
void Ogre::AllocatedObject< Alloc >::operator delete[] | ( | void * | ptr | ) | [inherited] |
Definition at line 112 of file OgreMemoryAllocatedObject.h.
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.
void* Ogre::AllocatedObject< Alloc >::operator new | ( | size_t | sz | ) | [inherited] |
Definition at line 72 of file OgreMemoryAllocatedObject.h.
void* Ogre::AllocatedObject< Alloc >::operator new | ( | size_t | sz, | |
void * | ptr | |||
) | [inherited] |
placement operator new
Definition at line 78 of file OgreMemoryAllocatedObject.h.
void* Ogre::AllocatedObject< Alloc >::operator new[] | ( | size_t | sz | ) | [inherited] |
Definition at line 90 of file OgreMemoryAllocatedObject.h.
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.
bool Ogre::AnimationState::operator!= | ( | const AnimationState & | rhs | ) | const |
bool Ogre::AnimationState::operator== | ( | const AnimationState & | rhs | ) | const |
Equality operator.
void Ogre::AnimationState::setBlendMaskEntry | ( | size_t | boneHandle, | |
float | weight | |||
) |
set the weight for the bone identified by the given handle
void Ogre::AnimationState::setEnabled | ( | bool | enabled | ) |
Sets whether this animation is enabled.
void Ogre::AnimationState::setLength | ( | Real | len | ) |
Sets the total length of this animation (may be shorter than whole animation).
void Ogre::AnimationState::setLoop | ( | bool | loop | ) |
Sets whether or not an animation loops at the start and end of the animation if the time continues to be altered.
Definition at line 105 of file OgreAnimationState.h.
void Ogre::AnimationState::setTimePosition | ( | Real | timePos | ) |
Sets the time position for this animation.
void Ogre::AnimationState::setWeight | ( | Real | weight | ) |
Sets the weight (influence) of this animation.
String Ogre::AnimationState::mAnimationName [protected] |
Definition at line 163 of file OgreAnimationState.h.
BoneBlendMask* Ogre::AnimationState::mBlendMask [protected] |
the blend mask (containing per bone weights)
Definition at line 161 of file OgreAnimationState.h.
bool Ogre::AnimationState::mEnabled [protected] |
Definition at line 168 of file OgreAnimationState.h.
Real Ogre::AnimationState::mLength [protected] |
Definition at line 166 of file OgreAnimationState.h.
bool Ogre::AnimationState::mLoop [protected] |
Definition at line 169 of file OgreAnimationState.h.
AnimationStateSet* Ogre::AnimationState::mParent [protected] |
Definition at line 164 of file OgreAnimationState.h.
Real Ogre::AnimationState::mTimePos [protected] |
Definition at line 165 of file OgreAnimationState.h.
Real Ogre::AnimationState::mWeight [protected] |
Definition at line 167 of file OgreAnimationState.h.
Copyright © 2008 Torus Knot Software Ltd
This work is licensed under a Creative Commons Attribution-ShareAlike 3.0 Unported License.
Last modified Wed Nov 3 2010 19:24:53