maptool.h

Go to the documentation of this file.

 
#ifndef MAPTOOL_H
#define MAPTOOL_H
 
#include <QObject>
#include <QCursor>
#include <QString>
 
class QMouseEvent;
class QWheelEvent;
class QKeyEvent;
class QPainter;
class QGraphicsScene;
class MapCanvas;
class MapExtent;
class SpatialReferenceSystem;
 
class OpenSWMMVisMapTool : public QObject
{
    Q_OBJECT
    Q_PROPERTY(QString toolName READ toolName CONSTANT)
    Q_PROPERTY(QCursor cursor   READ cursor   NOTIFY cursorChanged)
    Q_PROPERTY(bool    active   READ isActive NOTIFY activeChanged)
 
public:
 
    explicit OpenSWMMVisMapTool(const QString &toolName,
                            MapCanvas *canvas,
                            QObject *parent = nullptr);
 
    virtual ~OpenSWMMVisMapTool() = default;
 
    // ----- Identity -------------------------------------------------------
 
    [[nodiscard]] QString toolName() const;
 
    [[nodiscard]] virtual QCursor cursor() const;
 
    [[nodiscard]] bool isActive() const;
 
    // ----- Canvas access --------------------------------------------------
 
    [[nodiscard]] MapCanvas *canvas() const;
 
    // ----- Lifecycle hooks ------------------------------------------------
 
    virtual void activate();
 
    virtual void deactivate();
 
    // ----- Event handlers (override in subclasses) ------------------------
 
    virtual void mousePressEvent(QMouseEvent *event);
    virtual void mouseMoveEvent(QMouseEvent *event);
    virtual void mouseReleaseEvent(QMouseEvent *event);
    virtual void mouseDoubleClickEvent(QMouseEvent *event);
    virtual void wheelEvent(QWheelEvent *event);
    virtual void keyPressEvent(QKeyEvent *event);
    virtual void keyReleaseEvent(QKeyEvent *event);
 
    // ----- Painting (via scene items) --------------------------------------
 
    virtual void paint(QPainter *painter,
                       const MapExtent &canvasExtent,
                       const SpatialReferenceSystem *canvasSRS);
 
    [[nodiscard]] QGraphicsScene *scene() const;
 
    // ----- Helpers provided to subclasses --------------------------------
 
    void toMapCoords(int px, int py, double &mapX, double &mapY) const;
 
    void toPixelCoords(double mapX, double mapY, int &px, int &py) const;
 
signals:
    void cursorChanged(const QCursor &cursor);
    void activeChanged(bool active);
 
    void repaintRequested();
 
protected:
    QString     m_toolName;
    MapCanvas  *m_canvas = nullptr;
 
private:
    bool        m_active = false;
 
    friend class MapCanvas;
    void setActive(bool active);
};
 
#endif // MAPTOOL_H