FakeBot_ParamsParser.cpp

Go to the documentation of this file.

/*
 * SPDX-FileCopyrightText: 2023-2023 Istituto Italiano di Tecnologia (IIT)
 * SPDX-License-Identifier: LGPL-2.1-or-later
 */
 
 
// Generated by yarpDeviceParamParserGenerator (2.0)
// This is an automatically generated file. Please do not edit it.
// It will be re-generated if the cmake flag ALLOW_DEVICE_PARAM_PARSER_GERNERATION is ON.
 
// Generated on: Thu May 22 11:32:30 2025
 
 
#include "FakeBot_ParamsParser.h"
#include <yarp/os/LogStream.h>
#include <yarp/os/Value.h>
 
namespace {
    YARP_LOG_COMPONENT(FakeBotParamsCOMPONENT, "yarp.device.FakeBot")
}
 
 
FakeBot_ParamsParser::FakeBot_ParamsParser()
{
}
 
 
std::vector<std::string> FakeBot_ParamsParser::getListOfParams() const
{
    std::vector<std::string> params;
    params.push_back("background");
    params.push_back("target");
    params.push_back("noise");
    params.push_back("sx");
    params.push_back("sy");
    params.push_back("lifetime");
    return params;
}
 
 
bool FakeBot_ParamsParser::getParamValue(const std::string& paramName, std::string& paramValue) const
{
    if (paramName =="background")
    {
        paramValue = m_background;
        return true;
    }
    if (paramName =="target")
    {
        paramValue = m_target;
        return true;
    }
    if (paramName =="noise")
    {
        paramValue = std::to_string(m_noise);
        return true;
    }
    if (paramName =="sx")
    {
        paramValue = std::to_string(m_sx);
        return true;
    }
    if (paramName =="sy")
    {
        paramValue = std::to_string(m_sy);
        return true;
    }
    if (paramName =="lifetime")
    {
        paramValue = std::to_string(m_lifetime);
        return true;
    }
 
    yError() <<"parameter '" << paramName << "' was not found";
    return false;
 
}
 
 
std::string FakeBot_ParamsParser::getConfiguration() const
{
    //This is a sub-optimal solution.
    //Ideally getConfiguration() should return all parameters but it is currently
    //returning only user provided parameters (excluding default values)
    //This behaviour will be fixed in the near future.
    std::string s_cfg = m_provided_configuration;
    return s_cfg;
}
 
bool      FakeBot_ParamsParser::parseParams(const yarp::os::Searchable & config)
{
    //Check for --help option
    if (config.check("help"))
    {
        yCInfo(FakeBotParamsCOMPONENT) << getDocumentationOfDeviceParams();
    }
 
    m_provided_configuration = config.toString();
    yarp::os::Property prop_check(m_provided_configuration.c_str());
    //Parser of parameter background
    {
        if (config.check("background"))
        {
            m_background = config.find("background").asString();
            yCInfo(FakeBotParamsCOMPONENT) << "Parameter 'background' using value:" << m_background;
        }
        else
        {
            yCInfo(FakeBotParamsCOMPONENT) << "Parameter 'background' using DEFAULT value:" << m_background;
        }
        prop_check.unput("background");
    }
 
    //Parser of parameter target
    {
        if (config.check("target"))
        {
            m_target = config.find("target").asString();
            yCInfo(FakeBotParamsCOMPONENT) << "Parameter 'target' using value:" << m_target;
        }
        else
        {
            yCInfo(FakeBotParamsCOMPONENT) << "Parameter 'target' using DEFAULT value:" << m_target;
        }
        prop_check.unput("target");
    }
 
    //Parser of parameter noise
    {
        if (config.check("noise"))
        {
            m_noise = config.find("noise").asFloat64();
            yCInfo(FakeBotParamsCOMPONENT) << "Parameter 'noise' using value:" << m_noise;
        }
        else
        {
            yCInfo(FakeBotParamsCOMPONENT) << "Parameter 'noise' using DEFAULT value:" << m_noise;
        }
        prop_check.unput("noise");
    }
 
    //Parser of parameter sx
    {
        if (config.check("sx"))
        {
            m_sx = config.find("sx").asFloat64();
            yCInfo(FakeBotParamsCOMPONENT) << "Parameter 'sx' using value:" << m_sx;
        }
        else
        {
            yCInfo(FakeBotParamsCOMPONENT) << "Parameter 'sx' using DEFAULT value:" << m_sx;
        }
        prop_check.unput("sx");
    }
 
    //Parser of parameter sy
    {
        if (config.check("sy"))
        {
            m_sy = config.find("sy").asFloat64();
            yCInfo(FakeBotParamsCOMPONENT) << "Parameter 'sy' using value:" << m_sy;
        }
        else
        {
            yCInfo(FakeBotParamsCOMPONENT) << "Parameter 'sy' using DEFAULT value:" << m_sy;
        }
        prop_check.unput("sy");
    }
 
    //Parser of parameter lifetime
    {
        if (config.check("lifetime"))
        {
            m_lifetime = config.find("lifetime").asFloat64();
            yCInfo(FakeBotParamsCOMPONENT) << "Parameter 'lifetime' using value:" << m_lifetime;
        }
        else
        {
            yCInfo(FakeBotParamsCOMPONENT) << "Parameter 'lifetime' using DEFAULT value:" << m_lifetime;
        }
        prop_check.unput("lifetime");
    }
 
    /*
    //This code check if the user set some parameter which are not check by the parser
    //If the parser is set in strict mode, this will generate an error
    if (prop_check.size() > 0)
    {
        bool extra_params_found = false;
        for (auto it=prop_check.begin(); it!=prop_check.end(); it++)
        {
            if (m_parser_is_strict)
            {
                yCError(FakeBotParamsCOMPONENT) << "User asking for parameter: "<<it->name <<" which is unknown to this parser!";
                extra_params_found = true;
            }
            else
            {
                yCWarning(FakeBotParamsCOMPONENT) << "User asking for parameter: "<< it->name <<" which is unknown to this parser!";
            }
        }
 
       if (m_parser_is_strict && extra_params_found)
       {
           return false;
       }
    }
    */
    return true;
}
 
 
std::string      FakeBot_ParamsParser::getDocumentationOfDeviceParams() const
{
    std::string doc;
    doc = doc + std::string("\n=============================================\n");
    doc = doc + std::string("This is the help for device: FakeBot\n");
    doc = doc + std::string("\n");
    doc = doc + std::string("This is the list of the parameters accepted by the device:\n");
    doc = doc + std::string("'background': background image to use\n");
    doc = doc + std::string("'target': target image to use\n");
    doc = doc + std::string("'noise': pixel noise level\n");
    doc = doc + std::string("'sx': scaling for x coordinate\n");
    doc = doc + std::string("'sy': scaling for y coordinate\n");
    doc = doc + std::string("'lifetime': device should exist for this length of time\n");
    doc = doc + std::string("\n");
    doc = doc + std::string("Here are some examples of invocation command with yarpdev, with all params:\n");
    doc = doc + " yarpdev --device fakebot --background textures/back.ppm --target textures/fore.ppm --noise 0.05 --sx 1.0 --sy 1.0 --lifetime -1.0\n";
    doc = doc + std::string("Using only mandatory params:\n");
    doc = doc + " yarpdev --device fakebot\n";
    doc = doc + std::string("=============================================\n\n");    return doc;
}