FactMetaData.h 13.8 KB
Newer Older
1 2 3 4 5 6 7 8 9
/****************************************************************************
 *
 *   (c) 2009-2016 QGROUNDCONTROL PROJECT <http://www.qgroundcontrol.org>
 *
 * QGroundControl is licensed according to the terms in the file
 * COPYING.md in the root of the source code directory.
 *
 ****************************************************************************/

Don Gagne's avatar
Don Gagne committed
10 11 12 13 14 15 16 17 18 19

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

#ifndef FactMetaData_H
#define FactMetaData_H

#include <QObject>
#include <QString>
#include <QVariant>
20
#include <QJsonObject>
21

Don Gagne's avatar
Don Gagne committed
22 23
/// Holds the meta data associated with a Fact.
///
Ricardo de Almeida Gonzaga's avatar
Ricardo de Almeida Gonzaga committed
24
/// Holds the meta data associated with a Fact. This is kept in a separate object from the Fact itself
Don Gagne's avatar
Don Gagne committed
25 26 27 28 29
/// 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
30

Don Gagne's avatar
Don Gagne committed
31 32 33 34 35 36 37 38
public:
    typedef enum {
        valueTypeUint8,
        valueTypeInt8,
        valueTypeUint16,
        valueTypeInt16,
        valueTypeUint32,
        valueTypeInt32,
39 40
        valueTypeUint64,
        valueTypeInt64,
Don Gagne's avatar
Don Gagne committed
41
        valueTypeFloat,
Don Gagne's avatar
Don Gagne committed
42
        valueTypeDouble,
43
        valueTypeString,
44 45
        valueTypeBool,
        valueTypeElapsedTimeInSeconds,  // Internally stored as double, valueString displays as HH:MM:SS
46
        valueTypeCustom,                // Internally stored as a QByteArray
Don Gagne's avatar
Don Gagne committed
47
    } ValueType_t;
48 49

    typedef QVariant (*Translator)(const QVariant& from);
50

Don Gagne's avatar
Don Gagne committed
51
    FactMetaData(QObject* parent = NULL);
52
    FactMetaData(ValueType_t type, QObject* parent = NULL);
53
    FactMetaData(ValueType_t type, const QString name, QObject* parent = NULL);
Don Gagne's avatar
Don Gagne committed
54 55
    FactMetaData(const FactMetaData& other, QObject* parent = NULL);

56
    static QMap<QString, FactMetaData*> createMapFromJsonFile(const QString& jsonFilename, QObject* metaDataParent);
57
    static QMap<QString, FactMetaData*> createMapFromJsonArray(const QJsonArray jsonArray, QObject* metaDataParent);
58

59 60
    static FactMetaData* createFromJsonObject(const QJsonObject& json, QObject* metaDataParent);

Don Gagne's avatar
Don Gagne committed
61
    const FactMetaData& operator=(const FactMetaData& other);
62

63 64 65 66 67 68 69 70 71
    /// Converts from meters to the user specified distance unit
    static QVariant metersToAppSettingsDistanceUnits(const QVariant& meters);

    /// Converts from user specified distance unit to meters
    static QVariant appSettingsDistanceUnitsToMeters(const QVariant& distance);

    /// Returns the string for distance units which has configued by user
    static QString appSettingsDistanceUnitsString(void);

72 73 74 75 76 77 78 79 80
    /// Converts from meters to the user specified distance unit
    static QVariant squareMetersToAppSettingsAreaUnits(const QVariant& squareMeters);

    /// Converts from user specified distance unit to meters
    static QVariant appSettingsAreaUnitsToSquareMeters(const QVariant& area);

    /// Returns the string for distance units which has configued by user
    static QString appSettingsAreaUnitsString(void);

81 82 83
    static const QString defaultCategory    ();
    static const QString defaultGroup       ();

84
    int             decimalPlaces           (void) const;
85 86
    QVariant        rawDefaultValue         (void) const;
    QVariant        cookedDefaultValue      (void) const { return _rawTranslator(rawDefaultValue()); }
87
    bool            defaultValueAvailable   (void) const { return _defaultValueAvailable; }
88 89
    QStringList     bitmaskStrings          (void) const { return _bitmaskStrings; }
    QVariantList    bitmaskValues           (void) const { return _bitmaskValues; }
90 91
    QStringList     enumStrings             (void) const { return _enumStrings; }
    QVariantList    enumValues              (void) const { return _enumValues; }
92
    QString         category                (void) const { return _category; }
93 94
    QString         group                   (void) const { return _group; }
    QString         longDescription         (void) const { return _longDescription;}
95
    QVariant        rawMax                  (void) const { return _rawMax; }
96
    QVariant        cookedMax               (void) const;
97
    bool            maxIsDefaultForType     (void) const { return _maxIsDefaultForType; }
98
    QVariant        rawMin                  (void) const { return _rawMin; }
99
    QVariant        cookedMin               (void) const;
100 101 102 103
    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; }
104 105
    QString         rawUnits                (void) const { return _rawUnits; }
    QString         cookedUnits             (void) const { return _cookedUnits; }
106
    bool            rebootRequired          (void) const { return _rebootRequired; }
107
    bool            hasControl              (void) const { return _hasControl; }
108
    bool            readOnly                (void) const { return _readOnly; }
109
    bool            writeOnly               (void) const { return _writeOnly; }
110
    bool            volatileValue           (void) const { return _volatile; }
111

Don Gagne's avatar
Don Gagne committed
112 113 114 115
    /// Amount to increment value when used in controls such as spin button or slider with detents.
    /// NaN for no increment available.
    double          increment               (void) const { return _increment; }

116 117
    Translator      rawTranslator           (void) const { return _rawTranslator; }
    Translator      cookedTranslator        (void) const { return _cookedTranslator; }
118

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

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

125
    void setDecimalPlaces   (int decimalPlaces)                 { _decimalPlaces = decimalPlaces; }
126
    void setRawDefaultValue (const QVariant& rawDefaultValue);
127
    void setBitmaskInfo     (const QStringList& strings, const QVariantList& values);
128
    void setEnumInfo        (const QStringList& strings, const QVariantList& values);
129
    void setCategory        (const QString& category)           { _category = category; }
130 131
    void setGroup           (const QString& group)              { _group = group; }
    void setLongDescription (const QString& longDescription)    { _longDescription = longDescription;}
132 133
    void setRawMax          (const QVariant& rawMax);
    void setRawMin          (const QVariant& rawMin);
134
    void setName            (const QString& name)               { _name = name; }
135
    void setShortDescription(const QString& shortDescription)   { _shortDescription = shortDescription; }
136
    void setRawUnits        (const QString& rawUnits);
137
    void setRebootRequired  (bool rebootRequired)               { _rebootRequired = rebootRequired; }
Don Gagne's avatar
Don Gagne committed
138
    void setIncrement       (double increment)                  { _increment = increment; }
139
    void setHasControl      (bool bValue)                       { _hasControl = bValue; }
140
    void setReadOnly        (bool bValue)                       { _readOnly = bValue; }
141
    void setWriteOnly       (bool bValue)                       { _writeOnly = bValue; }
142
    void setVolatileValue   (bool bValue);
143 144 145

    void setTranslators(Translator rawTranslator, Translator cookedTranslator);

146 147 148
    /// Set the translators to the standard built in versions
    void setBuiltInTranslator(void);

149 150
    /// Converts the specified raw value, validating against meta data
    ///     @param rawValue Value to convert, can be string
Don Gagne's avatar
Don Gagne committed
151 152
    ///     @param convertOnly true: convert to correct type only, do not validate against meta data
    ///     @param typeValue Converted value, correctly typed
153
    ///     @param errorString Error string if convert fails, values are cooked values since user visible
Don Gagne's avatar
Don Gagne committed
154
    /// @returns false: Convert failed, errorString set
155 156 157 158
    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
159

160 161 162 163 164 165
    /// Converts the specified cooked value and clamps it (max/min)
    ///     @param cookedValue Value to convert, can be string
    ///     @param typeValue Converted value, correctly typed and clamped
    /// @returns false: Convertion failed
    bool clampValue(const QVariant& cookedValue, QVariant& typedValue);

166 167
    static const int defaultDecimalPlaces = 3;  ///< Default value for decimal places if not specified/known
    static const int unknownDecimalPlaces = -1; ///< Number of decimal places to specify is not known
168

Don Gagne's avatar
Don Gagne committed
169
    static ValueType_t stringToType(const QString& typeString, bool& unknownType);
170
    static size_t typeToSize(ValueType_t type);
Don Gagne's avatar
Don Gagne committed
171

172
private:
173 174
    QVariant _minForType(void) const;
    QVariant _maxForType(void) const;
175
    void _setAppSettingsTranslators(void);
176 177 178 179 180 181 182

    // 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);
183 184
    static QVariant _userGimbalDegreesToMavlinkGimbalDegrees(const QVariant& userGimbalDegrees);
    static QVariant _mavlinkGimbalDegreesToUserGimbalDegrees(const QVariant& mavlinkGimbalDegrees);
185 186
    static QVariant _metersToFeet(const QVariant& meters);
    static QVariant _feetToMeters(const QVariant& feet);
187 188 189 190 191 192 193 194 195 196
    static QVariant _squareMetersToSquareKilometers(const QVariant& squareMeters);
    static QVariant _squareKilometersToSquareMeters(const QVariant& squareKilometers);
    static QVariant _squareMetersToHectares(const QVariant& squareMeters);
    static QVariant _hectaresToSquareMeters(const QVariant& hectares);
    static QVariant _squareMetersToSquareFeet(const QVariant& squareMeters);
    static QVariant _squareFeetToSquareMeters(const QVariant& squareFeet);
    static QVariant _squareMetersToAcres(const QVariant& squareMeters);
    static QVariant _acresToSquareMeters(const QVariant& acres);
    static QVariant _squareMetersToSquareMiles(const QVariant& squareMeters);
    static QVariant _squareMilesToSquareMeters(const QVariant& squareMiles);
197 198 199 200 201 202
    static QVariant _metersPerSecondToMilesPerHour(const QVariant& metersPerSecond);
    static QVariant _milesPerHourToMetersPerSecond(const QVariant& milesPerHour);
    static QVariant _metersPerSecondToKilometersPerHour(const QVariant& metersPerSecond);
    static QVariant _kilometersPerHourToMetersPerSecond(const QVariant& kilometersPerHour);
    static QVariant _metersPerSecondToKnots(const QVariant& metersPerSecond);
    static QVariant _knotsToMetersPerSecond(const QVariant& knots);
203 204
    static QVariant _percentToNorm(const QVariant& percent);
    static QVariant _normToPercent(const QVariant& normalized);
205 206
    static QVariant _centimetersToInches(const QVariant& centimeters);
    static QVariant _inchesToCentimeters(const QVariant& inches);
207 208
    static QVariant _celsiusToFarenheit(const QVariant& celsius);
    static QVariant _farenheitToCelsius(const QVariant& farenheit);
209

Gus Grubba's avatar
Gus Grubba committed
210 211 212 213 214 215
    enum UnitTypes {
        UnitDistance = 0,
        UnitArea,
        UnitSpeed,
        UnitTemperature
    };
216

Gus Grubba's avatar
Gus Grubba committed
217 218 219 220 221 222 223
    struct AppSettingsTranslation_s {
        const char*     rawUnits;
        const char*     cookedUnits;
        UnitTypes       unitType;
        uint32_t        unitOption;
        Translator      rawTranslator;
        Translator      cookedTranslator;
224 225 226
    };

    static const AppSettingsTranslation_s* _findAppSettingsDistanceUnitsTranslation(const QString& rawUnits);
227
    static const AppSettingsTranslation_s* _findAppSettingsAreaUnitsTranslation(const QString& rawUnits);
228

229 230
    ValueType_t     _type;                  // must be first for correct constructor init
    int             _decimalPlaces;
231
    QVariant        _rawDefaultValue;
232
    bool            _defaultValueAvailable;
233 234
    QStringList     _bitmaskStrings;
    QVariantList    _bitmaskValues;
235 236
    QStringList     _enumStrings;
    QVariantList    _enumValues;
237
    QString         _category;
238 239
    QString         _group;
    QString         _longDescription;
240
    QVariant        _rawMax;
241
    bool            _maxIsDefaultForType;
242
    QVariant        _rawMin;
243 244 245
    bool            _minIsDefaultForType;
    QString         _name;
    QString         _shortDescription;
246 247
    QString         _rawUnits;
    QString         _cookedUnits;
248 249
    Translator      _rawTranslator;
    Translator      _cookedTranslator;
250
    bool            _rebootRequired;
Don Gagne's avatar
Don Gagne committed
251
    double          _increment;
252
    bool            _hasControl;
253
    bool            _readOnly;
254
    bool            _writeOnly;
255
    bool            _volatile;
256

257 258 259 260 261 262
    // Exact conversion constants
    static const struct UnitConsts_s {
        static const qreal secondsPerHour;
        static const qreal knotsToKPH;
        static const qreal milesToMeters;
        static const qreal feetToMeters;
263
        static const qreal inchesToCentimeters;
264 265
    } constants;

266 267 268 269 270 271 272
    struct BuiltInTranslation_s {
        const char* rawUnits;
        const char* cookedUnits;
        Translator  rawTranslator;
        Translator  cookedTranslator;

    };
273

274
    static const BuiltInTranslation_s _rgBuiltInTranslations[];
275

276
    static const AppSettingsTranslation_s _rgAppSettingsTranslations[];
277 278 279 280 281 282 283 284

    static const char*  _nameJsonKey;
    static const char*  _decimalPlacesJsonKey;
    static const char*  _typeJsonKey;
    static const char*  _shortDescriptionJsonKey;
    static const char*  _longDescriptionJsonKey;
    static const char*  _unitsJsonKey;
    static const char*  _defaultValueJsonKey;
285
    static const char*  _mobileDefaultValueJsonKey;
286 287
    static const char*  _minJsonKey;
    static const char*  _maxJsonKey;
288
    static const char* _hasControlJsonKey;
Don Gagne's avatar
Don Gagne committed
289 290
};

291
#endif