OpenCVGrabber_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 20:45:26 2025
 
 
#include "OpenCVGrabber_ParamsParser.h"
#include <yarp/os/LogStream.h>
#include <yarp/os/Value.h>
 
namespace {
    YARP_LOG_COMPONENT(OpenCVGrabberParamsCOMPONENT, "yarp.device.OpenCVGrabber")
}
 
 
OpenCVGrabber_ParamsParser::OpenCVGrabber_ParamsParser()
{
}
 
 
std::vector<std::string> OpenCVGrabber_ParamsParser::getListOfParams() const
{
    std::vector<std::string> params;
    params.push_back("movie");
    params.push_back("loop");
    params.push_back("camera");
    params.push_back("framerate");
    params.push_back("width");
    params.push_back("height");
    params.push_back("flip_x");
    params.push_back("flip_y");
    params.push_back("transpose");
    return params;
}
 
 
bool OpenCVGrabber_ParamsParser::getParamValue(const std::string& paramName, std::string& paramValue) const
{
    if (paramName =="movie")
    {
        paramValue = m_movie;
        return true;
    }
    if (paramName =="loop")
    {
        if (m_loop==true) paramValue = "true";
        else paramValue = "false";
        return true;
    }
    if (paramName =="camera")
    {
        paramValue = std::to_string(m_camera);
        return true;
    }
    if (paramName =="framerate")
    {
        paramValue = std::to_string(m_framerate);
        return true;
    }
    if (paramName =="width")
    {
        paramValue = std::to_string(m_width);
        return true;
    }
    if (paramName =="height")
    {
        paramValue = std::to_string(m_height);
        return true;
    }
    if (paramName =="flip_x")
    {
        if (m_flip_x==true) paramValue = "true";
        else paramValue = "false";
        return true;
    }
    if (paramName =="flip_y")
    {
        if (m_flip_y==true) paramValue = "true";
        else paramValue = "false";
        return true;
    }
    if (paramName =="transpose")
    {
        if (m_transpose==true) paramValue = "true";
        else paramValue = "false";
        return true;
    }
 
    yError() <<"parameter '" << paramName << "' was not found";
    return false;
 
}
 
 
std::string OpenCVGrabber_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      OpenCVGrabber_ParamsParser::parseParams(const yarp::os::Searchable & config)
{
    //Check for --help option
    if (config.check("help"))
    {
        yCInfo(OpenCVGrabberParamsCOMPONENT) << getDocumentationOfDeviceParams();
    }
 
    m_provided_configuration = config.toString();
    yarp::os::Property prop_check(m_provided_configuration.c_str());
    //Parser of parameter movie
    {
        if (config.check("movie"))
        {
            m_movie = config.find("movie").asString();
            yCInfo(OpenCVGrabberParamsCOMPONENT) << "Parameter 'movie' using value:" << m_movie;
        }
        else
        {
            yCInfo(OpenCVGrabberParamsCOMPONENT) << "Parameter 'movie' using DEFAULT value:" << m_movie;
        }
        prop_check.unput("movie");
    }
 
    //Parser of parameter loop
    {
        if (config.check("loop"))
        {
            m_loop = config.find("loop").asBool();
            yCInfo(OpenCVGrabberParamsCOMPONENT) << "Parameter 'loop' using value:" << m_loop;
        }
        else
        {
            yCInfo(OpenCVGrabberParamsCOMPONENT) << "Parameter 'loop' using DEFAULT value:" << m_loop;
        }
        prop_check.unput("loop");
    }
 
    //Parser of parameter camera
    {
        if (config.check("camera"))
        {
            m_camera = config.find("camera").asInt64();
            yCInfo(OpenCVGrabberParamsCOMPONENT) << "Parameter 'camera' using value:" << m_camera;
        }
        else
        {
            yCInfo(OpenCVGrabberParamsCOMPONENT) << "Parameter 'camera' using DEFAULT value:" << m_camera;
        }
        prop_check.unput("camera");
    }
 
    //Parser of parameter framerate
    {
        if (config.check("framerate"))
        {
            m_framerate = config.find("framerate").asFloat64();
            yCInfo(OpenCVGrabberParamsCOMPONENT) << "Parameter 'framerate' using value:" << m_framerate;
        }
        else
        {
            yCInfo(OpenCVGrabberParamsCOMPONENT) << "Parameter 'framerate' using DEFAULT value:" << m_framerate;
        }
        prop_check.unput("framerate");
    }
 
    //Parser of parameter width
    {
        if (config.check("width"))
        {
            m_width = config.find("width").asInt64();
            yCInfo(OpenCVGrabberParamsCOMPONENT) << "Parameter 'width' using value:" << m_width;
        }
        else
        {
            yCInfo(OpenCVGrabberParamsCOMPONENT) << "Parameter 'width' using DEFAULT value:" << m_width;
        }
        prop_check.unput("width");
    }
 
    //Parser of parameter height
    {
        if (config.check("height"))
        {
            m_height = config.find("height").asInt64();
            yCInfo(OpenCVGrabberParamsCOMPONENT) << "Parameter 'height' using value:" << m_height;
        }
        else
        {
            yCInfo(OpenCVGrabberParamsCOMPONENT) << "Parameter 'height' using DEFAULT value:" << m_height;
        }
        prop_check.unput("height");
    }
 
    //Parser of parameter flip_x
    {
        if (config.check("flip_x"))
        {
            m_flip_x = config.find("flip_x").asBool();
            yCInfo(OpenCVGrabberParamsCOMPONENT) << "Parameter 'flip_x' using value:" << m_flip_x;
        }
        else
        {
            yCInfo(OpenCVGrabberParamsCOMPONENT) << "Parameter 'flip_x' using DEFAULT value:" << m_flip_x;
        }
        prop_check.unput("flip_x");
    }
 
    //Parser of parameter flip_y
    {
        if (config.check("flip_y"))
        {
            m_flip_y = config.find("flip_y").asBool();
            yCInfo(OpenCVGrabberParamsCOMPONENT) << "Parameter 'flip_y' using value:" << m_flip_y;
        }
        else
        {
            yCInfo(OpenCVGrabberParamsCOMPONENT) << "Parameter 'flip_y' using DEFAULT value:" << m_flip_y;
        }
        prop_check.unput("flip_y");
    }
 
    //Parser of parameter transpose
    {
        if (config.check("transpose"))
        {
            m_transpose = config.find("transpose").asBool();
            yCInfo(OpenCVGrabberParamsCOMPONENT) << "Parameter 'transpose' using value:" << m_transpose;
        }
        else
        {
            yCInfo(OpenCVGrabberParamsCOMPONENT) << "Parameter 'transpose' using DEFAULT value:" << m_transpose;
        }
        prop_check.unput("transpose");
    }
 
    /*
    //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(OpenCVGrabberParamsCOMPONENT) << "User asking for parameter: "<<it->name <<" which is unknown to this parser!";
                extra_params_found = true;
            }
            else
            {
                yCWarning(OpenCVGrabberParamsCOMPONENT) << "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      OpenCVGrabber_ParamsParser::getDocumentationOfDeviceParams() const
{
    std::string doc;
    doc = doc + std::string("\n=============================================\n");
    doc = doc + std::string("This is the help for device: OpenCVGrabber\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("'movie': if present, read an .avi file instead of opening a camera\n");
    doc = doc + std::string("'loop': if true, and movie parameter is set, enable the loop playback of the file\n");
    doc = doc + std::string("'camera': Id of the camera hardware device\n");
    doc = doc + std::string("'framerate': Framerate. Default value obtained by the hardware\n");
    doc = doc + std::string("'width': Width of the frame. Default value obtained by the hardware\n");
    doc = doc + std::string("'height': Height of the frame. Default value obtained by the hardware\n");
    doc = doc + std::string("'flip_x': Flip along the x axis\n");
    doc = doc + std::string("'flip_y': flip along the y axis\n");
    doc = doc + std::string("'transpose': Rotate the image by 90 degrees\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 openCVGrabber --movie <optional_value> --loop false --camera 0 --framerate -1 --width 0 --height 0 --flip_x false --flip_y false --transpose false\n";
    doc = doc + std::string("Using only mandatory params:\n");
    doc = doc + " yarpdev --device openCVGrabber\n";
    doc = doc + std::string("=============================================\n\n");    return doc;
}