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.3 2001/02/25 08:43:03 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;
53 class BackgroundSupervisor : public wxEvtHandler {
55 DECLARE_DYNAMIC_CLASS(BackgroundSupervisor)
57 typedef std::vector<BackgroundWorkerThread*> ThreadContainer;
58 ThreadContainer m_vecpThreads;
59 wxFrame* m_pParentFrame;
60 wxDocument* m_pDocument;
61 const std::string m_strProcessTitle;
62 wxProgressDialog* m_pDialogProgress;
64 volatile bool m_bFail;
65 std::string m_strFailMessage;
67 volatile int m_iRunning;
68 unsigned int m_iUnitsDone;
69 const unsigned int m_iTotalUnits;
73 bool m_bBackgroundTaskAdded;
74 bool m_bWorkersDeleted;
75 wxCriticalSection m_critsectThreads;
79 MSG_BACKGROUND_SUPERVISOR_ADD = 7500, // sends to BackgroundManager and Document
80 MSG_BACKGROUND_SUPERVISOR_REMOVE = 7501, // sends to BackgroundManager and Document
81 MSG_BACKGROUND_SUPERVISOR_UNIT_TICK = 7502, // sends to BackgroundManager for progress bars
82 MSG_BACKGROUND_SUPERVISOR_CANCEL = 7503, // *sent* to Supervisor to cancel process
83 MSG_DOCUMENT_ACK_REMOVE = 7504,
85 MSG_WORKER_THREAD_UNIT_TICK = 7505,
86 MSG_WORKER_THREAD_DONE = 7506,
87 MSG_WORKER_THREAD_FAIL = 7507, // sent by workers when they fail
90 BackgroundSupervisor (wxFrame* pParentFrame, wxDocument* pDocument, const char* const pszProcessTitle,
93 BackgroundSupervisor ()
94 : m_iTotalUnits(0), wxEvtHandler()
97 virtual ~BackgroundSupervisor();
99 virtual BackgroundWorkerThread* createWorker (int iThread, int iStartUnit, int iNumUnits)
103 virtual void onDone() {};
105 virtual void OnWorkerFail(wxCommandEvent& event);
106 virtual void OnWorkerUnitTick(wxCommandEvent& event);
107 virtual void OnWorkerDone(wxCommandEvent& event);
108 virtual void OnCancel(wxCommandEvent& event);
109 virtual void OnAckDocumentRemove(wxCommandEvent& event);
111 void deleteWorkers();
112 bool workersDeleted() const { return m_bWorkersDeleted; }
113 bool isDone() const {return m_bDone;}
114 void setDone() { m_bDone = true; }
115 bool fail() const {return m_bFail;}
116 const std::string& getFailMessage() const { return m_strFailMessage; }
118 int getNumWorkers() const { return m_iNumThreads; }
119 double getTimerEnd() { return m_pTimer->timerEnd(); }
121 static void cancelSupervisor (BackgroundSupervisor* pSupervisor);
123 DECLARE_EVENT_TABLE()
127 class BackgroundWorkerThread : public wxThread {
129 BackgroundSupervisor* m_pSupervisor;
130 const int m_iStartUnit;
131 const int m_iNumUnits;
135 BackgroundWorkerThread (BackgroundSupervisor* pSupervisor, int iThread, int iStartUnit, int iNumUnits)
136 : m_pSupervisor(pSupervisor), m_iThread(iThread), m_iStartUnit(iStartUnit), m_iNumUnits(iNumUnits),
137 wxThread (wxTHREAD_DETACHED)
141 #endif // _BACKGROUNDSUPR_H_