connector.h

/***************************************************************************
 *   Copyright (C) 2003-2005 by David Saxton                               *
 *   david@bluehaze.org                                                    *
 *                                                                         *
 *   This program is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU General Public License as published by  *
 *   the Free Software Foundation; either version 2 of the License, or     *
 *   (at your option) any later version.                                   *
 ***************************************************************************/

#ifndef CONNECTOR_H
#define CONNECTOR_H

#include <qcanvas.h>
#include <qguardedptr.h>
#include <qvaluevector.h>

class Cell;
class ConnectorData;
class ConnectorLine;
class ConRouter;
class CNItem;
class ICNDocument;
class Node;
class NodeGroup;
class Wire;

typedef QValueList<ConnectorLine*> ConnectorLineList;
typedef QValueList<QPoint> QPointList;
typedef QValueVector<QGuardedPtr<Wire> > WireVector;


/*
        TODO: Audit/enhance this code.
*/

class Connector : public QObject, public QCanvasPolygon
{
Q_OBJECT
public:
        Connector( Node *startNode, Node *endNode, ICNDocument *_ICNDocument, QString *id = 0 );
        ~Connector();
        
        virtual int rtti() const;

        Node * startNode() const { return m_startNode; }

        Node * endNode() const { return m_endNode; }

        ConnectorData connectorData() const;

        void restoreFromConnectorData( const ConnectorData &connectorData );

        virtual void setSelected( bool yes );

        QString id() const { return m_id; }

        void updateDrawList();

        void setNodeGroup( NodeGroup *nodeGroup ) { p_nodeGroup = nodeGroup; }

        NodeGroup *nodeGroup() const { return p_nodeGroup; }

        void updateConnectorPoints( bool add );

        void setRoutePoints( QPointList pointList, bool setManual, bool checkEndPoints = false );

        void setSemiHidden( bool semiHidden );

        void setParentContainer( const QString &cnItemId );

        CNItem *parentContainer() const { return p_parentContainer; }

        bool usesManualPoints() const { return b_manualPoints; }

        QValueList<QPointList> splitConnectorPoints( const QPoint &pos ) const;

        ICNDocument *icnDocument() const { return p_icnDocument; }

        bool pointsAreReverse( const QPointList &pointList ) const;

        QPointList connectorPoints( bool reverse = false ) const;

        void rerouteConnector();

        void translateRoute( int dx, int dy );
        virtual void setVisible( bool yes );
        WireVector wires() const { return m_wires; }
        unsigned numWires() const { return m_wires.size(); }
        Wire * wire( unsigned num = 0 ) const { return (num < m_wires.size()) ? m_wires[num] : 0; }
        
signals:
        void removed( Connector *connector );
        void selected( bool yes );
        void numWiresChanged( unsigned newNum );
        
public slots:
        void removeConnector( Node* = 0 );
        void syncWiresWithNodes();
        
protected:
        void updateConnectorLines();
        
        bool m_bIsSyncingWires;
        bool b_semiHidden;
        QGuardedPtr<Node> m_startNode;
        QGuardedPtr<Node> m_endNode;
        NodeGroup *p_nodeGroup;
        CNItem *p_parentContainer;
        ICNDocument *p_icnDocument;
        ConRouter *m_conRouter;
        QString m_id;
        ConnectorLineList m_connectorLineList;
        QRect m_oldBoundRect;
        WireVector m_wires;
        bool b_deleted;
        bool b_manualPoints;
        bool b_pointsAdded;
};
typedef QValueList<QGuardedPtr<Connector> > ConnectorList;


//BEGIN ConnectorLine things
class ConnectorLine : public QObject, public QCanvasLine
{
public:
        ConnectorLine( Connector *connector );
        Connector *parent() const { return p_connector; }
        virtual int rtti() const;

protected:
        Connector *p_connector;
};
//END ConnectorLine things

#endif

---