/**************************************************************************** * * (c) 2009-2020 QGROUNDCONTROL PROJECT * * 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 #include #include #include #include "QmlObjectListModel.h" #include "KMLDomDocument.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. class QGCMapPolygon : public QObject { Q_OBJECT public: QGCMapPolygon(QObject* parent = nullptr); QGCMapPolygon(const QGCMapPolygon& other, QObject* parent = nullptr); 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) Q_PROPERTY(bool isValid READ isValid NOTIFY isValidChanged) Q_PROPERTY(bool empty READ empty NOTIFY isEmptyChanged) Q_PROPERTY(bool traceMode MEMBER _traceMode NOTIFY traceModeChanged) Q_INVOKABLE void clear(void); Q_INVOKABLE void appendVertex(const QGeoCoordinate& coordinate); Q_INVOKABLE void removeVertex(int vertexIndex); Q_INVOKABLE void appendVertices(const QList& coordinates); /// Adjust the value for the specified coordinate /// @param vertexIndex Polygon point index to modify (0-based) /// @param coordinate New coordinate for point Q_INVOKABLE void adjustVertex(int vertexIndex, const QGeoCoordinate coordinate); /// Splits the segment comprised of vertextIndex -> vertexIndex + 1 Q_INVOKABLE void splitPolygonSegment(int vertexIndex); /// Returns true if the specified coordinate is within the polygon Q_INVOKABLE bool containsCoordinate(const QGeoCoordinate& coordinate) const; /// Offsets the current polygon edges by the specified distance in meters Q_INVOKABLE void offset(double distance); /// Loads a polygon from a KML/SH{ file /// @return true: success Q_INVOKABLE bool loadKMLOrSHPFile(const QString& file); /// Returns the path in a list of QGeoCoordinate's format QList coordinateList(void) const; /// Returns the QGeoCoordinate for the vertex specified Q_INVOKABLE QGeoCoordinate vertexCoordinate(int vertex) const; /// Adjust polygon winding order to be clockwise (if needed) Q_INVOKABLE void verifyClockwiseWinding(void); Q_INVOKABLE void beginReset (void); Q_INVOKABLE void endReset (void); /// 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); /// Convert polygon to NED and return (D is ignored) QList nedPolygon(void) const; /// Returns the area of the polygon in meters squared double area(void) const; QDomElement kmlPolygonElement(KMLDomDocument& domDocument); // Property methods 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; } bool interactive (void) const { return _interactive; } bool isValid (void) const { return _polygonModel.count() >= 3; } bool empty (void) const { return _polygonModel.count() == 0; } QVariantList path (void) const { return _polygonPath; } QmlObjectListModel* qmlPathModel(void) { return &_polygonModel; } QmlObjectListModel& pathModel (void) { return _polygonModel; } void setPath (const QList& path); void setPath (const QVariantList& path); void setCenter (QGeoCoordinate newCenter); void setCenterDrag (bool centerDrag); void setInteractive (bool interactive); static const char* jsonPolygonKey; signals: void countChanged (int count); void pathChanged (void); void dirtyChanged (bool dirty); void cleared (void); void centerChanged (QGeoCoordinate center); void centerDragChanged (bool centerDrag); void interactiveChanged (bool interactive); bool isValidChanged (void); bool isEmptyChanged (void); void traceModeChanged (bool traceMode); private slots: void _polygonModelCountChanged(int count); void _polygonModelDirtyChanged(bool dirty); void _updateCenter(void); private: 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); QVariantList _polygonPath; QmlObjectListModel _polygonModel; bool _dirty; QGeoCoordinate _center; bool _centerDrag; bool _ignoreCenterUpdates; bool _interactive; bool _resetActive; bool _traceMode = false; }; #endif