GeoMapItem.h

Go to the documentation of this file.

/****************************************************************************
 *
 * (c) 2009-2024 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.
 *
 ****************************************************************************/
 
#pragma once
 
#include <QtCore/QPointF>
#include <QtGui/QVector3D>
#include <QtPositioning/QGeoCoordinate>
#include <QtQmlIntegration/QtQmlIntegration>
#include <QtQuick/QQuickItem>
 
class GeoMapCamera;
class GeoScene;
class QQmlComponent;
class SurfacePatchModel;
 
Q_MOC_INCLUDE("GeoScene.h")
Q_MOC_INCLUDE("SurfacePatchModel.h")
Q_MOC_INCLUDE("QtQml/QQmlComponent")
 
class GeoMapItem : public QQuickItem
{
    Q_OBJECT
    QML_ELEMENT
    Q_PROPERTY(QGeoCoordinate coordinate READ coordinate WRITE setCoordinate NOTIFY coordinateChanged)
    Q_PROPERTY(QPointF anchorPoint READ anchorPoint WRITE setAnchorPoint NOTIFY anchorPointChanged)
    Q_PROPERTY(GeoScene* scene READ scene WRITE setScene NOTIFY sceneChanged)
    Q_PROPERTY(SurfacePatchModel* surfaceModel READ surfaceModel WRITE setSurfaceModel NOTIFY surfaceModelChanged)
    Q_PROPERTY(AltitudeMode altitudeMode READ altitudeMode WRITE setAltitudeMode NOTIFY altitudeModeChanged)
    Q_PROPERTY(bool projected READ projected NOTIFY projectedChanged)
    Q_PROPERTY(QVector3D scenePosition READ scenePosition NOTIFY scenePositionChanged)
    Q_PROPERTY(QQmlComponent* delegate3D READ delegate3D WRITE setDelegate3D NOTIFY delegate3DChanged)
    Q_PROPERTY(QObject* node3D READ node3D NOTIFY node3DChanged)
    Q_PROPERTY(bool crossfade3D READ crossfade3D WRITE setCrossfade3D NOTIFY crossfade3DChanged)
    Q_PROPERTY(qreal contentOpacity2D READ contentOpacity2D NOTIFY contentOpacity2DChanged)
 
public:
    explicit GeoMapItem(QQuickItem* parent = nullptr);
    ~GeoMapItem() override;
 
    enum class AltitudeMode
    {
        ClampToGround,  
        Absolute        
    };
    Q_ENUM(AltitudeMode)
 
    QGeoCoordinate coordinate() const { return _coordinate; }
 
    void setCoordinate(const QGeoCoordinate& coordinate);
 
    QPointF anchorPoint() const { return _anchorPoint; }
 
    void setAnchorPoint(const QPointF& anchorPoint);
 
    GeoScene* scene() const { return _scene; }
 
    void setScene(GeoScene* scene);
 
    SurfacePatchModel* surfaceModel() const { return _surfaceModel; }
 
    void setSurfaceModel(SurfacePatchModel* surfaceModel);
 
    AltitudeMode altitudeMode() const { return _altitudeMode; }
 
    void setAltitudeMode(AltitudeMode mode);
 
    bool projected() const { return _projected; }
 
    QVector3D scenePosition() const { return _scenePosition; }
 
    QQmlComponent* delegate3D() const { return _delegate3D; }
 
    void setDelegate3D(QQmlComponent* delegate3D);
 
    QObject* node3D() const { return _node3D; }
 
    bool crossfade3D() const { return _crossfade3D; }
 
    void setCrossfade3D(bool crossfade3D);
 
    qreal contentOpacity2D() const { return _contentOpacity2D; }
 
signals:
    void coordinateChanged();
    void anchorPointChanged();
    void sceneChanged();
    void surfaceModelChanged();
    void altitudeModeChanged();
    void projectedChanged();
    void scenePositionChanged();
    void delegate3DChanged();
    void node3DChanged();
    void crossfade3DChanged();
    void contentOpacity2DChanged();
 
private slots:
    void _updatePosition();
    void _terrainHeightsChanged();
 
private:
    void _connectCamera();
    void _setProjected(bool projected);
    void _setScenePosition(const QVector3D& scenePosition);
    void _rebuildNode3D();
    void _updateCrossfade();
    void _updateNode3DVisibility();
 
    QGeoCoordinate _coordinate;
    QPointF _anchorPoint;
    GeoScene* _scene = nullptr;
    SurfacePatchModel* _surfaceModel = nullptr;
    GeoMapCamera* _connectedCamera = nullptr;
    AltitudeMode _altitudeMode = AltitudeMode::ClampToGround;
    bool _projected = false;
    QVector3D _scenePosition;
    QQmlComponent* _delegate3D = nullptr;
    QObject* _node3D = nullptr;
    bool _crossfade3D = true;
    qreal _contentOpacity2D = 1.0;
};