OpenSceneGraph/include/osgGA/AnimationPathManipulator

/* -*-c++-*- OpenSceneGraph - Copyright (C) 1998-2006 Robert Osfield 
 *
 * This library is open source and may be redistributed and/or modified under  
 * the terms of the OpenSceneGraph Public License (OSGPL) version 0.0 or 
 * (at your option) any later version.  The full license is in LICENSE file
 * included with this distribution, and on the openscenegraph.org website.
 * 
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the 
 * OpenSceneGraph Public License for more details.
*/

#ifndef OSGGA_ANIMATION_PATH_MANIPULATOR
#define OSGGA_ANIMATION_PATH_MANIPULATOR 1

#include <osg/AnimationPath>
#include <osg/Notify>
#include <osgGA/CameraManipulator>

namespace osgGA{

//
// The AnimationPathManipulator is a Matrix Manipulator that reads an
// animation path from a file and plays it back.  The file is expected
// to be ascii and a succession of lines with 8 floating point values
// per line.  The succession of values are:
// time  px py pz ax ay az aw
// where:
//    time = elapsed time in seconds from the beginning of the animation
//    px py pz = World position in cartesian coordinates
//    ax ay az aw = Orientation (attitude) defined as a quaternion

class OSGGA_EXPORT AnimationPathManipulator : public CameraManipulator
{
    public:
    
        AnimationPathManipulator( osg::AnimationPath* animationPath=0 );

        AnimationPathManipulator( const std::string& filename );
        
        virtual const char* className() const { return "AnimationPath"; }

        void setPrintOutTimingInfo(bool printOutTimingInfo) { _printOutTimingInfo=printOutTimingInfo; }
        bool getPrintOutTimingInfo() const { return _printOutTimingInfo; }
        
        /** set the position of the matrix manipulator using a 4x4 Matrix.*/
        virtual void setByMatrix(const osg::Matrixd& matrix) { _matrix = matrix; }

        /** set the position of the matrix manipulator using a 4x4 Matrix.*/
        virtual void setByInverseMatrix(const osg::Matrixd& matrix) { _matrix.invert(matrix); }

        /** get the position of the manipulator as 4x4 Matrix.*/
        virtual osg::Matrixd getMatrix() const { return _matrix; }

        /** get the position of the manipulator as a inverse matrix of the manipulator, typically used as a model view matrix.*/
        virtual osg::Matrixd getInverseMatrix() const { return osg::Matrixd::inverse(_matrix); } 


        void setAnimationPath( osg::AnimationPath* animationPath ) { _animationPath=animationPath; }
        
        osg::AnimationPath* getAnimationPath() { return _animationPath.get(); }
        
        const osg::AnimationPath* getAnimationPath() const { return _animationPath.get(); }

        bool valid() const { return _animationPath.valid(); }

        void init(const GUIEventAdapter& ea,GUIActionAdapter& us);

        void home(const GUIEventAdapter& ea,GUIActionAdapter& us);
        void home(double currentTime);

        virtual bool handle(const GUIEventAdapter& ea,GUIActionAdapter& us);

        /** Get the keyboard and mouse usage of this manipulator.*/
        virtual void getUsage(osg::ApplicationUsage& usage) const;
            
    protected:

        bool _valid;
        
        bool _printOutTimingInfo;

        void handleFrame( double time );

        osg::ref_ptr<osg::AnimationPath> _animationPath;
        
        double  _timeOffset;
        double  _timeScale;
        double  _pauseTime;
        bool    _isPaused;
        
        double  _realStartOfTimedPeriod;
        double  _animStartOfTimedPeriod;
        int     _numOfFramesSinceStartOfTimedPeriod;
        
        osg::Matrixd _matrix;

};

}

#endif