first commit of QtLocation

1 files changed, 321 insertions, 0 deletions

diff --git a/src/location/maps/qgeomaneuver.cpp b/src/location/maps/qgeomaneuver.cpp
new file mode 100644
index 00000000..92a2ac26
--- /dev/null
+++ b/src/location/maps/qgeomaneuver.cpp
@@ -0,0 +1,321 @@
+/****************************************************************************
+**
+** Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies).
+** All rights reserved.
+** Contact: Nokia Corporation (qt-info@nokia.com)
+**
+** This file is part of the Qt Mobility Components.
+**
+** $QT_BEGIN_LICENSE:LGPL$
+** No Commercial Usage
+** This file contains pre-release code and may not be distributed.
+** You may use this file in accordance with the terms and conditions
+** contained in the Technology Preview License Agreement accompanying
+** this package.
+**
+** GNU Lesser General Public License Usage
+** Alternatively, this file may be used under the terms of the GNU Lesser
+** General Public License version 2.1 as published by the Free Software
+** Foundation and appearing in the file LICENSE.LGPL included in the
+** packaging of this file.  Please review the following information to
+** ensure the GNU Lesser General Public License version 2.1 requirements
+** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
+**
+** In addition, as a special exception, Nokia gives you certain additional
+** rights.  These rights are described in the Nokia Qt LGPL Exception
+** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
+**
+** If you have questions regarding the use of this file, please contact
+** Nokia at qt-info@nokia.com.
+**
+**
+**
+**
+**
+**
+**
+**
+** $QT_END_LICENSE$
+**
+****************************************************************************/
+
+#include "qgeomaneuver.h"
+#include "qgeomaneuver_p.h"
+
+#include "qgeocoordinate.h"
+
+QTM_BEGIN_NAMESPACE
+
+/*!
+    \class QGeoManeuver
+    \brief The QGeoManeuver class represents the information relevant to the
+    point at which two QGeoRouteSegments meet.
+
+    \inmodule QtLocation
+    \since 1.1
+
+    \ingroup maps-routing
+
+    QGeoRouteSegment instances can be thought of as edges on a routing
+    graph, with QGeoManeuver instances as optional labels attached to the
+    vertices of the graph.
+
+    The most interesting information help in a QGeoManeuver instance is
+    normally the textual navigation to provide and the position at which to
+    provide it, accessible by instructionText() and position() respectively.
+
+    It is also possible to determine if a routing waypoint has been passed by
+    checking if waypoint() returns a valid QGeoCoordinate.
+*/
+
+/*!
+\enum QGeoManeuver::InstructionDirection
+
+Describes the change in direction associated with the instruction text
+that is associated with a QGeoManaeuver.
+
+\value NoDirection
+There is no direction associated with the instruction text.
+
+\value DirectionForward
+The instruction indicates that the direction of travel does not need to change.
+
+\value DirectionBearRight
+The instruction indicates that the direction of travel should bear to the right.
+
+\value DirectionLightRight
+The instruction indicates that a light turn to the right is required.
+
+\value DirectionRight
+The instruction indicates that a turn to the right is required.
+
+\value DirectionHardRight
+The instruction indicates that a hard turn to the right is required.
+
+\value DirectionUTurnRight
+The instruction indicates that a u-turn to the right is required.
+
+\value DirectionUTurnLeft
+The instruction indicates that a u-turn to the left is required.
+
+\value DirectionHardLeft
+The instruction indicates that a hard turn to the left is required.
+
+\value DirectionLeft
+The instruction indicates that a turn to the left is required.
+
+\value DirectionLightLeft
+The instruction indicates that a light turn to the left is required.
+
+\value DirectionBearLeft
+The instruction indicates that the direction of travel should bear to the left.
+
+*/
+
+/*!
+    Constructs a invalid maneuver object.
+
+    The maneuver will remain invalid until one of
+    setPosition(), setInstructionText(), setDirection(),
+    setTimeToNextInstruction(), setDistanceToNextInstruction() or
+    setWaypoint() is called.
+*/
+QGeoManeuver::QGeoManeuver()
+    : d_ptr(new QGeoManeuverPrivate()) {}
+
+/*!
+    Constructs a maneuver object from the contents of \a other.
+*/
+QGeoManeuver::QGeoManeuver(const QGeoManeuver &other)
+    : d_ptr(other.d_ptr) {}
+
+/*!
+    Destroys this manevuer object.
+*/
+QGeoManeuver::~QGeoManeuver() {}
+
+/*!
+    Assigns \a other to this maneuver object and then returns
+    a reference to this maneuver object.
+*/
+QGeoManeuver& QGeoManeuver::operator= (const QGeoManeuver & other)
+{
+    d_ptr = other.d_ptr;
+    return *this;
+}
+
+/*!
+    Returns whether this maneuver is equal to \a other.
+*/
+bool QGeoManeuver::operator== (const QGeoManeuver &other) const
+{
+    return (*(d_ptr.constData()) == *(other.d_ptr.constData()));
+}
+
+/*!
+    Returns whether this maneuver is not equal to \a other.
+*/
+bool QGeoManeuver::operator!= (const QGeoManeuver &other) const
+{
+    return !(operator==(other));
+}
+
+/*!
+    Returns whether this maneuver is valid or not.
+
+    Invalid maneuvers are used when there is no information
+    that needs to be attached to the endpoint of a QGeoRouteSegment instance.
+*/
+bool QGeoManeuver::isValid() const
+{
+    return d_ptr->valid;
+}
+
+/*!
+    Sets the position where instructionText() should be displayed to \a
+    position.
+*/
+void QGeoManeuver::setPosition(const QGeoCoordinate &position)
+{
+    d_ptr->valid = true;
+    d_ptr->position = position;
+}
+
+/*!
+    Returns the position where instructionText() should be displayed.
+*/
+QGeoCoordinate QGeoManeuver::position() const
+{
+    return d_ptr->position;
+}
+
+/*!
+    Sets the textual navigation instructions to \a instructionText.
+*/
+void QGeoManeuver::setInstructionText(const QString &instructionText)
+{
+    d_ptr->valid = true;
+    d_ptr->text = instructionText;
+}
+
+/*!
+    Returns the textual navigation instructions.
+*/
+QString QGeoManeuver::instructionText() const
+{
+    return d_ptr->text;
+}
+
+/*!
+    Sets the direction associated with the associated instruction to \a
+    direction.
+*/
+void QGeoManeuver::setDirection(QGeoManeuver::InstructionDirection direction)
+{
+    d_ptr->valid = true;
+    d_ptr->direction = direction;
+}
+
+/*!
+    Returns the direction associated with the associated instruction.
+*/
+QGeoManeuver::InstructionDirection QGeoManeuver::direction() const
+{
+    return d_ptr->direction;
+}
+
+/*!
+    Sets the estimated time it will take to travel from the point at which the
+    associated instruction was issued and the point that the next instruction
+    should be issued, in seconds, to \a secs.
+*/
+void QGeoManeuver::setTimeToNextInstruction(int secs)
+{
+    d_ptr->valid = true;
+    d_ptr->timeToNextInstruction = secs;
+}
+
+/*!
+    Returns the estimated time it will take to travel from the point at which
+    the associated instruction was issued and the point that the next
+    instruction should be issued, in seconds.
+*/
+int QGeoManeuver::timeToNextInstruction() const
+{
+    return d_ptr->timeToNextInstruction;
+}
+
+/*!
+    Sets the distance, in metres, between the point at which the associated
+    instruction was issued and the point that the next instruction should be
+    issued to \a distance.
+*/
+void QGeoManeuver::setDistanceToNextInstruction(qreal distance)
+{
+    d_ptr->valid = true;
+    d_ptr->distanceToNextInstruction = distance;
+}
+
+/*!
+    Returns the distance, in metres, between the point at which the associated
+    instruction was issued and the point that the next instruction should be
+    issued.
+*/
+qreal QGeoManeuver::distanceToNextInstruction() const
+{
+    return d_ptr->distanceToNextInstruction;
+}
+
+/*!
+    Sets the waypoint associated with this maneuver to \a coordinate.
+*/
+void QGeoManeuver::setWaypoint(const QGeoCoordinate &coordinate)
+{
+    d_ptr->valid = true;
+    d_ptr->waypoint = coordinate;
+}
+
+/*!
+    Returns the waypoint associated with this maneuver.
+
+    If there is not waypoint associated with this maneuver an invalid
+    QGeoCoordinate will be returned.
+*/
+QGeoCoordinate QGeoManeuver::waypoint() const
+{
+    return d_ptr->waypoint;
+}
+
+/*******************************************************************************
+*******************************************************************************/
+
+QGeoManeuverPrivate::QGeoManeuverPrivate()
+    : valid(false),
+      direction(QGeoManeuver::NoDirection),
+      timeToNextInstruction(0),
+      distanceToNextInstruction(0.0) {}
+
+QGeoManeuverPrivate::QGeoManeuverPrivate(const QGeoManeuverPrivate &other)
+    : QSharedData(other),
+      valid(other.valid),
+      position(other.position),
+      text(other.text),
+      direction(other.direction),
+      timeToNextInstruction(other.timeToNextInstruction),
+      distanceToNextInstruction(other.distanceToNextInstruction),
+      waypoint(other.waypoint) {}
+
+QGeoManeuverPrivate::~QGeoManeuverPrivate() {}
+
+bool QGeoManeuverPrivate::operator ==(const QGeoManeuverPrivate &other) const
+{
+    return ((valid == other.valid)
+            && (position == other.position)
+            && (text == other.text)
+            && (direction == other.direction)
+            && (timeToNextInstruction == other.timeToNextInstruction)
+            && (distanceToNextInstruction == other.distanceToNextInstruction)
+            && (waypoint == other.waypoint));
+}
+
+QTM_END_NAMESPACE