Fact.h 4.27 KB
Newer Older
Don Gagne's avatar
Don Gagne committed
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34
/*=====================================================================
 
 QGroundControl Open Source Ground Control Station
 
 (c) 2009 - 2014 QGROUNDCONTROL PROJECT <http://www.qgroundcontrol.org>
 
 This file is part of the QGROUNDCONTROL project
 
 QGROUNDCONTROL 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 3 of the License, or
 (at your option) any later version.
 
 QGROUNDCONTROL 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 QGROUNDCONTROL. If not, see <http://www.gnu.org/licenses/>.
 
 ======================================================================*/

/// @file
///     @author Don Gagne <don@thegagnes.com>

#ifndef Fact_H
#define Fact_H

#include "FactMetaData.h"

#include <QObject>
#include <QString>
#include <QVariant>
35
#include <QDebug>
Don Gagne's avatar
Don Gagne committed
36 37 38 39 40 41 42

/// @brief A Fact is used to hold a single value within the system.
class Fact : public QObject
{
    Q_OBJECT
    
public:
Don Gagne's avatar
Don Gagne committed
43
    Fact(void);
44
    Fact(int componentId, QString name, FactMetaData::ValueType_t type, QObject* parent = NULL);
Don Gagne's avatar
Don Gagne committed
45
    
Don Gagne's avatar
Don Gagne committed
46 47 48 49 50 51 52 53 54 55 56 57
    Q_PROPERTY(int componentId READ componentId CONSTANT)
    Q_PROPERTY(QString name READ name CONSTANT)
    Q_PROPERTY(QVariant value READ value WRITE setValue NOTIFY valueChanged USER true)
    Q_PROPERTY(QVariant valueString READ valueString NOTIFY valueChanged)
    Q_PROPERTY(QString units READ units CONSTANT)
    Q_PROPERTY(QVariant defaultValue READ defaultValue CONSTANT)
    Q_PROPERTY(bool defaultValueAvailable READ defaultValueAvailable CONSTANT)
    Q_PROPERTY(bool valueEqualsDefault READ valueEqualsDefault NOTIFY valueChanged)
    Q_PROPERTY(FactMetaData::ValueType_t type READ type CONSTANT)
    Q_PROPERTY(QString shortDescription READ shortDescription CONSTANT)
    Q_PROPERTY(QString longDescription READ longDescription CONSTANT)
    Q_PROPERTY(QVariant min READ min CONSTANT)
Don Gagne's avatar
Don Gagne committed
58
    Q_PROPERTY(bool minIsDefaultForType READ minIsDefaultForType CONSTANT)
Don Gagne's avatar
Don Gagne committed
59
    Q_PROPERTY(QVariant max READ max CONSTANT)
Don Gagne's avatar
Don Gagne committed
60
    Q_PROPERTY(bool maxIsDefaultForType READ maxIsDefaultForType CONSTANT)
Don Gagne's avatar
Don Gagne committed
61 62
    Q_PROPERTY(QString group READ group CONSTANT)
    
Don Gagne's avatar
Don Gagne committed
63 64 65 66
    /// Convert and validate value
    ///     @param convertOnly true: validate type conversion only, false: validate against meta data as well
    Q_INVOKABLE QString validate(const QString& value, bool convertOnly);
    
Don Gagne's avatar
Don Gagne committed
67 68
    // Property system methods
    
69
    QString name(void) const;
70
    int componentId(void) const;
71 72
    QVariant value(void) const;
    QString valueString(void) const;
73
    void setValue(const QVariant& value);
74
    QVariant defaultValue(void);
75 76
	bool defaultValueAvailable(void);
    bool valueEqualsDefault(void);
77 78 79 80 81
    FactMetaData::ValueType_t type(void);
    QString shortDescription(void);
    QString longDescription(void);
    QString units(void);
    QVariant min(void);
Don Gagne's avatar
Don Gagne committed
82
    bool minIsDefaultForType(void);
83
    QVariant max(void);    
Don Gagne's avatar
Don Gagne committed
84
    bool maxIsDefaultForType(void);
85
    QString group(void);
Don Gagne's avatar
Don Gagne committed
86
    
87 88 89
    /// Sets and sends new value to vehicle even if value is the same
    void forceSetValue(const QVariant& value);
    
Don Gagne's avatar
Don Gagne committed
90
    /// Sets the meta data associated with the Fact.
91
    void setMetaData(FactMetaData* metaData);
Don Gagne's avatar
Don Gagne committed
92
    
93 94
    void _containerSetValue(const QVariant& value);
    
Don Gagne's avatar
Don Gagne committed
95 96 97 98
signals:
    /// QObject Property System signal for value property changes
    ///
    /// This signal is only meant for use by the QT property system. It should not be connected to by client code.
99
    void valueChanged(QVariant value);
Don Gagne's avatar
Don Gagne committed
100
    
101 102 103
    /// Signalled when the param write ack comes back from the vehicle
    void vehicleUpdated(QVariant value);
    
Don Gagne's avatar
Don Gagne committed
104 105
    /// Signalled when property has been changed by a call to the property write accessor
    ///
106
    /// This signal is meant for use by Fact container implementations.
Don Gagne's avatar
Don Gagne committed
107
    void _containerValueChanged(const QVariant& value);
Don Gagne's avatar
Don Gagne committed
108 109
    
private:
110
    QString                     _name;
111
    int                         _componentId;
112 113 114
    QVariant                    _value;
    FactMetaData::ValueType_t   _type;
    FactMetaData*               _metaData;
Don Gagne's avatar
Don Gagne committed
115 116 117
};

#endif