meshstagecache.h

Go to the documentation of this file.

 
#ifndef OPENSWMMVIS_MESH_MESHSTAGECACHE_H
#define OPENSWMMVIS_MESH_MESHSTAGECACHE_H
 
#include "mesh/dtmthinner.h"
 
#include <QByteArray>
#include <QLoggingCategory>
#include <QPointF>
#include <QPolygonF>
#include <QRectF>
#include <QString>
#include <QVector>
 
// Opt-in perf/diagnostic chatter for the mesh pipeline:
// QT_LOGGING_RULES="openswmm.mesh.perf.debug=true" (cache lines are qCInfo).
Q_DECLARE_LOGGING_CATEGORY(lcMeshPerf)
 
namespace mesh {
 
class MeshStageCache
{
public:
    explicit MeshStageCache(const QString &projectInpPath);
 
    [[nodiscard]] bool isUsable() const;
 
    struct FileIdentity
    {
        QString absPath;
        qint64  mtimeMs   = 0;
        qint64  sizeBytes = 0;
    };
 
    // ── Stage A payload: prepared PSLG boundary ──────────────────────
    struct BoundaryPrep
    {
        QVector<QPolygonF>        domains;     
        QVector<QVector<QPointF>> holeRings;   
        QVector<QPointF>          holeSeeds;   
        QVector<bool>             holeValid;   
        qint32                    skippedRings = 0;
    };
 
    // ── Stage B payload: terrain candidates (DTM CRS, pre-filter) ────
    struct TerrainPoints
    {
        QVector<QPointF> xyDtm;
        QVector<double>  z;
    };
 
    static QByteArray boundaryKey(const FileIdentity &src,
                                  const QByteArray   &subcatchHash,
                                  const QString      &layerName,
                                  const QString      &boundaryCRSWkt,
                                  const QString      &meshCRSWkt,
                                  double simplifyEps,
                                  double maxBoundaryEdgeLen,
                                  double minCellSize = 0.0,
                                  bool   minSizeEnforce = false);
 
    static QByteArray terrainKey(const FileIdentity &dem, int band,
                                 const DTMThinnerOptions &opts,
                                 bool doThinning,
                                 const QRectF &dtmBbox);
 
    bool loadBoundary(const QByteArray &key, BoundaryPrep *out) const;
    bool storeBoundary(const QByteArray &key, const BoundaryPrep &v) const;
    bool loadTerrain(const QByteArray &key, TerrainPoints *out) const;
    bool storeTerrain(const QByteArray &key, const TerrainPoints &v) const;
 
    void prune(int keepPerStage = 8) const;
 
    [[nodiscard]] QString dir() const { return m_dir; }
 
private:
    static constexpr quint32 kMagic         = 0x4D435348;  // "MCSH"
    // Salted into every cache key AND written into every payload header —
    // bumping it invalidates all entries at once.  MUST be bumped when
    // DTMThinner's banded-thinning geometry constants change
    // (kBytesPerGridPoint, kMaxGridBytesDefault, kMaxThinningHalo in
    // dtmthinner.{h,cpp}): they determine multi-band tiling and therefore
    // the terrain-point OUTPUT for banded configurations.
    static constexpr quint16 kFormatVersion = 1;
 
    [[nodiscard]] QString entryPath(char stage, const QByteArray &key) const;
 
    QString m_dir;
};
 
} // namespace mesh
 
#endif // OPENSWMMVIS_MESH_MESHSTAGECACHE_H