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