FactMetaData.h 7.56 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 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53
/*=====================================================================
 
 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 FactMetaData_H
#define FactMetaData_H

#include <QObject>
#include <QString>
#include <QVariant>

/// Holds the meta data associated with a Fact.
///
/// Holds the meta data associated with a Fact. This is kept in a seperate object from the Fact itself
/// since you may have multiple instances of the same Fact. But there is only ever one FactMetaData
/// instance or each Fact.
class FactMetaData : public QObject
{
    Q_OBJECT
    
public:
    typedef enum {
        valueTypeUint8,
        valueTypeInt8,
        valueTypeUint16,
        valueTypeInt16,
        valueTypeUint32,
        valueTypeInt32,
        valueTypeFloat,
        valueTypeDouble
    } ValueType_t;
54 55

    typedef QVariant (*Translator)(const QVariant& from);
Don Gagne's avatar
Don Gagne committed
56
    
Don Gagne's avatar
Don Gagne committed
57
    FactMetaData(QObject* parent = NULL);
58
    FactMetaData(ValueType_t type, QObject* parent = NULL);
Don Gagne's avatar
Don Gagne committed
59 60 61
    FactMetaData(const FactMetaData& other, QObject* parent = NULL);

    const FactMetaData& operator=(const FactMetaData& other);
62

63
    int             decimalPlaces           (void) const { return _decimalPlaces; }
64 65
    QVariant        rawDefaultValue         (void) const;
    QVariant        cookedDefaultValue      (void) const { return _rawTranslator(rawDefaultValue()); }
66
    bool            defaultValueAvailable   (void) const { return _defaultValueAvailable; }
67 68
    QStringList     bitmaskStrings          (void) const { return _bitmaskStrings; }
    QVariantList    bitmaskValues           (void) const { return _bitmaskValues; }
69 70 71 72
    QStringList     enumStrings             (void) const { return _enumStrings; }
    QVariantList    enumValues              (void) const { return _enumValues; }
    QString         group                   (void) const { return _group; }
    QString         longDescription         (void) const { return _longDescription;}
73 74
    QVariant        rawMax                  (void) const { return _rawMax; }
    QVariant        cookedMax               (void) const { return _rawTranslator(_rawMax); }
75
    bool            maxIsDefaultForType     (void) const { return _maxIsDefaultForType; }
76 77
    QVariant        rawMin                  (void) const { return _rawMin; }
    QVariant        cookedMin               (void) const { return _rawTranslator(_rawMin); }
78 79 80 81
    bool            minIsDefaultForType     (void) const { return _minIsDefaultForType; }
    QString         name                    (void) const { return _name; }
    QString         shortDescription        (void) const { return _shortDescription; }
    ValueType_t     type                    (void) const { return _type; }
82 83
    QString         rawUnits                (void) const { return _rawUnits; }
    QString         cookedUnits             (void) const { return _cookedUnits; }
84
    bool            rebootRequired          (void) const { return _rebootRequired; }
85 86 87

    Translator      rawTranslator           (void) const { return _rawTranslator; }
    Translator      cookedTranslator        (void) const { return _cookedTranslator; }
88

89 90 91
    /// Used to add new values to the bitmask lists after the meta data has been loaded
    void addBitmaskInfo(const QString& name, const QVariant& value);

92 93 94
    /// Used to add new values to the enum lists after the meta data has been loaded
    void addEnumInfo(const QString& name, const QVariant& value);

95
    void setDecimalPlaces   (int decimalPlaces)                 { _decimalPlaces = decimalPlaces; }
96
    void setRawDefaultValue (const QVariant& rawDefaultValue);
97
    void setBitmaskInfo     (const QStringList& strings, const QVariantList& values);
98 99 100
    void setEnumInfo        (const QStringList& strings, const QVariantList& values);
    void setGroup           (const QString& group)              { _group = group; }
    void setLongDescription (const QString& longDescription)    { _longDescription = longDescription;}
101 102
    void setRawMax          (const QVariant& rawMax);
    void setRawMin          (const QVariant& rawMin);
103
    void setName            (const QString& name)               { _name = name; }
104
    void setShortDescription(const QString& shortDescription)   { _shortDescription = shortDescription; }
105
    void setRawUnits        (const QString& rawUnits);
106
    void setRebootRequired  (bool rebootRequired)               { _rebootRequired = rebootRequired; }
107 108 109

    void setTranslators(Translator rawTranslator, Translator cookedTranslator);

110 111
    /// Converts the specified raw value, validating against meta data
    ///     @param rawValue Value to convert, can be string
Don Gagne's avatar
Don Gagne committed
112 113
    ///     @param convertOnly true: convert to correct type only, do not validate against meta data
    ///     @param typeValue Converted value, correctly typed
114
    ///     @param errorString Error string if convert fails, values are cooked values since user visible
Don Gagne's avatar
Don Gagne committed
115
    /// @returns false: Convert failed, errorString set
116 117 118 119
    bool convertAndValidateRaw(const QVariant& rawValue, bool convertOnly, QVariant& typedValue, QString& errorString);

    /// Same as convertAndValidateRaw except for cookedValue input
    bool convertAndValidateCooked(const QVariant& cookedValue, bool convertOnly, QVariant& typedValue, QString& errorString);
Don Gagne's avatar
Don Gagne committed
120

121 122
    static const int defaultDecimalPlaces = 3;

123
private:
124 125
    QVariant _minForType(void) const;
    QVariant _maxForType(void) const;
126 127 128 129 130 131 132 133 134
    void _setBuiltInTranslator(void);

    // Built in translators
    static QVariant _defaultTranslator(const QVariant& from) { return from; }
    static QVariant _degreesToRadians(const QVariant& degrees);
    static QVariant _radiansToDegrees(const QVariant& radians);
    static QVariant _centiDegreesToDegrees(const QVariant& centiDegrees);
    static QVariant _degreesToCentiDegrees(const QVariant& degrees);

135 136
    ValueType_t     _type;                  // must be first for correct constructor init
    int             _decimalPlaces;
137
    QVariant        _rawDefaultValue;
138
    bool            _defaultValueAvailable;
139 140
    QStringList     _bitmaskStrings;
    QVariantList    _bitmaskValues;
141 142 143 144
    QStringList     _enumStrings;
    QVariantList    _enumValues;
    QString         _group;
    QString         _longDescription;
145
    QVariant        _rawMax;
146
    bool            _maxIsDefaultForType;
147
    QVariant        _rawMin;
148 149 150
    bool            _minIsDefaultForType;
    QString         _name;
    QString         _shortDescription;
151 152
    QString         _rawUnits;
    QString         _cookedUnits;
153 154
    Translator      _rawTranslator;
    Translator      _cookedTranslator;
155
    bool            _rebootRequired;
156 157 158 159 160 161 162 163 164 165

    struct BuiltInTranslation_s {
        const char* rawUnits;
        const char* cookedUnits;
        Translator  rawTranslator;
        Translator  cookedTranslator;

    };

    static const BuiltInTranslation_s _rgBuildInTranslations[];
Don Gagne's avatar
Don Gagne committed
166 167
};

168
#endif