joint.hpp

// Copyright  (C)  2007  Ruben Smits <ruben dot smits at intermodalics dot eu>
 
// Version: 1.0
// Author: Ruben Smits <ruben dot smits at intermodalics dot eu>
// Maintainer: Ruben Smits <ruben dot smits at intermodalics dot eu>
// URL: http://www.orocos.org/kdl
 
// This library is free software; you can redistribute it and/or
// modify it under the terms of the GNU Lesser General Public
// License as published by the Free Software Foundation; either
// version 2.1 of the License, or (at your option) any later version.
 
// 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 GNU
// Lesser General Public License for more details.
 
// You should have received a copy of the GNU Lesser General Public
// License along with this library; if not, write to the Free Software
// Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
 
#ifndef KDL_JOINT_HPP
#define KDL_JOINT_HPP
 
#include "frames.hpp"
#include <string>
#include <exception>
 
 
namespace KDL {

    class Joint {
    public:
        typedef enum { RotAxis,RotX,RotY,RotZ,TransAxis,TransX,TransY,TransZ,Fixed,None=Fixed} JointType;
        explicit Joint(const std::string& name, const JointType& type=Fixed,const double& scale=1,const double& offset=0,
              const double& inertia=0,const double& damping=0,const double& stiffness=0);
        explicit Joint(const JointType& type=Fixed,const double& scale=1,const double& offset=0,
               const double& inertia=0,const double& damping=0,const double& stiffness=0);
        Joint(const std::string& name, const Vector& _origin, const Vector& _axis, const JointType& type, const double& _scale=1, const double& _offset=0,
          const double& _inertia=0, const double& _damping=0, const double& _stiffness=0);
        Joint(const Vector& _origin, const Vector& _axis, const JointType& type, const double& _scale=1, const double& _offset=0,
          const double& _inertia=0, const double& _damping=0, const double& _stiffness=0);

        Frame pose(const double& q)const;
        Twist twist(const double& qdot)const;

        Vector JointAxis() const;

        Vector JointOrigin() const;
          const std::string& getName()const
          {
              return name;
          }

        const JointType& getType() const
        {
            return type;
        };

        const std::string getTypeName() const
        {
            switch (type) {
        case RotAxis:
            return "RotAxis";
            case TransAxis:
            return "TransAxis";
        case RotX:
                return "RotX";
            case RotY:
                return "RotY";
            case RotZ:
                return "RotZ";
            case TransX:
                return "TransX";
            case TransY:
                return "TransY";
            case TransZ:
                return "TransZ";
            case Fixed:
                return "Fixed";
            default:
                return "Fixed";
            }
        };

        const double& getScale() const
        {
            return scale;
        }

        const double& getOffset() const
        {
            return offset;
        }

        const double& getInertia() const
        {
            return inertia;
        };

        const double& getDamping() const
        {
            return damping;
        };

        const double& getStiffness() const
        {
            return stiffness;
        };

        const Vector& getAxis() const
        {
            return axis;
        }

        const Vector& getOrigin() const
        {
            return origin;
        }
 
        virtual ~Joint();
 
    private:
        std::string name;
        Joint::JointType type;
        double scale;
        double offset;
        double inertia;
        double damping;
        double stiffness;
 
        // variables for RotAxis joint
        Vector axis, origin;
        mutable Frame  joint_pose; // Deprecated, but keeping for ABI compatibility
        mutable double q_previous; // Deprecated, but keeping for ABI compatibility
 
      class joint_type_exception: public std::exception{
    virtual const char* what() const throw(){
      return "Joint Type excption";}
      } joint_type_ex;
 
    };
 
} // end of namespace KDL
 
#endif