core/thread/ThreadWorker.cpp
author David Anderson <dvander@alliedmods.net>
Wed Aug 01 02:12:47 2007 +0000 (2007-08-01)
changeset 1231 17badaf66ce4
parent 1090 5c54e353c019
child 1330 ab94316bb52b
permissions -rw-r--r--
updated more header files (mostly internal now)
dvander@1084
     1
/**
dvander@1084
     2
 * vim: set ts=4 :
dvander@1231
     3
 * ================================================================
dvander@1231
     4
 * SourceMod
dvander@1231
     5
 * Copyright (C) 2004-2007 AlliedModders LLC.  All rights reserved.
dvander@1231
     6
 * ================================================================
dvander@1084
     7
 *
dvander@1231
     8
 * This program is free software; you can redistribute it and/or 
dvander@1231
     9
 * modify it under the terms of the GNU General Public License, 
dvander@1231
    10
 * version 3.0, as published by the Free Software Foundation.
dvander@1231
    11
 * 
dvander@1231
    12
 * This program is distributed in the hope that it will be useful,
dvander@1231
    13
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
dvander@1231
    14
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
dvander@1231
    15
 * GNU General Public License for more details.
dvander@1231
    16
 *
dvander@1231
    17
 * You should have received a copy of the GNU General Public License
dvander@1231
    18
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
dvander@1231
    19
 *
dvander@1231
    20
 * As a special exception, AlliedModders LLC gives you permission to 
dvander@1231
    21
 * link the code of this program (as well as its derivative works) to 
dvander@1231
    22
 * "Half-Life 2," the "Source Engine," the "SourcePawn JIT," and any 
dvander@1231
    23
 * Game MODs that run on software by the Valve Corporation.  You must 
dvander@1231
    24
 * obey the GNU General Public License in all respects for all other 
dvander@1231
    25
 * code used. Additionally, AlliedModders LLC grants this exception 
dvander@1231
    26
 * to all derivative works. AlliedModders LLC defines further 
dvander@1231
    27
 * exceptions, found in LICENSE.txt (as of this writing, version 
dvander@1231
    28
 * JULY-31-2007), or <http://www.sourcemod.net/license.php>.
dvander@1084
    29
 *
dvander@1084
    30
 * Version: $Id$
dvander@1084
    31
 */
dvander@1084
    32
dvander@1084
    33
#include "ThreadWorker.h"
dvander@1084
    34
dvander@1090
    35
ThreadWorker::ThreadWorker(IThreadWorkerCallbacks *hooks) : BaseWorker(hooks),
dvander@1084
    36
	m_Threader(NULL),
dvander@1084
    37
	m_QueueLock(NULL),
dvander@1084
    38
	m_StateLock(NULL),
dvander@1084
    39
	m_PauseSignal(NULL),
dvander@1084
    40
	m_AddSignal(NULL),
dvander@1084
    41
	me(NULL),
dvander@1084
    42
	m_think_time(DEFAULT_THINK_TIME_MS)
dvander@1084
    43
{
dvander@1084
    44
	m_state = Worker_Invalid;
dvander@1084
    45
}
dvander@1084
    46
dvander@1090
    47
ThreadWorker::ThreadWorker(IThreadWorkerCallbacks *hooks, IThreader *pThreader, unsigned int thinktime) : 
dvander@1090
    48
	BaseWorker(hooks),
dvander@1084
    49
	m_Threader(pThreader),
dvander@1084
    50
	m_QueueLock(NULL),
dvander@1084
    51
	m_StateLock(NULL),
dvander@1084
    52
	m_PauseSignal(NULL),
dvander@1084
    53
	m_AddSignal(NULL),
dvander@1084
    54
	me(NULL),
dvander@1084
    55
	m_think_time(thinktime)
dvander@1084
    56
{
dvander@1084
    57
	if (m_Threader)
dvander@1084
    58
	{
dvander@1084
    59
		m_state = Worker_Stopped;
dvander@1084
    60
	} else {
dvander@1084
    61
		m_state = Worker_Invalid;
dvander@1084
    62
	}
dvander@1084
    63
}
dvander@1084
    64
dvander@1084
    65
ThreadWorker::~ThreadWorker()
dvander@1084
    66
{
dvander@1084
    67
	if (m_state != Worker_Stopped || m_state != Worker_Invalid)
dvander@1090
    68
	{
dvander@1084
    69
		Stop(true);
dvander@1090
    70
	}
dvander@1084
    71
dvander@1084
    72
	if (m_ThreadQueue.size())
dvander@1090
    73
	{
dvander@1084
    74
		Flush(true);
dvander@1090
    75
	}
dvander@1084
    76
}
dvander@1084
    77
dvander@1084
    78
void ThreadWorker::OnTerminate(IThreadHandle *pHandle, bool cancel)
dvander@1084
    79
{
dvander@1084
    80
	//we don't particularly care
dvander@1084
    81
	return;
dvander@1084
    82
}
dvander@1084
    83
dvander@1084
    84
void ThreadWorker::RunThread(IThreadHandle *pHandle)
dvander@1084
    85
{
dvander@1084
    86
	WorkerState this_state = Worker_Running;
dvander@1084
    87
	size_t num;
dvander@1090
    88
dvander@1090
    89
	if (m_pHooks)
dvander@1090
    90
	{
dvander@1090
    91
		m_pHooks->OnWorkerStart(this);
dvander@1090
    92
	}
dvander@1084
    93
    
dvander@1084
    94
	while (true)
dvander@1084
    95
	{
dvander@1084
    96
		/**
dvander@1084
    97
		 * Check number of items in the queue
dvander@1084
    98
		 */
dvander@1084
    99
		m_StateLock->Lock();
dvander@1084
   100
		this_state = m_state;
dvander@1084
   101
		m_StateLock->Unlock();
dvander@1084
   102
		if (this_state != Worker_Stopped)
dvander@1084
   103
		{
dvander@1084
   104
			m_QueueLock->Lock();
dvander@1084
   105
			num = m_ThreadQueue.size();
dvander@1084
   106
			if (!num)
dvander@1084
   107
			{
dvander@1084
   108
				/** 
dvander@1084
   109
				 * if none, wait for an item
dvander@1084
   110
				 */
dvander@1084
   111
				m_Waiting = true;
dvander@1084
   112
				m_QueueLock->Unlock();
dvander@1084
   113
				/* first check if we should end again */
dvander@1084
   114
				if (this_state == Worker_Stopped)
dvander@1084
   115
				{
dvander@1084
   116
					break;
dvander@1084
   117
				}
dvander@1084
   118
				m_AddSignal->Wait();
dvander@1084
   119
				m_Waiting = false;
dvander@1084
   120
			} else {
dvander@1084
   121
				m_QueueLock->Unlock();
dvander@1084
   122
			}
dvander@1084
   123
		}
dvander@1084
   124
		m_StateLock->Lock();
dvander@1084
   125
		this_state = m_state;
dvander@1084
   126
		m_StateLock->Unlock();
dvander@1084
   127
		if (this_state != Worker_Running)
dvander@1084
   128
		{
dvander@1084
   129
			if (this_state == Worker_Paused || this_state == Worker_Stopped)
dvander@1084
   130
			{
dvander@1084
   131
				//wait until the lock is cleared.
dvander@1084
   132
				if (this_state == Worker_Paused)
dvander@1084
   133
				{
dvander@1084
   134
					m_PauseSignal->Wait();
dvander@1084
   135
				}
dvander@1084
   136
				if (this_state == Worker_Stopped)
dvander@1084
   137
				{
dvander@1084
   138
					//if we're supposed to flush cleanrly, 
dvander@1084
   139
					// run all of the remaining frames first.
dvander@1084
   140
					if (!m_FlushType)
dvander@1084
   141
					{
dvander@1084
   142
						while (m_ThreadQueue.size())
dvander@1090
   143
						{
dvander@1084
   144
							RunFrame();
dvander@1090
   145
						}
dvander@1084
   146
					}
dvander@1084
   147
					break;
dvander@1084
   148
				}
dvander@1084
   149
			}
dvander@1084
   150
		}
dvander@1084
   151
		/**
dvander@1084
   152
		 * Run the frame.
dvander@1084
   153
		 */
dvander@1084
   154
		RunFrame();
dvander@1084
   155
dvander@1084
   156
		/**
dvander@1084
   157
		 * wait in between threads if specified
dvander@1084
   158
		 */
dvander@1084
   159
		if (m_think_time)
dvander@1090
   160
		{
dvander@1084
   161
			m_Threader->ThreadSleep(m_think_time);
dvander@1090
   162
		}
dvander@1090
   163
	}
dvander@1090
   164
dvander@1090
   165
	if (m_pHooks)
dvander@1090
   166
	{
dvander@1090
   167
		m_pHooks->OnWorkerStop(this);
dvander@1084
   168
	}
dvander@1084
   169
}
dvander@1084
   170
dvander@1084
   171
SWThreadHandle *ThreadWorker::PopThreadFromQueue()
dvander@1084
   172
{
dvander@1084
   173
	if (m_state <= Worker_Stopped && !m_QueueLock)
dvander@1090
   174
	{
dvander@1084
   175
		return NULL;
dvander@1090
   176
	}
dvander@1084
   177
dvander@1084
   178
	SWThreadHandle *swt;
dvander@1084
   179
	m_QueueLock->Lock();
dvander@1084
   180
	swt = BaseWorker::PopThreadFromQueue();
dvander@1084
   181
	m_QueueLock->Unlock();
dvander@1084
   182
dvander@1084
   183
	return swt;
dvander@1084
   184
}
dvander@1084
   185
dvander@1084
   186
void ThreadWorker::AddThreadToQueue(SWThreadHandle *pHandle)
dvander@1084
   187
{
dvander@1084
   188
	if (m_state <= Worker_Stopped)
dvander@1090
   189
	{
dvander@1084
   190
		return;
dvander@1090
   191
	}
dvander@1084
   192
dvander@1084
   193
	m_QueueLock->Lock();
dvander@1084
   194
	BaseWorker::AddThreadToQueue(pHandle);
dvander@1084
   195
	if (m_Waiting)
dvander@1084
   196
	{
dvander@1084
   197
		m_AddSignal->Signal();
dvander@1084
   198
	}
dvander@1084
   199
	m_QueueLock->Unlock();
dvander@1084
   200
}
dvander@1084
   201
dvander@1084
   202
WorkerState ThreadWorker::GetStatus(unsigned int *threads)
dvander@1084
   203
{
dvander@1084
   204
	WorkerState state;
dvander@1084
   205
dvander@1084
   206
	m_StateLock->Lock();
dvander@1084
   207
	state = BaseWorker::GetStatus(threads);
dvander@1084
   208
	m_StateLock->Unlock();
dvander@1084
   209
dvander@1084
   210
	return state;
dvander@1084
   211
}
dvander@1084
   212
dvander@1084
   213
bool ThreadWorker::Start()
dvander@1084
   214
{
dvander@1084
   215
	if (m_state == Worker_Invalid)
dvander@1084
   216
	{
dvander@1084
   217
		if (m_Threader == NULL)
dvander@1090
   218
		{
dvander@1084
   219
			return false;
dvander@1090
   220
		}
dvander@1084
   221
	} else if (m_state != Worker_Stopped) {
dvander@1084
   222
		return false;
dvander@1084
   223
	}
dvander@1084
   224
dvander@1084
   225
	m_Waiting = false;
dvander@1084
   226
	m_QueueLock = m_Threader->MakeMutex();
dvander@1084
   227
	m_StateLock = m_Threader->MakeMutex();
dvander@1084
   228
	m_PauseSignal = m_Threader->MakeEventSignal();
dvander@1084
   229
	m_AddSignal = m_Threader->MakeEventSignal();
dvander@1084
   230
	m_state = Worker_Running;
dvander@1084
   231
	ThreadParams pt;
dvander@1084
   232
	pt.flags = Thread_Default;
dvander@1084
   233
	pt.prio = ThreadPrio_Normal;
dvander@1084
   234
	me = m_Threader->MakeThread(this, &pt);
dvander@1084
   235
dvander@1084
   236
	return true;
dvander@1084
   237
}
dvander@1084
   238
dvander@1084
   239
bool ThreadWorker::Stop(bool flush_cancel)
dvander@1084
   240
{
dvander@1084
   241
	if (m_state == Worker_Invalid || m_state == Worker_Stopped)
dvander@1090
   242
	{
dvander@1084
   243
		return false;
dvander@1090
   244
	}
dvander@1084
   245
dvander@1084
   246
	WorkerState oldstate;
dvander@1084
   247
dvander@1084
   248
	//set new state
dvander@1084
   249
	m_StateLock->Lock();
dvander@1084
   250
	oldstate = m_state;
dvander@1084
   251
	m_state = Worker_Stopped;
dvander@1084
   252
	m_FlushType = flush_cancel;
dvander@1084
   253
	m_StateLock->Unlock();
dvander@1084
   254
dvander@1084
   255
	if (oldstate == Worker_Paused)
dvander@1084
   256
	{
dvander@1084
   257
		Unpause();
dvander@1084
   258
	} else {
dvander@1084
   259
		m_QueueLock->Lock();
dvander@1084
   260
		if (m_Waiting)
dvander@1084
   261
		{
dvander@1084
   262
			m_AddSignal->Signal();
dvander@1084
   263
		}
dvander@1084
   264
		m_QueueLock->Unlock();
dvander@1084
   265
	}
dvander@1084
   266
dvander@1084
   267
	me->WaitForThread();
dvander@1084
   268
	//destroy it
dvander@1084
   269
	me->DestroyThis();
dvander@1084
   270
	//flush all remaining events
dvander@1084
   271
	Flush(true);
dvander@1084
   272
dvander@1084
   273
	//free mutex locks
dvander@1084
   274
	m_QueueLock->DestroyThis();
dvander@1084
   275
	m_StateLock->DestroyThis();
dvander@1084
   276
	m_PauseSignal->DestroyThis();
dvander@1084
   277
	m_AddSignal->DestroyThis();
dvander@1084
   278
dvander@1084
   279
	//invalidizzle
dvander@1084
   280
	m_QueueLock = NULL;
dvander@1084
   281
	m_StateLock = NULL;
dvander@1084
   282
	m_PauseSignal = NULL;
dvander@1084
   283
	m_AddSignal = NULL;
dvander@1084
   284
	me = NULL;
dvander@1084
   285
dvander@1084
   286
	return true;
dvander@1084
   287
}
dvander@1084
   288
dvander@1084
   289
bool ThreadWorker::Pause()
dvander@1084
   290
{
dvander@1084
   291
	if (m_state != Worker_Running)
dvander@1090
   292
	{
dvander@1084
   293
		return false;
dvander@1090
   294
	}
dvander@1084
   295
dvander@1084
   296
	m_StateLock->Lock();
dvander@1084
   297
	m_state = Worker_Paused;
dvander@1084
   298
	m_StateLock->Unlock();
dvander@1084
   299
dvander@1084
   300
	return true;
dvander@1084
   301
}
dvander@1084
   302
dvander@1084
   303
dvander@1084
   304
bool ThreadWorker::Unpause()
dvander@1084
   305
{
dvander@1084
   306
	if (m_state != Worker_Paused)
dvander@1090
   307
	{
dvander@1084
   308
		return false;
dvander@1090
   309
	}
dvander@1084
   310
dvander@1084
   311
	m_StateLock->Lock();
dvander@1084
   312
	m_state = Worker_Running;
dvander@1084
   313
	m_StateLock->Unlock();
dvander@1084
   314
	m_PauseSignal->Signal();
dvander@1084
   315
	if (m_Waiting)
dvander@1084
   316
	{
dvander@1084
   317
		m_AddSignal->Signal();
dvander@1084
   318
	}
dvander@1084
   319
dvander@1084
   320
	return true;
dvander@1084
   321
}