ConnectionManager.h

Go to the documentation of this file.

// Copyright 2015 - 2026, GIBIS-UNIFESP and the wiRedPanda contributors
// SPDX-License-Identifier: GPL-3.0-or-later

 
#pragma once
 
#include <QCoreApplication>
#include <QList>
#include <QPair>
#include <QPointer>
#include <QPointF>
 
class GraphicElement;
class PortHoverLabel;
class Connection;
class InputPort;
class OutputPort;
class Port;
class Scene;

class ConnectionManager
{
    Q_DECLARE_TR_FUNCTIONS(ConnectionManager)
    friend class TestConnectionManager;
 
public:
    explicit ConnectionManager(Scene *scene);
 
    // --- Wire creation workflow ---

    void startFromOutput(OutputPort *startPort);

    void startFromInput(InputPort *endPort);

    void tryComplete(const QPointF &scenePos);

    void cancel();

    void detach(InputPort *endPort);
 
    // --- In-progress wire state ---

    [[nodiscard]] bool hasEditedConnection() const;

    [[nodiscard]] Connection *editedConnection() const;

    void updateEditedEnd(const QPointF &scenePos);
 
    // --- Hover feedback ---

    void updateHover(const QPointF &scenePos);

    void clearHover();

    void showHoverLabels(Port *port);
 
    // --- Validation ---

    static bool isConnectionAllowed(OutputPort *startPort, InputPort *endPort);

    static QString connectionRejectionReason(OutputPort *startPort, InputPort *endPort);
 
private:
    void setEditedConnection(Connection *connection);
    void deleteEditedConnection();
 
    void setHoverPort(Port *port);
    void releaseHoverPort();
    [[nodiscard]] Port *hoverPort();

    [[nodiscard]] static QList<Port *> connectedPeers(Port *port);

    void clearHoverLabels();
 
    Scene *m_scene = nullptr;

    int m_editedConnectionId = 0;

    int m_hoverPortElmId = 0;
    int m_hoverPortNumber = 0;

    QList<QPointer<PortHoverLabel>> m_peerLabels;

    QList<QPair<int, int>> m_highlightedPeers;
};