Added KDE3 version of ktechlab

git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/applications/ktechlab@1095338 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 107 insertions, 0 deletions

diff --git a/src/languages/flowcode.h b/src/languages/flowcode.h
new file mode 100644
index 0000000..afa17db
--- /dev/null
+++ b/src/languages/flowcode.h
@@ -0,0 +1,107 @@
+/***************************************************************************
+ *   Copyright (C) 2003-2004 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 FLOWCODE_H
+#define FLOWCODE_H
+
+#include "language.h"
+
+#include <qguardedptr.h>
+#include <qobject.h>
+#include <qstring.h>
+#include <qstringlist.h>
+#include <qvaluelist.h>
+
+class CNItem;
+class FlowPart;
+class Item;
+class MicroSettings;
+
+typedef QValueList<FlowPart*> FlowPartList;
+typedef QValueList<QGuardedPtr<Item> > ItemList;
+
+/**
+"FlowCode" can possibly be considered a misnomer, as the output is actually Microbe.
+However, the function of this class is to take a set of FlowParts, and generate the
+basic from the code that they create. The 3 simple steps for usage of this function:
+(1) Create an instance of this class, giving the Start point and setings
+(2) Add all the subroutines present using addSubroutine()
+(3) Call generateMicrobe() to get the Microbe code.
+@author David Saxton
+*/
+class FlowCode : public Language
+{
+public:
+	FlowCode( ProcessChain *processChain, KTechlab *parent );
+
+	virtual void processInput( ProcessOptions options );
+	virtual ProcessOptions::ProcessPath::Path outputPath( ProcessOptions::ProcessPath::Path inputPath ) const;
+
+	/**
+	 * You must set the start part
+	 */
+	void setStartPart( FlowPart *startPart );
+	~FlowCode();
+	/**
+	 * You must add all top level subroutines using this function
+	 */
+	void addSubroutine( FlowPart *part );
+	/**
+	 * Adds code at the current insertion point
+	 */
+	void addCode( const QString& code );
+	/**
+	 * Adds a code branch to the current insertion point. This will stop when the level gets
+	 * below the original starting level (so for insertion of the contents of a for loop,
+	 * insertion will stop at the end of that for loop).
+	 * @param flowPart The next FlowPart to get code from
+	 */
+	void addCodeBranch( FlowPart *flowPart );
+	/**
+	 * Designates a FlowPart as a stopping part (i.e. will refuse requests to addCodeBranch
+	 * for that FlowPart until removeStopPart is called
+	 */
+	void addStopPart( FlowPart *part );
+	/**
+	 * Undesignates a FlowPart as a stopping part
+	 */
+	void removeStopPart( FlowPart *part );
+	/**
+	 * Generates and returns the microbe code
+	 * @param nonVerbal if true then will not inform the user when something goes wrong
+	 */
+	QString generateMicrobe( const ItemList &itemList, MicroSettings *settings );
+	/**
+	 * Returns true if the FlowPart is a valid one for adding a branch
+	 */
+	bool isValidBranch( FlowPart *flowPart );
+	/**
+	 * Generates a nice label name from the string, e.g. genLabel("callsub")
+	 * returns "__label_callsub".
+	 */
+	static QString genLabel( const QString &id );
+	
+protected:
+	/**
+	 * Performs indenting, removal of unnecessary labels, etc.
+	 */
+	void tidyCode();
+
+	QStringList m_gotos; // Gotos used
+	QStringList m_labels; // Labels used
+	FlowPartList m_subroutines;
+	FlowPartList m_addedParts;
+	FlowPartList m_stopParts;
+	FlowPart *p_startPart;
+	QString m_code;
+	int m_curLevel;
+};
+
+#endif