irendererpanel.h

Go to the documentation of this file.

 
#ifndef OPENSWMMVIS_UI_DIALOGS_IRENDERERPANEL_H
#define OPENSWMMVIS_UI_DIALOGS_IRENDERERPANEL_H
 
#include "layers/swmm_category.h"
// Gap A4.1 — resolved capability snapshot (attribute fields + archetype).
#include "render/iattributeprovider.h"
#include "render/sublayers/feature/featuresublayer.h"
 
#include <QString>
#include <QVector>
#include <QWidget>
 
#include <functional>
#include <memory>
#include <optional>
#include <vector>
 
class OpenSWMMVisLayer;
 
namespace OpenSWMM::Render {
class IFeatureRenderer;
class Rule;
}
 
namespace openswmmvis::ui {
 
struct RendererPanelContext
{
    OpenSWMMVisLayer                                *hostLayer = nullptr;
    std::optional<OpenSWMMVis::SwmmCategory>        category;     // empty => layer-level
    OpenSWMM::Render::Rule                          *rule = nullptr;  // Slice Z.3b
 
    // ----- Gap A4.1 — resolved capability snapshot -----------------------
    // Filled by resolve(); declarative inputs for contextual gating so the
    // panels and the renderer-class dropdown share one source of truth
    // instead of re-deriving (and drifting on) provider lookups and
    // rule→layer parent walks.
 
    QVector<OpenSWMM::Render::AttributeField>       fields;
 
    OpenSWMM::Render::FeatureSublayer::Archetype    archetype =
        OpenSWMM::Render::FeatureSublayer::Archetype::Point;
 
    bool                                            animated = false;
 
    [[nodiscard]] bool hasNumeric() const
    {
        for (const auto &f : fields)
            if (f.type != QMetaType::QString) return true;
        return false;
    }
    [[nodiscard]] bool hasString() const
    {
        for (const auto &f : fields)
            if (f.type == QMetaType::QString) return true;
        return false;
    }
 
    [[nodiscard]] static RendererPanelContext resolve(
        OpenSWMMVisLayer *layer,
        std::optional<OpenSWMMVis::SwmmCategory> category,
        OpenSWMM::Render::Rule *rule = nullptr);
};
 
class IRendererPanel : public QWidget
{
    Q_OBJECT
public:
    using QWidget::QWidget;
    ~IRendererPanel() override = default;
 
    virtual void refreshFromModel() = 0;
 
    virtual QString displayName() const = 0;
};
 
class RendererPanelRegistry
{
public:
    using Factory = std::function<IRendererPanel *(const RendererPanelContext &ctx,
                                                    QWidget *parent)>;
 
    using Applicable = std::function<bool(const RendererPanelContext &ctx)>;
 
    struct Entry {
        QString    rendererId;     // "single" / "graduated" / "categorized" / "rulebased" / ...
        QString    displayName;    // shown in the dropdown
        Factory    factory;
        Applicable applicable;     // Gap A4.2 — null => always applicable
        QString    disabledReason; // tooltip shown on the greyed-out row
    };
 
    static RendererPanelRegistry &instance();
 
    void registerRenderer(QString rendererId, QString displayName, Factory factory,
                          Applicable applicable = {},
                          QString disabledReason = QString());
 
    [[nodiscard]] const std::vector<Entry> &entries() const { return m_entries; }
 
    [[nodiscard]] const Entry *find(const QString &rendererId) const;
 
private:
    RendererPanelRegistry() = default;
    std::vector<Entry> m_entries;
};
 
class RendererPanelRegistrar
{
public:
    RendererPanelRegistrar(QString rendererId, QString displayName,
                            RendererPanelRegistry::Factory factory,
                            RendererPanelRegistry::Applicable applicable = {},
                            QString disabledReason = QString())
    {
        RendererPanelRegistry::instance().registerRenderer(
            std::move(rendererId), std::move(displayName), std::move(factory),
            std::move(applicable), std::move(disabledReason));
    }
};
 
#define REGISTER_RENDERER_PANEL(ID_STRING, DISPLAY_STRING, FACTORY) \
    static const openswmmvis::ui::RendererPanelRegistrar \
        s_register_renderer_##__LINE__( \
            QStringLiteral(ID_STRING), QStringLiteral(DISPLAY_STRING), FACTORY);
 
#define REGISTER_RENDERER_PANEL_GATED(ID_STRING, DISPLAY_STRING, FACTORY, \
                                      APPLICABLE, REASON_STRING) \
    static const openswmmvis::ui::RendererPanelRegistrar \
        s_register_renderer_##__LINE__( \
            QStringLiteral(ID_STRING), QStringLiteral(DISPLAY_STRING), FACTORY, \
            APPLICABLE, QStringLiteral(REASON_STRING));
 
} // namespace openswmmvis::ui
 
#endif // OPENSWMMVIS_UI_DIALOGS_IRENDERERPANEL_H