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, AddBlock, AddConnection, AddGroup, 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<ConnectionItem*> getConnectionItems() { return connectionItems; }
  54   inline QList<GroupScene*> getChildrenScene() { return childrenScene; }
  55   inline GroupScene* getParentScene() { return parentScene; }
  56   inline GroupWidget* getGroupWidget() { return window; }
  57   inline int getId() { return id; }
  58   inline EditMode getEditionMode() { return editMode; }
  59   InterfaceItem* getSelectedInterface(int id);
  60
  61   // attributes setters
  62   inline void setWindow(GroupWidget* _window) { window = _window; }
  63   void setGroupItem(GroupItem* group);
  64   inline void setId(int id) { this->id = id; }
  65   inline void setEditionMode(EditMode mode) { editMode = mode; }
  66   void setSelectedInterface(int id, InterfaceItem* iface);
  67
  68   // attributes testers
  69   inline bool isTopScene() { return topScene; }
  70
  71   // others
  72
  73   // BoxItem related
  74   BoxItem* createBoxItem(AbstractBlock* block); //! create a new BoxItem and place it at the center of the scene
  75   void addBoxItem(BoxItem* item); //! add an already configured BoxItem in the scene.
  76   void removeBoxItem(BoxItem* item);
  77
  78   // ConnectionItem related
  79   void createConnectionItem(InterfaceItem* iface1, InterfaceItem* iface2, bool withinGroup = true);
  80   ConnectionItem* searchConnectionItem(InterfaceItem* iface1, InterfaceItem* iface2);
  81   void addConnectionItem(ConnectionItem* item);
  82   void removeConnectionItem(ConnectionItem* item);
  83
  84   // GroupItem related
  85   void removeGroupItem();
  86
  87   // SourceItem related
  88   SourceItem* createSourceItem(AbstractBlock* block); //! create a new SourceItem and place it around the group item
  89   void addSourceItem(SourceItem* item); //! add an already configured SourceItem in the scene.
  90   void removeSourceItem(SourceItem* item);
  91
  92   // child scenes related
  93   inline void addChildScene(GroupScene* child) { childrenScene.append(child); }
  94   inline void removeChildScene(GroupScene* child) { childrenScene.removeAll(child); }
  95   inline int getNbChildScene() { return childrenScene.size(); }
  96   void unselecteInterfaces();
  97
  98   QList<BoxItem *> getSelectedBlocks();
  99
 100   int setItemsId(int countInit=1);
 101   int setInterfacesId(int countInit=1);
 102
 103   void updateConnectionItemsShape();
 104
 105   void save(QXmlStreamWriter& writer);
 106
 107 private:
 108   Dispatcher *dispatcher;
 109   Parameters *params;
 110   GroupScene* parentScene; // the parent scene, =NULL for top scene
 111   GroupWidget* window; // the GroupWindow that contains that scene
 112   int id;
 113   GroupItem *groupItem; //! for convenience, the group item is directly accessible via this attribute
 114   QList<ConnectionItem*> connectionItems; //! for convenience, connections are directly accessible via this attribute
 115   QList<BoxItem*> boxItems; //! for convenience, box items are directly accessible via this attribute
 116   QList<SourceItem*> sourceItems; //! for convenience, box items are directly accessible via this attribute. Only usefull for top scene
 117   QList<GroupScene*> childrenScene;//! for convenience, children scenes are directly accessible via this attribute
 118   bool topScene;
 119   EditMode editMode;
 120   InterfaceItem* selectedInterfaces[2]; // selected iface 1 in AddConnection mode
 121
 122 };
 123
 124 #endif // __GROUPSCENE_H__