ZoneDetector.h

Go to the documentation of this file.

// SPDX-FileCopyrightText: 2026 fuddlesworth
// SPDX-License-Identifier: LGPL-2.1-or-later
 
#pragma once
 
#include <PhosphorZones/IZoneDetector.h>
#include <PhosphorZones/Layout.h>
#include <PhosphorZones/Zone.h>
#include <PhosphorZones/ZoneDefaults.h>
#include <QPointF>
#include <QRectF>
#include <QVector>
#include <memory>
 
namespace PhosphorZones {
class ZoneHighlighter;
} // namespace PhosphorZones
 
namespace PhosphorZones {
 
// ZoneDetectionResult is defined in IZoneDetector.h
 
class PHOSPHORZONES_EXPORT ZoneDetector : public IZoneDetector
{
    Q_OBJECT
 
    // Fully-qualified property type so moc's NOTIFY-signal validity check
    // (a global-namespace namespace block that references the property
    // type by its textual spelling) can resolve the type.
    Q_PROPERTY(PhosphorZones::Layout* layout READ layout WRITE setLayout NOTIFY layoutChanged)
 
public:
    explicit ZoneDetector(QObject* parent = nullptr);
    ~ZoneDetector() override; // Defined in .cpp to allow unique_ptr with forward declaration
 
    // IZoneDetector interface implementation
    Layout* layout() const override
    {
        return m_layout;
    }
    void setLayout(Layout* layout) override;
 
    void setAdjacentThreshold(int px)
    {
        m_adjacentThreshold = px;
    }
    int adjacentThreshold() const
    {
        return m_adjacentThreshold;
    }
 
    Q_INVOKABLE ZoneDetectionResult detectZone(const QPointF& cursorPos) const override;
    Q_INVOKABLE ZoneDetectionResult detectMultiZone(const QPointF& cursorPos) const override;
    Q_INVOKABLE QVector<Zone*> expandPaintedZonesToRect(const QVector<Zone*>& seedZones) const override;
    Q_INVOKABLE Zone* zoneAtPoint(const QPointF& point) const override;
    Q_INVOKABLE Zone* nearestZone(const QPointF& point) const override;
 
    // Note: Highlighting methods removed - use ZoneHighlighter instead
    // These methods are kept for backward compatibility but delegate to ZoneHighlighter
    Q_INVOKABLE void highlightZone(Zone* zone) override;
    Q_INVOKABLE void highlightZones(const QVector<Zone*>& zones) override;
    Q_INVOKABLE void clearHighlights() override;
 
    // Signals (layoutChanged, zoneHighlighted, highlightsCleared) are
    // inherited from IZoneDetector. Redeclaring them here would make moc
    // generate a second metaObject entry for each, causing connections
    // established through IZoneDetector* to fire a different slot from
    // connections made through ZoneDetector* — exactly the "signal
    // shadowing" pitfall that ILayoutManager.h warns against.
 
private:
    QRectF combineZoneGeometries(const QVector<Zone*>& zones) const;
    bool areZonesAdjacent(Zone* zone1, Zone* zone2) const;
    qreal distanceToZoneEdge(const QPointF& point, Zone* zone) const;
    Zone* resolveOverlappingZone(const QPointF& point) const;
 
    Layout* m_layout = nullptr;
    int m_adjacentThreshold = ::PhosphorZones::ZoneDefaults::AdjacentThreshold;
 
    // UI state management
    std::unique_ptr<class ZoneHighlighter> m_highlighter;
};
 
} // namespace PhosphorZones
 
// Q_DECLARE_METATYPE is in IZoneDetector.h