QGCCorePlugin.h 11.6 KB
Newer Older
1 2
/****************************************************************************
 *
Gus Grubba's avatar
Gus Grubba committed
3
 * (c) 2009-2020 QGROUNDCONTROL PROJECT <http://www.qgroundcontrol.org>
4 5 6 7 8 9 10 11 12
 *
 * QGroundControl is licensed according to the terms in the file
 * COPYING.md in the root of the source code directory.
 *
 ****************************************************************************/

#pragma once

#include "QGCToolbox.h"
13
#include "QGCPalette.h"
14
#include "QGCMAVLink.h"
15
#include "QmlObjectListModel.h"
16 17 18 19 20

#include <QObject>
#include <QVariantList>

/// @file
Gus Grubba's avatar
Gus Grubba committed
21 22
/// @brief Core Plugin Interface for QGroundControl
/// @author Gus Grubba <gus@auterion.com>
23 24 25 26 27

class QGCApplication;
class QGCOptions;
class QGCSettings;
class QGCCorePlugin_p;
28
class FactMetaData;
29
class QGeoPositionInfoSource;
30
class QQmlApplicationEngine;
31 32
class Vehicle;
class LinkInterface;
33
class QmlObjectListModel;
34
class VideoReceiver;
35
class VideoSink;
36
class PlanMasterController;
37
class QGCCameraManager;
38
class QGCCameraControl;
39
class QQuickItem;
40
class InstrumentValueAreaController;
41

42 43 44 45
class QGCCorePlugin : public QGCTool
{
    Q_OBJECT
public:
46
    QGCCorePlugin(QGCApplication* app, QGCToolbox* toolbox);
47 48
    ~QGCCorePlugin();

49 50 51 52 53 54 55 56 57 58 59 60 61 62
    Q_PROPERTY(QVariantList         settingsPages                   READ settingsPages                                  NOTIFY settingsPagesChanged)
    Q_PROPERTY(QVariantList         analyzePages                    READ analyzePages                                   NOTIFY analyzePagesChanged)
    Q_PROPERTY(QVariantList         instrumentPages                 READ instrumentPages                                NOTIFY instrumentPagesChanged)
    Q_PROPERTY(int                  defaultSettings                 READ defaultSettings                                CONSTANT)
    Q_PROPERTY(QGCOptions*          options                         READ options                                        CONSTANT)
    Q_PROPERTY(bool                 showTouchAreas                  READ showTouchAreas         WRITE setShowTouchAreas NOTIFY showTouchAreasChanged)
    Q_PROPERTY(bool                 showAdvancedUI                  READ showAdvancedUI         WRITE setShowAdvancedUI NOTIFY showAdvancedUIChanged)
    Q_PROPERTY(QString              showAdvancedUIMessage           READ showAdvancedUIMessage                          CONSTANT)
    Q_PROPERTY(QString              brandImageIndoor                READ brandImageIndoor                               CONSTANT)
    Q_PROPERTY(QString              brandImageOutdoor               READ brandImageOutdoor                              CONSTANT)
    Q_PROPERTY(QmlObjectListModel*  customMapItems                  READ customMapItems                                 CONSTANT)
    Q_PROPERTY(QVariantList         toolBarIndicators               READ toolBarIndicators                              NOTIFY toolBarIndicatorsChanged)
    Q_PROPERTY(int                  unitsFirstRunPromptId           MEMBER unitsFirstRunPromptId                        CONSTANT)
    Q_PROPERTY(int                  offlineVehicleFirstRunPromptId  MEMBER offlineVehicleFirstRunPromptId               CONSTANT)
63

64
    Q_INVOKABLE bool guidedActionsControllerLogging() const;
65

66 67
    /// The list of settings under the Settings Menu
    /// @return A list of QGCSettings
68
    virtual QVariantList& settingsPages();
69

70 71 72 73
    /// The list of pages/buttons under the Analyze Menu
    /// @return A list of QmlPageInfo
    virtual QVariantList& analyzePages();

74 75
    /// The list of PageWidget pages shown in the instrument panel
    /// @return A list of QmlPageInfo
76
    virtual QVariantList& instrumentPages();
77

78 79
    /// The default settings panel to show
    /// @return The settings index
80
    virtual int defaultSettings();
81 82 83

    /// Global options
    /// @return An instance of QGCOptions
84
    virtual QGCOptions* options();
85

Don Gagne's avatar
Don Gagne committed
86
    /// Allows the core plugin to override the visibility for a settings group
87
    ///     @param name - SettingsGroup name
88
    /// @return true: Show settings ui, false: Hide settings ui
89
    virtual bool overrideSettingsGroupVisibility(QString name);
90

91
    /// Allows the core plugin to override the setting meta data before the setting fact is created.
92
    ///     @param settingsGroup - QSettings group which contains this item
93 94
    ///     @param metaData - MetaData for setting fact
    /// @return true: Setting should be visible in ui, false: Setting should not be shown in ui
95
    virtual bool adjustSettingMetaData(const QString& settingsGroup, FactMetaData& metaData);
96

97
    /// Return the resource file which contains the brand image for for Indoor theme.
98
    virtual QString brandImageIndoor() const { return QString(); }
99 100

    /// Return the resource file which contains the brand image for for Outdoor theme.
101
    virtual QString brandImageOutdoor() const { return QString(); }
102

Donald Gagne's avatar
Donald Gagne committed
103
    /// @return The message to show to the user when they a re prompted to confirm turning on advanced ui.
104
    virtual QString showAdvancedUIMessage() const;
Donald Gagne's avatar
Donald Gagne committed
105

Patrick José Pereira's avatar
Patrick José Pereira committed
106
    /// @return An instance of an alternate position source (or NULL if not available)
Gus Grubba's avatar
Gus Grubba committed
107
    virtual QGeoPositionInfoSource* createPositionSource(QObject* /*parent*/) { return nullptr; }
108 109 110

    /// Allows a plugin to override the specified color name from the palette
    virtual void paletteOverride(QString colorName, QGCPalette::PaletteColorInfo_t& colorInfo);
111

112
    virtual void factValueGridCreateDefaultSettings(const QString& defaultSettingsGroup);
113

114 115 116 117
    /// Allows the plugin to override or get access to the QmlApplicationEngine to do things like add import
    /// path or stuff things into the context prior to window creation.
    virtual QQmlApplicationEngine* createQmlApplicationEngine(QObject* parent);

118
    /// Allows the plugin to override the creation of the root (native) window.
119
    virtual void createRootWindow(QQmlApplicationEngine* qmlEngine);
120

121 122
    /// Allows the plugin to override the creation of VideoManager.
    virtual VideoManager* createVideoManager(QGCApplication* app, QGCToolbox* toolbox);
123 124
    /// Allows the plugin to override the creation of VideoReceiver.
    virtual VideoReceiver* createVideoReceiver(QObject* parent);
125 126
    /// Allows the plugin to override the creation of VideoSink.
    virtual void* createVideoSink(QObject* parent, QQuickItem* widget);
127 128
    /// Allows the plugin to override the release of VideoSink.
    virtual void releaseVideoSink(void* sink);
129

130 131 132 133
    /// Allows the plugin to see all mavlink traffic to a vehicle
    /// @return true: Allow vehicle to continue processing, false: Vehicle should not process message
    virtual bool mavlinkMessage(Vehicle* vehicle, LinkInterface* link, mavlink_message_t message);

Gus Grubba's avatar
Gus Grubba committed
134
    /// Allows custom builds to add custom items to the FlightMap. Objects put into QmlObjectListModel should derive from QmlComponentInfo and set the url property.
135
    virtual QmlObjectListModel* customMapItems();
136

Gus Grubba's avatar
Gus Grubba committed
137 138 139 140
    /// Allows custom builds to add custom items to the plan file before the document is created.
    virtual void    preSaveToJson           (PlanMasterController* /*pController*/, QJsonObject& /*json*/) {}
    /// Allows custom builds to add custom items to the plan file after the document is created.
    virtual void    postSaveToJson          (PlanMasterController* /*pController*/, QJsonObject& /*json*/) {}
141

Gus Grubba's avatar
Gus Grubba committed
142 143 144 145
    /// Allows custom builds to add custom items to the mission section of the plan file before the item is created.
    virtual void    preSaveToMissionJson    (PlanMasterController* /*pController*/, QJsonObject& /*missionJson*/) {}
    /// Allows custom builds to add custom items to the mission section of the plan file after the item is created.
    virtual void    postSaveToMissionJson   (PlanMasterController* /*pController*/, QJsonObject& /*missionJson*/) {}
146

Gus Grubba's avatar
Gus Grubba committed
147 148 149 150
    /// Allows custom builds to load custom items from the plan file before the document is parsed.
    virtual void    preLoadFromJson     (PlanMasterController* /*pController*/, QJsonObject& /*json*/) {}
    /// Allows custom builds to load custom items from the plan file after the document is parsed.
    virtual void    postLoadFromJson    (PlanMasterController* /*pController*/, QJsonObject& /*json*/) {}
151

Don Gagne's avatar
Don Gagne committed
152
    /// Returns the url to download the stable version check file. Return QString() to indicate no version check should be performed.
153 154
    /// Default QGC mainline implemenentation returns QGC Stable file location. Default QGC custom build code returns QString().
    /// Custom builds can override to turn on and provide their own location.
Don Gagne's avatar
Don Gagne committed
155 156 157
    /// The contents of this file should be a single line in the form:
    ///     v3.4.4
    /// This indicates the latest stable version number.
158
    virtual QString stableVersionCheckFileUrl() const;
Don Gagne's avatar
Don Gagne committed
159 160 161

    /// Returns the user visible url to show user where to download new stable builds from.
    /// Custom builds must override to provide their own location.
162
    virtual QString stableDownloadLocation() const { return QString("qgroundcontrol.com"); }
Don Gagne's avatar
Don Gagne committed
163

164
    /// Returns the complex mission items to display in the Plan UI
Gus Grubba's avatar
Gus Grubba committed
165
    /// @param complexMissionItemNames Default set of complex items
166
    /// @return Complex items to be made available to user
Gus Grubba's avatar
Gus Grubba committed
167
    virtual QStringList complexMissionItemNames(Vehicle* /*vehicle*/, const QStringList& complexMissionItemNames) { return complexMissionItemNames; }
168

169 170 171 172 173 174 175 176 177 178 179 180
    /// Returns the standard list of first run prompt ids for possible display. Actual display is based on the
    /// current AppSettings::firstRunPromptIds value. The order of this list also determines the order the prompts
    /// will be displayed in.
    virtual QList<int> firstRunPromptStdIds(void);

    /// Returns the custom build list of first run prompt ids for possible display. Actual display is based on the
    /// current AppSettings::firstRunPromptIds value. The order of this list also determines the order the prompts
    /// will be displayed in.
    virtual QList<int> firstRunPromptCustomIds(void);

    /// Returns the resource which contains the specified first run prompt for display
    Q_INVOKABLE virtual QString firstRunPromptResource(int id);
181

182 183 184 185 186
    /// Returns the list of toolbar indicators which are not related to a vehicle
    ///     signals toolbarIndicatorsChanged
    /// @return A list of QUrl with the indicators
    virtual const QVariantList& toolBarIndicators(void);

187 188 189
    /// Returns the list of first run prompt ids which need to be displayed according to current settings
    Q_INVOKABLE QVariantList firstRunPromptsToShow(void);

190 191
    bool showTouchAreas() const { return _showTouchAreas; }
    bool showAdvancedUI() const { return _showAdvancedUI; }
DonLakeFlyer's avatar
DonLakeFlyer committed
192 193
    void setShowTouchAreas(bool show);
    void setShowAdvancedUI(bool show);
194

195
    // Override from QGCTool
196
    void                            setToolbox              (QGCToolbox* toolbox);
197

198 199 200 201 202 203 204
    // Standard first run prompt ids
    static const int unitsFirstRunPromptId =            1;
    static const int offlineVehicleFirstRunPromptId =   2;

    // Custom builds can start there first run prompt ids from here
    static const int firstRunPromptIdsFirstCustomId = 10000;

205
signals:
206 207 208 209 210 211
    void settingsPagesChanged       ();
    void analyzePagesChanged        ();
    void instrumentPagesChanged     ();
    void showTouchAreasChanged      (bool showTouchAreas);
    void showAdvancedUIChanged      (bool showAdvancedUI);
    void toolBarIndicatorsChanged   ();
212

213 214 215 216
protected slots:
    void _activeVehicleChanged  (Vehicle* activeVehicle);
    void _dynamicCamerasChanged ();
    void _currentCameraChanged  ();
217
    void _autoStreamChanged     ();
218 219 220 221

protected:
    void _resetInstrumentPages  ();

222 223 224
protected:
    bool                _showTouchAreas;
    bool                _showAdvancedUI;
225 226
    Vehicle*            _activeVehicle  = nullptr;
    QGCCameraManager*   _dynamicCameras = nullptr;
227
    QGCCameraControl*   _currentCamera  = nullptr;
228
    QVariantList        _toolBarIndicatorList;
229

230
private:
231
    QGCCorePlugin_p*    _p;
232
};