wmslayer.h

Go to the documentation of this file.

 
#ifndef WMSLAYER_H
#define WMSLAYER_H
 
#include "layers/openswmmvislayer.h"
#include "render/basemaprenderparams.h"
 
#include <QImage>
#include <QList>
#include <QMap>
#include <QNetworkAccessManager>
#include <QNetworkReply>
#include <QString>
#include <QUrl>
 
class SpatialReferenceSystem;
class OpenSWMMVisWorkspace;
class RasterTileItem;
 
struct WMSLayerInfo
{
    QString              name;          
    QString              title;         
    QString              abstractText;  
    QStringList          crsIdentifiers; 
    QStringList          styles;        
    MapExtent            geographicBoundingBox; 
    bool                 queryable = false;
};
 
struct WMSServiceInfo
{
    QString              title;
    QString              abstractText;
    QString              version;       
    QStringList          imageFormats;  
    QList<WMSLayerInfo>  layers;
};
 
class WMSLayer : public OpenSWMMVisLayer
{
    Q_OBJECT
 
    Q_PROPERTY(QUrl     serviceUrl      READ serviceUrl     CONSTANT)
    Q_PROPERTY(QString  wmsVersion      READ wmsVersion     NOTIFY wmsVersionChanged)
    Q_PROPERTY(QString  activeLayerName READ activeLayerName WRITE setActiveLayerName
               NOTIFY activeLayerNameChanged)
    Q_PROPERTY(QString  activeStyle     READ activeStyle    WRITE setActiveStyle
               NOTIFY activeStyleChanged)
    Q_PROPERTY(QString  imageFormat     READ imageFormat    WRITE setImageFormat
               NOTIFY imageFormatChanged)
    Q_PROPERTY(bool     transparent     READ isTransparent  WRITE setTransparent
               NOTIFY transparentChanged)
 
public:
 
    explicit WMSLayer(const QUrl &serviceUrl,
                      OpenSWMMVisWorkspace *parent = nullptr);
 
    ~WMSLayer() override;
 
    // ----- Service metadata -----------------------------------------------
 
    [[nodiscard]] QUrl             serviceUrl()      const;
    [[nodiscard]] QString          wmsVersion()      const;
    [[nodiscard]] WMSServiceInfo   serviceInfo()     const;
    [[nodiscard]] bool             capabilitiesReady() const;
 
    [[nodiscard]] QString sourceDescription() const override
    { return serviceUrl().toString(); }
 
    void fetchCapabilities();
 
    void setServiceInfo(const WMSServiceInfo &info);
 
    // ----- Active layer / style -------------------------------------------
 
    [[nodiscard]] QString activeLayerName() const;
    void setActiveLayerName(const QString &layerName);
 
    [[nodiscard]] QString activeStyle()     const;
    void setActiveStyle(const QString &style);
 
    // ----- Request parameters ---------------------------------------------
 
    [[nodiscard]] QString imageFormat()     const;
    void setImageFormat(const QString &fmt);  
    [[nodiscard]] QString crs()             const;
    void setCrs(const QString &crs);           
    [[nodiscard]] int     dpiMode()         const;
    void setDpiMode(int mode);                 
    [[nodiscard]] QString capabilitiesUrl() const { return m_serviceUrl.toString(); }
 
    [[nodiscard]] bool    isTransparent()   const;
    void setTransparent(bool transparent);
 
    [[nodiscard]] QMap<QString, QString> extraParams() const;
    void setExtraParams(const QMap<QString, QString> &params);
 
    // ----- OpenSWMMVisLayer interface -----------------------------------------
 
    [[nodiscard]] bool isRasterLayer() const override { return true; }
 
    void fetchCache(const MapExtent &extent,
                    const QSize &viewportSize,
                    const SpatialReferenceSystem *srs) override;
 
    void render(QPainter *painter,
                const MapExtent &extent,
                const QSize &imageSize,
                const SpatialReferenceSystem *srs) override;
 
    void populateScene(QGraphicsScene *scene,
                       const MapExtent &canvasExtent,
                       const SpatialReferenceSystem *canvasSRS) override;
 
    void depopulateScene(QGraphicsScene *scene) override;
 
    void refreshScene(QGraphicsScene *scene,
                      const MapExtent &canvasExtent,
                      const SpatialReferenceSystem *canvasSRS) override;
 
    void onCanvasCRSChanged(const SpatialReferenceSystem *newCanvasSRS) override;
 
    [[nodiscard]] const OpenSWMM::Render::BasemapRenderParams &basemapRenderParams() const { return m_renderParams; }
    void setBasemapRenderParams(const OpenSWMM::Render::BasemapRenderParams &p);
 
signals:
    void capabilitiesFetched(const WMSServiceInfo &info);
 
    void capabilitiesError(const QString &errorMessage);
 
    void tileReady();
 
    void wmsVersionChanged(const QString &version);
    void activeLayerNameChanged(const QString &name);
    void activeStyleChanged(const QString &style);
    void imageFormatChanged(const QString &fmt);
    void transparentChanged(bool transparent);
 
    void basemapRenderParamsChanged();
 
private slots:
    void onCapabilitiesReply(QNetworkReply *reply);
    void onGetMapReply(QNetworkReply *reply);
 
private:
    [[nodiscard]] QUrl buildGetMapUrl(const MapExtent &ext,
                                      const SpatialReferenceSystem *srs,
                                      int w, int h) const;
 
    void parseCapabilities(const QByteArray &xml);
    void requestTile(const MapExtent &trackingExt,
                     const MapExtent &requestExt,
                     const SpatialReferenceSystem *requestSrs,
                     int w, int h);
    void invalidateCache();
    void applyExtentFromActiveLayer();
 
    QUrl                    m_serviceUrl;
    QString                 m_wmsVersion  = "1.3.0";
    QString                 m_activeLayer;
    QString                 m_activeStyle;
    QString                 m_imageFormat = "image/png";
    QString                 m_crs         = "EPSG:3857"; 
    int                     m_dpiMode     = 7;            
    bool                    m_transparent = true;
    QMap<QString, QString>  m_extraParams;
    WMSServiceInfo          m_serviceInfo;
    bool                    m_capsReady   = false;
 
    QNetworkAccessManager  *m_nam         = nullptr;  
    QNetworkReply          *m_pendingReply = nullptr; 
    // Tile cache — extent/size describe the image already in m_cachedTile
    QImage                  m_cachedTile;
    OpenSWMM::Render::BasemapRenderParams m_renderParams;  
    MapExtent               m_cacheExtent;
    int                     m_cacheWidth  = 0;
    int                     m_cacheHeight = 0;
 
    // In-flight request metadata — NOT committed to m_cache* until the reply arrives
    MapExtent               m_requestedExtent;
    int                     m_requestedWidth  = 0;
    int                     m_requestedHeight = 0;
 
    // Persistent scene item (kept visible as placeholder until new tile arrives)
    RasterTileItem         *m_sceneItem   = nullptr;
};
 
Q_DECLARE_METATYPE(WMSLayer *)
Q_DECLARE_METATYPE(WMSServiceInfo)
Q_DECLARE_METATYPE(WMSLayerInfo)
 
#endif // WMSLAYER_H