QGCMapPolygon.h 6.55 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 13 14 15
 *
 * QGroundControl is licensed according to the terms in the file
 * COPYING.md in the root of the source code directory.
 *
 ****************************************************************************/

#ifndef QGCMapPolygon_H
#define QGCMapPolygon_H

#include <QObject>
#include <QGeoCoordinate>
#include <QVariantList>
16
#include <QPolygon>
17

18 19 20 21
#include "QmlObjectListModel.h"

/// The QGCMapPolygon class provides a polygon which can be displayed on a map using a map visuals control.
/// It maintains a representation of the polygon on QVariantList and QmlObjectListModel format.
22 23 24 25 26
class QGCMapPolygon : public QObject
{
    Q_OBJECT

public:
27 28
    QGCMapPolygon(QObject* parent = nullptr);
    QGCMapPolygon(const QGCMapPolygon& other, QObject* parent = nullptr);
29

30 31 32 33 34 35 36 37 38
    const QGCMapPolygon& operator=(const QGCMapPolygon& other);

    Q_PROPERTY(int                  count       READ count                                  NOTIFY countChanged)
    Q_PROPERTY(QVariantList         path        READ path                                   NOTIFY pathChanged)
    Q_PROPERTY(QmlObjectListModel*  pathModel   READ qmlPathModel                           CONSTANT)
    Q_PROPERTY(bool                 dirty       READ dirty          WRITE setDirty          NOTIFY dirtyChanged)
    Q_PROPERTY(QGeoCoordinate       center      READ center         WRITE setCenter         NOTIFY centerChanged)
    Q_PROPERTY(bool                 centerDrag  READ centerDrag     WRITE setCenterDrag     NOTIFY centerDragChanged)
    Q_PROPERTY(bool                 interactive READ interactive    WRITE setInteractive    NOTIFY interactiveChanged)
DonLakeFlyer's avatar
DonLakeFlyer committed
39 40
    Q_PROPERTY(bool                 isValid     READ isValid                                NOTIFY isValidChanged)
    Q_PROPERTY(bool                 empty       READ empty                                  NOTIFY isEmptyChanged)
41
    Q_PROPERTY(bool                 traceMode   MEMBER _traceMode                           NOTIFY traceModeChanged)
42

43
    Q_INVOKABLE void clear(void);
44 45
    Q_INVOKABLE void appendVertex(const QGeoCoordinate& coordinate);
    Q_INVOKABLE void removeVertex(int vertexIndex);
46
    Q_INVOKABLE void appendVertices(const QList<QGeoCoordinate>& coordinates);
47 48 49 50

    /// Adjust the value for the specified coordinate
    ///     @param vertexIndex Polygon point index to modify (0-based)
    ///     @param coordinate New coordinate for point
51 52 53 54
    Q_INVOKABLE void adjustVertex(int vertexIndex, const QGeoCoordinate coordinate);

    /// Splits the segment comprised of vertextIndex -> vertexIndex + 1
    Q_INVOKABLE void splitPolygonSegment(int vertexIndex);
55

56 57
    /// Returns true if the specified coordinate is within the polygon
    Q_INVOKABLE bool containsCoordinate(const QGeoCoordinate& coordinate) const;
58

59 60 61
    /// Offsets the current polygon edges by the specified distance in meters
    Q_INVOKABLE void offset(double distance);

62
    /// Loads a polygon from a KML/SH{ file
DonLakeFlyer's avatar
DonLakeFlyer committed
63
    /// @return true: success
64
    Q_INVOKABLE bool loadKMLOrSHPFile(const QString& file);
DonLakeFlyer's avatar
DonLakeFlyer committed
65

66 67
    /// Returns the path in a list of QGeoCoordinate's format
    QList<QGeoCoordinate> coordinateList(void) const;
68

69
    /// Returns the QGeoCoordinate for the vertex specified
70
    Q_INVOKABLE QGeoCoordinate vertexCoordinate(int vertex) const;
71

72 73 74
    /// Adjust polygon winding order to be clockwise (if needed)
    Q_INVOKABLE void verifyClockwiseWinding(void);

Don Gagne's avatar
Don Gagne committed
75 76 77
    Q_INVOKABLE void beginReset (void);
    Q_INVOKABLE void endReset   (void);

78 79 80 81 82 83 84 85 86 87 88
    /// Saves the polygon to the json object.
    ///     @param json Json object to save to
    void saveToJson(QJsonObject& json);

    /// Load a polygon from json
    ///     @param json Json object to load from
    ///     @param required true: no polygon in object will generate error
    ///     @param errorString Error string if return is false
    /// @return true: success, false: failure (errorString set)
    bool loadFromJson(const QJsonObject& json, bool required, QString& errorString);

89
    /// Convert polygon to NED and return (D is ignored)
90 91 92 93
    QList<QPointF> nedPolygon(void) const;

    /// Returns the area of the polygon in meters squared
    double area(void) const;
94

95 96
    // Property methods

DonLakeFlyer's avatar
DonLakeFlyer committed
97 98 99 100 101
    int             count       (void) const { return _polygonPath.count(); }
    bool            dirty       (void) const { return _dirty; }
    void            setDirty    (bool dirty);
    QGeoCoordinate  center      (void) const { return _center; }
    bool            centerDrag  (void) const { return _centerDrag; }
102
    bool            interactive (void) const { return _interactive; }
Don Gagne's avatar
Don Gagne committed
103 104
    bool            isValid     (void) const { return _polygonModel.count() >= 3; }
    bool            empty       (void) const { return _polygonModel.count() == 0; }
105 106 107 108

    QVariantList        path        (void) const { return _polygonPath; }
    QmlObjectListModel* qmlPathModel(void) { return &_polygonModel; }
    QmlObjectListModel& pathModel   (void) { return _polygonModel; }
109

DonLakeFlyer's avatar
DonLakeFlyer committed
110 111 112 113
    void setPath        (const QList<QGeoCoordinate>& path);
    void setPath        (const QVariantList& path);
    void setCenter      (QGeoCoordinate newCenter);
    void setCenterDrag  (bool centerDrag);
114
    void setInteractive (bool interactive);
115 116

    static const char* jsonPolygonKey;
117

118
signals:
DonLakeFlyer's avatar
DonLakeFlyer committed
119 120 121 122 123 124
    void countChanged       (int count);
    void pathChanged        (void);
    void dirtyChanged       (bool dirty);
    void cleared            (void);
    void centerChanged      (QGeoCoordinate center);
    void centerDragChanged  (bool centerDrag);
125
    void interactiveChanged (bool interactive);
DonLakeFlyer's avatar
DonLakeFlyer committed
126 127
    bool isValidChanged     (void);
    bool isEmptyChanged     (void);
128
    void traceModeChanged   (bool traceMode);
129

130 131 132
private slots:
    void _polygonModelCountChanged(int count);
    void _polygonModelDirtyChanged(bool dirty);
133
    void _updateCenter(void);
134

135
private:
Don Gagne's avatar
Don Gagne committed
136 137 138 139 140 141
    void            _init                   (void);
    QPolygonF       _toPolygonF             (void) const;
    QGeoCoordinate  _coordFromPointF        (const QPointF& point) const;
    QPointF         _pointFFromCoord        (const QGeoCoordinate& coordinate) const;
    void            _beginResetIfNotActive  (void);
    void            _endResetIfNotActive    (void);
142

143 144 145
    QVariantList        _polygonPath;
    QmlObjectListModel  _polygonModel;
    bool                _dirty;
146
    QGeoCoordinate      _center;
DonLakeFlyer's avatar
DonLakeFlyer committed
147
    bool                _centerDrag;
148
    bool                _ignoreCenterUpdates;
149
    bool                _interactive;
Don Gagne's avatar
Don Gagne committed
150
    bool                _resetActive;
151
    bool                _traceMode = false;
152 153 154
};

#endif