1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
|
/*
Copyright (C) 2012 Carl Hetherington <cth@carlh.net>
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.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
*/
/** @file src/job.h
* @brief A parent class to represent long-running tasks which are run in their own thread.
*/
#ifndef DVDOMATIC_JOB_H
#define DVDOMATIC_JOB_H
#include <string>
#include <boost/thread/mutex.hpp>
#include <sigc++/sigc++.h>
class Log;
class FilmState;
class Options;
/** @class Job
* @brief A parent class to represent long-running tasks which are run in their own thread.
*/
class Job
{
public:
Job (boost::shared_ptr<const FilmState> s, boost::shared_ptr<const Options> o, Log* l);
/** @return user-readable name of this job */
virtual std::string name () const = 0;
/** Run this job in the current thread. */
virtual void run () = 0;
void start ();
bool running () const;
bool finished () const;
bool finished_ok () const;
bool finished_in_error () const;
std::string error () const;
int elapsed_time () const;
virtual std::string status () const;
void set_progress_unknown ();
void set_progress (float);
void ascend ();
void descend (float);
float overall_progress () const;
void emit_finished ();
/** Emitted from the GUI thread */
sigc::signal0<void> Finished;
protected:
enum State {
NEW, ///< the job hasn't been started yet
RUNNING, ///< the job is running
FINISHED_OK, ///< the job has finished successfully
FINISHED_ERROR ///< the job has finished in error
};
void set_state (State);
void set_error (std::string e);
boost::shared_ptr<const FilmState> _fs;
boost::shared_ptr<const Options> _opt;
/** A log that this job can write to */
Log* _log;
private:
void run_wrapper ();
/** mutex for _state and _error */
mutable boost::mutex _state_mutex;
State _state;
std::string _error;
time_t _start_time;
mutable boost::mutex _progress_mutex;
struct Level {
Level (float a) : allocation (a), normalised (0) {}
float allocation;
float normalised;
};
std::list<Level> _stack;
/** true if this job's progress will always be unknown */
bool _progress_unknown;
};
#endif
|
