Isis 3 Developer Reference
CubeDataThread.h
Go to the documentation of this file.
1 #ifndef CubeDataThread_h
2 #define CubeDataThread_h
3 
4 #include <QThread>
5 
6 template<typename T> class QList;
7 
8 template<typename A, typename B> struct QPair;
9 template<typename A, typename B> class QMap;
10 
11 class QReadWriteLock;
12 class QMutex;
13 
14 namespace Isis {
15  class Cube;
16  class FileName;
17  class Brick;
18  class UniversalGroundMap;
19 
53  class CubeDataThread : public QThread {
54  Q_OBJECT
55 
56  public:
58  virtual ~CubeDataThread();
59 
60  int AddCube(const FileName &fileName,
61  bool mustOpenReadWrite = false);
62  int AddCube(Cube *cube);
63 
64  void RemoveCube(int cubeId);
65 
66  void AddChangeListener();
67  void RemoveChangeListener();
68 
69  int BricksInMemory();
70 
71  UniversalGroundMap *GetUniversalGroundMap(int cubeId) const;
72 
73  const Cube *GetCube(int cubeId) const;
74  int FindCubeId(const Cube *) const;
75 
76  public slots:
77  void ReadCube(int cubeId, int startSample, int startLine,
78  int endSample, int endLine, int band, void *caller);
79  void ReadWriteCube(int cubeId, int startSample, int startLine,
80  int endSample, int endLine, int band, void *caller);
81 
82  void DoneWithData(int, const Isis::Brick *);
83 
84  signals:
85 
97  void ReadReady(void *requester, int cubeId, const Isis::Brick *data);
98 
110  void ReadWriteReady(void *requester, int cubeId, Isis::Brick *data);
111 
124  void BrickChanged(int cubeId, const Isis::Brick *data);
125 
126  private:
135  CubeDataThread(const CubeDataThread &cdt);
136 
146  const CubeDataThread &operator=(CubeDataThread rhs);
147 
148  int OverlapIndex(const Brick *initial, int cubeId,
149  int instanceNum, bool &exact);
150 
151  void GetCubeData(int cubeId, int ss, int sl, int es, int el, int band,
152  void *caller, bool sharedLock);
153 
154  void AcquireLock(QReadWriteLock *lockObject, bool readLock);
155 
156  bool FreeBrick(int brickIndex);
157 
165  QMap< int, QPair< bool, Cube * > > * p_managedCubes;
166 
168  QMutex *p_threadSafeMutex;
169 
193  QList< QPair<QReadWriteLock *, Brick *> > * p_managedData;
194 
196  QList< int > * p_managedDataSources;
197 
199  int p_numChangeListeners;
200 
202  unsigned int p_currentId;
203 
205  bool p_stopping;
206 
211  unsigned int p_currentLocksWaiting;
212  };
213 
214 };
215 
216 
217 #endif
void RemoveCube(int cubeId)
Removes a cube from this lock manager.
Definition: CubeDataThread.cpp:186
int FindCubeId(const Cube *) const
Given a Cube pointer, return the cube ID associated with it.
Definition: CubeDataThread.cpp:345
File name manipulation and expansion.
Definition: FileName.h:116
Universal Ground Map.
Definition: UniversalGroundMap.h:85
void DoneWithData(int, const Isis::Brick *)
When done processing with a brick (reading or writing) this slot needs to be signalled to free locks ...
Definition: CubeDataThread.cpp:581
Buffer for containing a three dimensional section of an image.
Definition: Brick.h:61
void ReadReady(void *requester, int cubeId, const Isis::Brick *data)
This signal will be emitted when ReadCube has finished processing.
virtual ~CubeDataThread()
This class is a self-contained thread, so normally it would be bad to simply delete it...
Definition: CubeDataThread.cpp:60
int AddCube(const FileName &fileName, bool mustOpenReadWrite=false)
This method is designed to be callable from any thread before data is requested, though no known side...
Definition: CubeDataThread.cpp:119
UniversalGroundMap * GetUniversalGroundMap(int cubeId) const
This returns a new Universal Ground Map given a Cube ID.
Definition: CubeDataThread.cpp:744
Encapsulation of Cube I/O with Change Notifications.
Definition: CubeDataThread.h:53
void AddChangeListener()
You must call this method after connecting to the BrickChanged signal, otherwise you are not guarante...
Definition: CubeDataThread.cpp:224
void ReadWriteReady(void *requester, int cubeId, Isis::Brick *data)
This signal will be emitted when ReadWriteCube has finished processing.
void ReadCube(int cubeId, int startSample, int startLine, int endSample, int endLine, int band, void *caller)
This slot should be connected to and upon receiving a signal it will begin the necessary cube I/O to ...
Definition: CubeDataThread.cpp:421
Definition: BoxcarCachingAlgorithm.h:29
Namespace for ISIS/Bullet specific routines.
Definition: Apollo.h:31
void RemoveChangeListener()
You must call this method after disconnecting from the BrickChanged signal, otherwise bricks cannot b...
Definition: CubeDataThread.cpp:232
void BrickChanged(int cubeId, const Isis::Brick *data)
DO NOT CONNECT TO THIS SIGNAL WITHOUT CALLING AddChangeListener().
void ReadWriteCube(int cubeId, int startSample, int startLine, int endSample, int endLine, int band, void *caller)
This slot should be connected to and upon receiving a signal it will begin the necessary cube I/O to ...
Definition: CubeDataThread.cpp:456
int BricksInMemory()
This is a helper method for both testing/debugging and general information that provides the current ...
Definition: CubeDataThread.cpp:728
Definition: CubeIoHandler.h:39
Definition: CubeIoHandler.h:38
CubeDataThread()
This constructs a CubeDataThread().
Definition: CubeDataThread.cpp:29
const Cube * GetCube(int cubeId) const
This returns a constant pointer to a Cube at the given Cube ID.
Definition: CubeDataThread.cpp:761
IO Handler for Isis Cubes.
Definition: Cube.h:170