GroupScene.h

   1 #ifndef __GROUPSCENE_H__
   2 #define __GROUPSCENE_H__
   3
   4 #include <QtCore>
   5 #include <QtGui>
   6 #include <QtWidgets>
   7
   8 class Dispatcher;
   9 class Parameters;
  10 class AbstractBlock;
  11 class GroupWidget;
  12 class GroupItem;
  13 class BoxItem;
  14 class SourceItem;
  15 class AbstractBoxItem;
  16 class ConnectionItem;
  17 class InterfaceItem;
  18
  19 using namespace std;
  20 using namespace Qt;
  21
  22 /* NOTES :
  23
  24  - A GroupScene is composed of a single GroupItem that contains BlockItem and ConnectionItem
  25    The GroupItem is stored in the mainGroup attribute
  26
  27  - A GroupScene is instanciated whenever there is a GroupItem that must be created, i.e.
  28   for the top scene or for subgroups.
  29
  30   - This class is a subclass of QGraphicsScene by convenience but it's goal is more to list
  31   the different inner items. Thus, all operations that add/remove items to the scene will also
  32   add them in the QList
  33  */
  34
  35 class GroupScene : public QGraphicsScene {
  36
  37 public:
  38
  39   /* edition mode of the window:
  40      - AddBlock: can only add blocks to the scene
  41      - AddConnection: can only add connections to the scene
  42      - AddGroup: while a new group (empty or from selected blocks) is created
  43      - ItemEdtion: can move/resize blocks/interfaces, remove blocks/interface/group, ...
  44    */
  45   enum EditMode { InitState, AddConnection, ItemEdition };
  46
  47   GroupScene(GroupScene* _parentScene, GroupWidget* _window, Dispatcher* _dispatcher, Parameters* _params, bool topScene = false, QObject *parent = 0);
  48   ~GroupScene();
  49
  50   // attributes getters
  51   inline GroupItem* getGroupItem() {return groupItem;}
  52   inline QList<BoxItem*> getBoxItems() { return boxItems; }
  53   inline QList<SourceItem*> getSourceItems() { return sourceItems; }
  54   inline QList<ConnectionItem*> getConnectionItems() { return connectionItems; }
  55   inline QList<GroupScene*> getChildrenScene() { return childrenScene; }
  56   inline GroupScene* getParentScene() { return parentScene; }
  57   inline GroupWidget* getGroupWidget() { return window; }
  58   inline int getId() { return id; }
  59   inline EditMode getEditionMode() { return editMode; }
  60   InterfaceItem* getSelectedInterface(int id);
  61
  62   // attributes setters
  63   inline void setWindow(GroupWidget* _window) { window = _window; }
  64   void setGroupItem(GroupItem* group);
  65   inline void setId(int id) { this->id = id; }
  66   inline void setEditionMode(EditMode mode) { editMode = mode; }
  67   void setSelectedInterface(int id, InterfaceItem* iface);
  68
  69   // attributes testers
  70   inline bool isTopScene() { return topScene; }
  71
  72   // others
  73
  74   // BoxItem related
  75   BoxItem* createBoxItem(AbstractBlock* block); //! create a new BoxItem and place it at the center of the scene
  76   void addBoxItem(BoxItem* item); //! add an already configured BoxItem in the scene.
  77   void removeBoxItem(BoxItem* item);
  78
  79   // ConnectionItem related
  80   void createConnectionItem(InterfaceItem* iface1, InterfaceItem* iface2);
  81   ConnectionItem* searchConnectionItem(InterfaceItem* iface1, InterfaceItem* iface2);
  82   void addConnectionItem(ConnectionItem* item);
  83   void removeConnectionItem(ConnectionItem* item);
  84
  85   // GroupItem related
  86   void removeGroupItem();
  87
  88   // SourceItem related
  89   SourceItem* createSourceItem(AbstractBlock* block); //! create a new SourceItem and place it around the group item
  90   void addSourceItem(SourceItem* item); //! add an already configured SourceItem in the scene.
  91   void removeSourceItem(SourceItem* item);
  92
  93   // child scenes related
  94   inline void addChildScene(GroupScene* child) { childrenScene.append(child); }
  95   inline void removeChildScene(GroupScene* child) { childrenScene.removeAll(child); }
  96   inline int getNbChildScene() { return childrenScene.size(); }
  97   void unselecteInterfaces();
  98
  99   QList<BoxItem *> getSelectedBlocks();
 100
 101   int setItemsId(int countInit=1);
 102   int setInterfacesId(int countInit=1);
 103
 104   void updateConnectionItemsShape();
 105
 106   void save(QXmlStreamWriter& writer);
 107
 108 private:
 109   Dispatcher *dispatcher;
 110   Parameters *params;
 111   GroupScene* parentScene; // the parent scene, =NULL for top scene
 112   GroupWidget* window; // the GroupWindow that contains that scene
 113   int id;
 114   GroupItem *groupItem; //! for convenience, the group item is directly accessible via this attribute
 115   QList<ConnectionItem*> connectionItems; //! for convenience, connections are directly accessible via this attribute
 116   QList<BoxItem*> boxItems; //! for convenience, box items are directly accessible via this attribute
 117   QList<SourceItem*> sourceItems; //! for convenience, box items are directly accessible via this attribute. Only usefull for top scene
 118   QList<GroupScene*> childrenScene;//! for convenience, children scenes are directly accessible via this attribute
 119   bool topScene;
 120   EditMode editMode;
 121   InterfaceItem* selectedInterfaces[2]; // selected iface 1 in AddConnection mode
 122
 123 };
 124
 125 #endif // __GROUPSCENE_H__