X-Git-Url: https://git.carlh.net/gitweb/?a=blobdiff_plain;f=src%2Flib%2Fjob.h;h=06a341f40d6808581d4bcf44ed3f2805f15285d1;hb=e60bb3e51bd1508b149e6b8f6608f09b5196ae26;hp=f50ed078434efb6cd3661de2802a4c528fb18c7d;hpb=d382f34db155ddaf4bb61538c18b87c7564e00b2;p=dcpomatic.git diff --git a/src/lib/job.h b/src/lib/job.h index f50ed0784..06a341f40 100644 --- a/src/lib/job.h +++ b/src/lib/job.h @@ -21,58 +21,68 @@ * @brief A parent class to represent long-running tasks which are run in their own thread. */ -#ifndef DVDOMATIC_JOB_H -#define DVDOMATIC_JOB_H +#ifndef DCPOMATIC_JOB_H +#define DCPOMATIC_JOB_H -#include +#include "signaller.h" #include #include -#include +#include +#include +#include -class Log; -class FilmState; -class Options; +class Film; /** @class Job * @brief A parent class to represent long-running tasks which are run in their own thread. */ -class Job : public boost::enable_shared_from_this +class Job : public boost::enable_shared_from_this, public Signaller, public boost::noncopyable { public: - Job (boost::shared_ptr s, boost::shared_ptr o, Log* l, boost::shared_ptr req); + Job (boost::shared_ptr); + virtual ~Job() {} /** @return user-readable name of this job */ virtual std::string name () const = 0; + virtual std::string json_name () const = 0; /** Run this job in the current thread. */ virtual void run () = 0; - + void start (); + void pause (); + void resume (); + void cancel (); bool is_new () const; bool running () const; bool finished () const; bool finished_ok () const; bool finished_in_error () const; + bool finished_cancelled () const; + bool paused () const; - std::string error () const; + std::string error_summary () const; + std::string error_details () const; int elapsed_time () const; virtual std::string status () const; + std::string json_status () const; + std::string sub_name () const { + return _sub_name; + } void set_progress_unknown (); - void set_progress (float); - void ascend (); - void descend (float); - float overall_progress () const; - - void emit_finished (); + void set_progress (float, bool force = false); + void sub (std::string); + boost::optional progress () const; - boost::shared_ptr required () const { - return _required; + boost::shared_ptr film () const { + return _film; } - /** Emitted from the GUI thread */ - sigc::signal0 Finished; + boost::signals2::signal Progress; + /** Emitted from the UI thread when the job is finished */ + boost::signals2::signal Finished; protected: @@ -80,52 +90,45 @@ protected: /** Description of a job's state */ 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 + NEW, ///< the job hasn't been started yet + RUNNING, ///< the job is running + PAUSED, ///< the job has been paused + FINISHED_OK, ///< the job has finished successfully + FINISHED_ERROR, ///< the job has finished in error + FINISHED_CANCELLED ///< the job was cancelled }; - + void set_state (State); - void set_error (std::string e); + void set_error (std::string s, std::string d); - /** FilmState for this job */ - boost::shared_ptr _fs; - /** options in use for this job */ - boost::shared_ptr _opt; - /** a log that this job can write to */ - Log* _log; + boost::shared_ptr _film; private: void run_wrapper (); - boost::shared_ptr _required; + boost::thread* _thread; /** mutex for _state and _error */ mutable boost::mutex _state_mutex; /** current state of the job */ State _state; - /** message for an error that has occurred (when state == FINISHED_ERROR) */ - std::string _error; + /** summary of an error that has occurred (when state == FINISHED_ERROR) */ + std::string _error_summary; + std::string _error_details; - /** time that this job was started */ + /** time that this sub-job was started */ time_t _start_time; + std::string _sub_name; - /** mutex for _stack and _progress_unknown */ + /** mutex for _progress */ mutable boost::mutex _progress_mutex; + boost::optional _progress; - struct Level { - Level (float a) : allocation (a), normalised (0) {} - - float allocation; - float normalised; - }; - - std::list _stack; - - /** true if this job's progress will always be unknown */ - bool _progress_unknown; + /** condition to signal changes to pause/resume so that we know when to wake; + this could be a general _state_change if it made more sense. + */ + boost::condition_variable _pause_changed; int _ran_for; };