QGCLoggingCategory.h 2.66 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 11 12 13 14 15 16 17 18 19 20

/// @file
///     @author Don Gagne <don@thegagnes.com>

#ifndef QGC_LOGGING_CATEGORY_H
#define QGC_LOGGING_CATEGORY_H

#include <QLoggingCategory>
#include <QStringList>

// Add Global logging categories (not class specific) here using Q_DECLARE_LOGGING_CATEGORY
21
Q_DECLARE_LOGGING_CATEGORY(FirmwareUpgradeLog)
Don Gagne's avatar
Don Gagne committed
22
Q_DECLARE_LOGGING_CATEGORY(FirmwareUpgradeVerboseLog)
23
Q_DECLARE_LOGGING_CATEGORY(MissionCommandsLog)
24
Q_DECLARE_LOGGING_CATEGORY(MissionItemLog)
25
Q_DECLARE_LOGGING_CATEGORY(ParameterManagerLog)
26
Q_DECLARE_LOGGING_CATEGORY(GeotaggingLog)
27
Q_DECLARE_LOGGING_CATEGORY(RTKGPSLog)
28
Q_DECLARE_LOGGING_CATEGORY(GuidedActionsControllerLog)
29
Q_DECLARE_LOGGING_CATEGORY(ADSBVehicleManagerLog)
30 31 32 33 34

/// @def QGC_LOGGING_CATEGORY
/// This is a QGC specific replacement for Q_LOGGING_CATEGORY. It will register the category name into a
/// global list. It's usage is the same as Q_LOGGING_CATEOGRY.
#define QGC_LOGGING_CATEGORY(name, ...) \
35
    static QGCLoggingCategory qgcCategory ## name (__VA_ARGS__); \
36 37
    Q_LOGGING_CATEGORY(name, __VA_ARGS__)

38
class QGCLoggingCategoryRegister : public QObject
39
{
40 41
    Q_OBJECT

42 43
public:
    static QGCLoggingCategoryRegister* instance(void);
44 45

    /// Registers the specified logging category to the system.
46
    void registerCategory(const char* category) { _registeredCategories << category; }
47 48 49 50 51 52 53 54 55 56 57 58 59 60

    /// Returns the list of available logging category names.
    Q_INVOKABLE QStringList registeredCategories(void);

    /// Turns on/off logging for the specified category. State is saved in app settings.
    Q_INVOKABLE void setCategoryLoggingOn(const QString& category, bool enable);

    /// Returns true if logging is turned on for the specified category.
    Q_INVOKABLE bool categoryLoggingOn(const QString& category);

    /// Sets the logging filters rules from saved settings.
    ///     @param commandLineLogggingOptions Logging options which were specified on the command line
    void setFilterRulesFromSettings(const QString& commandLineLoggingOptions);

61 62 63 64
private:
    QGCLoggingCategoryRegister(void) { }
    
    QStringList _registeredCategories;
65 66 67
    QString     _commandLineLoggingOptions;

    static const char* _filterRulesSettingsGroup;
68 69 70 71 72 73 74 75 76
};
        
class QGCLoggingCategory
{
public:
    QGCLoggingCategory(const char* category) { QGCLoggingCategoryRegister::instance()->registerCategory(category); }
};

#endif