1 files changed, 105 insertions, 0 deletions
diff --git a/kstars/kstars/filesource.h b/kstars/kstars/filesource.h
new file mode 100644
index 00000000..39fb83bd
--- /dev/null
+++ b/kstars/kstars/filesource.h
@@ -0,0 +1,105 @@
+/***************************************************************************
+                          filesource.h  -  description
+                             -------------------
+    begin                : Son Feb 10 2002
+    copyright            : (C) 2002 by Thomas Kabelmann
+    email                : tk78@gmx.de
+ ***************************************************************************/
+
+/***************************************************************************
+ *                                                                         *
+ *   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 FILESOURCE_H
+#define FILESOURCE_H
+
+/**@class FileSource
+	*FileSource is an asynchronous class for reloading star data while running
+	*the program. It's basing on QDataSource class and implements the function
+	*for reading a file step by step and send these data to an QDataSink object.
+	*KStarsData uses this class for asynchronous io.
+	*@author Thomas Kabelmann
+	*@version 1.0
+	*/
+
+#include <qasyncio.h>
+#include <qstring.h>
+
+class KStarsData;
+class KSFileReader;
+
+class FileSource : public QDataSource  {
+
+	public:
+	/**constructor needs an KStarsData object, a file name and the new magnitude
+		*/
+		FileSource( KStarsData *ksdata, float magnitude );
+
+	/** destructor */
+		~FileSource();
+  	
+	/**send a value indicating whether the object is ready to send data.
+		*@return 1 if data is ready to send; return -1 if the stream is finished.
+		*/
+		int readyToSend();
+
+	/**Is this object rewindable?
+		*@return false, because it's not needed to rewind.
+		*/
+		bool rewindable() { return false; }
+		
+	/**The function for sending data to an QDataSink object. Here will all data
+		*operations defined. Because this function is virtual, we need a second int
+		*parameter, but we don't use it, so it's unnamed.
+		*@p sink pointer to the QDataSink object which will receive the data stream
+		*/
+		void sendTo( QDataSink *sink, int );
+
+	/**@return current magnitude to load (always returns maxMagnitude)
+		*/
+		float magnitude() { return maxMagnitude; }
+		
+	private:
+
+		bool readingData;
+
+		KSFileReader *fileReader;
+
+		// which sao file should be opened and which line
+		int fileNumber, lineNumber;
+
+		// counts blocksize
+		int counter;
+
+		// new magnitude to load
+		float maxMagnitude;
+
+		KStarsData *data;
+
+	/**maxLines defines how many lines in data file should be read and
+		*send to QDataSink. This is only needed if a data block is longer
+		*than the max defined lines. I figured out this value of 500
+		*on a fast system, so if it is to high the value might be decreased.
+		*A high value means faster reloading but perhaps on slow systems this
+		*might interrupt the main event loop.
+		*A low value needs longer to reload data, but it doesn't interrupt the
+		*main event loop (it's smoother).
+		*But it's important to know that 500 lines to read is very fast, but
+		*appending to QList in StarDataSink will take the most time and this
+		*will also defined with this value.
+		*/
+		#define maxLines 500
+	
+	/**The loaded data will stored in a string array and a pointer to first
+		*object in array will send to StarDataSink.
+		*/
+		QString stringArray[ maxLines ];
+
+};
+
+#endif