qsg2ddirtystate.h

Go to the documentation of this file.

 
#ifndef OPENSWMM_RENDER_QSG2DDIRTYSTATE_H
#define OPENSWMM_RENDER_QSG2DDIRTYSTATE_H
 
#include <QtGlobal>
 
namespace OpenSWMM::Render
{
 
class Qsg2DDirtyState
{
public:
    enum Domain : quint32 {
        None      = 0,
        Geometry  = 1u << 0,
        Style     = 1u << 1,
        Data      = 1u << 2,
        Selection = 1u << 3,
        Lod       = 1u << 4,
        Transform = 1u << 5,
 
        AllContent = Geometry | Style | Data | Selection | Lod,
        All        = AllContent | Transform,
    };
 
    // ── Event notes (called from signal handlers / setters) ────────────
 
    void noteExtentChanged(bool zoomChanged)
    {
        m_extentChanged = true;
        m_zoomChanged   = m_zoomChanged || zoomChanged;
    }
 
    void noteDataChanged()      { m_pending |= Data; }
    void noteSelectionChanged() { m_pending |= Selection; }
    void noteStyleChanged()     { m_pending |= Style; }
    void noteGeometryChanged()  { m_pending |= Geometry; }
 
    void noteLayerChanged()     { m_pending |= AllContent; }
 
    void noteExternalChanged()  { m_external = true; }
 
    // ── Pre-resolve introspection (for perf-log dirty reasons) ─────────
 
    [[nodiscard]] bool extentChangePending() const { return m_extentChanged; }
    [[nodiscard]] bool zoomChangePending()   const { return m_zoomChanged; }
    [[nodiscard]] bool externalChangePending() const { return m_external; }
    [[nodiscard]] quint32 pending() const { return m_pending; }
 
    [[nodiscard]] bool hasAnythingPending() const
    {
        return m_pending != None || m_external || m_extentChanged;
    }
 
    // ── Sync-time resolution ────────────────────────────────────────────
 
    quint32 resolve(bool geomRevisionChanged,
                    bool selectionChanged,
                    bool timeChanged,
                    bool lodKeyChanged,
                    bool extentInsideCoverage)
    {
        quint32 bits = m_pending;
 
        // Snapshot diffs always win — they are ground truth regardless of
        // which (or whether a) signal fired.
        if (geomRevisionChanged) bits |= Geometry;
        if (selectionChanged)    bits |= Selection;
        if (timeChanged)         bits |= Data;
 
        // An ambiguous external change with no observable diff is treated
        // as a style edit: the broadest safe content refresh that still
        // leaves static geometry, selection and transform state alone.
        if (m_external
            && !geomRevisionChanged && !selectionChanged && !timeChanged
            && (bits & (Geometry | Selection | Data)) == 0)
            bits |= Style;
 
        if (m_extentChanged) {
            bits |= Transform;
            if (lodKeyChanged || !extentInsideCoverage) bits |= Lod;
        } else if (lodKeyChanged || !extentInsideCoverage) {
            // Viewport/DPR resize (or a mesh-stat change) without an extent
            // move still re-keys the content — and a coverage miss without
            // an extent event (view grew past the built region) must
            // likewise repopulate.
            bits |= Lod;
        }
 
        m_pending       = None;
        m_external      = false;
        m_extentChanged = false;
        m_zoomChanged   = false;
        return bits;
    }
 
    void clear()
    {
        m_pending       = None;
        m_external      = false;
        m_extentChanged = false;
        m_zoomChanged   = false;
    }
 
private:
    quint32 m_pending       = None;
    bool    m_external      = false;
    bool    m_extentChanged = false;
    bool    m_zoomChanged   = false;
};
 
} // namespace OpenSWMM::Render
 
#endif // OPENSWMM_RENDER_QSG2DDIRTYSTATE_H