Fact.h 12.2 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
20
21

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

#ifndef Fact_H
#define Fact_H

#include "FactMetaData.h"

#include <QObject>
#include <QString>
#include <QVariant>
Don Gagne's avatar
Don Gagne committed
22
#include <QDebug>
23
24
25
#include <QAbstractListModel>

class FactValueSliderListModel;
Don Gagne's avatar
Don Gagne committed
26
27
28
29
30
31
32

/// @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
33
    Fact(QObject* parent = NULL);
34
    Fact(int componentId, QString name, FactMetaData::ValueType_t type, QObject* parent = NULL);
Don Gagne's avatar
Don Gagne committed
35
36
    Fact(const Fact& other, QObject* parent = NULL);

37
38
    /// Creates a Fact using the name and type from metaData. Also calls QGCCorePlugin::adjustSettingsMetaData allowing
    /// custom builds to override the metadata.
DonLakeFlyer's avatar
DonLakeFlyer committed
39
    Fact(const QString& settingsGroup, FactMetaData* metaData, QObject* parent = NULL);
40

Don Gagne's avatar
Don Gagne committed
41
42
    const Fact& operator=(const Fact& other);

Don Gagne's avatar
Don Gagne committed
43
    Q_PROPERTY(int          componentId             READ componentId                                        CONSTANT)
Don Gagne's avatar
Don Gagne committed
44
45
    Q_PROPERTY(QStringList  bitmaskStrings          READ bitmaskStrings                                     NOTIFY bitmaskStringsChanged)
    Q_PROPERTY(QVariantList bitmaskValues           READ bitmaskValues                                      NOTIFY bitmaskValuesChanged)
Don Gagne's avatar
Don Gagne committed
46
    Q_PROPERTY(int          decimalPlaces           READ decimalPlaces                                      CONSTANT)
47
48
    Q_PROPERTY(QVariant     defaultValue            READ cookedDefaultValue                                 CONSTANT)
    Q_PROPERTY(QString      defaultValueString      READ cookedDefaultValueString                           CONSTANT)
Don Gagne's avatar
Don Gagne committed
49
50
    Q_PROPERTY(bool         defaultValueAvailable   READ defaultValueAvailable                              CONSTANT)
    Q_PROPERTY(int          enumIndex               READ enumIndex              WRITE setEnumIndex          NOTIFY valueChanged)
51
    Q_PROPERTY(QStringList  enumStrings             READ enumStrings                                        NOTIFY enumsChanged)
Don Gagne's avatar
Don Gagne committed
52
    Q_PROPERTY(QString      enumStringValue         READ enumStringValue        WRITE setEnumStringValue    NOTIFY valueChanged)
53
    Q_PROPERTY(QVariantList enumValues              READ enumValues                                         NOTIFY enumsChanged)
54
    Q_PROPERTY(QString      category                READ category                                              CONSTANT)
Don Gagne's avatar
Don Gagne committed
55
56
    Q_PROPERTY(QString      group                   READ group                                              CONSTANT)
    Q_PROPERTY(QString      longDescription         READ longDescription                                    CONSTANT)
57
58
    Q_PROPERTY(QVariant     max                     READ cookedMax                                          CONSTANT)
    Q_PROPERTY(QString      maxString               READ cookedMaxString                                    CONSTANT)
Don Gagne's avatar
Don Gagne committed
59
    Q_PROPERTY(bool         maxIsDefaultForType     READ maxIsDefaultForType                                CONSTANT)
60
61
    Q_PROPERTY(QVariant     min                     READ cookedMin                                          CONSTANT)
    Q_PROPERTY(QString      minString               READ cookedMinString                                    CONSTANT)
Don Gagne's avatar
Don Gagne committed
62
63
    Q_PROPERTY(bool         minIsDefaultForType     READ minIsDefaultForType                                CONSTANT)
    Q_PROPERTY(QString      name                    READ name                                               CONSTANT)
Don Gagne's avatar
   
Don Gagne committed
64
65
    Q_PROPERTY(bool         vehicleRebootRequired   READ vehicleRebootRequired                              CONSTANT)
    Q_PROPERTY(bool         qgcRebootRequired       READ qgcRebootRequired                                  CONSTANT)
Don Gagne's avatar
Don Gagne committed
66
    Q_PROPERTY(QString      shortDescription        READ shortDescription                                   CONSTANT)
67
    Q_PROPERTY(QString      units                   READ cookedUnits                                        CONSTANT)
Don Gagne's avatar
Don Gagne committed
68
    Q_PROPERTY(QVariant     value                   READ cookedValue            WRITE setCookedValue        NOTIFY valueChanged)
69
    Q_PROPERTY(QVariant     rawValue                READ rawValue               WRITE setRawValue           NOTIFY rawValueChanged)
Don Gagne's avatar
Don Gagne committed
70
    Q_PROPERTY(bool         valueEqualsDefault      READ valueEqualsDefault                                 NOTIFY valueChanged)
71
72
    Q_PROPERTY(QString      valueString             READ cookedValueString                                  NOTIFY valueChanged)
    Q_PROPERTY(QString      enumOrValueString       READ enumOrValueString                                  NOTIFY valueChanged)
DonLakeFlyer's avatar
DonLakeFlyer committed
73
    Q_PROPERTY(double       increment               READ cookedIncrement                                    CONSTANT)
Don Gagne's avatar
Don Gagne committed
74
75
    Q_PROPERTY(bool         typeIsString            READ typeIsString                                       CONSTANT)
    Q_PROPERTY(bool         typeIsBool              READ typeIsBool                                         CONSTANT)
Gus Grubba's avatar
Gus Grubba committed
76
    Q_PROPERTY(bool         hasControl              READ hasControl                                         CONSTANT)
77
    Q_PROPERTY(bool         readOnly                READ readOnly                                           CONSTANT)
78
    Q_PROPERTY(bool         writeOnly               READ writeOnly                                          CONSTANT)
79
    Q_PROPERTY(bool         volatileValue           READ volatileValue                                      CONSTANT)
Don Gagne's avatar
Don Gagne committed
80

Don Gagne's avatar
Don Gagne committed
81
82
    /// Convert and validate value
    ///     @param convertOnly true: validate type conversion only, false: validate against meta data as well
83
    Q_INVOKABLE QString validate(const QString& cookedValue, bool convertOnly);
84
85
    /// Convert and clamp value
    Q_INVOKABLE QVariant clamp(const QString& cookedValue);
Don Gagne's avatar
Don Gagne committed
86

Don Gagne's avatar
Don Gagne committed
87
    QVariant        cookedValue             (void) const;   /// Value after translation
88
    QVariant        rawValue                (void) const { return _rawValue; }  /// value prior to translation, careful
Don Gagne's avatar
Don Gagne committed
89
90
    int             componentId             (void) const;
    int             decimalPlaces           (void) const;
91
92
    QVariant        rawDefaultValue         (void) const;
    QVariant        cookedDefaultValue      (void) const;
Don Gagne's avatar
Don Gagne committed
93
    bool            defaultValueAvailable   (void) const;
94
    QString         cookedDefaultValueString(void) const;
Don Gagne's avatar
Don Gagne committed
95
96
    QStringList     bitmaskStrings          (void) const;
    QVariantList    bitmaskValues           (void) const;
Don Gagne's avatar
Don Gagne committed
97
    int             enumIndex               (void);         // This is not const, since an unknown value can modify the enum lists
Don Gagne's avatar
Don Gagne committed
98
    QStringList     enumStrings             (void) const;
Don Gagne's avatar
Don Gagne committed
99
    QString         enumStringValue         (void);         // This is not const, since an unknown value can modify the enum lists
Don Gagne's avatar
Don Gagne committed
100
    QVariantList    enumValues              (void) const;
101
    QString         category                (void) const;
Don Gagne's avatar
Don Gagne committed
102
103
    QString         group                   (void) const;
    QString         longDescription         (void) const;
104
105
106
    QVariant        rawMax                  (void) const;
    QVariant        cookedMax               (void) const;
    QString         cookedMaxString         (void) const;
Don Gagne's avatar
Don Gagne committed
107
    bool            maxIsDefaultForType     (void) const;
108
109
110
    QVariant        rawMin                  (void) const;
    QVariant        cookedMin               (void) const;
    QString         cookedMinString         (void) const;
Don Gagne's avatar
Don Gagne committed
111
112
113
114
    bool            minIsDefaultForType     (void) const;
    QString         name                    (void) const;
    QString         shortDescription        (void) const;
    FactMetaData::ValueType_t type          (void) const;
115
116
117
118
    QString         cookedUnits             (void) const;
    QString         rawUnits                (void) const;
    QString         rawValueString          (void) const;
    QString         cookedValueString       (void) const;
Don Gagne's avatar
Don Gagne committed
119
    bool            valueEqualsDefault      (void) const;
Don Gagne's avatar
   
Don Gagne committed
120
121
    bool            vehicleRebootRequired   (void) const;
    bool            qgcRebootRequired       (void) const;
122
    QString         enumOrValueString       (void);         // This is not const, since an unknown value can modify the enum lists
123
    double          rawIncrement            (void) const;
DonLakeFlyer's avatar
DonLakeFlyer committed
124
    double          cookedIncrement         (void) const;
Don Gagne's avatar
Don Gagne committed
125
126
    bool            typeIsString            (void) const { return type() == FactMetaData::valueTypeString; }
    bool            typeIsBool              (void) const { return type() == FactMetaData::valueTypeBool; }
Gus Grubba's avatar
Gus Grubba committed
127
    bool            hasControl              (void) const;
128
    bool            readOnly                (void) const;
129
130
    bool            writeOnly               (void) const;
    bool            volatileValue           (void) const;
131

132
133
    Q_INVOKABLE FactValueSliderListModel* valueSliderModel(void);

134
135
136
    /// Returns the values as a string with full 18 digit precision if float/double.
    QString rawValueStringFullPrecision(void) const;

Gus Grubba's avatar
Gus Grubba committed
137
    void setRawValue        (const QVariant& value);
Don Gagne's avatar
Don Gagne committed
138
    void setCookedValue     (const QVariant& value);
Don Gagne's avatar
Don Gagne committed
139
140
    void setEnumIndex       (int index);
    void setEnumStringValue (const QString& value);
Gus Grubba's avatar
Gus Grubba committed
141
    int  valueIndex         (const QString& value);
142

Don Gagne's avatar
Don Gagne committed
143
144
145
146
147
148
149
150
151
    // The following methods allow you to defer sending of the valueChanged signals in order to implement
    // rate limited signalling for ui performance. Used by FactGroup for example.

    void setSendValueChangedSignals (bool sendValueChangedSignals);
    bool sendValueChangedSignals (void) const { return _sendValueChangedSignals; }
    bool deferredValueChangeSignal(void) const { return _deferredValueChangeSignal; }
    void clearDeferredValueChangeSignal(void) { _deferredValueChangeSignal = false; }
    void sendDeferredValueChangedSignal(void);

Don Gagne's avatar
Don Gagne committed
152
    // C++ methods
153

Don Gagne's avatar
Don Gagne committed
154
    /// Sets and sends new value to vehicle even if value is the same
Don Gagne's avatar
Don Gagne committed
155
    void forceSetRawValue(const QVariant& value);
Don Gagne's avatar
Don Gagne committed
156
    
Don Gagne's avatar
Don Gagne committed
157
    /// Sets the meta data associated with the Fact.
158
159
160
    ///     @param metaData FactMetaData for Fact
    ///     @param setDefaultFromMetaData true: set the fact value to the default specified in the meta data
    void setMetaData(FactMetaData* metaData, bool setDefaultFromMetaData = false);
Don Gagne's avatar
Don Gagne committed
161
    
Gus Grubba's avatar
Gus Grubba committed
162
    FactMetaData* metaData() { return _metaData; }
Gus Grubba's avatar
Gus Grubba committed
163
164

    //-- Value coming from Vehicle. This does NOT send a _containerRawValueChanged signal.
Don Gagne's avatar
Don Gagne committed
165
    void _containerSetRawValue(const QVariant& value);
166
    
Don Gagne's avatar
Don Gagne committed
167
168
    /// Generally you should not change the name of a fact. But if you know what you are doing, you can.
    void _setName(const QString& name) { _name = name; }
Don Gagne's avatar
Don Gagne committed
169

Gus Grubba's avatar
Gus Grubba committed
170
171
172
    /// Generally this is done during parsing. But if you know what you are doing, you can.
    void setEnumInfo(const QStringList& strings, const QVariantList& values);

Don Gagne's avatar
Don Gagne committed
173
signals:
Don Gagne's avatar
Don Gagne committed
174
175
    void bitmaskStringsChanged(void);
    void bitmaskValuesChanged(void);
176
    void enumsChanged(void);
Don Gagne's avatar
Don Gagne committed
177
    void sendValueChangedSignalsChanged(bool sendValueChangedSignals);
Don Gagne's avatar
Don Gagne committed
178

Don Gagne's avatar
Don Gagne committed
179
180
181
    /// 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.
182
    void valueChanged(QVariant value);
183
    void rawValueChanged(QVariant value);
Don Gagne's avatar
Don Gagne committed
184
    
Don Gagne's avatar
Don Gagne committed
185
186
187
    /// Signalled when the param write ack comes back from the vehicle
    void vehicleUpdated(QVariant value);
    
Don Gagne's avatar
Don Gagne committed
188
189
    /// Signalled when property has been changed by a call to the property write accessor
    ///
Gus Grubba's avatar
Gus Grubba committed
190
    /// This signal is meant for use by Fact container implementations. Used to send changed values to vehicle.
Don Gagne's avatar
Don Gagne committed
191
    void _containerRawValueChanged(const QVariant& value);
Don Gagne's avatar
   
Don Gagne committed
192
193
194
195
196
197

private slots:
    void _checkForRebootMessaging(void);

private:
    void _init(void);
Don Gagne's avatar
Don Gagne committed
198
    
Don Gagne's avatar
Don Gagne committed
199
protected:
200
    QString _variantToString(const QVariant& variant, int decimalPlaces) const;
Don Gagne's avatar
Don Gagne committed
201
    void _sendValueChangedSignal(QVariant value);
202

203
    QString                     _name;
204
    int                         _componentId;
Don Gagne's avatar
Don Gagne committed
205
    QVariant                    _rawValue;
206
207
    FactMetaData::ValueType_t   _type;
    FactMetaData*               _metaData;
Don Gagne's avatar
Don Gagne committed
208
209
    bool                        _sendValueChangedSignals;
    bool                        _deferredValueChangeSignal;
210
    FactValueSliderListModel*   _valueSliderModel;
Don Gagne's avatar
Don Gagne committed
211
212
};

213
#endif