Provide new planespotter example

This diversifies the location examples as it adds a relatively small
example. Short of the places examples there is only one large
demo-like mapviewer example.

This new example demonstrates the following features:
- integration of C++ types into QML
- coordinate animations
- fitting viewport of maps

Change-Id: Id0b5b9669cfd1d98bb5dce7d7d42d220efd60142
Task-number: QTBUG-45415
Reviewed-by: Michal Klocek <michal.klocek@theqtcompany.com>
Reviewed-by: Alessandro Portale <alessandro.portale@theqtcompany.com>

1 files changed, 226 insertions, 0 deletions

diff --git a/examples/location/planespotter/planespotter.qml b/examples/location/planespotter/planespotter.qml
new file mode 100644
index 00000000..59b8b00b
--- /dev/null
+++ b/examples/location/planespotter/planespotter.qml
@@ -0,0 +1,226 @@
+/****************************************************************************
+**
+** Copyright (C) 2015 The Qt Company Ltd.
+** Contact: http://www.qt.io/licensing/
+**
+** This file is part of the examples of the Qt Toolkit.
+**
+** $QT_BEGIN_LICENSE:BSD$
+** You may use this file under the terms of the BSD license as follows:
+**
+** "Redistribution and use in source and binary forms, with or without
+** modification, are permitted provided that the following conditions are
+** met:
+**   * Redistributions of source code must retain the above copyright
+**     notice, this list of conditions and the following disclaimer.
+**   * Redistributions in binary form must reproduce the above copyright
+**     notice, this list of conditions and the following disclaimer in
+**     the documentation and/or other materials provided with the
+**     distribution.
+**   * Neither the name of The Qt Company Ltd nor the names of its
+**     contributors may be used to endorse or promote products derived
+**     from this software without specific prior written permission.
+**
+**
+** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE."
+**
+** $QT_END_LICENSE$
+**
+****************************************************************************/
+
+import QtQuick 2.4
+import QtQuick.Window 2.2
+import QtPositioning 5.5
+import QtLocation 5.5
+
+Window {
+    width: 700
+    height: 500
+    visible: true
+
+    property variant topLeftEurope: QtPositioning.coordinate(60.5, 0.0)
+    property variant bottomRightEurope: QtPositioning.coordinate(51.0, 14.0)
+    property variant viewOfEurope:
+            QtPositioning.rectangle(topLeftEurope, bottomRightEurope)
+
+    property variant berlin: QtPositioning.coordinate(52.5175, 13.384)
+    property variant oslo: QtPositioning.coordinate(59.9154, 10.7425)
+    property variant london: QtPositioning.coordinate(51.5, 0.1275)
+
+    Map {
+        id: mapOfEurope
+        anchors.centerIn: parent;
+        anchors.fill: parent
+        plugin: Plugin {
+            name: "osm"
+        }
+
+        Plane {
+            id: qmlPlane
+            pilotName: "QML"
+            coordinate: oslo2Berlin.position
+
+            SequentialAnimation {
+                id: qmlPlaneAnimation
+                property real rotationDirection : 0;
+                NumberAnimation {
+                    target: qmlPlane; property: "bearing"; duration: 1000
+                    easing.type: Easing.InOutQuad
+                    to: qmlPlaneAnimation.rotationDirection
+                }
+                //! [QmlPlane1]
+                CoordinateAnimation {
+                    id: coordinateAnimation; duration: 5000
+                    target: oslo2Berlin; property: "position"
+                    easing.type: Easing.InOutQuad
+                }
+                //! [QmlPlane1]
+
+                onStopped: {
+                    if (coordinateAnimation.to === berlin)
+                        qmlPlane.showMessage(qsTr("Hello Berlin!"))
+                    else if (coordinateAnimation.to === oslo)
+                        qmlPlane.showMessage(qsTr("Hello Oslo!"))
+                }
+                onStarted: {
+                    if (coordinateAnimation.from === oslo)
+                        qmlPlane.showMessage(qsTr("See you Oslo!"))
+                    else if (coordinateAnimation.from === berlin)
+                        qmlPlane.showMessage(qsTr("See you Berlin!"))
+                }
+            }
+
+            //! [QmlPlane2]
+            MouseArea {
+                anchors.fill: parent
+                onClicked: {
+                    if (qmlPlaneAnimation.running) {
+                        console.log("Plane still in the air.");
+                        return;
+                    }
+
+                    if (oslo2Berlin.position === berlin) {
+                        coordinateAnimation.from = berlin;
+                        coordinateAnimation.to = oslo;
+                    } else if (oslo2Berlin.position === oslo) {
+                        coordinateAnimation.from = oslo;
+                        coordinateAnimation.to = berlin;
+                    }
+
+                    qmlPlaneAnimation.rotationDirection = oslo2Berlin.position.azimuthTo(coordinateAnimation.to)
+                    qmlPlaneAnimation.start()
+                }
+            }
+            //! [QmlPlane2]
+            Component.onCompleted: {
+                oslo2Berlin.position = oslo;
+            }
+        }
+
+        //! [CppPlane1]
+        Plane {
+            id: cppPlane
+            pilotName: "C++"
+            coordinate: berlin2London.position
+
+            MouseArea {
+                anchors.fill: parent
+                onClicked: {
+                    if (cppPlaneAnimation.running || berlin2London.isFlying()) {
+                        console.log("Plane still in the air.");
+                        return;
+                    }
+
+                    berlin2London.swapDestinations();
+                    cppPlaneAnimation.rotationDirection = berlin2London.position.azimuthTo(berlin2London.to)
+                    cppPlaneAnimation.start();
+                    cppPlane.departed();
+                }
+            }
+        //! [CppPlane1]
+            //! [CppPlane3]
+            SequentialAnimation {
+                id: cppPlaneAnimation
+                property real rotationDirection : 0;
+                NumberAnimation {
+                    target: cppPlane; property: "bearing"; duration: 1000
+                    easing.type: Easing.InOutQuad
+                    to: cppPlaneAnimation.rotationDirection
+                }
+                ScriptAction { script: berlin2London.startFlight() }
+            }
+            //! [CppPlane3]
+
+            Component.onCompleted: {
+                berlin2London.position = berlin;
+                berlin2London.to = london;
+                berlin2London.from = berlin;
+                berlin2London.arrived.connect(arrived)
+            }
+
+            function arrived(){
+                if (berlin2London.to === berlin)
+                    cppPlane.showMessage(qsTr("Hello Berlin!"))
+                else if (berlin2London.to === london)
+                    cppPlane.showMessage(qsTr("Hello London!"))
+            }
+
+            function departed(){
+                if (berlin2London.from === berlin)
+                    cppPlane.showMessage(qsTr("See you Berlin!"))
+                else if (berlin2London.from === london)
+                    cppPlane.showMessage(qsTr("See you London!"))
+            }
+        //! [CppPlane2]
+        }
+        //! [CppPlane2]
+
+        onWidthChanged: {
+            if (width > 0)
+                mapOfEurope.fitViewportToGeoShape(viewOfEurope)
+        }
+
+        onHeightChanged: {
+            if (height > 0)
+                mapOfEurope.fitViewportToGeoShape(viewOfEurope)
+        }
+    }
+
+    Rectangle {
+        id: infoBox
+        anchors.centerIn: parent
+        color: "white"
+        border.width: 1
+        width: text.width * 1.3
+        height: text.height * 1.3
+        radius: 5
+        Text {
+            id: text
+            anchors.centerIn: parent
+            text: qsTr("Hit the plane to start the flight!")
+        }
+
+        Timer {
+            interval: 5000; running: true; repeat: false;
+            onTriggered: fadeOut.start()
+        }
+
+        NumberAnimation {
+            id: fadeOut; target: infoBox;
+            property: "opacity";
+            to: 0.0;
+            duration: 200
+            easing.type: Easing.InOutQuad
+        }
+    }
+}