RoutingModel.h

// SPDX-License-Identifier: LGPL-2.1-or-later
//
// SPDX-FileCopyrightText: 2010 Dennis Nienhüser <nienhueser@kde.org>
//
 
#ifndef MARBLE_ROUTINGMODEL_H
#define MARBLE_ROUTINGMODEL_H
 
#include "marble_export.h"
 
#include <QAbstractListModel>
 
class QIODevice;
 
/**
  * A QAbstractItemModel that contains a list of routing instructions.
  * Each item represents a routing step in the way from source to
  * destination. Steps near the source come first, steps near the target
  * last.
  */
namespace Marble
{
 
class RoutingModelPrivate;
class Route;
class RouteRequest;
class GeoDataCoordinates;
class PositionTracking;
 
class MARBLE_EXPORT RoutingModel : public QAbstractListModel
{
    Q_OBJECT
 
    Q_PROPERTY( bool deviatedFromRoute READ deviatedFromRoute NOTIFY deviatedFromRoute )
 
public:
    enum RoutingModelRoles {
        CoordinateRole = Qt::UserRole + 3,
        TurnTypeIconRole,
        LongitudeRole,
        LatitudeRole
    };
 
    /** Constructor */
    explicit RoutingModel(RouteRequest *request, PositionTracking *positionTracking, QObject *parent = nullptr);
 
    /** Destructor */
    ~RoutingModel() override;
 
    // Model querying
 
    /** Overload of QAbstractListModel */
    int rowCount ( const QModelIndex &parent = QModelIndex() ) const override;
 
    /** Overload of QAbstractListModel */
    QVariant headerData ( int section, Qt::Orientation orientation, int role = Qt::DisplayRole ) const override;
 
    /** Overload of QAbstractListModel */
    QVariant data ( const QModelIndex &index, int role = Qt::DisplayRole ) const override;
 
    /** Overload of QAbstractListModel */
    QHash<int, QByteArray> roleNames() const override;
 
    // Model data filling
 
    /**
      * Export waypoints and instructions in gpx format
      */
    void exportGpx( QIODevice *device ) const;
 
    /**
      * Clear any data held in the model
      */
    void clear();
 
    /**
      * Maps points from the provided route request to waypoints in the model
      * according to their global minimal distance. Returns the right neighbor
      * (next route request item along the waypoints) of the provided position.
      * Provided route must not be null.
      * @return -1 If the provided route is empty, the index of the right
      * neighbor along the waypoints otherwise (result is a valid RouteRequest
      * index in that case)
      */
    int rightNeighbor( const GeoDataCoordinates &position, RouteRequest const *const route ) const;
 
    /**
     * returns whether the gps location is on route
     */
    bool deviatedFromRoute() const;
 
    const Route & route() const;
 
public Q_SLOTS:
    /**
      * Old data in the model is discarded and a model reset is done
      */
    void setRoute( const Route &route );
 
    void updatePosition( const GeoDataCoordinates&, qreal );
 
Q_SIGNALS:
   /**
    * emits a signal regarding information about total time( seconds ) and distance( metres ) remaining to reach destination
    */
    void positionChanged();
    void deviatedFromRoute( bool deviated );
 
    /** A different route was loaded */
    void currentRouteChanged();
 
private:
    RoutingModelPrivate *const d;
};
 
} // namespace Marble
 
#endif