GeoGraphicsItem.h

// SPDX-License-Identifier: LGPL-2.1-or-later
//
// SPDX-FileCopyrightText: 2009 Bastian Holst <bastianholst@gmx.de>
// SPDX-FileCopyrightText: 2009 Andrew Manson <g.real.ate@gmail.com>
//
 
#ifndef MARBLE_GEOGRAPHICSITEM_H
#define MARBLE_GEOGRAPHICSITEM_H
 
// Marble
#include "GeoDataStyle.h"
#include "marble_export.h"
 
class QString;
 
namespace Marble
{
 
class GeoDataFeature;
class GeoDataLatLonAltBox;
class GeoDataCoordinates;
class GeoGraphicsItemPrivate;
class GeoPainter;
class StyleBuilder;
class ViewportParams;
class GeoDataRelation;
 
class RenderContext
{
public:
    bool operator==(const RenderContext &other) const;
    bool operator!=(const RenderContext &other) const;
 
    explicit RenderContext(int tileLevel = -1);
    int tileLevel() const;
 
private:
    int m_tileLevel;
};
 
class MARBLE_EXPORT GeoGraphicsItem
{
public:
    explicit GeoGraphicsItem(const GeoDataFeature *feature);
    virtual ~GeoGraphicsItem();
 
    enum GeoGraphicsItemFlag {
        NoOptions = 0x0,
        ItemIsMovable = 0x1,
        ItemIsSelectable = 0x2,
        ItemIsVisible = 0x4
    };
 
    Q_DECLARE_FLAGS(GeoGraphicsItemFlags, GeoGraphicsItemFlag)
 
    bool visible() const;
 
    void setVisible(bool visible);
 
    /**
     * Get the GeoGraphicItemFlags value that describes which flags are set on
     * this item. @see QFlags
     */
    GeoGraphicsItemFlags flags() const;
 
    /**
     * Set or unset a single flag
     * @param flag the flag
     * @param enabled sets if the flag is to be set or unset
     */
    void setFlag(GeoGraphicsItemFlag flag, bool enabled = true);
 
    /**
     * Replace all of the current flags.
     * @param flags is the new value for this item's flags.
     */
    void setFlags(GeoGraphicsItemFlags flags);
 
    /**
     * Returns the minim zoom level on which item will be active.
     */
    int minZoomLevel() const;
 
    /**
     * Sets the minimum zoom level
     */
    void setMinZoomLevel(int zoomLevel);
 
    /**
     * Returns the placemark for that item.
     */
    const GeoDataFeature *feature() const;
 
    /**
     * Returns the bounding box covered by the item.
     */
    virtual const GeoDataLatLonAltBox &latLonAltBox() const = 0;
 
    /**
     * Returns the style of item.
     */
    GeoDataStyle::ConstPtr style() const;
 
    /**
     * Set the style for the item.
     */
    void setStyleBuilder(const StyleBuilder *styleBuilder);
 
    void resetStyle();
 
    /**
     * Set the style which will be used when
     * placemark is highlighted.
     * GeoGraphicsItem takes ownership of the
     * passed style and deletes it when appropriate.
     */
    void setHighlightStyle(const GeoDataStyle::ConstPtr &highlightStyle);
 
    /**
     * Returns the z value of the item
     */
    qreal zValue() const;
 
    /**
     * Set the z value of the item
     */
    void setZValue(qreal z);
 
    static bool zValueLessThan(GeoGraphicsItem *one, GeoGraphicsItem *two);
    static bool styleLessThan(GeoGraphicsItem *one, GeoGraphicsItem *two);
    static bool zValueAndStyleLessThan(GeoGraphicsItem *one, GeoGraphicsItem *two);
 
    /**
     * Paints the item using the given GeoPainter.
     *
     * Note that depending on the projection and zoom level, the item may be visible more than once,
     * which is taken care of by GeoPainter.
     */
    virtual void paint(GeoPainter *painter, const ViewportParams *viewport, const QString &layer, int tileZoomLevel) = 0;
 
    void setHighlighted(bool highlight);
 
    bool isHighlighted() const;
 
    QStringList paintLayers() const;
 
    void setPaintLayers(const QStringList &paintLayers);
 
    void setRenderContext(const RenderContext &renderContext);
 
    /**
     * @brief contains Returns true if the item contains the given coordinates
     * @param screenPosition
     * @param viewport
     * @return
     */
    virtual bool contains(const QPoint &screenPosition, const ViewportParams *viewport) const;
 
    void setRelations(const QSet<const GeoDataRelation *> &relations);
 
protected:
    virtual void handleRelationUpdate(const QList<const GeoDataRelation *> &relations);
 
    GeoGraphicsItemPrivate *const d;
};
 
} // Namespace Marble
Q_DECLARE_OPERATORS_FOR_FLAGS(Marble::GeoGraphicsItem::GeoGraphicsItemFlags)
 
#endif