vymmodel.h
author insilmaril
Wed, 25 Nov 2009 10:58:21 +0000
changeset 807 f9f7922989d8
parent 804 14f2b1b15242
child 808 b163492fda17
permissions -rw-r--r--
Added demos/vym-contribute.vym, fixes for selecting items
     1 #ifndef VYMMODEL_H
     2 #define VYMMODEL_H
     3 
     4 #include <QGraphicsScene>
     5 #include <QtNetwork>
     6 
     7 #include <QtDBus/QDBusAbstractAdaptor>
     8 #include <QtDBus/QDBusVariant>
     9 
    10 #include "adaptormodel.h"
    11 #include "file.h"
    12 #include "imageitem.h"
    13 #include "mapeditor.h"
    14 #include "parser.h"
    15 #include "treeitem.h"
    16 #include "treemodel.h"
    17 
    18 class AttributeItem;
    19 class BranchItem;
    20 class MapEditor;
    21 class XLinkItem;
    22 
    23 class VymModel :  public TreeModel {		
    24 	Q_OBJECT
    25 	Q_CLASSINFO("D-Bus Interface", "org.insilmaril.vym.VymModel-h")
    26 
    27 
    28 ////////////////////////////////////////////
    29 // General housekeeping
    30 ////////////////////////////////////////////
    31 private:
    32 	QString version;	//!< version string saved in vym file
    33 	QString author;
    34 	QString comment;
    35 	QDate date;
    36 
    37 public:
    38 	VymModel();
    39 	~VymModel ();
    40     void clear();
    41     void init();
    42 	void makeTmpDirectories();		//!< create temporary directories e.g. for history
    43 
    44 	MapEditor* getMapEditor();			// FIXME-2 still necessary?
    45 
    46 	bool isRepositionBlocked();		//!< While load or undo there is no need to update graphicsview
    47 
    48 	void updateActions();			//!< Update buttons in mainwindow
    49 
    50 
    51 ////////////////////////////////////////////
    52 // Load/save 
    53 ////////////////////////////////////////////
    54 private:
    55 
    56 	bool zipped;				// should map be zipped
    57 	static	int mapNum;			// unique number for model used in save/undo
    58 	FileType fileType;			// type of file, e.g. vym, freemind...
    59 	QString fileName;			// short name of file (for tab)
    60 	QString filePath;			// path to file which will be saved
    61 	QString fileDir;			// dir where file is saved
    62 	QString destPath;			// path to .vym file (needed for vymlinks)
    63 	QString mapName;			// fileName without ".vym"
    64 
    65 	QString tmpMapDir;			// tmp directory with undo history
    66 
    67 	QTimer *autosaveTimer;
    68 	QTimer *fileChangedTimer;
    69 	QDateTime fileChangedTime;
    70 
    71 public:
    72 	/*! This function saves all information of the map to disc.
    73 	    saveToDir also calls the functions for all BranchObj and other objects in the map.
    74 		The structure of the map itself is returned as QString and passed back to Main, 
    75 		where saveToDir is called initially
    76 	*/	
    77     QString saveToDir (const QString &tmpdir, const QString &prefix, bool writeflags, const QPointF &offset, TreeItem *saveSel);
    78 
    79 	/*! Save all data in tree*/
    80 	QString saveTreeToDir (const QString&,const QString&,int, const QPointF&);// Save data recursivly to tempdir
    81 
    82 
    83 	/*! \brief Sets filepath, filename and mapname
    84 
    85 	     If the filepath is "/home/tux/map.xml", then the filename will be set
    86 		 to map.xml. The destname is needed for vymLinks, pointing to another map. 
    87 		 The destname holds the real name of the file, after it has been compressed, e.g. "map.vym"
    88 	*/	 
    89 
    90 
    91 	/*! \brief Set File path
    92 
    93 	     The destname is needed to construct the references between maps
    94 	*/	 
    95 	void setFilePath (QString filepath,QString destname);	
    96 	void setFilePath (QString);	//!< Overloaded for convenience
    97 	QString getFilePath ();	//!< Full path e.g. "/home/tux/map.xml"
    98 	QString getFileName ();	//!< e.g. "map.xml"
    99 	QString getMapName ();	//!< e.g. "map"
   100 	QString getDestPath (); //!< e.g. "/home/tux/map.vym"
   101 
   102 	/*! \brief Load map
   103 
   104 		The data is read from file. Depending on LoadMode the current
   105 		selection gets replaced by data or the data is appended.
   106 	*/	
   107     ErrorCode load (QString, const LoadMode &, const FileType& );	// newmap, import/replace selection
   108 
   109 public:
   110 	/*! \brief Save the map to file */
   111     ErrorCode save(const SaveMode &);	
   112 
   113 private:
   114     void addMapReplaceInt(const QString & undoSel, const QString & path);
   115     bool addMapInsertInt (const QString & path);
   116     bool addMapInsertInt (const QString & path, int pos);
   117 
   118 	ImageItem* loadFloatImageInt (BranchItem *dst,QString);
   119 	void saveFloatImageInt (ImageItem*, const QString &, const QString &);
   120 public:	
   121 	void loadFloatImage ();
   122 	void saveFloatImage ();
   123 
   124 private:	
   125     void importDirInt(BranchItem *,QDir);
   126     void importDirInt(const QString&);
   127 public:	
   128     void importDir();
   129 
   130 private slots:
   131 	void autosave ();
   132 	void fileChanged();
   133 
   134 ////////////////////////////////////////////
   135 // history (undo/redo)
   136 ////////////////////////////////////////////
   137 private:
   138     bool mapDefault;			//!< Flag if map is untouched
   139     bool mapChanged;			//!< Flag if undo is possible
   140 	bool mapUnsaved;			//!< Flag if map should be saved
   141 
   142 	QString histPath;			//!< Path to history file
   143 	SimpleSettings undoSet;		//!< undo/redo commands, saved in histPath
   144 	int stepsTotal;				//!< total number of steps (undos+redos) 
   145 	int curStep;				//!< Current step in history (ring buffer)
   146 	int curClipboard;			//!< number of history step, which is the current clipboard
   147 	int redosAvail;				//!< Available number of redo steps
   148 	int undosAvail;				//!< Available number of undo steps
   149 	bool blockReposition;		//!< block while load or undo
   150 	bool blockSaveState;		//!< block while load or undo
   151 public:
   152 	bool isDefault();			//!< true, if map is still the empty default map
   153 	void makeDefault();			//!< Reset changelog, declare this as default map
   154     bool hasChanged()	;		//!< true, if something has changed and is not saved yet
   155 	void setChanged();			//!< called from TextEditor via LinkableMapObj
   156 
   157 	/*! \brief Get name of object
   158 	  
   159 	  Returns heading of a branch or name of an object for use in comment
   160 	  of undo/redo history
   161 	*/ 
   162 	QString getObjectName(LinkableMapObj*);	
   163 	QString getObjectName(TreeItem*);	
   164 
   165     void redo();						//!< Redo last action
   166 	bool isRedoAvailable();				//!< True, if redo is available
   167     void undo();						//!< Undo last action
   168 	bool isUndoAvailable();				//!< True, if undo is available
   169 	void gotoHistoryStep (int);			//!< Goto a specifig step in history
   170 
   171 
   172 	QString getHistoryPath();			//!< Path to directory containing the history
   173 
   174 	/*! \brief Save the current changes in map 
   175 
   176 		Two commands and selections are saved:
   177 
   178 			- undocommand and undoselection to undo the change
   179 			- redocommand and redoselection to redo the action after an undo
   180 
   181 		Additionally a comment is logged. 
   182 
   183 	*/	
   184     void saveState(
   185 		const SaveMode& savemode, 
   186 		const QString &undoSelection, 
   187 		const QString &undoCommand, 
   188 		const QString &redoSelection, 
   189 		const QString &redoCommand, 
   190 		const QString &comment, 
   191 		TreeItem *saveSelection);
   192 	/*! Overloaded for convenience */
   193     void saveStateChangingPart(
   194 		TreeItem *undoSelection, 
   195 		TreeItem* redoSelection, 
   196 		const QString &redoCommand, 
   197 		const QString &comment);
   198 	/*! Overloaded for convenience */
   199     void saveStateRemovingPart(
   200 		TreeItem *redoSelection, 
   201 		const QString &comment);
   202 	/*! Overloaded for convenience */
   203     void saveState(
   204 		TreeItem *undoSelection, 
   205 		const QString &undoCommand, 
   206 		TreeItem *redoSelection, 
   207 		const QString &redoCommand, 
   208 		const QString &comment); 
   209 	/*! Overloaded for convenience */
   210     void saveState(
   211 		const QString &undoSelection, 
   212 		const QString &undoCommand, 
   213 		const QString &redoSelection, 
   214 		const QString &redoCommand, 
   215 		const QString &comment) ;
   216     void saveState(
   217 		const QString &undoCommand, 
   218 		const QString &redoCommand, 
   219 		const QString &comment) ;
   220 
   221 
   222 ////////////////////////////////////////////
   223 // unsorted so far
   224 ////////////////////////////////////////////
   225 private:
   226 	QGraphicsScene *mapScene;
   227 public:
   228 	void setScene(QGraphicsScene *s);
   229 	QGraphicsScene *getScene();
   230 
   231     TreeItem* findBySelectString (QString s);		
   232     TreeItem* findID (const QString &s);				// find MapObj by previously set ID
   233 
   234 
   235 ////////////////////////////////////////////
   236 // Interface 
   237 ////////////////////////////////////////////
   238 public:
   239 	void setVersion(const  QString &);
   240 	void setAuthor  (const QString &);
   241 	QString getAuthor ();
   242 	void setComment (const QString &);
   243 	QString getComment ();
   244 	QString getDate();
   245 	int branchCount();
   246 
   247 	void setSortFilter (const QString &);
   248 	QString getSortFilter ();
   249 protected:	
   250 	QString sortFilter;
   251 signals:
   252 	void sortFilterChanged (QString );		//!< Notify editors of new filter
   253 
   254 public:
   255 	void setHeading(const QString &);		//!< Set heading of item	
   256 	QString getHeading ();					//!< Get heading of item
   257 	void setNote(const QString &s);			//!< Set note text
   258 	QString getNote();						//!< Get note text
   259 
   260 private:
   261 	BranchItem* findCurrent;				// next object in find process
   262 	BranchItem* findPrevious;				// next object in find process
   263 	bool EOFind;							// true, if search failed
   264 
   265 public:
   266     BranchItem* findText(QString,bool);		// Find object
   267     void findReset();						// Reset Search
   268 
   269 	void setURL(const QString &url);
   270 	QString getURL();						// returns URL of selection or ""
   271 	QStringList getURLs();					// returns URLs of subtree
   272 
   273 
   274 	void setFrameType(const FrameObj::FrameType &);
   275 	void setFrameType(const QString &);
   276 	void setFramePenColor (const QColor &);
   277 	void setFrameBrushColor (const QColor &);
   278 	void setFramePadding (const int &);
   279 	void setFrameBorderWidth (const int &);
   280 	void setIncludeImagesVer(bool);
   281 	void setIncludeImagesHor(bool);
   282 	void setHideLinkUnselected (bool);
   283 
   284 	/*! Should object be hidden in exports (clouded)? */
   285 	void setHideExport(bool);			
   286 
   287 	/*! Should object be hidden in exports (clouded)? */
   288 	void toggleHideExport();		
   289 
   290 	void addTimestamp();		
   291 
   292     void copy();						//!< Copy to clipboard
   293 private:	
   294     void pasteNoSave(const int &n);		//!< paste clipboard to branch
   295 public:	
   296     void paste();			//!< Paste clipboard to branch and backup
   297     void cut();				//!< Cut to clipboard (and copy)
   298 
   299     bool moveUp(BranchItem *bi);	//!< Move branch up without saving state
   300     void moveUp();					//!< Move branch up with saving state
   301     bool moveDown(BranchItem *bi);	//!< Move branch down without saving state
   302     void moveDown();		//!< Move branch down
   303 	void detach();					//!< Detach branch and use as new mapcenter
   304 	void sortChildren();	//!< Sort children lexically
   305 
   306 	// The create methods are used to quickly parse a XML file
   307 	BranchItem* createMapCenter();				//!< Create MapCenter 
   308 	BranchItem* createBranch(BranchItem *dst);	//!< Create Branch
   309 	ImageItem* createImage(BranchItem *dst);	//!< Create image
   310 	XLinkItem* createXLink(BranchItem *dst,bool createMO=false);	//!< Create XLink starting at dst
   311 
   312 	AttributeItem* addAttribute();
   313 
   314 	/*! \brief Add new mapcenter
   315 
   316 	    Disclaimer: Still experimental, not fully supported yet.
   317 	*/	
   318 	BranchItem* addMapCenter();
   319 private:	
   320 	BranchItem* addMapCenter(QPointF absPos);
   321 
   322 	/*! \brief Add new branch
   323 
   324 		Depending on num the new branch is created
   325 
   326 		-3 above selection as child of selections parent
   327 		-2 as child of selection
   328 		-1 below selection as child of selections parent
   329 		0..n	insert at a specific position in selections parent
   330 		(needed for free relinking)
   331 	*/	
   332 
   333 private:	
   334     BranchItem* addNewBranchInt(BranchItem *dst, int pos);	// pos allows to add above/below selection
   335 public:	
   336 	/*! \Add new branch
   337 		
   338 		Depending on num the new branch is created
   339 		-1 above selection
   340 		 0 as child of selection
   341 		 1 below selection
   342 	*/
   343     BranchItem* addNewBranch(int pos=0);		
   344     BranchItem* addNewBranchBefore();		//!< Insert branch between selection and its parent
   345 	/*! \brief Relink a branch to a new destination dst 
   346 	    Relinks branch to dst at branch position pos. There is no saveState
   347 		here, as for example moveUp or moving in MapEditor have
   348 		different needs to call saveState
   349 		Returns true if relinking was successful.
   350 	*/	
   351 	bool relinkBranch (BranchItem* branch, BranchItem* dst, int pos =-1);	
   352 	bool relinkImage  (ImageItem* image, BranchItem* dst);	
   353 
   354     void deleteSelection();				//!< Delete selection
   355 	void deleteKeepChildren();			//!< remove branch, but keep children
   356 	void deleteChildren();				//!< keep branch, but remove children
   357 
   358 	TreeItem* deleteItem(TreeItem*);	//!< Delete item and return parent (if parent!= rootItem)
   359 	void clearItem (TreeItem* ti);		//!< Remove all children of TreeItem ti
   360 	bool scrollBranch(BranchItem *);
   361 	bool unscrollBranch(BranchItem *);
   362 public:	
   363     void toggleScroll();
   364     void unscrollChildren();
   365 	void emitExpandAll();
   366 	void emitExpandOneLevel();
   367 	void emitCollapseOneLevel();
   368 signals:	
   369 	void expandAll();
   370 	void expandOneLevel();
   371 	void collapseOneLevel();
   372 
   373 public:	
   374 	void toggleStandardFlag (const QString &name, FlagRow *master=NULL);
   375     void addFloatImage(const QPixmap &img);
   376 
   377     void colorBranch(QColor);
   378     void colorSubtree(QColor);
   379 	QColor getCurrentHeadingColor();
   380 
   381 
   382 	void editURL();							// edit URL
   383 	void editLocalURL();					// edit URL to local file
   384 	void editHeading2URL();					// copy heading to URL
   385 	void editBugzilla2URL();				// create URL to Bugzilla
   386 	void editFATE2URL();					// create URL to FATE
   387 	void editVymLink();						// edit link to another map
   388 	void setVymLink (const QString &);	// Set vymLink for selection
   389 	void deleteVymLink();					// delete link to another map
   390 	QString getVymLink();					// return path to map
   391 	QStringList getVymLinks();				// return paths in subtree
   392 	void followXLink (int);
   393 	void editXLink (int);
   394 
   395 
   396 
   397 
   398 ////////////////////////////////////////////
   399 // Scripting
   400 ////////////////////////////////////////////
   401 public:	
   402 
   403 	/* \brief Process one command and its parameters */
   404     QVariant parseAtom (const QString &atom, bool &noError, QString &errorMsg);	
   405 
   406 	/* \brief Runs the script */
   407 	QVariant runScript (const QString &script);
   408 
   409 private:
   410 	Parser parser;
   411 
   412 ////////////////////////////////////////////
   413 // Exports
   414 ////////////////////////////////////////////
   415 private:
   416 	TreeItem::HideTmpMode hidemode;	// true while exporting to hide some stuff
   417 
   418 public:
   419 	/*! Set or unset temporary hiding of objects during export  */
   420 	void setExportMode (bool);
   421 
   422 	/*! Save as image */
   423     void exportImage (QString fname="",bool askForName=true,QString format="PNG");
   424 
   425 
   426 	/*! Export as XTML to directory */
   427     void exportXML(QString dir="", bool askForName=true);
   428 
   429 	/*! Export as A&O report text to file */
   430 	void exportAO (QString fname="",bool askForName=true);  
   431 
   432 	/*! Export as ASCII text to file */
   433 	void exportASCII (QString fname="",bool askForName=true);  
   434 
   435 	/*! Export as XHTML to directory */
   436     void exportXHTML(const QString& dir="", bool askForName=true);	
   437 
   438     /*! Export as OpenOfficeOrg presentation */
   439     void exportOOPresentation(const QString &,const QString &);	
   440 
   441 
   442 ////////////////////////////////////////////
   443 // View related
   444 ////////////////////////////////////////////
   445 public:
   446 	void registerEditor (QWidget *);
   447 	void unregisterEditor (QWidget *);
   448 
   449 private: 
   450 	QPointF contextPos;					//!< local position during context menu
   451 public:
   452 	void setContextPos (QPointF);		//!< local position during context menu
   453 	void unsetContextPos ();			//!< forget local position after context menu
   454 
   455 	void updateNoteFlag();				//!< Signal origination in TextEditor
   456 	void reposition();					//!< Call reposition for all MCOs
   457 	void setHideTmpMode (TreeItem::HideTmpMode mode);	
   458 
   459 	void emitNoteHasChanged (TreeItem *ti);
   460 	void emitDataHasChanged (TreeItem *ti);
   461 
   462 signals:
   463 	void noteHasChanged (QModelIndex ix);
   464 	void newChildObject(QModelIndex ix);
   465 
   466 private:
   467 	MapEditor *mapEditor;
   468 
   469 	QColor defLinkColor;		// default color for links
   470 	QColor defXLinkColor;		// default color for xlinks
   471 	int defXLinkWidth;			// default width for xlinks
   472 	LinkableMapObj::ColorHint linkcolorhint;// use heading color or own color
   473 	LinkableMapObj::Style linkstyle;		// default style for links
   474 
   475 public:
   476 	void setMapLinkStyle (const QString &);	// Set style of link
   477 	LinkableMapObj::Style getMapLinkStyle ();	// requested in LMO
   478 	void setMapDefLinkColor(QColor);		// default color of links
   479 	void setMapLinkColorHintInt();			// color of links
   480 	void setMapLinkColorHint(LinkableMapObj::ColorHint);// color of links
   481 	void toggleMapLinkColorHint();			// after changing linkStyles
   482     void selectMapBackgroundImage();
   483     void setMapBackgroundImage(const QString &);
   484     void selectMapBackgroundColor();
   485     void setMapBackgroundColor(QColor);
   486     QColor getMapBackgroundColor();
   487 
   488 
   489 	LinkableMapObj::ColorHint getMapLinkColorHint();
   490 	QColor getMapDefLinkColor();
   491 	void setMapDefXLinkColor(QColor);
   492 	QColor getMapDefXLinkColor();
   493 	void setMapDefXLinkWidth (int);
   494 	int getMapDefXLinkWidth();
   495 
   496 	/*!  Move absolutly to (x,y).  */	
   497     void move    (const double &x, const double &y);
   498 
   499 	/*!  Move relativly to (x,y).  */	
   500     void moveRel (const double &x, const double &y);
   501 
   502 ////////////////////////////////////////////
   503 // Animation  **experimental**
   504 ////////////////////////////////////////////
   505 private:	
   506 	QTimer *animationTimer;
   507 	bool animationUse;
   508 	uint animationTicks;
   509 	uint animationInterval;
   510 	int timerId;				// animation timer
   511 	QList <MapObj*> animObjList;// list with animated objects //FIXME-2 should go to MapEditor
   512 
   513 private slots:
   514 	void animate();						//!< Called by timer to animate stuff
   515 public:
   516 	void startAnimation(BranchObj *bo, const QPointF &start, const QPointF &dest);
   517 	void stopAnimation(MapObj *mo);
   518 
   519 ////////////////////////////////////////////
   520 // Network related 
   521 ////////////////////////////////////////////
   522 public:
   523     /*! \brief Networking states
   524 		
   525 		In Network modus we want to switch of saveState, autosave, ...
   526 	*/
   527 	enum NetState {
   528 		Offline,			//!< Offline
   529 		Client,				//!< I am the client and connected to server
   530 		Server				//!< I am the server
   531 	};
   532 
   533 private:
   534 	// Network connections **Experimental**
   535 	NetState netstate;			// offline, client, server
   536 	QTcpServer *tcpServer;		// Act as server in conference mode (experimental)
   537 	QList <QTcpSocket*> clientList;		// List of connected clients
   538 	quint16 sendCounter;		// Increased with every sent command
   539 
   540 	QTcpSocket	*clientSocket;	// socket of this client
   541 	QString server;				// server address of this client
   542 	int port;					// server port of this client
   543 
   544 
   545 
   546 protected:
   547 	void sendSelection();
   548 
   549 public:
   550 	void newServer();
   551 	void connectToServer();
   552 
   553 private slots:	
   554 	void newClient();
   555 	void sendData(const QString &s);
   556 	void readData();
   557 	void displayNetworkError (QAbstractSocket::SocketError);
   558 
   559 ////////////////////////////////////////////
   560 // DBUS related 
   561 ////////////////////////////////////////////
   562 
   563 private:
   564 AdaptorModel *adaptorModel; //FIXME-3
   565 
   566 public slots:
   567 	void testslot();
   568 
   569 ////////////////////////////////////////////
   570 // Selection related 
   571 ////////////////////////////////////////////
   572 private:
   573 	TreeItem *latestAddedItem;				// latest added object, reset on setChanged()
   574 
   575 public:
   576 	void setSelectionModel(QItemSelectionModel *);		// Set common selectionModel
   577 	QItemSelectionModel* getSelectionModel();
   578 
   579 	void setSelectionBlocked(bool);
   580 	bool isSelectionBlocked();
   581 
   582 	bool select ();							//! select by using common QItemSelectionModel
   583 	bool select (const QString &);			//! Select by string
   584 	bool select (LinkableMapObj *lmo);		//! Select by pointer to LMO
   585 	bool select (TreeItem *ti );			//! Select by pointer to TreeItem
   586 	bool select (const QModelIndex &index);	//! Select by ModelIndex
   587 	void unselect();
   588 	bool reselect();
   589 
   590 	void emitShowSelection();				//!< Show selection in all views
   591 signals:
   592 	void showSelection();
   593 
   594 public:	
   595     bool selectFirstBranch();
   596     bool selectLastBranch();
   597 	bool selectLastSelectedBranch();
   598 	bool selectParent();
   599 
   600 public:
   601 	TreeItem::Type selectionType();
   602 	LinkableMapObj* getSelectedLMO();
   603 	BranchObj* getSelectedBranchObj();	// FIXME-3 replace by item...
   604 	BranchItem* getSelectedBranch();
   605 	ImageItem* getSelectedImage();
   606 	AttributeItem* getSelectedAttribute();
   607 	TreeItem* getSelectedItem();
   608 	QModelIndex getSelectedIndex();
   609 	QString getSelectString ();
   610 	QString getSelectString (LinkableMapObj *lmo);
   611 	QString getSelectString (TreeItem *item);
   612 	
   613 	
   614 signals:
   615 	void selectionChanged(const QItemSelection &newsel, const QItemSelection &oldsel);
   616 
   617 public:
   618 	void emitSelectionChanged(const QItemSelection &oldsel);
   619 	void emitSelectionChanged();
   620 	void selectMapLinkColor();
   621     void selectMapSelectionColor();
   622 private:	
   623     void setSelectionColorInt(QColor);
   624 	QItemSelectionModel *selModel;
   625 	QString lastSelectString;
   626 	bool selectionBlocked;		//! Used to block changes of selection while editing a heading
   627 
   628 public:	
   629     void setSelectionColor(QColor);
   630     QColor getSelectionColor();
   631 };
   632 
   633 #endif