kstars/kstars/stardatasink.h

   1 /***************************************************************************
   2                           stardatasink.h  -  description
   3                              -------------------
   4     begin                : Son Feb 10 2002
   5     copyright            : (C) 2002 by Thomas Kabelmann
   6     email                : tk78@gmx.de
   7  ***************************************************************************/
   8
   9 /***************************************************************************
  10  *                                                                         *
  11  *   This program is free software; you can redistribute it and/or modify  *
  12  *   it under the terms of the GNU General Public License as published by  *
  13  *   the Free Software Foundation; either version 2 of the License, or     *
  14  *   (at your option) any later version.                                   *
  15  *                                                                         *
  16  ***************************************************************************/
  17
  18 #ifndef STARDATASINK_H
  19 #define STARDATASINK_H
  20
  21
  22 /**@class StarDataSink
  23         *StarDataSink receives data from an FileSource object and appends these data
  24         *to a QList of star data. It's an asynchronous io class.
  25         *@author Thomas Kabelmann
  26         *@version 1.0
  27         */
  28
  29 #include <qobject.h>
  30 #include <qasyncio.h>
  31
  32 #include <qglobal.h>
  33
  34 class KStarsData;
  35
  36 class StarDataSink : public QObject, public QDataSink {
  37 /**
  38         *class needs signals
  39         */
  40         Q_OBJECT
  41
  42         public:
  43         /** constructor */
  44                 StarDataSink( KStarsData *parent, const char *name=0 );
  45
  46         /** destructor */
  47                 ~StarDataSink();
  48
  49         /** is this object ready to receive data? */
  50                 int readyToReceive();
  51
  52         /** end of data transmission reached */
  53                 void eof();
  54
  55         /**
  56                 *This function receives data from FileSource and appends data
  57                 *to some lists in KStarsData.
  58                 */
  59                 void receive( const uchar *data, int entries );
  60
  61         private:
  62
  63                 KStarsData *ksData;
  64
  65                 // has objectnamelist changed while reloading?
  66                 uint nameListCount;
  67
  68                 // counts the number of blocks
  69                 uint receivedBlocks;
  70
  71         signals:
  72
  73         /**
  74                 *send signal if all data were transmitted
  75                 */
  76                 void done();
  77
  78         /**
  79                 *send signal to update skymap time by time
  80                 *just for long data transmissions needed.
  81                 */
  82                 void updateSkymap();
  83
  84         /**
  85                 *If name list has changed emit this signal.
  86                 */
  87                 void clearCache();
  88 };
  89
  90 #endif