RouteRequest.h

// SPDX-License-Identifier: LGPL-2.1-or-later
//
// SPDX-FileCopyrightText: 2010 Dennis Nienhüser <nienhueser@kde.org>
//
 
#ifndef MARBLE_ROUTEREQUEST_H
#define MARBLE_ROUTEREQUEST_H
 
#include "RoutingProfile.h"
#include "marble_export.h"
 
#include <QObject>
 
namespace Marble
{
 
class GeoDataCoordinates;
class GeoDataPlacemark;
class RouteRequestPrivate;
 
/**
 * @brief Points to be included in a route. An ordered list of
 * GeoDataCoordinates with change notification and Pixmap access, similar
 * to QAbstractItemModel.
 */
class MARBLE_EXPORT RouteRequest : public QObject
{
    Q_OBJECT
 
public:
    /** Constructor */
    explicit RouteRequest(QObject *parent = nullptr);
 
    /** Destructor */
    ~RouteRequest() override;
 
    /** The first point, or a default constructed if empty */
    GeoDataCoordinates source() const;
 
    /** The last point, or a default constructed if empty */
    GeoDataCoordinates destination() const;
 
    /** Number of points in the route */
    int size() const;
 
    /** Accessor for the n-th position */
    GeoDataCoordinates at(int index) const;
 
    /** Add the given element to the end */
    void append(const GeoDataCoordinates &coordinates, const QString &name = QString());
 
    void append(const GeoDataPlacemark &placemark);
 
    /** Add the given element at the given position */
    void insert(int index, const GeoDataCoordinates &coordinates, const QString &name = QString());
 
    void insert(int index, const GeoDataPlacemark &placemark);
 
    /** Swaps the given elements at the given positions*/
    void swap(int index1, int index2);
 
    /** Change the value of the element at the given position */
    void setPosition(int index, const GeoDataCoordinates &position, const QString &name = QString());
 
    /** Remove the element at the given position */
    void remove(int index);
 
    /** Remove all elements */
    void clear();
 
    /**
     * Insert a via point. Order will be chosen such that the via point is not before
     * the start or after the destination. Furthermore the distance between neighboring
     * route points is minimized
     *
     * @note: This does not trigger an update of the route. It becomes "dirty"
     *
     * @todo: Minimizing the distance might not always be what the user wants
     */
    void addVia(const GeoDataCoordinates &position);
    void addVia(const GeoDataPlacemark &placemark);
 
    /** Returns a pixmap which indicates the position of the element */
    QPixmap pixmap(int index, int size = -1, int margin = 2) const;
 
    void setName(int index, const QString &name);
 
    QString name(int index) const;
 
    void setVisited(int index, bool visited);
 
    bool visited(int index) const;
 
    void reverse();
 
    void setRoutingProfile(const RoutingProfile &profile);
 
    RoutingProfile routingProfile() const;
 
    GeoDataPlacemark &operator[](int index);
 
    GeoDataPlacemark const &operator[](int index) const;
 
Q_SIGNALS:
    /** The value of the n-th element was changed */
    void positionChanged(int index, const GeoDataCoordinates &position);
 
    /** An element was added at the given position */
    void positionAdded(int index);
 
    /** The element at the given position was removed */
    void positionRemoved(int index);
 
    /** The routing profile was changed */
    void routingProfileChanged();
 
private:
    RouteRequestPrivate *const d;
};
 
} // namespace Marble
 
#endif