configuration/include/parametersettable.h

/********************************************************************************
 *  FARSA - Total99                                                             *
 *  Copyright (C) 2008-2011 Tomassino Ferrauto <t_ferrauto@yahoo.it>            *
 *                                                                              *
 *  This program is free software; you can redistribute it and/or modify        *
 *  it under the terms of the GNU General Public License as published by        *
 *  the Free Software Foundation; either version 2 of the License, or           *
 *  (at your option) any later version.                                         *
 *                                                                              *
 *  This program 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 General Public License for more details.                                *
 *                                                                              *
 *  You should have received a copy of the GNU General Public License           *
 *  along with this program; if not, write to the Free Software                 *
 *  Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA  *
 ********************************************************************************/

#ifndef PARAMETER_SETTABLE_H
#define PARAMETER_SETTABLE_H

#include "configurationconfig.h"
#include "runtimeparametersetters.h"
#include <QFlags>
#include <cmath>
#include <limits>

namespace farsa {

class ConfigurationHelper;
class ConfigurationParameters;

class FARSA_CONF_API ParameterSettable
{
public:
    enum Property {
        Default = 0x0000,
        IsList = 0x0001,
        IsMandatory = 0x0002,
        AllowMultiple = 0x0004
    };
    Q_DECLARE_FLAGS( Properties, Property )
    
    
    static const double Infinity;
    static const int MaxInteger;
    static const int MinInteger;

    ParameterSettable()
    {
    }

    virtual ~ParameterSettable()
    {
    }

    virtual void save(ConfigurationParameters& params, QString prefix) = 0;
    
//#ifdef DOXYGEN_RUNNING
    static void describe( QString type ) { addTypeDescription( type, "Describe is missing" ); };
//#endif
    virtual void postConfigureInitialization()
    {
    }
    void setRuntimeParameter( QString paramFullPath, int newvalue );
    void setRuntimeParameter( QString paramFullPath, unsigned int newvalue );
    void setRuntimeParameter( QString paramFullPath, double newvalue );
    void setRuntimeParameter( QString paramFullPath, float newvalue );
    void setRuntimeParameter( QString paramFullPath, bool newvalue );
    QList<RuntimeParameterSetter*> runtimeParameterList();

protected:
    void markParameterAsRuntime( QString paramName, int* paramPointer );
    void markParameterAsRuntime( QString paramName, unsigned int* paramPointer );
    void markParameterAsRuntime( QString paramName, double* paramPointer );
    void markParameterAsRuntime( QString paramName, bool* paramPointer );
    template<class T>
    void markParameterAsRuntime( QString paramName, T* paramOwner, void (T::*setterMethod)(int), int (T::*getterMethod)()const ) {
        markParameterAsRuntime( new MethodSetter<T, int>( paramOwner, setterMethod, getterMethod, paramName ) );
    };
    template<class T>
    void markParameterAsRuntime( QString paramName, T* paramOwner, void (T::*setterMethod)(unsigned int), unsigned int (T::*getterMethod)()const ) {
        markParameterAsRuntime( new MethodSetter<T, unsigned int>( paramOwner, setterMethod, getterMethod, paramName ) );
    };
    template<class T>
    void markParameterAsRuntime( QString paramName, T* paramOwner, void (T::*setterMethod)(double), double (T::*getterMethod)()const ) {
        markParameterAsRuntime( new MethodSetter<T, double>( paramOwner, setterMethod, getterMethod, paramName ) );
    };
    template<class T>
    void markParameterAsRuntime( QString paramName, T* paramOwner, void (T::*setterMethod)(float), float (T::*getterMethod)()const ) {
        markParameterAsRuntime( new MethodSetter<T, float>( paramOwner, setterMethod, getterMethod, paramName ) );
    };
    template<class T>
    void markParameterAsRuntime( QString paramName, T* paramOwner, void (T::*setterMethod)(bool), bool (T::*getterMethod)()const ) {
        markParameterAsRuntime( new MethodSetter<T, bool>( paramOwner, setterMethod, getterMethod, paramName ) );
    };

    class FARSA_CONF_API StringDescriptor {
    public:
        StringDescriptor( QString paramPath );
        StringDescriptor& def( QString defaultValue );
        StringDescriptor& props( Properties properties );
        StringDescriptor& help( QString shortHelp, QString longHelp=QString("") );
    private:
        QString paramPath;
    };

    class FARSA_CONF_API IntDescriptor {
    public:
        IntDescriptor( QString paramPath );
        IntDescriptor& def( int defaultValue );
        IntDescriptor& props( Properties properties );
        IntDescriptor& limits( int lower_bound, int upper_bound );
        IntDescriptor& help( QString shortHelp, QString longHelp=QString("") );
    private:
        QString paramPath;
    };

    class FARSA_CONF_API RealDescriptor {
    public:
        RealDescriptor( QString paramPath );
        RealDescriptor& def( double defaultValue );
        RealDescriptor& props( Properties properties );
        RealDescriptor& limits( double lower_bound, double upper_bound );
        RealDescriptor& help( QString shortHelp, QString longHelp=QString("") );
    private:
        QString paramPath;
    };

    class FARSA_CONF_API BoolDescriptor {
    public:
        BoolDescriptor( QString paramPath );
        BoolDescriptor& def( bool defaultValue );
        BoolDescriptor& props( Properties properties );
        BoolDescriptor& help( QString shortHelp, QString longHelp=QString("") );
    private:
        QString paramPath;
    };

    class FARSA_CONF_API EnumDescriptor {
    public:
        EnumDescriptor( QString paramPath );
        EnumDescriptor& def( QString defaultValue );
        EnumDescriptor& props( Properties properties );
        EnumDescriptor& values( QStringList allValues );
        EnumDescriptor& help( QString shortHelp, QString longHelp=QString("") );
    private:
        QString paramPath;
    };

    class FARSA_CONF_API ObjectDescriptor {
    public:
        ObjectDescriptor( QString paramPath );
        ObjectDescriptor& props( Properties properties );
        ObjectDescriptor& type( QString className );
        ObjectDescriptor& help( QString shortHelp, QString longHelp=QString("") );
    private:
        QString paramPath;
    };

    class FARSA_CONF_API SubgroupDescriptor {
    public:
        SubgroupDescriptor( QString paramPath );
        SubgroupDescriptor& props( Properties properties );
        SubgroupDescriptor& type( QString className );
        SubgroupDescriptor& help( QString shortHelp, QString longHelp=QString("") );
        StringDescriptor describeString( QString parameter );
        IntDescriptor describeInt( QString parameter );
        RealDescriptor describeReal( QString parameter );
        BoolDescriptor describeBool( QString parameter );
        EnumDescriptor describeEnum( QString parameter );
        ObjectDescriptor describeObject( QString parameter );
        SubgroupDescriptor describeSubgroup( QString subgroup );
    private:
        QString subgroupPath;
    };

    class FARSA_CONF_API Descriptor {
    public:
        Descriptor( QString type, QString shortHelp, QString longHelp );
        StringDescriptor describeString( QString parameter );
        IntDescriptor describeInt( QString parameter );
        RealDescriptor describeReal( QString parameter );
        BoolDescriptor describeBool( QString parameter );
        EnumDescriptor describeEnum( QString parameter );
        ObjectDescriptor describeObject( QString parameter );
        SubgroupDescriptor describeSubgroup( QString subgroup );
    private:
        QString type;
    };

    static Descriptor addTypeDescription( QString type, QString shortHelp, QString longHelp=QString("") );

private:
    void markParameterAsRuntime( RuntimeParameterSetter* setter );

    QMap<QString, RuntimeParameterSetter*> runtimeParameters;
};

class FARSA_CONF_TEMPLATE ParameterSettableInConstructor : public ParameterSettable
{
public:
    ParameterSettableInConstructor()
    {
    }

    ParameterSettableInConstructor(ConfigurationParameters& /*params*/, QString /*prefix*/)
    {
    }

    virtual ~ParameterSettableInConstructor()
    {
    }
};

class FARSA_CONF_TEMPLATE ParameterSettableWithConfigureFunction : public ParameterSettable
{
public:
    ParameterSettableWithConfigureFunction()
    {
    }

    virtual ~ParameterSettableWithConfigureFunction()
    {
    }

    virtual void configure(ConfigurationParameters& params, QString prefix) = 0;
};

} // end namespace farsa

Q_DECLARE_OPERATORS_FOR_FLAGS( farsa::ParameterSettable::Properties )

#endif