/usr/include/marble/AlternativeRoutesModel.h is in libmarble-dev 4:4.13.0-0ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 | //
// This file is part of the Marble Virtual Globe.
//
// This program is free software licensed under the GNU LGPL. You can
// find a copy of this license in LICENSE.txt in the top directory of
// the source code.
//
// Copyright 2010      Dennis Nienhüser <earthwings@gentoo.org>
//
#ifndef MARBLE_ALTERNATIVEROUTESMODEL_H
#define MARBLE_ALTERNATIVEROUTESMODEL_H
#include "GeoDataLineString.h"
#include <QAbstractListModel>
/**
  * 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 AlternativeRoutesModelPrivate;
class RouteRequest;
class GeoDataDocument;
class MARBLE_EXPORT AlternativeRoutesModel : public QAbstractListModel
{
    Q_OBJECT
public:
    enum WritePolicy {
        Instant,
        Lazy
    };
    /** Constructor */
    explicit AlternativeRoutesModel( QObject *parent = 0 );
    /** Destructor */
    ~AlternativeRoutesModel();
    // Model querying
    /** Overload of QAbstractListModel */
    int rowCount ( const QModelIndex &parent = QModelIndex() ) const;
    /** Overload of QAbstractListModel */
    QVariant headerData ( int section, Qt::Orientation orientation, int role = Qt::DisplayRole ) const;
    /** Overload of QAbstractListModel */
    QVariant data ( const QModelIndex &index, int role = Qt::DisplayRole ) const;
    GeoDataDocument* route( int index );
    // Model data filling
    /** Invalidate the current alternative routes and prepare for new ones to arrive */
    void newRequest( RouteRequest *request );
    /**
      * Old data in the model is discarded, the parsed content of the provided document
      * is used as the new model data and a model reset is done
      * @param document The route to add
      * @param policy In lazy mode (default), a short amount of time is waited for
      *   other addRoute() calls before adding the route to the model. Otherwise, the
      *   model is changed immediately.
      */
    void addRoute( GeoDataDocument* document, WritePolicy policy = Lazy );
    /** Remove all alternative routes from the model */
    void clear();
    GeoDataDocument* currentRoute();
    /** Returns the waypoints contained in the route as a linestring */
    static const GeoDataLineString* waypoints( const GeoDataDocument* document );
    /** Returns the distance between the given point and the given great circle path */
    static qreal distance( const GeoDataCoordinates &satellite, const GeoDataCoordinates &lineA, const GeoDataCoordinates &lineB );
    /** Returns the minimal distance of each waypoint of routeA to routeB */
    static QVector<qreal> deviation( const GeoDataDocument* routeA, const GeoDataDocument* routeB );
public Q_SLOTS:
    void setCurrentRoute( int index );
Q_SIGNALS:
    void currentRouteChanged( GeoDataDocument* newRoute );
    void currentRouteChanged( int index );
private Q_SLOTS:
    void addRestrainedRoutes();
    void update( GeoDataDocument* route );
private:
    AlternativeRoutesModelPrivate *const d;
};
} // namespace Marble
#endif
 |