ITileAlgorithmRegistry.h

Go to the documentation of this file.

// SPDX-FileCopyrightText: 2026 fuddlesworth
// SPDX-License-Identifier: LGPL-2.1-or-later
 
#pragma once
 
#include <phosphortiles_export.h>
 
#include <PhosphorLayoutApi/ILayoutSourceRegistry.h>
#include <PhosphorTiles/AlgorithmPreviewParams.h>
 
#include <QList>
#include <QString>
#include <QStringList>
 
namespace PhosphorTiles {
 
class TilingAlgorithm;
 
class PHOSPHORTILES_EXPORT ITileAlgorithmRegistry : public PhosphorLayout::ILayoutSourceRegistry
{
    Q_OBJECT
public:
    explicit ITileAlgorithmRegistry(QObject* parent = nullptr);
    ~ITileAlgorithmRegistry() override;
 
    // ─── Enumeration / query ───────────────────────────────────────────────
 
    virtual TilingAlgorithm* algorithm(const QString& id) const = 0;
 
    virtual QStringList availableAlgorithms() const = 0;
 
    virtual QList<TilingAlgorithm*> allAlgorithms() const = 0;
 
    virtual bool hasAlgorithm(const QString& id) const = 0;
 
    virtual TilingAlgorithm* defaultAlgorithm() const = 0;
 
    virtual QString defaultAlgorithmId() const = 0;
 
    // ─── Mutation ──────────────────────────────────────────────────────────
 
    virtual void registerAlgorithm(const QString& id, TilingAlgorithm* algorithm) = 0;
 
    virtual bool unregisterAlgorithm(const QString& id) = 0;
 
    // ─── Preview params ────────────────────────────────────────────────────
 
    virtual void setPreviewParams(const AlgorithmPreviewParams& params) = 0;
 
    virtual const AlgorithmPreviewParams& previewParams() const noexcept = 0;
 
Q_SIGNALS:
    void algorithmRegistered(const QString& id);
 
    void algorithmUnregistered(const QString& id, bool replacing);
 
    void previewParamsChanged();
};
 
} // namespace PhosphorTiles