SLNodeAnimTrack Class Reference

Specialized animation track for node animations. More...

#include <SLAnimTrack.h>

Inheritance diagram for SLNodeAnimTrack:

Public Member Functions
	SLNodeAnimTrack (SLAnimation *parent)
virtual	~SLNodeAnimTrack ()
SLTransformKeyframe *	createNodeKeyframe (SLfloat time)
void	animatedNode (SLNode *target)
SLNode *	animatedNode ()
virtual void	calcInterpolatedKeyframe (SLfloat time, SLAnimKeyframe *keyframe) const
virtual void	apply (SLfloat time, SLfloat weight=1.0f, SLfloat scale=1.0f)
virtual void	applyToNode (SLNode *node, SLfloat time, SLfloat weight=1.0f, SLfloat scale=1.0f)
virtual void	drawVisuals (SLSceneView *sv)
	Draws all visualizations of node animations. More...
void	interpolationCurve (SLCurve *curve)
void	translationInterpolation (SLAnimInterpolation interp)
Public Member Functions inherited from SLAnimTrack
	SLAnimTrack (SLAnimation *parent)
virtual	~SLAnimTrack ()
SLAnimKeyframe *	createKeyframe (SLfloat time)
SLfloat	getKeyframesAtTime (SLfloat time, SLAnimKeyframe **k1, SLAnimKeyframe **k2) const
SLint	numKeyframes () const
SLAnimKeyframe *	keyframe (SLint index)

Protected Member Functions
void	buildInterpolationCurve () const
virtual SLAnimKeyframe *	createKeyframeImpl (SLfloat time)

Protected Attributes
SLNode *	_animatedNode
	the target node for this track_nodeID More...
SLCurve *	_interpolationCurve
	the translation interpolation curve More...
SLAnimInterpolation	_translationInterpolation
	interpolation mode for translations (Bezier or linear) More...
SLbool	_rebuildInterpolationCurve
	dirty flag of the Bezier curve More...
Protected Attributes inherited from SLAnimTrack
SLAnimation *	_animation
	parent animation that created this track More...
SLVKeyframe	_keyframes
	keyframe list for this track More...

Detailed Description

Specialized animation track for node animations.

Allows for translation, scale and rotation parameters to be animated. Also allows for either linear or Bezier interpolation of the position parameter in the track.

Definition at line 65 of file SLAnimTrack.h.

Constructor & Destructor Documentation

SLNodeAnimTrack()

SLNodeAnimTrack::SLNodeAnimTrack

(

SLAnimation *

animation

)

Constructor for specialized NodeAnimationTrack

Definition at line 169 of file SLAnimTrack.cpp.

  : SLAnimTrack(animation),
    _animatedNode(nullptr),
    _interpolationCurve(nullptr),
    _translationInterpolation(AI_linear),
    _rebuildInterpolationCurve(true)
{
}

~SLNodeAnimTrack()

SLNodeAnimTrack::~SLNodeAnimTrack ( )

virtual

Destructor

Definition at line 181 of file SLAnimTrack.cpp.

{
    if (_interpolationCurve)
        delete _interpolationCurve;
}

Member Function Documentation

animatedNode() [1/2]

SLNode* SLNodeAnimTrack::animatedNode ( )

inline

Definition at line 74 of file SLAnimTrack.h.

{ return _animatedNode; }

animatedNode() [2/2]

void SLNodeAnimTrack::animatedNode ( SLNode *  target )

inline

Definition at line 73 of file SLAnimTrack.h.

{ _animatedNode = target; }

apply()

void SLNodeAnimTrack::apply ( SLfloat  time, SLfloat  weight = 1.0f, SLfloat  scale = 1.0f  )

virtual

Applies the animation with the input timestamp to the set animation target if it exists.

Implements SLAnimTrack.

Definition at line 239 of file SLAnimTrack.cpp.

{
    if (_animatedNode)
        applyToNode(_animatedNode, time, weight, scale);
}

applyToNode()

void SLNodeAnimTrack::applyToNode ( SLNode *  node, SLfloat  time, SLfloat  weight = 1.0f, SLfloat  scale = 1.0f  )

virtual

Applies the animation to the input node with the input timestamp and weight.

Definition at line 248 of file SLAnimTrack.cpp.

{
    if (node == nullptr)
        return;
 
    SLTransformKeyframe kf(nullptr, time);
    calcInterpolatedKeyframe(time, &kf);
 
    SLVec3f translation = kf.translation() * weight * scale;
    node->translate(translation, TS_parent);
 
    // @todo update the slerp and lerp implementation for quaternions
    //       there is currently no early out for 1.0 and 0.0 inputs
    //       also provide a non OO version.
    SLQuat4f rotation = SLQuat4f().slerp(kf.rotation(), weight);
    node->rotate(rotation, TS_parent);
 
    // @todo find a good way to combine scale animations,
    // we can't just scale them by a weight factor...
    SLVec3f scl = kf.scale();
    node->scale(scl);
}

buildInterpolationCurve()

void SLNodeAnimTrack::buildInterpolationCurve ( ) const

protected

Rebuilds the translation interpolation Bezier curve.

Definition at line 289 of file SLAnimTrack.cpp.

{
    if (numKeyframes() > 1)
    {
        if (_interpolationCurve) delete _interpolationCurve;
 
        // Build curve data w. cumulated times
        SLVVec4f points;
        points.resize((SLuint)numKeyframes());
        // SLfloat  curTime = 0;
        for (SLuint i = 0; i < (SLuint)numKeyframes(); ++i)
        {
            SLVec3f t = ((SLTransformKeyframe*)_keyframes[i])->translation();
            points[i].set(t.x, t.y, t.z, _keyframes[i]->time());
        }
 
        // create curve and delete temp arrays again
        _interpolationCurve = new SLCurveBezier(points);
    }
}

calcInterpolatedKeyframe()

void SLNodeAnimTrack::calcInterpolatedKeyframe ( SLfloat  time, SLAnimKeyframe *  keyframe  ) const

virtual

Calculates a new keyframe based on the input time and interpolation functions.

Implements SLAnimTrack.

Definition at line 198 of file SLAnimTrack.cpp.

{
    SLAnimKeyframe* k1;
    SLAnimKeyframe* k2;
 
    SLfloat t = getKeyframesAtTime(time, &k1, &k2);
 
    if (k1 == nullptr)
        return;
 
    SLTransformKeyframe* kfOut = static_cast<SLTransformKeyframe*>(keyframe);
    SLTransformKeyframe* kf1   = static_cast<SLTransformKeyframe*>(k1);
    SLTransformKeyframe* kf2   = static_cast<SLTransformKeyframe*>(k2);
 
    SLVec3f base = kf1->translation();
    SLVec3f translation;
    if (_translationInterpolation == AI_linear)
        translation = base + (kf2->translation() - base) * t;
    else
    {
        if (_rebuildInterpolationCurve)
            buildInterpolationCurve();
        translation = _interpolationCurve->evaluate(time);
    }
 
    kfOut->translation(translation);
 
    SLQuat4f rotation;
    rotation = kf1->rotation().slerp(kf2->rotation(), t); // @todo provide a 2 parameter implementation for lerp, slerp etc.
    kfOut->rotation(rotation);
 
    base = kf1->scale();
    SLVec3f scale;
    scale = base + (kf2->scale() - base) * t;
    kfOut->scale(scale);
}

createKeyframeImpl()

SLAnimKeyframe * SLNodeAnimTrack::createKeyframeImpl ( SLfloat  time )

protectedvirtual

Implementation for the keyframe creation function.

Implements SLAnimTrack.

Definition at line 313 of file SLAnimTrack.cpp.

{
    return new SLTransformKeyframe(this, time);
}

createNodeKeyframe()

SLTransformKeyframe * SLNodeAnimTrack::createNodeKeyframe

(

SLfloat

time

)

Creates a new SLTransformKeyframe at 'time'.

Definition at line 190 of file SLAnimTrack.cpp.

{
    return static_cast<SLTransformKeyframe*>(createKeyframe(time));
}

drawVisuals()

void SLNodeAnimTrack::drawVisuals ( SLSceneView *  sv )

virtual

Draws all visualizations of node animations.

Implements SLAnimTrack.

Definition at line 275 of file SLAnimTrack.cpp.

{
    if (_animatedNode && _interpolationCurve &&
        (sv->drawBit(SL_DB_AXIS) || _animatedNode->drawBit(SL_DB_AXIS)))
    {
        // Move the animation curve to the initial WM position of the node
        SLMat4f parentWM  = _animatedNode->parent()->updateAndGetWM();
        SLMat4f initialOM = _animatedNode->initialOM();
        _interpolationCurve->draw(parentWM * initialOM);
    }
}

interpolationCurve()

void SLNodeAnimTrack::interpolationCurve

(

SLCurve *

curve

)

setter for the interpolation curve

Definition at line 321 of file SLAnimTrack.cpp.

{
    if (_interpolationCurve)
        delete _interpolationCurve;
 
    _interpolationCurve        = curve;
    _rebuildInterpolationCurve = false;
}

translationInterpolation()

void SLNodeAnimTrack::translationInterpolation ( SLAnimInterpolation  interp )

inline

Definition at line 82 of file SLAnimTrack.h.

{ _translationInterpolation = interp; }

Member Data Documentation

_animatedNode

SLNode* SLNodeAnimTrack::_animatedNode

protected

the target node for this track_nodeID

Definition at line 88 of file SLAnimTrack.h.

_interpolationCurve

SLCurve* SLNodeAnimTrack::_interpolationCurve

mutableprotected

the translation interpolation curve

Definition at line 89 of file SLAnimTrack.h.

_rebuildInterpolationCurve

SLbool SLNodeAnimTrack::_rebuildInterpolationCurve

protected

dirty flag of the Bezier curve

Definition at line 91 of file SLAnimTrack.h.

_translationInterpolation

SLAnimInterpolation SLNodeAnimTrack::_translationInterpolation

protected

interpolation mode for translations (Bezier or linear)

Definition at line 90 of file SLAnimTrack.h.

---

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

• SLAnimTrack.h
• SLAnimTrack.cpp