author | truebrain |
Tue, 26 Feb 2008 18:36:16 +0000 | |
branch | noai |
changeset 9779 | 5713a8978df7 |
parent 9694 | e72987579514 |
child 9856 | 6a0dcee9f8e4 |
permissions | -rw-r--r-- |
2285
3193cbd1ba88
(svn r2809) Implement more generic threading functions, which allow more than one thread
tron
parents:
diff
changeset
|
1 |
/* $Id$ */ |
3193cbd1ba88
(svn r2809) Implement more generic threading functions, which allow more than one thread
tron
parents:
diff
changeset
|
2 |
|
9574 | 3 |
/** @file thread.h */ |
4 |
||
2285
3193cbd1ba88
(svn r2809) Implement more generic threading functions, which allow more than one thread
tron
parents:
diff
changeset
|
5 |
#ifndef THREAD_H |
3193cbd1ba88
(svn r2809) Implement more generic threading functions, which allow more than one thread
tron
parents:
diff
changeset
|
6 |
#define THREAD_H |
3193cbd1ba88
(svn r2809) Implement more generic threading functions, which allow more than one thread
tron
parents:
diff
changeset
|
7 |
|
6574
e1d1a12faaf7
(svn r9051) -Codechange: typedef [enum|struct] Y {} X; -> [enum|struct] X {};
rubidium
parents:
6573
diff
changeset
|
8 |
struct OTTDThread; |
2285
3193cbd1ba88
(svn r2809) Implement more generic threading functions, which allow more than one thread
tron
parents:
diff
changeset
|
9 |
|
9694
e72987579514
(svn r10775) [NoAI] -Sync: with trunk r10535:r10774.
rubidium
parents:
9574
diff
changeset
|
10 |
typedef void * (*OTTDThreadFunc)(void*); |
2285
3193cbd1ba88
(svn r2809) Implement more generic threading functions, which allow more than one thread
tron
parents:
diff
changeset
|
11 |
|
9694
e72987579514
(svn r10775) [NoAI] -Sync: with trunk r10535:r10774.
rubidium
parents:
9574
diff
changeset
|
12 |
OTTDThread *OTTDCreateThread(OTTDThreadFunc, void*); |
e72987579514
(svn r10775) [NoAI] -Sync: with trunk r10535:r10774.
rubidium
parents:
9574
diff
changeset
|
13 |
void *OTTDJoinThread(OTTDThread*); |
6573 | 14 |
void OTTDExitThread(); |
2285
3193cbd1ba88
(svn r2809) Implement more generic threading functions, which allow more than one thread
tron
parents:
diff
changeset
|
15 |
|
9514
e31710af1ca0
(svn r9419) [NoAI] -Codechange: support AI threads also on Win32 (using threads on Win95 and fibers on other Win32 platforms)
KUDr
parents:
6574
diff
changeset
|
16 |
|
e31710af1ca0
(svn r9419) [NoAI] -Codechange: support AI threads also on Win32 (using threads on Win95 and fibers on other Win32 platforms)
KUDr
parents:
6574
diff
changeset
|
17 |
/** |
e31710af1ca0
(svn r9419) [NoAI] -Codechange: support AI threads also on Win32 (using threads on Win95 and fibers on other Win32 platforms)
KUDr
parents:
6574
diff
changeset
|
18 |
* C++ thread wrapper interface |
e31710af1ca0
(svn r9419) [NoAI] -Codechange: support AI threads also on Win32 (using threads on Win95 and fibers on other Win32 platforms)
KUDr
parents:
6574
diff
changeset
|
19 |
*/ |
e31710af1ca0
(svn r9419) [NoAI] -Codechange: support AI threads also on Win32 (using threads on Win95 and fibers on other Win32 platforms)
KUDr
parents:
6574
diff
changeset
|
20 |
struct ThreadObject { |
e31710af1ca0
(svn r9419) [NoAI] -Codechange: support AI threads also on Win32 (using threads on Win95 and fibers on other Win32 platforms)
KUDr
parents:
6574
diff
changeset
|
21 |
/** Virtual destructor to allow 'delete' operator to work properly. */ |
e31710af1ca0
(svn r9419) [NoAI] -Codechange: support AI threads also on Win32 (using threads on Win95 and fibers on other Win32 platforms)
KUDr
parents:
6574
diff
changeset
|
22 |
virtual ~ThreadObject() {}; |
e31710af1ca0
(svn r9419) [NoAI] -Codechange: support AI threads also on Win32 (using threads on Win95 and fibers on other Win32 platforms)
KUDr
parents:
6574
diff
changeset
|
23 |
/** Returns true if thread is running. */ |
e31710af1ca0
(svn r9419) [NoAI] -Codechange: support AI threads also on Win32 (using threads on Win95 and fibers on other Win32 platforms)
KUDr
parents:
6574
diff
changeset
|
24 |
virtual bool IsRunning() = 0; |
e31710af1ca0
(svn r9419) [NoAI] -Codechange: support AI threads also on Win32 (using threads on Win95 and fibers on other Win32 platforms)
KUDr
parents:
6574
diff
changeset
|
25 |
/** Waits for the thread exit. Returns true if thread exited. */ |
e31710af1ca0
(svn r9419) [NoAI] -Codechange: support AI threads also on Win32 (using threads on Win95 and fibers on other Win32 platforms)
KUDr
parents:
6574
diff
changeset
|
26 |
virtual bool WaitForStop() = 0; |
e31710af1ca0
(svn r9419) [NoAI] -Codechange: support AI threads also on Win32 (using threads on Win95 and fibers on other Win32 platforms)
KUDr
parents:
6574
diff
changeset
|
27 |
/** Returns true if this Thread Object belongs to the current (calling) thread. */ |
e31710af1ca0
(svn r9419) [NoAI] -Codechange: support AI threads also on Win32 (using threads on Win95 and fibers on other Win32 platforms)
KUDr
parents:
6574
diff
changeset
|
28 |
virtual bool IsCurrent() = 0; |
e31710af1ca0
(svn r9419) [NoAI] -Codechange: support AI threads also on Win32 (using threads on Win95 and fibers on other Win32 platforms)
KUDr
parents:
6574
diff
changeset
|
29 |
/** Returns thread id of the thread associated to this Thread Object. */ |
e31710af1ca0
(svn r9419) [NoAI] -Codechange: support AI threads also on Win32 (using threads on Win95 and fibers on other Win32 platforms)
KUDr
parents:
6574
diff
changeset
|
30 |
virtual uint Id() = 0; |
e31710af1ca0
(svn r9419) [NoAI] -Codechange: support AI threads also on Win32 (using threads on Win95 and fibers on other Win32 platforms)
KUDr
parents:
6574
diff
changeset
|
31 |
/** Begin thread execution by calling given procedure and passing given parameter to it. */ |
e31710af1ca0
(svn r9419) [NoAI] -Codechange: support AI threads also on Win32 (using threads on Win95 and fibers on other Win32 platforms)
KUDr
parents:
6574
diff
changeset
|
32 |
virtual bool Begin(void (CDECL *proc)(void*), void *param) = 0; |
e31710af1ca0
(svn r9419) [NoAI] -Codechange: support AI threads also on Win32 (using threads on Win95 and fibers on other Win32 platforms)
KUDr
parents:
6574
diff
changeset
|
33 |
/** Used to construct new instance of thread object. */ |
e31710af1ca0
(svn r9419) [NoAI] -Codechange: support AI threads also on Win32 (using threads on Win95 and fibers on other Win32 platforms)
KUDr
parents:
6574
diff
changeset
|
34 |
static ThreadObject* New(); |
e31710af1ca0
(svn r9419) [NoAI] -Codechange: support AI threads also on Win32 (using threads on Win95 and fibers on other Win32 platforms)
KUDr
parents:
6574
diff
changeset
|
35 |
/** Returns thread object instance that belongs to the current (calling) thread. */ |
e31710af1ca0
(svn r9419) [NoAI] -Codechange: support AI threads also on Win32 (using threads on Win95 and fibers on other Win32 platforms)
KUDr
parents:
6574
diff
changeset
|
36 |
static ThreadObject* Current(); |
e31710af1ca0
(svn r9419) [NoAI] -Codechange: support AI threads also on Win32 (using threads on Win95 and fibers on other Win32 platforms)
KUDr
parents:
6574
diff
changeset
|
37 |
/** Returns thread id of the current (calling) thread. */ |
e31710af1ca0
(svn r9419) [NoAI] -Codechange: support AI threads also on Win32 (using threads on Win95 and fibers on other Win32 platforms)
KUDr
parents:
6574
diff
changeset
|
38 |
static uint CurrentId(); |
e31710af1ca0
(svn r9419) [NoAI] -Codechange: support AI threads also on Win32 (using threads on Win95 and fibers on other Win32 platforms)
KUDr
parents:
6574
diff
changeset
|
39 |
}; |
e31710af1ca0
(svn r9419) [NoAI] -Codechange: support AI threads also on Win32 (using threads on Win95 and fibers on other Win32 platforms)
KUDr
parents:
6574
diff
changeset
|
40 |
|
e31710af1ca0
(svn r9419) [NoAI] -Codechange: support AI threads also on Win32 (using threads on Win95 and fibers on other Win32 platforms)
KUDr
parents:
6574
diff
changeset
|
41 |
/** |
e31710af1ca0
(svn r9419) [NoAI] -Codechange: support AI threads also on Win32 (using threads on Win95 and fibers on other Win32 platforms)
KUDr
parents:
6574
diff
changeset
|
42 |
* Event object that is signaled manually by Set() and reset automatically when thread passes Wait(). |
e31710af1ca0
(svn r9419) [NoAI] -Codechange: support AI threads also on Win32 (using threads on Win95 and fibers on other Win32 platforms)
KUDr
parents:
6574
diff
changeset
|
43 |
*/ |
e31710af1ca0
(svn r9419) [NoAI] -Codechange: support AI threads also on Win32 (using threads on Win95 and fibers on other Win32 platforms)
KUDr
parents:
6574
diff
changeset
|
44 |
struct AutoResetEvent { |
e31710af1ca0
(svn r9419) [NoAI] -Codechange: support AI threads also on Win32 (using threads on Win95 and fibers on other Win32 platforms)
KUDr
parents:
6574
diff
changeset
|
45 |
/** Virtual destructor to allow 'delete' operator to work properly. */ |
e31710af1ca0
(svn r9419) [NoAI] -Codechange: support AI threads also on Win32 (using threads on Win95 and fibers on other Win32 platforms)
KUDr
parents:
6574
diff
changeset
|
46 |
virtual ~AutoResetEvent() {}; |
e31710af1ca0
(svn r9419) [NoAI] -Codechange: support AI threads also on Win32 (using threads on Win95 and fibers on other Win32 platforms)
KUDr
parents:
6574
diff
changeset
|
47 |
/** Set the event state to signaled so that one thread can pass the Wait() method. */ |
e31710af1ca0
(svn r9419) [NoAI] -Codechange: support AI threads also on Win32 (using threads on Win95 and fibers on other Win32 platforms)
KUDr
parents:
6574
diff
changeset
|
48 |
virtual void Set() = 0; |
e31710af1ca0
(svn r9419) [NoAI] -Codechange: support AI threads also on Win32 (using threads on Win95 and fibers on other Win32 platforms)
KUDr
parents:
6574
diff
changeset
|
49 |
/** Wait until event is signaled by calling Set() */ |
e31710af1ca0
(svn r9419) [NoAI] -Codechange: support AI threads also on Win32 (using threads on Win95 and fibers on other Win32 platforms)
KUDr
parents:
6574
diff
changeset
|
50 |
virtual void Wait() = 0; |
e31710af1ca0
(svn r9419) [NoAI] -Codechange: support AI threads also on Win32 (using threads on Win95 and fibers on other Win32 platforms)
KUDr
parents:
6574
diff
changeset
|
51 |
/** Used to construct new instance of event object. */ |
e31710af1ca0
(svn r9419) [NoAI] -Codechange: support AI threads also on Win32 (using threads on Win95 and fibers on other Win32 platforms)
KUDr
parents:
6574
diff
changeset
|
52 |
static AutoResetEvent* New(); |
e31710af1ca0
(svn r9419) [NoAI] -Codechange: support AI threads also on Win32 (using threads on Win95 and fibers on other Win32 platforms)
KUDr
parents:
6574
diff
changeset
|
53 |
}; |
e31710af1ca0
(svn r9419) [NoAI] -Codechange: support AI threads also on Win32 (using threads on Win95 and fibers on other Win32 platforms)
KUDr
parents:
6574
diff
changeset
|
54 |
|
e31710af1ca0
(svn r9419) [NoAI] -Codechange: support AI threads also on Win32 (using threads on Win95 and fibers on other Win32 platforms)
KUDr
parents:
6574
diff
changeset
|
55 |
|
2380
3b26659b4a9a
(svn r2906) Fix some threaded saving problems. Now the thread only interfaces with the main program through a sort of mutex. Communication uses the function OTTD_SendThreadMessage() with the approiate message which is handled in ProcessSentMessage() during the main loop.
Darkvater
parents:
2286
diff
changeset
|
56 |
#endif /* THREAD_H */ |