wcslayer.h

Go to the documentation of this file.

 
#ifndef WCSLAYER_H
#define WCSLAYER_H
 
#include "layers/openswmmvislayer.h"
#include "render/basemaprenderparams.h"
 
#include <QImage>
#include <QList>
#include <QMap>
#include <QMutex>
#include <QNetworkAccessManager>
#include <QNetworkReply>
#include <QString>
#include <QUrl>
 
class SpatialReferenceSystem;
class OpenSWMMVisWorkspace;
class RasterTileItem;
class OGRSpatialReference;
class OGRCoordinateTransformation;
 
// ---------------------------------------------------------------------------
// Service-info structs
// ---------------------------------------------------------------------------
 
struct WCSFieldInfo
{
    QString identifier;   
    QString description;
};
 
struct WCSCoverageInfo
{
    QString              identifier;       
    QString              title;
    QString              abstractText;
    MapExtent            wgs84BoundingBox; 
    QStringList          supportedCrs;     
    QStringList          supportedFormats; 
    QList<WCSFieldInfo>  fields;           
    QStringList          interpolations;   
};
 
struct WCSServiceInfo
{
    QString                  title;
    QString                  abstractText;
    QString                  version;      
    QList<WCSCoverageInfo>   coverages;
};
 
// ---------------------------------------------------------------------------
// WCSLayer
// ---------------------------------------------------------------------------
 
class WCSLayer : public OpenSWMMVisLayer
{
    Q_OBJECT
 
public:
    explicit WCSLayer(const QUrl &serviceUrl,
                      OpenSWMMVisWorkspace *parent = nullptr);
    ~WCSLayer() override;
 
    // ----- Service metadata --------------------------------------------------
 
    [[nodiscard]] QUrl           serviceUrl()    const { return m_serviceUrl; }
    [[nodiscard]] QString        wcsVersion()    const { return m_version; }
    [[nodiscard]] WCSServiceInfo serviceInfo()   const { return m_serviceInfo; }
    [[nodiscard]] bool           capabilitiesReady() const { return m_capsReady; }
 
    [[nodiscard]] QString sourceDescription() const override
    { return m_serviceUrl.toString(); }
 
    void fetchCapabilities();
 
    void setServiceInfo(const WCSServiceInfo &info);
 
    // ----- Active coverage / request parameters ------------------------------
 
    [[nodiscard]] QString activeCoverageId() const { return m_coverageId; }
    void setActiveCoverageId(const QString &id);
 
    [[nodiscard]] QString outputCrs()    const { return m_outputCrs; }
    void setOutputCrs(const QString &crs);
 
    [[nodiscard]] QString outputFormat() const { return m_outputFormat; }
    void setOutputFormat(const QString &fmt);
 
    [[nodiscard]] QString rangeSubset()  const { return m_rangeSubset; }
    void setRangeSubset(const QString &subset);
 
    [[nodiscard]] QString interpolation() const { return m_interpolation; }
    void setInterpolation(const QString &interp);
 
    // ----- OpenSWMMVisLayer interface ----------------------------------------
 
    [[nodiscard]] bool isRasterLayer()  const override { return true; }
    [[nodiscard]] bool isBasemapLayer() const override { return false; }
 
    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 *,
                       const MapExtent &,
                       const SpatialReferenceSystem *) override {}
 
    void depopulateScene(QGraphicsScene *scene) override;
 
    void refreshScene(QGraphicsScene *scene,
                      const MapExtent &canvasExtent,
                      const SpatialReferenceSystem *canvasSRS) override;
 
    void onCanvasCRSChanged(const SpatialReferenceSystem *newCanvasSRS) override;
 
signals:
    void capabilitiesFetched(const WCSServiceInfo &info);
    void capabilitiesError(const QString &errorMessage);
    void coverageReady();
 
    void basemapRenderParamsChanged();
 
public:
    [[nodiscard]] const OpenSWMM::Render::BasemapRenderParams &basemapRenderParams() const { return m_renderParams; }
    void setBasemapRenderParams(const OpenSWMM::Render::BasemapRenderParams &p);
 
private slots:
    void onCapabilitiesReply(QNetworkReply *reply);
    void onGetCoverageReply(QNetworkReply *reply,
                            const MapExtent &trackingExtent,
                            const MapExtent &requestExtent,
                            const QString   &requestCrs,
                            const QString   &usedVersion,
                            int w, int h);
 
private:
    // --- Network / URL helpers ---
    [[nodiscard]] QUrl buildGetCoverageUrl(const MapExtent &requestExtent,
                                           const QString   &requestCrs,
                                           int w, int h,
                                           const QString   &versionOverride = {}) const;
    void requestCoverage(const MapExtent &trackingExtent,
                         const MapExtent &requestExtent,
                         const QString   &requestCrs,
                         int w, int h);
    void invalidateCache();
 
    // --- Capabilities parsing ---
    WCSServiceInfo   parseCapabilities(const QByteArray &xml) const;
    WCSCoverageInfo  parseCoverageSummary(class QXmlStreamReader &r,
                                          const QString &version) const;
    QString          negotiateNextVersion(const QString &failedVersion) const;
    QString          nextGetCoverageVersion(const QString &failedVersion) const;
 
    // --- GDAL decode ---
    QImage decodeGdalImage(const QByteArray &data) const;
 
    // --- OGR transforms (canvas ↔ request CRS) ---
    void rebuildTransforms(const SpatialReferenceSystem *canvasSRS);
 
    // ----- Members -----------------------------------------------------------
 
    QUrl                         m_serviceUrl;
    QString                      m_version      = QStringLiteral("2.0.1");
    WCSServiceInfo               m_serviceInfo;
    bool                         m_capsReady    = false;
 
    QString                      m_coverageId;
    QString                      m_outputCrs;   // empty = use canvas CRS (like WMS)
    QString                      m_outputFormat = QStringLiteral("image/tiff");
    QString                      m_rangeSubset;
    QString                      m_interpolation = QStringLiteral("nearest");
 
    QNetworkAccessManager       *m_nam          = nullptr;
    QNetworkReply               *m_pendingReply = nullptr;
 
    // Separately tracks the GetCoverage wire format version, which may be
    // downgraded independently of the capabilities version when the server
    // returns 404 for a given format (e.g. ArcGIS rejects SCALESIZE in 2.0).
    QString                      m_getCoverageVersion;   // "" = use m_version
 
    // Cached coverage (WMS-style: one image per viewport)
    QImage                       m_cachedImage;
    OpenSWMM::Render::BasemapRenderParams m_renderParams;  
    MapExtent                    m_cacheExtent;
    int                          m_cacheWidth   = 0;
    int                          m_cacheHeight  = 0;
 
    // In-flight request guard
    MapExtent                    m_requestedExtent;
    int                          m_requestedWidth  = 0;
    int                          m_requestedHeight = 0;
 
    // Scene item (placeholder while new coverage loads)
    RasterTileItem              *m_sceneItem    = nullptr;
 
    // OGR transforms
    OGRSpatialReference         *m_wgs84        = nullptr;
    OGRCoordinateTransformation *m_canvasToReq  = nullptr;
    OGRCoordinateTransformation *m_reqToCanvas  = nullptr;
    mutable QMutex               m_transformMutex;
};
 
Q_DECLARE_METATYPE(WCSLayer *)
Q_DECLARE_METATYPE(WCSServiceInfo)
Q_DECLARE_METATYPE(WCSCoverageInfo)
 
#endif // WCSLAYER_H