IAxisInfo.h

Go to the documentation of this file.

/*
 * SPDX-FileCopyrightText: 2006-2021 Istituto Italiano di Tecnologia (IIT)
 * SPDX-FileCopyrightText: 2006-2010 RobotCub Consortium
 * SPDX-License-Identifier: BSD-3-Clause
 */
 
#ifndef YARP_DEV_IAXISINFO_H
#define YARP_DEV_IAXISINFO_H
 
#include <string>
 
#include <yarp/os/Log.h>
#include <yarp/os/Vocab.h>
#include <yarp/dev/api.h>
 
namespace yarp
{
    namespace dev
    {
        class IAxisInfo;
        class IAxisInfoRaw;
 
        enum JointTypeEnum
        {
            VOCAB_JOINTTYPE_REVOLUTE  = yarp::os::createVocab32('a', 't', 'r', 'v'),
            VOCAB_JOINTTYPE_PRISMATIC = yarp::os::createVocab32('a', 't', 'p', 'r'),
            VOCAB_JOINTTYPE_UNKNOWN   = yarp::os::createVocab32('u', 'n', 'k', 'n')
        };
    }
}
 
class YARP_dev_API yarp::dev::IAxisInfo
{
public:
    virtual ~IAxisInfo() {}
 
    /* Get the name for a particular axis.
    * @param axis joint number
    * @param name the axis name
    * @return true if everything goes fine, false otherwise.
    */
    virtual bool getAxisName(int axis, std::string& name) = 0;
 
    /* Get the joint type (e.g. revolute/prismatic) for a particular axis.
    * @param axis joint number
    * @param type the joint type
    * @return true if everything goes fine, false otherwise.
    */
    virtual bool getJointType(int axis, yarp::dev::JointTypeEnum& type) { yFatal("getJointType() not implemented on your device, cannot proceed further. Please report the problem on yarp issue tracker"); return false; }
};
 
class YARP_dev_API yarp::dev::IAxisInfoRaw
{
public:
    virtual ~IAxisInfoRaw() {}
 
    /* Get the name for a particular axis.
    * @param axis joint number
    * @param name the axis name
    * @return true if everything goes fine, false otherwise.
    */
    virtual bool getAxisNameRaw(int axis, std::string& name) = 0;
 
    /* Get the joint type (e.g. revolute/prismatic) for a particular axis.
    * @param axis joint number
    * @param type the joint type
    * @return true if everything goes fine, false otherwise.
    */
    virtual bool getJointTypeRaw(int axis, yarp::dev::JointTypeEnum& type)  { yFatal("getJointType() not implemented on your device, cannot proceed further. Please report the problem on yarp issue tracker"); return false; };
};
 
// interface IAxisInfo
constexpr yarp::conf::vocab32_t VOCAB_INFO_NAME            = yarp::os::createVocab32('n','a','m','e');
constexpr yarp::conf::vocab32_t VOCAB_INFO_TYPE            = yarp::os::createVocab32('t','y','p','e');
 
#endif // YARP_DEV_IAXISINFO_H