summaryrefslogtreecommitdiff
path: root/src/lib/ui_signaller.h
blob: 221bcbe9581ad2cdfaacdcaaeabf4487ab6e6723 (plain)
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
/*
    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.

*/

#ifndef DVDOMATIC_UI_SIGNALLER_H
#define DVDOMATIC_UI_SIGNALLER_H

#include <boost/bind.hpp>
#include <boost/asio.hpp>
#include <boost/thread.hpp>

/** A class to allow signals to be emitted from non-UI threads and handled
 *  by a UI thread.
 */
class UISignaller
{
public:
	/** Create a UISignaller.  Must be called from the UI thread */
	UISignaller ()
		: _work (_service)
	{
		_ui_thread = boost::this_thread::get_id ();
	}

	/** Emit a signal from any thread whose handlers will be called in the UI
	 *  thread.  Use something like:
	 *
	 *  ui_signaller->emit (boost::bind (boost::ref (SomeSignal), parameter));
	 */
	template <typename T>
	void emit (T f) {
		if (boost::this_thread::get_id() == _ui_thread) {
			/* already in the UI thread */
			f ();
		} else {
			/* non-UI thread; post to the service and wake up the UI */
			_service.post (f);
			wake_ui ();
		}
	}

	/** Call this in the UI when it is idle */
	void ui_idle () {
		_service.poll ();
	}

	/** This should wake the UI and make it call ui_idle() */
	virtual void wake_ui () = 0;

private:
	/** A io_service which is used as the conduit for messages */
	boost::asio::io_service _service;
	/** Object required to keep io_service from stopping when it has nothing to do */
	boost::asio::io_service::work _work;
	/** The UI thread's ID */
	boost::thread::id _ui_thread;
};

extern UISignaller* ui_signaller;

#endif