QGCCorePlugin.h 7.9 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12
/****************************************************************************
 *
 *   (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.
 *
 ****************************************************************************/

#pragma once

#include "QGCToolbox.h"
13
#include "QGCPalette.h"
14
#include "QGCMAVLink.h"
15
#include "QmlObjectListModel.h"
16 17 18 19 20 21 22 23 24 25 26 27

#include <QObject>
#include <QVariantList>

/// @file
///     @brief Core Plugin Interface for QGroundControl
///     @author Gus Grubba <mavlink@grubba.com>

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 PlanMasterController;
36

37 38 39 40
class QGCCorePlugin : public QGCTool
{
    Q_OBJECT
public:
41
    QGCCorePlugin(QGCApplication* app, QGCToolbox* toolbox);
42 43
    ~QGCCorePlugin();

44 45 46 47 48 49 50 51 52 53
    Q_PROPERTY(QVariantList         settingsPages           READ settingsPages                                  NOTIFY settingsPagesChanged)
    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)
54

55 56
    Q_INVOKABLE bool guidedActionsControllerLogging(void) const;

57 58
    /// The list of settings under the Settings Menu
    /// @return A list of QGCSettings
59
    virtual QVariantList& settingsPages(void);
60

61 62 63 64
    /// The list of PageWidget pages shown in the instrument panel
    /// @return A list of QmlPageInfo
    virtual QVariantList& instrumentPages(void);

65 66
    /// The default settings panel to show
    /// @return The settings index
67
    virtual int defaultSettings(void);
68 69 70

    /// Global options
    /// @return An instance of QGCOptions
71
    virtual QGCOptions* options(void);
72

Don Gagne's avatar
Don Gagne committed
73
    /// Allows the core plugin to override the visibility for a settings group
74
    ///     @param name - SettingsGroup name
75
    /// @return true: Show settings ui, false: Hide settings ui
76
    virtual bool overrideSettingsGroupVisibility(QString name);
77

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

84 85 86 87 88 89
    /// Return the resource file which contains the brand image for for Indoor theme.
    virtual QString brandImageIndoor(void) const { return QString(); }

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

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

Patrick José Pereira's avatar
Patrick José Pereira committed
93
    /// @return An instance of an alternate position source (or NULL if not available)
94
    virtual QGeoPositionInfoSource* createPositionSource(QObject* parent) { Q_UNUSED(parent); return nullptr; }
95 96 97

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

99
    /// Allows the plugin to override the default settings for the Values Widget large and small values
100 101
    virtual void valuesWidgetDefaultSettings(QStringList& largeValues, QStringList& smallValues);

102 103 104
    /// Allows the plugin to override the creation of the root (native) window.
    virtual QQmlApplicationEngine* createRootWindow(QObject* parent);

105 106 107
    /// Allows the plugin to override the creation of VideoReceiver.
    virtual VideoReceiver* createVideoReceiver(QObject* parent);

108 109 110 111
    /// 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);

112 113 114 115
    /// Allows custom builds to add custom items to the FlightMap. Objects put into QmlObjectListModel
    /// should derive from QmlComponentInfo and set the url property.
    virtual QmlObjectListModel* customMapItems(void);

116 117 118 119 120 121 122 123 124 125 126 127 128 129
    /// Allows custom builds to add custom items to the plan file. Either before the document is
    /// created or after.
    virtual void    preSaveToJson           (PlanMasterController* pController, QJsonObject& json) { Q_UNUSED(pController); Q_UNUSED(json); }
    virtual void    postSaveToJson          (PlanMasterController* pController, QJsonObject& json) { Q_UNUSED(pController); Q_UNUSED(json); }

    /// Same for the specific "mission" portion
    virtual void    preSaveToMissionJson    (PlanMasterController* pController, QJsonObject& missionJson) { Q_UNUSED(pController); Q_UNUSED(missionJson); }
    virtual void    postSaveToMissionJson   (PlanMasterController* pController, QJsonObject& missionJson) { Q_UNUSED(pController); Q_UNUSED(missionJson); }

    /// Allows custom builds to load custom items from the plan file. Either before the document is
    /// parsed or after.
    virtual void    preLoadFromJson     (PlanMasterController* pController, QJsonObject& json) { Q_UNUSED(pController); Q_UNUSED(json); }
    virtual void    postLoadFromJson    (PlanMasterController* pController, QJsonObject& json) { Q_UNUSED(pController); Q_UNUSED(json); }

Don Gagne's avatar
Don Gagne committed
130
    /// Returns the url to download the stable version check file. Return QString() to indicate no version check should be performed.
131 132
    /// 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
133 134 135
    /// The contents of this file should be a single line in the form:
    ///     v3.4.4
    /// This indicates the latest stable version number.
136
    virtual QString stableVersionCheckFileUrl(void) const;
Don Gagne's avatar
Don Gagne committed
137 138 139

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

DonLakeFlyer's avatar
DonLakeFlyer committed
142 143 144 145
    bool showTouchAreas(void) const { return _showTouchAreas; }
    bool showAdvancedUI(void) const { return _showAdvancedUI; }
    void setShowTouchAreas(bool show);
    void setShowAdvancedUI(bool show);
146

147
    // Override from QGCTool
148
    void                            setToolbox              (QGCToolbox* toolbox);
149 150 151

signals:
    void settingsPagesChanged   (void);
152
    void instrumentPagesChanged (void);
153 154 155 156 157 158 159
    void showTouchAreasChanged  (bool showTouchAreas);
    void showAdvancedUIChanged  (bool showAdvancedUI);

protected:
    bool                _showTouchAreas;
    bool                _showAdvancedUI;

160
private:
161
    QGCCorePlugin_p*    _p;
162
};