File indexing completed on 2024-05-05 03:49:47

 // 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 "marble_export.h"
 #include "GeoDataStyle.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 QVector<const GeoDataRelation *> &relations);
 
     GeoGraphicsItemPrivate *const d;
 };
 
 } // Namespace Marble
 Q_DECLARE_OPERATORS_FOR_FLAGS(Marble::GeoGraphicsItem::GeoGraphicsItemFlags)
 
 #endif