SurveyComplexItem.h 7.95 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
    double  additionalTimeDelay (void) const final;
56

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

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

    static const char* jsonV3ComplexItemTypeValue;
75

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

private slots:
80
    // Overrides from TransectStyleComplexItem
81 82 83
    void _rebuildTransectsPhase1    (void) final;
    void _recalcComplexDistance     (void) final;
    void _recalcCameraShots         (void) final;
84 85

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

93 94 95 96
    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);
97
    int _appendWaypointToMission(QList<MissionItem*>& items, int seqNum, QGeoCoordinate& coord, CameraTriggerCode cameraTrigger, QObject* missionItemParent);
DonLakeFlyer's avatar
DonLakeFlyer committed
98
    bool _nextTransectCoord(const QList<QGeoCoordinate>& transectPoints, int pointIndex, QGeoCoordinate& coord);
99
    bool _appendMissionItemsWorker(QList<MissionItem*>& items, QObject* missionItemParent, int& seqNum, bool hasRefly, bool buildRefly);
DonLakeFlyer's avatar
DonLakeFlyer committed
100
    void _optimizeTransectsForShortestDistance(const QGeoCoordinate& distanceCoord, QList<QList<QGeoCoordinate>>& transects);
101 102 103
    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
104 105 106 107 108
    void _reverseTransectOrder(QList<QList<QGeoCoordinate>>& transects);
    void _reverseInternalTransectPoints(QList<QList<QGeoCoordinate>>& transects);
    void _adjustTransectsToEntryPointLocation(QList<QList<QGeoCoordinate>>& transects);
    bool _gridAngleIsNorthSouthTransects();
    double _clampGridAngle90(double gridAngle);
109 110 111 112 113 114 115 116
    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);
117
    bool _loadV4V5(const QJsonObject& complexObject, int sequenceNumber, QString& errorString, int version);
118
    void _rebuildTransectsPhase1Worker(bool refly);
119 120
    void _rebuildTransectsPhase1WorkerSinglePolygon(bool refly);
    void _rebuildTransectsPhase1WorkerSplitPolygons(bool refly);
121
    /// Adds to the _transects array from one polygon
122
    void _rebuildTransectsFromPolygon(bool refly, const QPolygonF& polygon, const QGeoCoordinate& tangentOrigin, const QPointF* const transitionPoint);
123 124 125
    // 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
126 127
    bool _VertexCanSeeOther(const QPolygonF& polygon, const QPointF* vertexA, const QPointF* vertexB);
    bool _VertexIsReflex(const QPolygonF& polygon, const QPointF* vertex);
128

129 130 131
    QMap<QString, FactMetaData*> _metaDataMap;

    SettingsFact    _gridAngleFact;
132
    SettingsFact    _flyAlternateTransectsFact;
133
    SettingsFact    _splitConcavePolygonsFact;
DonLakeFlyer's avatar
DonLakeFlyer committed
134
    int             _entryPoint;
135 136

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

    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
146
    static const char* _jsonV3EntryPointKey;
147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166
    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;

167

DonLakeFlyer's avatar
DonLakeFlyer committed
168
    static const int _hoverAndCaptureDelaySeconds = 4;
169
};