GeoMapWaypointItem.qml

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.
 *
 ****************************************************************************/
 
import QtQuick
import QtQuick3D
import QtPositioning
 
import QGroundControl
import QGroundControl.Controls
import QGroundControl.GeoMap
 
/// Simple-mission waypoint marker for the GeoMap: a colored dot that
/// crossfades into a 3D sphere, with an always-visible sequence-number label.
/// Marker color matches the existing 2D FlyView convention (MissionItemIndexLabel):
/// current item highlighted, everything else a plain indicator color.
/// Renders nothing for complex mission items, the home item, or items with
/// no real coordinate (e.g. RTL, which flies to home dynamically rather than
/// a mission-encoded lat/lon) — see visible.
GeoMapItem {
    id: root
 
    property var item          ///< VisualMissionItem for this marker
    // DEM-vs-home-AMSL bias (see GeoMapVehicleItem), computed once by the
    // consumer for the active vehicle and shared across every marker instead
    // of each one re-sampling the same DEM lookup independently
    property real homeTerrainBias: 0
    property real size: ScreenTools.defaultFontPixelHeight * 1.5
    property bool collapsed: false  ///< Drawn by another marker of its overlap group (see GeoMapMissionItems)
    property bool grouped: false    ///< Stands for an overlap group: shows a "…" badge
 
    readonly property bool hasMarker: item ? item.isSimpleItem && item.specifiesCoordinate : false
    readonly property real smallIndicatorSize: size * 0.75
 
    signal clicked()
 
    objectName: "geoMapWaypointMarker"
    width: size
    height: size
    anchorPoint: Qt.point(width / 2, height / 2)
    altitudeMode: GeoMapItem.Absolute
    // item.amslEntryAlt is AMSL per QGC's own terrain-query pipeline, which
    // can disagree with GeoMap's own DEM tiles; bias-corrected the same way
    // GeoMapVehicleItem aligns the vehicle marker to the rendered mesh
    coordinate: item ? QtPositioning.coordinate(item.coordinate.latitude,
                                                item.coordinate.longitude,
                                                item.amslEntryAlt + homeTerrainBias)
                     : QtPositioning.coordinate()
    visible: hasMarker && !collapsed
 
    QGCPalette { id: qgcPal; colorGroupEnabled: root.enabled }
 
    // Matches MissionItemIndicator.qml's _isCurrentItem exactly: current item
    // (or a complex item with a current child) is highlighted
    readonly property bool _isCurrentItem: item ? (item.isCurrentItem || item.hasCurrentChildItem) : false
 
    // Matches MissionItemIndexLabel.qml's existing convention: current item
    // is "green", everything else is the plain map indicator color
    readonly property color _markerColor: root._isCurrentItem ? "green" : qgcPal.mapIndicator
 
    // MissionItemIndexLabel also grows the indicator for the current item
    // (small: !checked) and for a group; mirrored here for both the 2D dot and 3D sphere
    readonly property real _indicatorSize: (root._isCurrentItem || root.grouped) ? root.size : root.smallIndicatorSize
 
    readonly property var _camera: scene ? scene.camera : null
 
    // Constant apparent size, same technique as GeoMapVehicleItem: scene
    // units per screen pixel at the camera's look-at distance. Built-in
    // QtQuick3D meshes are 100 units across.
    readonly property real _modelScale: _camera
        ? root._indicatorSize * _camera.distance * _camera.unitsPerPixelAtUnitDistance / 100
        : 1
 
    Rectangle {
        anchors.centerIn: parent
        width: root._indicatorSize
        height: root._indicatorSize
        radius: width / 2
        color: root._markerColor
        opacity: root.contentOpacity2D
    }
 
    // Matches MissionItemIndicator.qml's "extra circle to indicate selection"
    Rectangle {
        anchors.centerIn: parent
        width: root._indicatorSize * 1.4
        height: width
        radius: width / 2
        color: "transparent"
        border.color: Qt.rgba(1, 1, 1, 0.5)
        border.width: 1
        opacity: root.contentOpacity2D
        visible: root._isCurrentItem
    }
 
    QGCLabel {
        anchors.centerIn: parent
        text: root.item ? root.item.sequenceNumber : ""
        color: "white"
        font.bold: true
    }
 
    QGCLabel {
        anchors.horizontalCenter: parent.horizontalCenter
        anchors.bottom: parent.bottom
        text: "…"
        color: "white"
        font.pointSize: ScreenTools.smallFontPointSize
        visible: root.grouped
    }
 
    // The item itself tracks the projected marker position at any tilt, so
    // this hit target follows the 3D sphere through the 2D<->3D crossfade
    MouseArea {
        anchors.fill: parent
        onClicked: root.clicked()
    }
 
    GeoMapDropShadow {
        id: dropShadow
        geoItem: root
        indicatorSize: root._indicatorSize
    }
 
    delegate3D: Component {
        Node {
            Node {
                scale: Qt.vector3d(root._modelScale, root._modelScale, root._modelScale)
 
                Model {
                    source: "#Sphere"
 
                    materials: PrincipledMaterial {
                        baseColor: root._markerColor
                    }
                }
            }
 
            GeoMapDropLine {
                dropLength: dropShadow.dropLength
                lineScale: dropShadow.dropLineScale
                lineColor: root._markerColor
            }
        }
    }
}