QGroundControlQmlGlobal.h

Go to the documentation of this file.

#pragma once
 
#include <QtCore/QPointF>
#include <QtCore/QTimer>
#include <QtCore/QVariantMap>
#include <QtPositioning/QGeoCoordinate>
#include <QtQml/QJSValue>
#include <QtQmlIntegration/QtQmlIntegration>
 
#include "QmlUnitsConversion.h"
 
class ADSBVehicleManager;
class GPSManager;
class LinkManager;
class MAVLinkSigningKeys;
class MissionCommandTree;
class MultiVehicleManager;
class PositionManager;
class QGCCorePlugin;
class QGCMapEngineManager;
class QGCPalette;
class SettingsManager;
class VideoManager;
class QmlObjectListModel;
 
Q_MOC_INCLUDE("ADSBVehicleManager.h")
Q_MOC_INCLUDE("GPSManager.h")
Q_MOC_INCLUDE("LinkManager.h")
Q_MOC_INCLUDE("MAVLinkSigningKeys.h")
Q_MOC_INCLUDE("MissionCommandTree.h")
Q_MOC_INCLUDE("MultiVehicleManager.h")
Q_MOC_INCLUDE("PositionManager.h")
Q_MOC_INCLUDE("QGCCorePlugin.h")
Q_MOC_INCLUDE("QGCMapEngineManager.h")
Q_MOC_INCLUDE("QGCPalette.h")
Q_MOC_INCLUDE("SettingsManager.h")
Q_MOC_INCLUDE("VideoManager.h")
 
class QGroundControlQmlGlobal : public QObject
{
    Q_OBJECT
    QML_NAMED_ELEMENT(QGroundControl)
    QML_SINGLETON
 
public:
    static constexpr int kDefaultMessageDialogButtons = 0x00000400; // Dialog.Ok (Qt 6 StandardButton::Ok)
 
    explicit QGroundControlQmlGlobal(QObject *parent = nullptr);
    ~QGroundControlQmlGlobal();
 
    enum AltitudeFrame {
        AltitudeFrameMixed,              // Used by global altitude frame for mission planning
        AltitudeFrameRelative,           // MAV_FRAME_GLOBAL_RELATIVE_ALT
        AltitudeFrameAbsolute,           // MAV_FRAME_GLOBAL
        AltitudeFrameCalcAboveTerrain,   // Absolute altitude above terrain calculated from terrain data
        AltitudeFrameTerrain,       // MAV_FRAME_GLOBAL_TERRAIN_ALT
        AltitudeFrameNone,               // Being used as distance value unrelated to ground (for example distance to structure)
    };
    Q_ENUM(AltitudeFrame)
 
    Q_PROPERTY(QString              appName                 READ    appName                 CONSTANT)
    Q_PROPERTY(LinkManager*         linkManager             READ    linkManager             CONSTANT)
    Q_PROPERTY(QObject* serialPortManager READ serialPortManager CONSTANT)
    Q_PROPERTY(MultiVehicleManager* multiVehicleManager     READ    multiVehicleManager     CONSTANT)
    Q_PROPERTY(QGCMapEngineManager* mapEngineManager        READ    mapEngineManager        CONSTANT)
    Q_PROPERTY(PositionManager* positionManager READ positionManager CONSTANT)
    Q_PROPERTY(VideoManager*        videoManager            READ    videoManager            CONSTANT)
    Q_PROPERTY(SettingsManager*     settingsManager         READ    settingsManager         CONSTANT)
    Q_PROPERTY(ADSBVehicleManager*  adsbVehicleManager      READ    adsbVehicleManager      CONSTANT)
    Q_PROPERTY(QGCCorePlugin*       corePlugin              READ    corePlugin              CONSTANT)
    Q_PROPERTY(MissionCommandTree*  missionCommandTree      READ    missionCommandTree      CONSTANT)
    Q_PROPERTY(MAVLinkSigningKeys*   mavlinkSigningKeys      READ    mavlinkSigningKeys      CONSTANT)
    Q_PROPERTY(GPSManager* gpsManager READ gpsManager CONSTANT)
    Q_PROPERTY(QGCPalette*          globalPalette           MEMBER  _globalPalette          CONSTANT)   
    Q_PROPERTY(QmlUnitsConversion*  unitsConversion         READ    unitsConversion         CONSTANT)
    Q_PROPERTY(bool                 singleFirmwareSupport   READ    singleFirmwareSupport   CONSTANT)
    Q_PROPERTY(bool                 singleVehicleSupport    READ    singleVehicleSupport    CONSTANT)
    Q_PROPERTY(bool                 px4ProFirmwareSupported READ    px4ProFirmwareSupported CONSTANT)
    Q_PROPERTY(bool                 apmFirmwareSupported    READ    apmFirmwareSupported    CONSTANT)
    Q_PROPERTY(QGeoCoordinate       flightMapPosition       READ    flightMapPosition       WRITE setFlightMapPosition  NOTIFY flightMapPositionChanged)
    Q_PROPERTY(double               flightMapZoom           READ    flightMapZoom           WRITE setFlightMapZoom      NOTIFY flightMapZoomChanged)
    Q_PROPERTY(double               flightMapInitialZoom    MEMBER  _flightMapInitialZoom   CONSTANT)   
 
    Q_PROPERTY(QString  parameterFileExtension  READ parameterFileExtension CONSTANT)
    Q_PROPERTY(QString  telemetryFileExtension  READ telemetryFileExtension CONSTANT)
 
    Q_PROPERTY(QString qgcVersion       READ qgcVersion         CONSTANT)
    Q_PROPERTY(QString qgcAppDate       READ qgcAppDate         CONSTANT)
    Q_PROPERTY(bool    qgcDailyBuild    READ qgcDailyBuild      CONSTANT)
    Q_PROPERTY(QString newStableVersion READ newStableVersion NOTIFY newStableVersionChanged)
 
    Q_PROPERTY(qreal zOrderTopMost              READ zOrderTopMost              CONSTANT) 
    Q_PROPERTY(qreal zOrderWidgets              READ zOrderWidgets              CONSTANT) 
    Q_PROPERTY(qreal zOrderMapItems             READ zOrderMapItems             CONSTANT)
    Q_PROPERTY(qreal zOrderVehicles             READ zOrderVehicles             CONSTANT)
    Q_PROPERTY(qreal zOrderWaypointIndicators   READ zOrderWaypointIndicators   CONSTANT)
    Q_PROPERTY(qreal zOrderTrajectoryLines      READ zOrderTrajectoryLines      CONSTANT)
    Q_PROPERTY(qreal zOrderWaypointLines        READ zOrderWaypointLines        CONSTANT)
 
 
    //-------------------------------------------------------------------------
    // Elevation Provider
    Q_PROPERTY(QString  elevationProviderName           READ elevationProviderName              CONSTANT)
    Q_PROPERTY(QString  elevationProviderNotice         READ elevationProviderNotice            CONSTANT)
 
    Q_INVOKABLE void    saveGlobalSetting       (const QString& key, const QString& value);
    Q_INVOKABLE QString loadGlobalSetting       (const QString& key, const QString& defaultValue);
    Q_INVOKABLE void    saveBoolGlobalSetting   (const QString& key, bool value);
    Q_INVOKABLE bool    loadBoolGlobalSetting   (const QString& key, bool defaultValue);
 
    Q_INVOKABLE void startMockLink(const QVariantMap& properties);
    Q_INVOKABLE void    stopOneMockLink             (void);
 
    Q_INVOKABLE bool linesIntersect(QPointF xLine1, QPointF yLine1, QPointF xLine2, QPointF yLine2);
 
    Q_INVOKABLE static QString bigSizeToString(quint64 size);
 
    Q_INVOKABLE QString altitudeFrameExtraUnits(AltitudeFrame altFrame);        
    Q_INVOKABLE QString altitudeFrameShortDescription(AltitudeFrame altFrame);  
 
    Q_INVOKABLE void showMessageDialog(
        QObject* owner,
        const QString& title,
        const QString& text,
        int buttons = kDefaultMessageDialogButtons,
        QJSValue acceptFunction = QJSValue(),
        QJSValue closeFunction = QJSValue());
 
    // Test audio output
    Q_INVOKABLE void testAudioOutput();
 
    Q_INVOKABLE static void copyToClipboard(const QString& text);
 
    // Property accessors
 
    static QString appName();
    QObject* serialPortManager() const;
 
    LinkManager* linkManager() { return _linkManager; }
 
    MultiVehicleManager* multiVehicleManager() { return _multiVehicleManager; }
 
    QGCMapEngineManager* mapEngineManager() { return _mapEngineManager; }
 
    PositionManager* positionManager() const;
 
    MissionCommandTree* missionCommandTree() { return _missionCommandTree; }
 
    MAVLinkSigningKeys* mavlinkSigningKeys() { return _mavlinkSigningKeys; }
 
    VideoManager* videoManager() { return _videoManager; }
 
    QGCCorePlugin* corePlugin() { return _corePlugin; }
 
    SettingsManager* settingsManager() { return _settingsManager; }
 
    GPSManager* gpsManager() const;
 
    ADSBVehicleManager* adsbVehicleManager() { return _adsbVehicleManager; }
 
    QmlUnitsConversion* unitsConversion() { return &_unitsConversion; }
 
    static QGeoCoordinate flightMapPosition() { return _coord; }
 
    static double flightMapZoom() { return _zoom; }
 
#ifdef QGC_UNITTEST_BUILD
    static void setFlightMapViewForTest(const QGeoCoordinate& position, double zoom)
    {
        _coord = position;
        _zoom = zoom;
    }
#endif
 
    qreal zOrderTopMost             () { return 1000; }
    qreal zOrderWidgets             () { return 100; }
    qreal zOrderMapItems            () { return 50; }
    qreal zOrderWaypointIndicators  () { return 50; }
    qreal zOrderVehicles            () { return 49; }
    qreal zOrderTrajectoryLines     () { return 48; }
    qreal zOrderWaypointLines       () { return 47; }
 
    QString elevationProviderName   ();
    QString elevationProviderNotice ();
 
    bool    singleFirmwareSupport   ();
    bool    singleVehicleSupport    ();
    bool    px4ProFirmwareSupported ();
    bool    apmFirmwareSupported    ();
 
    void    setFlightMapPosition        (QGeoCoordinate& coordinate);
    void    setFlightMapZoom            (double zoom);
 
    QString parameterFileExtension  (void) const;
    QString telemetryFileExtension  (void) const;
 
    static QString qgcVersion();
    static QString qgcAppDate();
    static QString newStableVersion();
#ifdef QGC_DAILY_BUILD
    static bool qgcDailyBuild() { return true; }
#else
    static bool qgcDailyBuild() { return false; }
#endif
 
signals:
    void isMultiplexingEnabledChanged   (bool enabled);
    void mavlinkSystemIDChanged         (int id);
    void flightMapPositionChanged       (QGeoCoordinate flightMapPosition);
    void flightMapZoomChanged           (double flightMapZoom);
    void newStableVersionChanged();
    void showMessageDialogRequested     (QObject* owner, QString title, QString text, int buttons, QJSValue acceptFunction, QJSValue closeFunction);
 
private:
    QGCMapEngineManager*    _mapEngineManager       = nullptr;
    ADSBVehicleManager*     _adsbVehicleManager     = nullptr;
    MissionCommandTree*     _missionCommandTree     = nullptr;
    MAVLinkSigningKeys*     _mavlinkSigningKeys     = nullptr;
    VideoManager*           _videoManager           = nullptr;
    LinkManager*            _linkManager            = nullptr;
    MultiVehicleManager*    _multiVehicleManager    = nullptr;
    SettingsManager*        _settingsManager        = nullptr;
    QGCCorePlugin*          _corePlugin             = nullptr;
    QGCPalette*             _globalPalette          = nullptr;
 
    double                  _flightMapInitialZoom   = 17.0;
    QmlUnitsConversion      _unitsConversion;
 
    QStringList             _altitudeFrameEnumString;
 
    static QGeoCoordinate   _coord;
    static double           _zoom;
    QTimer                  _flightMapPositionSettledTimer;
 
    static constexpr const char* kQmlGlobalKeyName = "QGCQml";
 
    static constexpr const char* _flightMapPositionSettingsGroup =          "FlightMapPosition";
    static constexpr const char* _flightMapPositionLatitudeSettingsKey =    "Latitude";
    static constexpr const char* _flightMapPositionLongitudeSettingsKey =   "Longitude";
    static constexpr const char* _flightMapZoomSettingsKey =                "FlightMapZoom";
};