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