SurveyComplexItem.h 7.84 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
#pragma once
11

12
#include "TransectStyleComplexItem.h"
13
#include "MissionItem.h"
14
#include "SettingsFact.h"
15 16
#include "QGCLoggingCategory.h"

17
Q_DECLARE_LOGGING_CATEGORY(SurveyComplexItemLog)
18

19
class SurveyComplexItem : public TransectStyleComplexItem
20 21 22 23
{
    Q_OBJECT

public:
24 25
    /// @param vehicle Vehicle which this is being contructed for
    /// @param flyView true: Created for use in the Fly View, false: Created for use in the Plan View
26 27
    /// @param kmlOrShpFile Polygon comes from this file, empty for default polygon
    SurveyComplexItem(Vehicle* vehicle, bool flyView, const QString& kmlOrShpFile, QObject* parent);
28

29 30
    Q_PROPERTY(Fact* gridAngle              READ gridAngle              CONSTANT)
    Q_PROPERTY(Fact* flyAlternateTransects  READ flyAlternateTransects  CONSTANT)
31
    Q_PROPERTY(Fact* splitConcavePolygons   READ splitConcavePolygons   CONSTANT)
32

33 34
    Fact* gridAngle             (void) { return &_gridAngleFact; }
    Fact* flyAlternateTransects (void) { return &_flyAlternateTransectsFact; }
35
    Fact* splitConcavePolygons  (void) { return &_splitConcavePolygonsFact; }
DonLakeFlyer's avatar
DonLakeFlyer committed
36 37

    Q_INVOKABLE void rotateEntryPoint(void);
38 39

    // Overrides from ComplexMissionItem
40 41
    bool    load                (const QJsonObject& complexObject, int sequenceNumber, QString& errorString) final;
    QString mapVisualQML        (void) const final { return QStringLiteral("SurveyMapVisual.qml"); }
42

43 44 45 46 47
    // Overrides from TransectStyleComplexItem
    void    save                (QJsonArray&  planItems) final;
    bool    specifiesCoordinate (void) const final { return true; }
    void    appendMissionItems  (QList<MissionItem*>& items, QObject* missionItemParent) final;
    void    applyNewAltitude    (double newAltitude) final;
48
    double  timeBetweenShots    (void) final;
49

50 51 52 53 54
    // Overrides from VisualMissionionItem
    QString commandDescription  (void) const final { return tr("Survey"); }
    QString commandName         (void) const final { return tr("Survey"); }
    QString abbreviation        (void) const final { return tr("S"); }
    bool    readyForSave        (void) const final;
55

56 57
    // Must match json spec for GridEntryLocation
    enum EntryLocation {
DonLakeFlyer's avatar
DonLakeFlyer committed
58 59
        EntryLocationFirst,
        EntryLocationTopLeft = EntryLocationFirst,
60 61 62
        EntryLocationTopRight,
        EntryLocationBottomLeft,
        EntryLocationBottomRight,
DonLakeFlyer's avatar
DonLakeFlyer committed
63
        EntryLocationLast = EntryLocationBottomRight
64 65
    };

Don Gagne's avatar
Don Gagne committed
66
    static const char* jsonComplexItemTypeValue;
67 68
    static const char* settingsGroup;
    static const char* gridAngleName;
DonLakeFlyer's avatar
DonLakeFlyer committed
69
    static const char* gridEntryLocationName;
70
    static const char* flyAlternateTransectsName;
71
    static const char* splitConcavePolygonsName;
72 73

    static const char* jsonV3ComplexItemTypeValue;
74

75
signals:
76
    void refly90DegreesChanged(bool refly90Degrees);
77 78

private slots:
79 80 81
    // Overrides from TransectStyleComplexItem
    void _rebuildTransectsPhase1(void) final;
    void _rebuildTransectsPhase2(void) final;
82 83

private:
84 85 86
    enum CameraTriggerCode {
        CameraTriggerNone,
        CameraTriggerOn,
DonLakeFlyer's avatar
DonLakeFlyer committed
87 88
        CameraTriggerOff,
        CameraTriggerHoverAndCapture
89 90
    };

91 92 93 94
    QPointF _rotatePoint(const QPointF& point, const QPointF& origin, double angle);
    void _intersectLinesWithRect(const QList<QLineF>& lineList, const QRectF& boundRect, QList<QLineF>& resultLines);
    void _intersectLinesWithPolygon(const QList<QLineF>& lineList, const QPolygonF& polygon, QList<QLineF>& resultLines);
    void _adjustLineDirection(const QList<QLineF>& lineList, QList<QLineF>& resultLines);
95
    int _appendWaypointToMission(QList<MissionItem*>& items, int seqNum, QGeoCoordinate& coord, CameraTriggerCode cameraTrigger, QObject* missionItemParent);
DonLakeFlyer's avatar
DonLakeFlyer committed
96
    bool _nextTransectCoord(const QList<QGeoCoordinate>& transectPoints, int pointIndex, QGeoCoordinate& coord);
97
    bool _appendMissionItemsWorker(QList<MissionItem*>& items, QObject* missionItemParent, int& seqNum, bool hasRefly, bool buildRefly);
DonLakeFlyer's avatar
DonLakeFlyer committed
98
    void _optimizeTransectsForShortestDistance(const QGeoCoordinate& distanceCoord, QList<QList<QGeoCoordinate>>& transects);
99 100 101
    qreal _ccw(QPointF pt1, QPointF pt2, QPointF pt3);
    qreal _dp(QPointF pt1, QPointF pt2);
    void _swapPoints(QList<QPointF>& points, int index1, int index2);
DonLakeFlyer's avatar
DonLakeFlyer committed
102 103 104 105 106
    void _reverseTransectOrder(QList<QList<QGeoCoordinate>>& transects);
    void _reverseInternalTransectPoints(QList<QList<QGeoCoordinate>>& transects);
    void _adjustTransectsToEntryPointLocation(QList<QList<QGeoCoordinate>>& transects);
    bool _gridAngleIsNorthSouthTransects();
    double _clampGridAngle90(double gridAngle);
107 108 109 110 111 112 113 114
    void _buildAndAppendMissionItems(QList<MissionItem*>& items, QObject* missionItemParent);
    void _appendLoadedMissionItems  (QList<MissionItem*>& items, QObject* missionItemParent);
    bool _imagesEverywhere(void) const;
    bool _triggerCamera(void) const;
    bool _hasTurnaround(void) const;
    double _turnaroundDistance(void) const;
    bool _hoverAndCaptureEnabled(void) const;
    bool _loadV3(const QJsonObject& complexObject, int sequenceNumber, QString& errorString);
115
    bool _loadV4V5(const QJsonObject& complexObject, int sequenceNumber, QString& errorString, int version);
116
    void _rebuildTransectsPhase1Worker(bool refly);
117 118
    void _rebuildTransectsPhase1WorkerSinglePolygon(bool refly);
    void _rebuildTransectsPhase1WorkerSplitPolygons(bool refly);
119
    /// Adds to the _transects array from one polygon
120
    void _rebuildTranscetsFromPolygon(bool refly, const QPolygonF& polygon, const QGeoCoordinate& tangentOrigin, const QPointF* const transitionPoint);
121 122 123
    // Decompose polygon into list of convex sub polygons
    void _PolygonDecomposeConvex(const QPolygonF& polygon, QList<QPolygonF>& decomposedPolygons);
    // return true if vertex a can see vertex b
124 125
    bool _VertexCanSeeOther(const QPolygonF& polygon, const QPointF* vertexA, const QPointF* vertexB);
    bool _VertexIsReflex(const QPolygonF& polygon, const QPointF* vertex);
126

127 128 129
    QMap<QString, FactMetaData*> _metaDataMap;

    SettingsFact    _gridAngleFact;
130
    SettingsFact    _flyAlternateTransectsFact;
131
    SettingsFact    _splitConcavePolygonsFact;
DonLakeFlyer's avatar
DonLakeFlyer committed
132
    int             _entryPoint;
133 134

    static const char* _jsonGridAngleKey;
DonLakeFlyer's avatar
DonLakeFlyer committed
135
    static const char* _jsonEntryPointKey;
136
    static const char* _jsonFlyAlternateTransectsKey;
137
    static const char* _jsonSplitConcavePolygonsKey;
138 139 140 141 142 143

    static const char* _jsonV3GridObjectKey;
    static const char* _jsonV3GridAltitudeKey;
    static const char* _jsonV3GridAltitudeRelativeKey;
    static const char* _jsonV3GridAngleKey;
    static const char* _jsonV3GridSpacingKey;
DonLakeFlyer's avatar
DonLakeFlyer committed
144
    static const char* _jsonV3EntryPointKey;
145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164
    static const char* _jsonV3TurnaroundDistKey;
    static const char* _jsonV3CameraTriggerDistanceKey;
    static const char* _jsonV3CameraTriggerInTurnaroundKey;
    static const char* _jsonV3HoverAndCaptureKey;
    static const char* _jsonV3GroundResolutionKey;
    static const char* _jsonV3FrontalOverlapKey;
    static const char* _jsonV3SideOverlapKey;
    static const char* _jsonV3CameraSensorWidthKey;
    static const char* _jsonV3CameraSensorHeightKey;
    static const char* _jsonV3CameraResolutionWidthKey;
    static const char* _jsonV3CameraResolutionHeightKey;
    static const char* _jsonV3CameraFocalLengthKey;
    static const char* _jsonV3CameraMinTriggerIntervalKey;
    static const char* _jsonV3ManualGridKey;
    static const char* _jsonV3CameraObjectKey;
    static const char* _jsonV3CameraNameKey;
    static const char* _jsonV3CameraOrientationLandscapeKey;
    static const char* _jsonV3FixedValueIsAltitudeKey;
    static const char* _jsonV3Refly90DegreesKey;

165

DonLakeFlyer's avatar
DonLakeFlyer committed
166
    static const int _hoverAndCaptureDelaySeconds = 4;
167
};