Main Page   Namespace List   Class Hierarchy   Alphabetical List   Compound List   File List   Namespace Members   Compound Members   File Members   Related Pages  

Ogre::KeyFrame Class Reference

A key frame in an animation sequence defined by an AnimationTrack. More...

#include <OgreKeyFrame.h>

List of all members.

Public Methods

 KeyFrame (const AnimationTrack *parent, Real time)
 Default constructor, you should not call this but use AnimationTrack::createKeyFrame instead.

Real getTime (void) const
 Gets the time of this keyframe in the animation sequence.

void setTranslate (const Vector3 &trans)
 Sets the translation associated with this keyframe.

const Vector3getTranslate (void) const
 Gets the translation applied by this keyframe.

void setScale (const Vector3 &scale)
 Sets the scaling factor applied by this keyframe to the animable object at it's time index.

const Vector3getScale (void) const
 Gets the scaling factor applied by this keyframe.

void setRotation (const Quaternion &rot)
 Sets the rotation applied by this keyframe.

const QuaterniongetRotation (void) const
 Gets the rotation applied by this keyframe.


Protected Attributes

Real mTime
Vector3 mTranslate
Vector3 mScale
Quaternion mRotate
const AnimationTrackmParentTrack


Detailed Description

A key frame in an animation sequence defined by an AnimationTrack.

Remarks:
This class can be used as a basis for all kinds of key frames. The unifying principle is that multiple KeyFrames define an animation sequence, with the exact state of the animation being an interpolation between these key frames.

Definition at line 43 of file OgreKeyFrame.h.


Constructor & Destructor Documentation

Ogre::KeyFrame::KeyFrame const AnimationTrack   parent,
Real    time
 

Default constructor, you should not call this but use AnimationTrack::createKeyFrame instead.

Definition at line 33 of file OgreKeyFrame.cpp.

References mRotate, mScale, mTranslate, Ogre::Real, Ogre::Vector3::x, Ogre::Vector3::y, and Ogre::Vector3::z.


Member Function Documentation

const Quaternion & Ogre::KeyFrame::getRotation void    const
 

Gets the rotation applied by this keyframe.

Definition at line 77 of file OgreKeyFrame.cpp.

References mRotate.

Referenced by Ogre::Skeleton::_dumpContents(), Ogre::AnimationTrack::applyToNode(), Ogre::AnimationTrack::getInterpolatedKeyFrame(), and Ogre::SkeletonSerializer::writeKeyFrame().

const Vector3 & Ogre::KeyFrame::getScale void    const
 

Gets the scaling factor applied by this keyframe.

Definition at line 65 of file OgreKeyFrame.cpp.

References mScale.

Referenced by Ogre::AnimationTrack::applyToNode(), and Ogre::AnimationTrack::getInterpolatedKeyFrame().

Real Ogre::KeyFrame::getTime void    const
 

Gets the time of this keyframe in the animation sequence.

Definition at line 41 of file OgreKeyFrame.cpp.

References mTime, and Ogre::Real.

Referenced by Ogre::Skeleton::_dumpContents(), Ogre::AnimationTrack::getKeyFramesAtTime(), and Ogre::SkeletonSerializer::writeKeyFrame().

const Vector3 & Ogre::KeyFrame::getTranslate void    const
 

Gets the translation applied by this keyframe.

Definition at line 53 of file OgreKeyFrame.cpp.

References mTranslate.

Referenced by Ogre::Skeleton::_dumpContents(), Ogre::AnimationTrack::applyToNode(), Ogre::AnimationTrack::getInterpolatedKeyFrame(), and Ogre::SkeletonSerializer::writeKeyFrame().

void Ogre::KeyFrame::setRotation const Quaternion   rot
 

Sets the rotation applied by this keyframe.

Parameters:
rot  The rotation applied; use Quaternion methods to convert from angle/axis or Matrix3 if you don't like using Quaternions directly.

Definition at line 70 of file OgreKeyFrame.cpp.

References Ogre::AnimationTrack::_keyFrameDataChanged(), mParentTrack, and mRotate.

Referenced by Ogre::AnimationTrack::getInterpolatedKeyFrame(), and Ogre::SkeletonSerializer::readKeyFrame().

void Ogre::KeyFrame::setScale const Vector3   scale
 

Sets the scaling factor applied by this keyframe to the animable object at it's time index.

Parameters:
scale  The vector to scale by (beware of supplying zero values for any component of this vector, it will scale the object to zero dimensions)

Definition at line 58 of file OgreKeyFrame.cpp.

References Ogre::AnimationTrack::_keyFrameDataChanged(), mParentTrack, and mScale.

Referenced by Ogre::AnimationTrack::getInterpolatedKeyFrame().

void Ogre::KeyFrame::setTranslate const Vector3   trans
 

Sets the translation associated with this keyframe.

Remarks:
The translation factor affects how much the keyframe translates (moves) it's animable object at it's time index.
Parameters:
trans  The vector to translate by

Definition at line 46 of file OgreKeyFrame.cpp.

References Ogre::AnimationTrack::_keyFrameDataChanged(), mParentTrack, and mTranslate.

Referenced by Ogre::AnimationTrack::getInterpolatedKeyFrame(), and Ogre::SkeletonSerializer::readKeyFrame().


Member Data Documentation

const AnimationTrack* Ogre::KeyFrame::mParentTrack [protected]
 

Definition at line 88 of file OgreKeyFrame.h.

Referenced by setRotation(), setScale(), and setTranslate().

Quaternion Ogre::KeyFrame::mRotate [protected]
 

Definition at line 87 of file OgreKeyFrame.h.

Referenced by getRotation(), KeyFrame(), and setRotation().

Vector3 Ogre::KeyFrame::mScale [protected]
 

Definition at line 86 of file OgreKeyFrame.h.

Referenced by getScale(), KeyFrame(), and setScale().

Real Ogre::KeyFrame::mTime [protected]
 

Definition at line 84 of file OgreKeyFrame.h.

Referenced by getTime().

Vector3 Ogre::KeyFrame::mTranslate [protected]
 

Definition at line 85 of file OgreKeyFrame.h.

Referenced by getTranslate(), KeyFrame(), and setTranslate().


The documentation for this class was generated from the following files:

Copyright © 2002-2003 by The OGRE Team
Last modified Fri May 14 23:26:26 2004