QGCApplication.h 8.1 KB
Newer Older
pixhawk's avatar
pixhawk committed
1
/*=====================================================================
Don Gagne's avatar
Don Gagne committed
2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22
 
 QGroundControl Open Source Ground Control Station
 
 (c) 2009 - 2015 QGROUNDCONTROL PROJECT <http://www.qgroundcontrol.org>
 
 This file is part of the QGROUNDCONTROL project
 
 QGROUNDCONTROL is free software: you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by
 the Free Software Foundation, either version 3 of the License, or
 (at your option) any later version.
 
 QGROUNDCONTROL is distributed in the hope that it will be useful,
 but WITHOUT ANY WARRANTY; without even the implied warranty of
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 GNU General Public License for more details.
 
 You should have received a copy of the GNU General Public License
 along with QGROUNDCONTROL. If not, see <http://www.gnu.org/licenses/>.
 
 ======================================================================*/
pixhawk's avatar
pixhawk committed
23 24 25

/**
 * @file
26
 *   @brief Definition of main class
pixhawk's avatar
pixhawk committed
27 28 29 30 31
 *
 *   @author Lorenz Meier <mavteam@student.ethz.ch>
 *
 */

Don Gagne's avatar
Don Gagne committed
32 33
#ifndef QGCAPPLICATION_H
#define QGCAPPLICATION_H
pixhawk's avatar
pixhawk committed
34 35

#include <QApplication>
36
#include <QTimer>
pixhawk's avatar
pixhawk committed
37

Don Gagne's avatar
Don Gagne committed
38
#include "LinkConfiguration.h"
39 40 41 42 43 44 45 46 47 48 49
#include "LinkManager.h"
#include "MAVLinkProtocol.h"
#include "FlightMapSettings.h"
#include "HomePositionManager.h"
#include "FirmwarePluginManager.h"
#include "MultiVehicleManager.h"
#include "JoystickManager.h"
#include "GAudioOutput.h"
#include "AutoPilotPluginManager.h"
#include "UASMessageHandler.h"
#include "FactSystem.h"
Don Gagne's avatar
Don Gagne committed
50

51
#ifdef QGC_RTLAB_ENABLED
52 53
#include "OpalLink.h"
#endif
54

55 56 57
// Work around circular header includes
class QGCSingleton;
class MainWindow;
58
class QGCToolbox;
Don Gagne's avatar
Don Gagne committed
59

pixhawk's avatar
pixhawk committed
60 61 62 63 64 65 66
/**
 * @brief The main application and management class.
 *
 * This class is started by the main method and provides
 * the central management unit of the groundstation application.
 *
 **/
Don Gagne's avatar
Don Gagne committed
67
class QGCApplication : public QApplication
pixhawk's avatar
pixhawk committed
68
{
69
    Q_OBJECT
Don Gagne's avatar
Don Gagne committed
70
    
pixhawk's avatar
pixhawk committed
71
public:
Don Gagne's avatar
Don Gagne committed
72
    QGCApplication(int &argc, char* argv[], bool unitTesting);
Don Gagne's avatar
Don Gagne committed
73
    ~QGCApplication();
74
    
Don Gagne's avatar
Don Gagne committed
75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95
    /// @brief Sets the persistent flag to delete all settings the next time QGroundControl is started.
    void deleteAllSettingsNextBoot(void);
    
    /// @brief Clears the persistent flag to delete all settings the next time QGroundControl is started.
    void clearDeleteAllSettingsNextBoot(void);
    
    /// @brief Returns the location of user visible saved file associated with QGroundControl
    QString savedFilesLocation(void);
    
    /// @brief Sets the location of user visible saved file associated with QGroundControl
    void setSavedFilesLocation(QString& location);
    
    /// @brief Location to save and load parameter files from.
    QString savedParameterFilesLocation(void);
    
    /// @brief Location to save and load mavlink log files from
    QString mavlinkLogFilesLocation(void);
    
    /// @brief Validates that the specified location will work for the saved files location.
    bool validatePossibleSavedFilesLocation(QString& location);
    
96
    /// @return true: Prompt to save log file when vehicle goes away
Don Gagne's avatar
Don Gagne committed
97 98
    bool promptFlightDataSave(void);
    
99 100 101
    /// @return true: Prompt to save log file even if vehicle was not armed
    bool promptFlightDataSaveNotArmed(void);

Don Gagne's avatar
Don Gagne committed
102
    void setPromptFlightDataSave(bool promptForSave);
103
    void setPromptFlightDataSaveNotArmed(bool promptForSave);
104

Don Gagne's avatar
Don Gagne committed
105 106 107
    /// @brief Returns truee if unit test are being run
    bool runningUnitTests(void) { return _runningUnitTests; }
    
108 109 110 111 112 113
    /// @return true: dark ui style, false: light ui style
    bool styleIsDark(void) { return _styleIsDark; }
    
    /// Set the current UI style
    void setStyle(bool styleIsDark);
    
Don Gagne's avatar
Don Gagne committed
114
    /// Used to report a missing Parameter. Warning will be displayed to user. Method may be called
115
    /// multiple times.
Don Gagne's avatar
Don Gagne committed
116
    void reportMissingParameter(int componentId, const QString& name);
117

Don Gagne's avatar
Don Gagne committed
118 119
    /// Show a non-modal message to the user
    void showToolBarMessage(const QString& message);
120 121 122

	/// @return true: Fake ui into showing mobile interface
	bool fakeMobile(void) { return _fakeMobile; }
Don Gagne's avatar
Don Gagne committed
123
    
124 125 126
#ifdef QT_DEBUG
    bool testHighDPI(void) { return _testHighDPI; }
#endif
127 128 129

    // Still working on getting rid of this and using dependency injection instead for everything
    QGCToolbox* toolbox(void) { return _toolbox; }
130
    
131 132 133 134 135 136 137 138 139 140 141 142
public slots:
    /// You can connect to this slot to show an information message box from a different thread.
    void informationMessageBoxOnMainThread(const QString& title, const QString& msg);
    
    /// You can connect to this slot to show a warning message box from a different thread.
    void warningMessageBoxOnMainThread(const QString& title, const QString& msg);
    
    /// You can connect to this slot to show a critical message box from a different thread.
    void criticalMessageBoxOnMainThread(const QString& title, const QString& msg);
    
    /// Save the specified Flight Data Log
    void saveTempFlightDataLogOnMainThread(QString tempLogfile);
143

144
signals:
145 146 147 148
    /// Signals that the style has changed
    ///     @param darkStyle true: dark style, false: light style
    void styleChanged(bool darkStyle);
    
149 150 151 152
    /// This is connected to MAVLinkProtocol::checkForLostLogFiles. We signal this to ourselves to call the slot
    /// on the MAVLinkProtocol thread;
    void checkForLostLogFiles(void);
    
153
public:
154 155
    // Although public, these methods are internal and should only be called by UnitTest code
    
156 157 158 159 160 161 162
    /// @brief Perform initialize which is common to both normal application running and unit tests.
    ///         Although public should only be called by main.
    void _initCommon(void);

    /// @brief Intialize the application for normal application boot. Or in other words we are not going to run
    ///         unit tests. Although public should only be called by main.
    bool _initForNormalAppBoot(void);
Don Gagne's avatar
Don Gagne committed
163
    
164 165 166
    /// @brief Intialize the application for normal application boot. Or in other words we are not going to run
    ///         unit tests. Although public should only be called by main.
    bool _initForUnitTests(void);
Don Gagne's avatar
Don Gagne committed
167
    
168
    static QGCApplication*  _app;   ///< Our own singleton. Should be reference directly by qgcApp
Don Gagne's avatar
Don Gagne committed
169
    
Don Gagne's avatar
Don Gagne committed
170
private slots:
Don Gagne's avatar
Don Gagne committed
171
    void _missingParamsDisplay(void);
Don Gagne's avatar
Don Gagne committed
172
    
pixhawk's avatar
pixhawk committed
173
private:
174
    void _loadCurrentStyle(void);
Don Gagne's avatar
Don Gagne committed
175 176 177 178
    
    static const char* _settingsVersionKey;             ///< Settings key which hold settings version
    static const char* _deleteAllSettingsKey;           ///< If this settings key is set on boot, all settings will be deleted
    static const char* _savedFilesLocationKey;          ///< Settings key for user visible saved files location
179 180
    static const char* _promptFlightDataSave;           ///< Settings key for promptFlightDataSave
    static const char* _promptFlightDataSaveNotArmed;   ///< Settings key for promptFlightDataSaveNotArmed
181
    static const char* _styleKey;                       ///< Settings key for UI style
Don Gagne's avatar
Don Gagne committed
182 183 184 185
    
    static const char* _defaultSavedFileDirectoryName;      ///< Default name for user visible save file directory
    static const char* _savedFileMavlinkLogDirectoryName;   ///< Name of mavlink log subdirectory
    static const char* _savedFileParameterDirectoryName;    ///< Name of parameter subdirectory
186

Don Gagne's avatar
Don Gagne committed
187
    bool _runningUnitTests; ///< true: running unit tests, false: normal app
Don Gagne's avatar
Don Gagne committed
188
    
189 190 191 192
    static const char*  _darkStyleFile;
    static const char*  _lightStyleFile;
    bool                _styleIsDark;      ///< true: dark style, false: light style
    
Don Gagne's avatar
Don Gagne committed
193 194 195
    static const int    _missingParamsDelayedDisplayTimerTimeout = 1000;  ///< Timeout to wait for next missing fact to come in before display
    QTimer              _missingParamsDelayedDisplayTimer;                ///< Timer use to delay missing fact display
    QStringList         _missingParams;                                  ///< List of missing facts to be displayed
196

197
	bool				_fakeMobile;	///< true: Fake ui into displaying mobile interface
198 199 200 201
    
#ifdef QT_DEBUG
    bool _testHighDPI;  ///< true: double fonts sizes for simulating high dpi devices
#endif
202

203 204
    QGCToolbox* _toolbox;

Don Gagne's avatar
Don Gagne committed
205 206
    /// Unit Test have access to creating and destroying singletons
    friend class UnitTest;
pixhawk's avatar
pixhawk committed
207 208
};

Don Gagne's avatar
Don Gagne committed
209 210 211 212
/// @brief Returns the QGCApplication object singleton.
QGCApplication* qgcApp(void);

#endif