1 /*****************************************************************************
4 ** Name: backgroundsupr.h
5 ** Purpose: Header file for background supervisors
6 ** Programmer: Kevin Rosenberg
7 ** Date Started: February 2001
9 ** This is part of the CTSim program
10 ** Copyright (C) 1983-2001 Kevin Rosenberg
12 ** $Id: backgroundsupr.h,v 1.9 2001/03/05 17:26:46 kevin Exp $
14 ** This program is free software; you can redistribute it and/or modify
15 ** it under the terms of the GNU General Public License (version 2) as
16 ** published by the Free Software Foundation.
18 ** This program is distributed in the hope that it will be useful,
19 ** but WITHOUT ANY WARRANTY; without even the implied warranty of
20 ** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
21 ** GNU General Public License for more details.
23 ** You should have received a copy of the GNU General Public License
24 ** along with this program; if not, write to the Free Software
25 ** Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
26 ******************************************************************************/
28 #ifndef _BACKGROUNDSUPR_H
29 #define _BACKGROUNDSUPR_H
32 #include <wx/thread.h>
33 #include <wx/progdlg.h>
36 // This thread creates a SupervisorTask event handler object
37 // The thread is detached and terminates when SupervisorTask terminates
38 class SupervisorThread : public wxThread {
43 : wxThread(wxTHREAD_DETACHED)
49 // Pure virtual class for BackgroundSupervisor that can communication
50 // with BackgroundManager via messages
51 class BackgroundWorkerThread;
52 class BackgroundProcessingDocument;
54 class BackgroundSupervisor : public wxEvtHandler {
56 DECLARE_DYNAMIC_CLASS(BackgroundSupervisor)
58 SupervisorThread* m_pMyThread;
59 wxFrame* m_pParentFrame;
60 BackgroundProcessingDocument* m_pDocument;
61 const std::string m_strProcessTitle;
63 const unsigned int m_iTotalUnits;
66 volatile bool m_bFail;
67 std::string m_strFailMessage;
69 volatile int m_iRunning;
70 unsigned int m_iUnitsDone;
72 bool m_bWorkersDeleted;
74 typedef std::vector<BackgroundWorkerThread*> ThreadContainer;
75 ThreadContainer m_vecpThreads;
76 wxCriticalSection m_critsectThreads;
81 MSG_BACKGROUND_SUPERVISOR_ADD = 7500, // sends to BackgroundManager and Document
82 MSG_BACKGROUND_SUPERVISOR_REMOVE = 7501, // sends to BackgroundManager and Document
83 MSG_BACKGROUND_SUPERVISOR_UNIT_TICK = 7502, // sends to BackgroundManager for progress bars
84 MSG_BACKGROUND_SUPERVISOR_CANCEL = 7503, // *sent* to Supervisor to cancel process
85 MSG_DOCUMENT_ACK_REMOVE = 7504,
87 MSG_WORKER_THREAD_UNIT_TICK = 7505,
88 MSG_WORKER_THREAD_DONE = 7506,
89 MSG_WORKER_THREAD_FAIL = 7507, // sent by workers when they fail
92 BackgroundSupervisor (SupervisorThread* pMyThread, wxFrame* pParentFrame, BackgroundProcessingDocument* pDocument, const char* const pszProcessTitle,
95 BackgroundSupervisor ()
96 : wxEvtHandler(), m_iTotalUnits(0)
99 virtual ~BackgroundSupervisor();
101 virtual BackgroundWorkerThread* createWorker (int iThread, int iStartUnit, int iNumUnits)
105 virtual void onDone() {};
107 virtual void onCancel();
109 virtual void onWorkerFail(int iThread, std::string strFailMessage);
110 virtual void onWorkerUnitTick();
111 virtual void onWorkerDone(int iThread);
113 void deleteWorkers();
114 bool workersDone() const { return m_iRunning == 0; }
115 bool workersDeleted() const { return m_bWorkersDeleted; }
116 bool isDone() const {return m_bDone;}
117 void setDone() { m_bDone = true; }
118 bool fail() const {return m_bFail;}
119 const std::string& getFailMessage() const { return m_strFailMessage; }
120 bool cancelled() const {return m_bCancelled;}
122 int getNumWorkers() const { return m_iNumThreads; }
123 double getTimerEnd() { return m_pTimer->timerEnd(); }
125 DECLARE_EVENT_TABLE()
129 class BackgroundWorkerThread : public wxThread {
131 BackgroundSupervisor* m_pSupervisor;
133 const int m_iStartUnit;
134 const int m_iNumUnits;
137 BackgroundWorkerThread (BackgroundSupervisor* pSupervisor, int iThread, int iStartUnit, int iNumUnits)
138 : wxThread (wxTHREAD_DETACHED), m_pSupervisor(pSupervisor), m_iThread(iThread), m_iStartUnit(iStartUnit), m_iNumUnits(iNumUnits)
142 #endif // _BACKGROUNDSUPR_H_