OpenSceneGraph/include/osgGA/AnimationPathManipulator

/* -*-c++-*- OpenSceneGraph - Copyright (C) 1998-2003 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 Camera 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 begining of the animation
//    px py pz = World position in catesian 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 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);

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

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

	bool _valid;

	void handleFrame( double time );

	osg::ref_ptr<osg::AnimationPath> _animationPath;
        
        double _timeOffset;
        double _timeScale;

};

}

#endif