summaryrefslogtreecommitdiffstats
path: root/src/sources/threadedtrigger.h
blob: cda4b2015273af2852adf2f4963a4b3572deff45 (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
77
78
79
80
81
82
83
84
85
86
87
88
89
90
/***************************************************************************
 *   Copyright (C) 2007 by Ken Werner                                      *
 *   [email protected]                                                     *
 *                                                                         *
 *   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.,                                       *
 *   51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.             *
 ***************************************************************************/

#ifndef THREADEDTRIGGER_H
#define THREADEDTRIGGER_H

#include "source.h"
#include "updateevent.h"
#include "triggeredsource.h"
#include <tqwaitcondition.h>
#include <tqmutex.h>
#include <tqthread.h>
#include <tqevent.h>
#include <tqobject.h>

/**
 * ThreadedTrigger calls the fetchValue method of a source asynchronous using a thread
 * @author Ken Werner
 */
class ThreadedTrigger : public TQObject, TQThread{
	Q_OBJECT
	 //macro which activates signals and slots (tqmoc)
public:
	/**
	 * Creates a new ThreadedTrigger
	 */
	ThreadedTrigger(TriggeredSource* inSource, unsigned long inRefreshSleep = 1000);
	
	virtual ~ThreadedTrigger();

protected:
	/**
	 * fetches tcalls the fetchValue method periodically
	 * and sends an UpdateEvent to the source
	 */
    virtual void run();

protected slots:
	/**
	 * enables (starts the thread) or disables (stops the thread)
	 * this method is called if mSource gets enabled or disabled
	 */
	void enable(bool inEnable);

private:
	/**
	 * pointer to the TriggeredSource
	 **/
	 TriggeredSource* mSource;

	/**
	 * time in milli seconds between two value fetches
	 */
	unsigned long mRefreshSleep;

    /**
     * indicates whether this thread runs
     */
    bool mRunning;
    
    /*
     * this is the condition, on which this thread sleeps 
     * mRefreshSleep milliseconds.
     */
    TQWaitCondition mWaitCond;

    /*
     * this mutex ensures that the thread always sleeps on the
     * condition, if we signal it.
     */
    TQMutex mWaitMutex;
};
#endif //THREADEDTRIGGER_H