[feature ] Add PositionKit, PositionMarker and other related classes …

…to QgsQuick.

For background information see the associated QEP (qgis/QGIS-Enhancement-Proposals#109

doc/qgsquick.dox

@@ -13,7 +13,9 @@ QGIS Quick consists of a Qt plugin that provides the QML components and of a sha
 
 \subsection qgsquick_overview_widgets QML Classes
 \subsubsection qgsquick_overview_widgets_mapcanvas MapCanvas
-Similarly to QgsMapCanvas, this component can be used for displaying GIS data on a canvas. See also QgsQuickMapCanvasMap.
+\subsubsection qgsquick_overview_widgets_positionmarker PositionMarker
+The element refers to current position according gps location device connected to it. It holds information about longitude, latitude, altitude,
+direction of the movement and accuracy of the signal. See also QgsQuickPostionKit.
 \subsubsection qgsquick_overview_widgets_scalebar ScaleBar
 A QML component that shows the scale ratio between its length and distance on the MapCanvas. There are predefined rounded values
 for several zooming levels with 'm' or 'km' postfixes. After any zoom in/out event on canvas recalculates its properties and updates

src/quickgui/CMakeLists.txt

@@ -2,13 +2,16 @@
 # sources
 SET(QGIS_QUICK_GUI_MOC_HDRS
   qgsquickfeaturelayerpair.h
+  qgsquickcoordinatetransformer.h
   qgsquickfeaturehighlight.h
   qgsquickidentifykit.h
   qgsquickmapcanvasmap.h
   qgsquickmapsettings.h
   qgsquickmaptransform.h
   qgsquickmessagelogmodel.h
+  qgsquickpositionkit.h
   qgsquickscalebarkit.h
+  qgsquicksimulatedpositionsource.h
   qgsquickutils.h
 )
 
@@ -18,14 +21,17 @@ SET(QGIS_QUICK_GUI_HDRS
 
 SET(QGIS_QUICK_GUI_SRC
   qgsquickfeaturelayerpair.cpp
+  qgsquickcoordinatetransformer.cpp
   qgsquickfeaturehighlight.cpp
   qgsquickhighlightsgnode.cpp
   qgsquickidentifykit.cpp
   qgsquickmapcanvasmap.cpp
   qgsquickmapsettings.cpp
   qgsquickmaptransform.cpp
   qgsquickmessagelogmodel.cpp
+  qgsquickpositionkit.cpp
   qgsquickscalebarkit.cpp
+  qgsquicksimulatedpositionsource.cpp
   qgsquickutils.cpp
 )
 
@@ -69,6 +75,10 @@ INCLUDE_DIRECTORIES(SYSTEM
 
 ADD_DEFINITIONS(-DCORE_EXPORT=)
 
+
+SET(QGIS_QUICK_GUI_IMAGE_RCCS ./images/images.qrc)
+QT5_ADD_RESOURCES(QGIS_QUICK_GUI_IMAGE_RCC_SRCS ${QGIS_QUICK_GUI_IMAGE_RCCS})
+
 ############################################################
 # qgis_quick shared library
 QT5_WRAP_CPP(QGIS_QUICK_GUI_MOC_SRCS ${QGIS_QUICK_GUI_MOC_HDRS})

src/quickgui/images/ic_navigation_black.svg

@@ -0,0 +1,4 @@
+<svg fill="#000000" height="48" viewBox="0 0 24 24" width="48" xmlns="http://www.w3.org/2000/svg">
+    <path d="M0 0h24v24H0z" fill="none"/>
+    <path d="M12 2L4.5 20.29l.71.71L12 18l6.79 3 .71-.71z"/>
+</svg>

src/quickgui/images/images.qrc

@@ -0,0 +1,5 @@
+<RCC>
+    <qresource prefix="/">
+        <file>ic_navigation_black.svg</file>
+    </qresource>
+</RCC>

src/quickgui/plugin/CMakeLists.txt

@@ -12,6 +12,7 @@ SET(QGIS_QUICK_PLUGIN_SRC
 SET(QGIS_QUICK_PLUGIN_RESOURCES
   qgsquickmapcanvas.qml
   qgsquickmessagelog.qml
+  qgsquickpositionmarker.qml
   qgsquickscalebar.qml
   qmldir
 )

src/quickgui/plugin/qgsquickplugin.cpp

@@ -30,13 +30,15 @@
 #include "qgsvectorlayer.h"
 
 #include "qgsquickfeaturehighlight.h"
+#include "qgsquickcoordinatetransformer.h"
 #include "qgsquickidentifykit.h"
 #include "qgsquickfeaturelayerpair.h"
 #include "qgsquickmapcanvasmap.h"
 #include "qgsquickmapsettings.h"
 #include "qgsquickmaptransform.h"
 #include "qgsquickmessagelogmodel.h"
 #include "qgsquickplugin.h"
+#include "qgsquickpositionkit.h"
 #include "qgsquickscalebarkit.h"
 #include "qgsquickutils.h"
 
@@ -61,11 +63,13 @@ void QgsQuickPlugin::registerTypes( const char *uri )
 
   qmlRegisterType< QgsProject >( uri, 0, 1, "Project" );
   qmlRegisterType< QgsQuickFeatureHighlight >( uri, 0, 1, "FeatureHighlight" );
+  qmlRegisterType< QgsQuickCoordinateTransformer >( uri, 0, 1, "CoordinateTransformer" );
   qmlRegisterType< QgsQuickIdentifyKit >( uri, 0, 1, "IdentifyKit" );
   qmlRegisterType< QgsQuickMapCanvasMap >( uri, 0, 1, "MapCanvasMap" );
   qmlRegisterType< QgsQuickMapSettings >( uri, 0, 1, "MapSettings" );
   qmlRegisterType< QgsQuickMapTransform >( uri, 0, 1, "MapTransform" );
   qmlRegisterType< QgsQuickMessageLogModel >( uri, 0, 1, "MessageLogModel" );
+  qmlRegisterType< QgsQuickPositionKit >( uri, 0, 1, "PositionKit" );
   qmlRegisterType< QgsQuickScaleBarKit >( uri, 0, 1, "ScaleBarKit" );
   qmlRegisterType< QgsVectorLayer >( uri, 0, 1, "VectorLayer" );
 

src/quickgui/plugin/qgsquickpositionmarker.qml

@@ -0,0 +1,115 @@
+/***************************************************************************
+  qgsquickpositionmarker.qml
+  --------------------------------------
+  Date                 : Dec 2017
+  Copyright            : (C) 2017 by Peter Petrik
+  Email                : zilolv at gmail dot com
+ ***************************************************************************
+ *                                                                         *
+ *   This program is free software; you can redistribute it and/or modify  *
+ *   it under the terms of the GNU General Public License as published by  *
+ *   the Free Software Foundation; either version 2 of the License, or     *
+ *   (at your option) any later version.                                   *
+ *                                                                         *
+ ***************************************************************************/
+
+import QtQuick 2.3
+import QtQuick.Controls 2.2
+import QtQml 2.2
+import QtGraphicalEffects 1.0
+import QgsQuick 0.1 as QgsQuick
+
+/**
+ * \brief Graphical representation of physical location on the map.
+ *
+ * Source position and accuracy taken from PositionKit is drawn as a marker on the map.
+ * Marker is grayed out when position is not available. When PositionKit support reading of the accuracy,
+ * the circle is drawn around the marker. PositionKit must be connected, for example GPS position source from QgsQuickPositionKit.
+ */
+Item {
+  id: positionMarker
+  property int size: 48 * QgsQuick.Utils.dp
+
+  /**
+   * Utils for handling position.
+   */
+  property QgsQuick.PositionKit positionKit
+
+  /**
+   * Color of the marker when position is known.
+   */
+  property color baseColor: "darkblue"
+  /**
+   * Color of the marker when position is unknown (e.g. GPS signal lost).
+   */
+  property color unavailableColor: "gray"
+
+  /**
+   * Whether circle representing accuracy of the position should be rendered.
+   */
+  property var withAccuracy: true
+
+  /**
+   * Icon for position marker.
+   */
+  property var markerIcon: QgsQuick.Utils.getThemeIcon("ic_navigation_black")
+
+  /**
+   * Source position accuracy circle-shaped indicator around positionMarker.
+   */
+  Rectangle {
+    id: accuracyIndicator
+    visible: withAccuracy &&
+             positionKit.hasPosition &&
+             (positionKit.accuracy > 0) &&
+             (accuracyIndicator.width > positionMarker.size / 2.0)
+    x: positionKit.screenPosition.x - width/2
+    y: positionKit.screenPosition.y - height/2
+    width:positionKit.screenAccuracy
+    height: accuracyIndicator.width
+    color: baseColor
+    border.color: "black"
+    border.width: 3 * QgsQuick.Utils.dp
+    radius: width*0.5
+    opacity: 0.1
+  }
+
+  /**
+   * Position marker.
+   */
+  Rectangle {
+    id: navigationMarker
+    property int borderWidth: 2 * QgsQuick.Utils.dp
+    width: positionMarker.size + 20 * QgsQuick.Utils.dp
+    height: width
+    color: "white"
+    border.color: baseColor
+    border.width: borderWidth
+    radius: width*0.5
+    antialiasing: true
+    x: positionKit.screenPosition.x - width/2
+    y: positionKit.screenPosition.y - height/2
+
+    Image {
+      id: navigation
+      source: positionMarker.markerIcon
+      fillMode: Image.PreserveAspectFit
+      rotation: positionKit.direction
+      anchors.centerIn: parent
+      width: positionMarker.size
+      height: width
+    }
+
+    /**
+     * Makes positionMarker (navigation) grey if position is unknown.
+     */
+    ColorOverlay {
+      anchors.fill: navigation
+      source: navigation
+      color: positionKit.hasPosition ? baseColor : unavailableColor
+      rotation: positionKit.direction
+      visible: !(positionKit.hasPosition)
+    }
+  }
+}
+

src/quickgui/plugin/qmldir

@@ -14,6 +14,7 @@ module QgsQuick
 plugin qgis_quick_plugin
 
 MapCanvas 0.1 qgsquickmapcanvas.qml
+PositionMarker 0.1 qgsquickpositionmarker.qml
 ScaleBar 0.1 qgsquickscalebar.qml
 MessageLog 0.1 qgsquickmessagelog.qml
 

src/quickgui/qgsquickcoordinatetransformer.cpp

@@ -0,0 +1,102 @@
+/***************************************************************************
+ qgsquickcoordinatetransformer.cpp
+  --------------------------------------
+  Date                 : 1.6.2017
+  Copyright            : (C) 2017 by Matthias Kuhn
+  Email                :  matthias (at) opengis.ch
+ ***************************************************************************
+ *                                                                         *
+ *   This program is free software; you can redistribute it and/or modify  *
+ *   it under the terms of the GNU General Public License as published by  *
+ *   the Free Software Foundation; either version 2 of the License, or     *
+ *   (at your option) any later version.                                   *
+ *                                                                         *
+ ***************************************************************************/
+
+#include <QtDebug>
+
+#include "qgsquickcoordinatetransformer.h"
+
+QgsQuickCoordinateTransformer::QgsQuickCoordinateTransformer( QObject *parent )
+  : QObject( parent )
+{
+  mCoordinateTransform.setSourceCrs( QgsCoordinateReferenceSystem::fromEpsgId( 4326 ) );
+  mCoordinateTransform.setContext( QgsCoordinateTransformContext() );
+}
+
+QgsPoint QgsQuickCoordinateTransformer::projectedPosition() const
+{
+  return mProjectedPosition;
+}
+
+QgsPoint QgsQuickCoordinateTransformer::sourcePosition() const
+{
+  return mSourcePosition;
+}
+
+void QgsQuickCoordinateTransformer::setSourcePosition( QgsPoint sourcePosition )
+{
+  if ( mSourcePosition == sourcePosition )
+    return;
+
+  mSourcePosition = sourcePosition;
+
+  emit sourcePositionChanged();
+  updatePosition();
+}
+
+QgsCoordinateReferenceSystem QgsQuickCoordinateTransformer::destinationCrs() const
+{
+  return mCoordinateTransform.destinationCrs();
+}
+
+void QgsQuickCoordinateTransformer::setDestinationCrs( const QgsCoordinateReferenceSystem &destinationCrs )
+{
+  if ( destinationCrs == mCoordinateTransform.destinationCrs() )
+    return;
+
+  mCoordinateTransform.setDestinationCrs( destinationCrs );
+  emit destinationCrsChanged();
+  updatePosition();
+}
+
+QgsCoordinateReferenceSystem QgsQuickCoordinateTransformer::sourceCrs() const
+{
+  return mCoordinateTransform.sourceCrs();
+}
+
+void QgsQuickCoordinateTransformer::setSourceCrs( const QgsCoordinateReferenceSystem &sourceCrs )
+{
+  if ( sourceCrs == mCoordinateTransform.sourceCrs() )
+    return;
+
+  mCoordinateTransform.setSourceCrs( sourceCrs );
+
+  emit sourceCrsChanged();
+  updatePosition();
+}
+
+void QgsQuickCoordinateTransformer::updatePosition()
+{
+  double x = mSourcePosition.x();
+  double y = mSourcePosition.y();
+  double z = mSourcePosition.z();
+
+  // If Z is NaN, coordinate transformation (proj4) will
+  // also set X and Y to NaN. But we also want to get projected
+  // coords if we do not have any Z coordinate.
+  if ( qIsNaN( z ) )
+  {
+    z = 0;
+  }
+
+  if ( mMapSettings )
+    mCoordinateTransform.setContext( mMapSettings->transformContext() );
+
+  mCoordinateTransform.transformInPlace( x, y, z );
+
+  mProjectedPosition = QgsPoint( x, y );
+  mProjectedPosition.addZValue( mSourcePosition.z() );
+
+  emit projectedPositionChanged();
+}