VehicleComponent.h 3.13 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.
 *
 ****************************************************************************/

10

Don Gagne's avatar
Don Gagne committed
11 12 13
/// @file
///     @author Don Gagne <don@thegagnes.com>

14 15 16 17
#ifndef VEHICLECOMPONENT_H
#define VEHICLECOMPONENT_H

#include <QObject>
18 19
#include <QQmlContext>
#include <QQuickItem>
20

21
#include "Vehicle.h"
22

Don Gagne's avatar
Don Gagne committed
23 24 25 26
class AutoPilotPlugin;

/// A vehicle component is an object which abstracts the physical portion of a vehicle into a set of
/// configurable values and user interface.
27 28 29 30

class VehicleComponent : public QObject
{
    Q_OBJECT
31
    
32 33 34 35 36
    Q_PROPERTY(QString  name                    READ name                   CONSTANT)
    Q_PROPERTY(QString  description             READ description            CONSTANT)
    Q_PROPERTY(bool     requiresSetup           READ requiresSetup          CONSTANT)
    Q_PROPERTY(bool     setupComplete           READ setupComplete          STORED false NOTIFY setupCompleteChanged)
    Q_PROPERTY(QString  iconResource            READ iconResource           CONSTANT)
37
    Q_PROPERTY(QUrl     setupSource             READ setupSource            NOTIFY setupSourceChanged)
38 39
    Q_PROPERTY(QUrl     summaryQmlSource        READ summaryQmlSource       CONSTANT)
    Q_PROPERTY(bool     allowSetupWhileArmed    READ allowSetupWhileArmed   CONSTANT)
40 41
    Q_PROPERTY(bool     allowSetupWhileFlying   READ allowSetupWhileFlying  CONSTANT)

42
public:
43
    VehicleComponent(Vehicle* vehicle, AutoPilotPlugin* autopilot, QObject* parent = nullptr);
44 45 46 47
    ~VehicleComponent();
    
    virtual QString name(void) const = 0;
    virtual QString description(void) const = 0;
48
    virtual QString iconResource(void) const = 0;
49 50
    virtual bool requiresSetup(void) const = 0;
    virtual bool setupComplete(void) const = 0;
51
    virtual QUrl setupSource(void) const = 0;
52
    virtual QUrl summaryQmlSource(void) const = 0;
53 54

    // @return true: Setup panel can be shown while vehicle is armed
55
    virtual bool allowSetupWhileArmed(void) const { return false; } // Defaults to false
56
    
57 58 59
    // @return true: Setup panel can be shown while vehicle is flying (and armed)
    virtual bool allowSetupWhileFlying(void) const { return false; } // Defaults to false

60
    virtual void addSummaryQmlComponent(QQmlContext* context, QQuickItem* parent);
61
    
62
    /// @brief Returns an list of parameter names for which a change should cause the setupCompleteChanged
63
    ///         signal to be emitted.
64 65 66 67 68 69
    virtual QStringList setupCompleteChangedTriggerList(void) const = 0;

    /// Should be called after the component is created (but not in constructor) to setup the
    /// signals which are used to track parameter changes which affect setupComplete state.
    virtual void setupTriggerSignals(void);

70
signals:
71
    void setupCompleteChanged(bool setupComplete);
72
    void setupSourceChanged(void);
73 74 75 76

protected slots:
    void _triggerUpdated(QVariant value);

77
protected:
78 79
    Vehicle*            _vehicle;
    AutoPilotPlugin*    _autopilot;
80 81 82
};

#endif