extensions/tf2/extension.cpp
author Nicholas Hastings <skamonkey@gmail.com>
Sat Apr 09 00:33:55 2011 -0400 (2011-04-09)
changeset 3233 21dbe3d3f620
parent 3159 608c56ebced9
child 3332 e0af1cba759f
permissions -rw-r--r--
Added forwards to TF2 ext for cond addition and removal (bug 4851, r=fyren).
dvander@1945
     1
/**
dvander@1945
     2
 * vim: set ts=4 :
dvander@1945
     3
 * =============================================================================
pred@1963
     4
 * SourceMod Team Fortress 2 Extension
skamonkey@3233
     5
 * Copyright (C) 2004-2011 AlliedModders LLC.  All rights reserved.
dvander@1945
     6
 * =============================================================================
dvander@1945
     7
 *
dvander@1945
     8
 * This program is free software; you can redistribute it and/or modify it under
dvander@1945
     9
 * the terms of the GNU General Public License, version 3.0, as published by the
dvander@1945
    10
 * Free Software Foundation.
dvander@1945
    11
 * 
dvander@1945
    12
 * This program is distributed in the hope that it will be useful, but WITHOUT
dvander@1945
    13
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
dvander@1945
    14
 * FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more
dvander@1945
    15
 * details.
dvander@1945
    16
 *
dvander@1945
    17
 * You should have received a copy of the GNU General Public License along with
dvander@1945
    18
 * this program.  If not, see <http://www.gnu.org/licenses/>.
dvander@1945
    19
 *
dvander@1945
    20
 * As a special exception, AlliedModders LLC gives you permission to link the
dvander@1945
    21
 * code of this program (as well as its derivative works) to "Half-Life 2," the
dvander@1945
    22
 * "Source Engine," the "SourcePawn JIT," and any Game MODs that run on software
dvander@1945
    23
 * by the Valve Corporation.  You must obey the GNU General Public License in
dvander@1945
    24
 * all respects for all other code used.  Additionally, AlliedModders LLC grants
dvander@1945
    25
 * this exception to all derivative works.  AlliedModders LLC defines further
dvander@1945
    26
 * exceptions, found in LICENSE.txt (as of this writing, version JULY-31-2007),
dvander@1945
    27
 * or <http://www.sourcemod.net/license.php>.
dvander@1945
    28
 *
dvander@1945
    29
 * Version: $Id$
dvander@1945
    30
 */
dvander@1945
    31
dvander@2783
    32
#include <sourcemod_version.h>
dvander@1945
    33
#include "extension.h"
pred@1963
    34
#include "util.h"
dvander@1945
    35
#include "RegNatives.h"
dvander@1945
    36
#include "iplayerinfo.h"
pred@1963
    37
#include "sm_trie_tpl.h"
pred@1979
    38
#include "criticals.h"
skamonkey@3056
    39
#include "holiday.h"
skamonkey@3233
    40
#include "conditions.h"
crimson@3151
    41
#include "gameplayrules.h"
pred@2136
    42
#include "CDetour/detours.h"
dvander@1945
    43
dvander@1945
    44
/**
dvander@1945
    45
 * @file extension.cpp
dvander@1945
    46
 * @brief Implement extension code here.
dvander@1945
    47
 */
dvander@1945
    48
dvander@1945
    49
dvander@1945
    50
TF2Tools g_TF2Tools;
dvander@1945
    51
IGameConfig *g_pGameConf = NULL;
dvander@1945
    52
dvander@1945
    53
IBinTools *g_pBinTools = NULL;
dvander@1945
    54
dvander@1945
    55
SMEXT_LINK(&g_TF2Tools);
dvander@1945
    56
pred@1979
    57
ICvar *icvar = NULL;
pred@1979
    58
pred@1963
    59
CGlobalVars *gpGlobals = NULL;
pred@1963
    60
pred@1963
    61
sm_sendprop_info_t *playerSharedOffset;
dvander@1945
    62
dvander@1945
    63
extern sp_nativeinfo_t g_TFNatives[];
dvander@1945
    64
pred@1963
    65
int g_resourceEntity;
pred@1963
    66
pred@1963
    67
SH_DECL_HOOK3_void(IServerGameDLL, ServerActivate, SH_NOATTRIB, 0, edict_t *, int , int);
pred@1963
    68
dvander@1945
    69
bool TF2Tools::SDK_OnLoad(char *error, size_t maxlength, bool late)
dvander@1945
    70
{
pred@2069
    71
	if (strcmp(g_pSM->GetGameFolderName(), "tf") != 0)
pred@2069
    72
	{
pred@2123
    73
		UTIL_Format(error, maxlength, "Cannot Load TF2 Extension on mods other than TF2");
pred@2069
    74
		return false;
pred@2069
    75
	}
pred@2069
    76
pred@1963
    77
	ServerClass *sc = UTIL_FindServerClass("CTFPlayer");
pred@1963
    78
	if (sc == NULL)
pred@1963
    79
	{
pred@2123
    80
		UTIL_Format(error, maxlength, "Could not find CTFPlayer server class");
pred@1963
    81
		return false;
pred@1963
    82
	}
pred@1963
    83
pred@1963
    84
	playerSharedOffset = new sm_sendprop_info_t;
pred@1963
    85
pred@1963
    86
	if (!UTIL_FindDataTable(sc->m_pTable, "DT_TFPlayerShared", playerSharedOffset, 0))
pred@1963
    87
	{
pred@2123
    88
		UTIL_Format(error, maxlength, "Could not find DT_TFPlayerShared data table");
pred@1963
    89
		return false;
pred@1963
    90
	}
pred@1963
    91
dvander@1945
    92
	sharesys->AddDependency(myself, "bintools.ext", true, true);
dvander@1945
    93
pred@2123
    94
	char conf_error[255] = "";
dvander@1945
    95
	if (!gameconfs->LoadGameConfigFile("sm-tf2.games", &g_pGameConf, conf_error, sizeof(conf_error)))
dvander@1945
    96
	{
pred@2600
    97
		if (conf_error[0])
dvander@1945
    98
		{
pred@2123
    99
			UTIL_Format(error, maxlength, "Could not read sm-tf2.games.txt: %s", conf_error);
dvander@1945
   100
		}
dvander@1945
   101
		return false;
dvander@1945
   102
	}
dvander@1945
   103
pred@2136
   104
	CDetourManager::Init(g_pSM->GetScriptingEngine(), g_pGameConf);
pred@2136
   105
dvander@1945
   106
	sharesys->AddNatives(myself, g_TFNatives);
dvander@1945
   107
	sharesys->RegisterLibrary(myself, "tf2");
dvander@1945
   108
pred@2619
   109
	plsys->AddPluginsListener(this);
pred@2619
   110
ds@1952
   111
	playerhelpers->RegisterCommandTargetProcessor(this);
dvander@1945
   112
pred@2136
   113
	g_critForward = forwards->CreateForward("TF2_CalcIsAttackCritical", ET_Hook, 4, NULL, Param_Cell, Param_Cell, Param_String, Param_CellByRef);
skamonkey@3056
   114
	g_getHolidayForward = forwards->CreateForward("TF2_OnGetHoliday", ET_Event, 1, NULL, Param_CellByRef);
skamonkey@3233
   115
	g_addCondForward = forwards->CreateForward("TF2_OnConditionAdded", ET_Ignore, 3, NULL, Param_Cell, Param_Cell, Param_Float);
skamonkey@3233
   116
	g_removeCondForward = forwards->CreateForward("TF2_OnConditionRemoved", ET_Ignore, 2, NULL, Param_Cell, Param_Cell);
crimson@3151
   117
	g_waitingPlayersStartForward = forwards->CreateForward("TF2_OnWaitingForPlayersStart", ET_Ignore, 0, NULL);
crimson@3151
   118
	g_waitingPlayersEndForward = forwards->CreateForward("TF2_OnWaitingForPlayersEnd", ET_Ignore, 0, NULL);
pred@1979
   119
pred@1979
   120
	g_pCVar = icvar;
dvander@1945
   121
skamonkey@3056
   122
	m_CritDetoursEnabled = false;
skamonkey@3056
   123
	m_GetHolidayDetourEnabled = false;
skamonkey@3233
   124
	m_CondChecksEnabled = false;
crimson@3151
   125
	m_RulesDetoursEnabled = false;
pred@2619
   126
dvander@1945
   127
	return true;
dvander@1945
   128
}
dvander@1945
   129
dvander@2790
   130
const char *TF2Tools::GetExtensionVerString()
dvander@2783
   131
{
dvander@2783
   132
	return SM_FULL_VERSION;
dvander@2783
   133
}
dvander@2783
   134
dvander@2790
   135
const char *TF2Tools::GetExtensionDateString()
dvander@2783
   136
{
dvander@2783
   137
	return SM_BUILD_TIMESTAMP;
dvander@2783
   138
}
dvander@2783
   139
dvander@1945
   140
bool TF2Tools::SDK_OnMetamodLoad(ISmmAPI *ismm, char *error, size_t maxlen, bool late)
dvander@1945
   141
{
dvander@1945
   142
	GET_V_IFACE_CURRENT(GetEngineFactory, engine, IVEngineServer, INTERFACEVERSION_VENGINESERVER);
dvander@1945
   143
pred@1963
   144
	gpGlobals = ismm->GetCGlobals();
pred@1963
   145
pred@1963
   146
	SH_ADD_HOOK(IServerGameDLL, ServerActivate, gamedll, SH_STATIC(OnServerActivate), true);
pred@1963
   147
pred@1979
   148
	GET_V_IFACE_CURRENT(GetEngineFactory, icvar, ICvar, CVAR_INTERFACE_VERSION);
pred@1979
   149
pred@1979
   150
	GET_V_IFACE_CURRENT(GetServerFactory, gameents, IServerGameEnts, INTERFACEVERSION_SERVERGAMEENTS);
pred@1979
   151
pred@2075
   152
	GET_V_IFACE_CURRENT(GetEngineFactory, m_GameEventManager, IGameEventManager2, INTERFACEVERSION_GAMEEVENTSMANAGER2);
pred@2075
   153
	m_GameEventManager->AddListener(this, "teamplay_restart_round", true);
pred@2075
   154
dvander@1945
   155
	return true;
dvander@1945
   156
}
dvander@1945
   157
dvander@1945
   158
void TF2Tools::SDK_OnUnload()
dvander@1945
   159
{
pred@1963
   160
	SH_REMOVE_HOOK(IServerGameDLL, ServerActivate, gamedll, SH_STATIC(OnServerActivate), true);
pred@1963
   161
dvander@1945
   162
	g_RegNatives.UnregisterAll();
dvander@1945
   163
	gameconfs->CloseGameConfigFile(g_pGameConf);
pred@1963
   164
	playerhelpers->UnregisterCommandTargetProcessor(this);
pred@2136
   165
pred@2619
   166
	plsys->RemovePluginsListener(this);
pred@2136
   167
pred@2619
   168
	forwards->ReleaseForward(g_critForward);
skamonkey@3056
   169
	forwards->ReleaseForward(g_getHolidayForward);
skamonkey@3233
   170
	forwards->ReleaseForward(g_addCondForward);
skamonkey@3233
   171
	forwards->ReleaseForward(g_removeCondForward);
crimson@3151
   172
	forwards->ReleaseForward(g_waitingPlayersStartForward);
crimson@3151
   173
	forwards->ReleaseForward(g_waitingPlayersEndForward);
dvander@1945
   174
}
dvander@1945
   175
dvander@1945
   176
void TF2Tools::SDK_OnAllLoaded()
dvander@1945
   177
{
dvander@1945
   178
	SM_GET_LATE_IFACE(BINTOOLS, g_pBinTools);
ds@1952
   179
}
ds@1952
   180
pred@1979
   181
bool TF2Tools::RegisterConCommandBase(ConCommandBase *pVar)
pred@1979
   182
{
pred@1979
   183
	return g_SMAPI->RegisterConCommandBase(g_PLAPI, pVar);
pred@1979
   184
}
pred@1979
   185
pred@2075
   186
void TF2Tools::FireGameEvent( IGameEvent *event )
pred@2075
   187
{
pred@2075
   188
	timersys->NotifyOfGameStart();
pred@2075
   189
	timersys->MapTimeLeftChanged();
dvander@1945
   190
}
dvander@1945
   191
dvander@1945
   192
bool TF2Tools::QueryRunning(char *error, size_t maxlength)
dvander@1945
   193
{
dvander@1945
   194
	SM_CHECK_IFACE(BINTOOLS, g_pBinTools);
dvander@1945
   195
dvander@1945
   196
	return true;
dvander@1945
   197
}
dvander@1945
   198
dvander@1945
   199
bool TF2Tools::QueryInterfaceDrop(SMInterface *pInterface)
dvander@1945
   200
{
dvander@1945
   201
	if (pInterface == g_pBinTools)
dvander@1945
   202
	{
dvander@1945
   203
		return false;
dvander@1945
   204
	}
dvander@1945
   205
dvander@1945
   206
	return IExtensionInterface::QueryInterfaceDrop(pInterface);
dvander@1945
   207
}
dvander@1945
   208
dvander@1945
   209
void TF2Tools::NotifyInterfaceDrop(SMInterface *pInterface)
dvander@1945
   210
{
dvander@1945
   211
	g_RegNatives.UnregisterAll();
dvander@1945
   212
}
dvander@1945
   213
pred@1963
   214
void OnServerActivate(edict_t *pEdictList, int edictCount, int clientMax)
dvander@1945
   215
{
pred@1963
   216
	g_resourceEntity = FindResourceEntity();
pred@1963
   217
}
dvander@1945
   218
dvander@1945
   219
bool TF2Tools::ProcessCommandTarget(cmd_target_info_t *info)
dvander@1945
   220
{
dvander@1945
   221
	int max_clients;
dvander@1945
   222
	IPlayerInfo *pInfo;
dvander@1945
   223
	unsigned int team_index = 0;
dvander@1945
   224
	IGamePlayer *pPlayer, *pAdmin;
dvander@1945
   225
dvander@1945
   226
	if ((info->flags & COMMAND_FILTER_NO_MULTI) == COMMAND_FILTER_NO_MULTI)
dvander@1945
   227
	{
dvander@1945
   228
		return false;
dvander@1945
   229
	}
dvander@1945
   230
dvander@1945
   231
	if (info->admin)
dvander@1945
   232
	{
dvander@1945
   233
		if ((pAdmin = playerhelpers->GetGamePlayer(info->admin)) == NULL)
dvander@1945
   234
		{
dvander@1945
   235
			return false;
dvander@1945
   236
		}
dvander@1945
   237
		if (!pAdmin->IsInGame())
dvander@1945
   238
		{
dvander@1945
   239
			return false;
dvander@1945
   240
		}
dvander@1945
   241
	}
dvander@1945
   242
	else
dvander@1945
   243
	{
dvander@1945
   244
		pAdmin = NULL;
dvander@1945
   245
	}
dvander@1945
   246
dvander@1945
   247
	if (strcmp(info->pattern, "@red") == 0 )
dvander@1945
   248
	{
dvander@1945
   249
		team_index = 2;
dvander@1945
   250
	}
dvander@1945
   251
	else if (strcmp(info->pattern, "@blue") == 0)
dvander@1945
   252
	{
dvander@1945
   253
		team_index = 3;
dvander@1945
   254
	}
dvander@1945
   255
	else
dvander@1945
   256
	{
dvander@1945
   257
		return false;
dvander@1945
   258
	}
dvander@1945
   259
dvander@1945
   260
	info->num_targets = 0;
dvander@1945
   261
dvander@1945
   262
	max_clients = playerhelpers->GetMaxClients();
dvander@1945
   263
	for (int i = 1; 
dvander@1945
   264
		 i <= max_clients && (cell_t)info->num_targets < info->max_targets; 
dvander@1945
   265
		 i++)
dvander@1945
   266
	{
dvander@1945
   267
		if ((pPlayer = playerhelpers->GetGamePlayer(i)) == NULL)
dvander@1945
   268
		{
dvander@1945
   269
			continue;
dvander@1945
   270
		}
dvander@1945
   271
		if (!pPlayer->IsInGame())
dvander@1945
   272
		{
dvander@1945
   273
			continue;
dvander@1945
   274
		}
dvander@1945
   275
		if ((pInfo = pPlayer->GetPlayerInfo()) == NULL)
dvander@1945
   276
		{
dvander@1945
   277
			continue;
dvander@1945
   278
		}
dvander@1945
   279
		if (pInfo->GetTeamIndex() != (int)team_index)
dvander@1945
   280
		{
dvander@1945
   281
			continue;
dvander@1945
   282
		}
dvander@1945
   283
		if (playerhelpers->FilterCommandTarget(pAdmin, pPlayer, info->flags) 
dvander@1945
   284
			!= COMMAND_TARGET_VALID)
dvander@1945
   285
		{
dvander@1945
   286
			continue;
dvander@1945
   287
		}
dvander@1945
   288
		info->targets[info->num_targets] = i;
dvander@1945
   289
		info->num_targets++;
dvander@1945
   290
	}
dvander@1945
   291
dvander@1945
   292
	if (info->num_targets == 0)
dvander@1945
   293
	{
dvander@1945
   294
		info->reason = COMMAND_TARGET_EMPTY_FILTER;
dvander@1945
   295
	}
dvander@1945
   296
	else
dvander@1945
   297
	{
dvander@1945
   298
		info->reason = COMMAND_TARGET_VALID;
dvander@1945
   299
	}
dvander@1945
   300
dvander@1945
   301
	info->target_name_style = COMMAND_TARGETNAME_RAW;
dvander@1945
   302
	if (team_index == 2)
dvander@1945
   303
	{
dvander@1945
   304
		UTIL_Format(info->target_name, info->target_name_maxlength, "Red Team");
dvander@1945
   305
	}
dvander@1945
   306
	else if (team_index == 3)
dvander@1945
   307
	{
dvander@1945
   308
		UTIL_Format(info->target_name, info->target_name_maxlength, "Blue Team");
dvander@1945
   309
	}
dvander@1945
   310
dvander@1945
   311
	return true;
dvander@1945
   312
}
dvander@1945
   313
pred@2619
   314
void TF2Tools::OnPluginLoaded(IPlugin *plugin)
pred@2619
   315
{
skamonkey@3056
   316
	if (!m_CritDetoursEnabled && g_critForward->GetFunctionCount())
pred@2619
   317
	{
skamonkey@3159
   318
		m_CritDetoursEnabled = InitialiseCritDetours();
skamonkey@3056
   319
	}
skamonkey@3159
   320
skamonkey@3056
   321
	if (!m_GetHolidayDetourEnabled && g_getHolidayForward->GetFunctionCount())
skamonkey@3056
   322
	{
skamonkey@3159
   323
		m_GetHolidayDetourEnabled = InitialiseGetHolidayDetour();
pred@2619
   324
	}
skamonkey@3159
   325
skamonkey@3233
   326
	if (!m_CondChecksEnabled
skamonkey@3233
   327
		&& ( g_addCondForward->GetFunctionCount() || g_removeCondForward->GetFunctionCount() )
skamonkey@3233
   328
		)
skamonkey@3233
   329
	{
skamonkey@3233
   330
		m_CondChecksEnabled = InitialiseConditionDetours();
skamonkey@3233
   331
	}
skamonkey@3233
   332
skamonkey@3159
   333
	if (!m_RulesDetoursEnabled
skamonkey@3159
   334
		&& ( g_waitingPlayersStartForward->GetFunctionCount() || g_waitingPlayersEndForward->GetFunctionCount() )
skamonkey@3159
   335
		)
crimson@3151
   336
	{
skamonkey@3159
   337
		m_RulesDetoursEnabled = InitialiseRulesDetours();
crimson@3151
   338
	}
pred@2619
   339
}
pred@2619
   340
pred@2619
   341
void TF2Tools::OnPluginUnloaded(IPlugin *plugin)
pred@2619
   342
{
skamonkey@3056
   343
	if (m_CritDetoursEnabled && !g_critForward->GetFunctionCount())
pred@2619
   344
	{
skamonkey@3056
   345
		RemoveCritDetours();
skamonkey@3056
   346
		m_CritDetoursEnabled = false;
skamonkey@3056
   347
	}
skamonkey@3056
   348
	if (m_GetHolidayDetourEnabled && !g_getHolidayForward->GetFunctionCount())
skamonkey@3056
   349
	{
skamonkey@3056
   350
		RemoveGetHolidayDetour();
skamonkey@3056
   351
		m_GetHolidayDetourEnabled = false;
pred@2619
   352
	}
skamonkey@3233
   353
	if (m_CondChecksEnabled)
skamonkey@3233
   354
	{
skamonkey@3233
   355
		if (!g_addCondForward->GetFunctionCount() && !g_removeCondForward->GetFunctionCount())
skamonkey@3233
   356
		{
skamonkey@3233
   357
			RemoveConditionDetours();
skamonkey@3233
   358
			m_CondChecksEnabled = false;
skamonkey@3233
   359
		}
skamonkey@3233
   360
	}
crimson@3151
   361
	if (m_RulesDetoursEnabled)
crimson@3151
   362
	{
skamonkey@3159
   363
		if (!g_waitingPlayersStartForward->GetFunctionCount() && !g_waitingPlayersEndForward->GetFunctionCount())
crimson@3151
   364
		{
crimson@3151
   365
			RemoveRulesDetours();
crimson@3151
   366
			m_RulesDetoursEnabled = false;
crimson@3151
   367
		}
crimson@3151
   368
	}
pred@2619
   369
}
pred@1963
   370
int FindResourceEntity()
pred@1963
   371
{
pred@1963
   372
	return FindEntityByNetClass(-1, "CTFPlayerResource");
pred@1963
   373
}
pred@1963
   374
pred@1963
   375
pred@1963
   376
int FindEntityByNetClass(int start, const char *classname)
pred@1963
   377
{
pred@1963
   378
	edict_t *current;
pred@1963
   379
pred@1963
   380
	for (int i = ((start != -1) ? start : 0); i < gpGlobals->maxEntities; i++)
pred@1963
   381
	{
pred@1963
   382
		current = engine->PEntityOfEntIndex(i);
pred@1963
   383
		if (current == NULL)
pred@1963
   384
		{
pred@1963
   385
			continue;
pred@1963
   386
		}
pred@1963
   387
pred@1963
   388
		IServerNetworkable *network = current->GetNetworkable();
pred@1963
   389
pred@1963
   390
		if (network == NULL)
pred@1963
   391
		{
pred@1963
   392
			continue;
pred@1963
   393
		}
pred@1963
   394
pred@1963
   395
		ServerClass *sClass = network->GetServerClass();
pred@1963
   396
		const char *name = sClass->GetName();
pred@1963
   397
		
pred@1963
   398
pred@1963
   399
		if (strcmp(name, classname) == 0)
pred@1963
   400
		{
pred@1963
   401
			return i;
pred@1963
   402
		}
pred@1963
   403
	}
pred@1963
   404
pred@1963
   405
	return -1;
pred@1963
   406
}
pred@1963
   407
pred@1963
   408
TFClassType ClassnameToType(const char *classname)
pred@1963
   409
{
pred@1963
   410
	static KTrie<TFClassType> trie;
pred@1963
   411
	static bool filled = false;
pred@1963
   412
	
pred@1963
   413
	if (!filled)
pred@1963
   414
	{
pred@1963
   415
		trie.insert("scout", TFClass_Scout);
pred@1963
   416
		trie.insert("sniper", TFClass_Sniper);
pred@1963
   417
		trie.insert("soldier", TFClass_Soldier);
pred@1963
   418
		trie.insert("demoman", TFClass_DemoMan);
pred@1963
   419
		trie.insert("demo", TFClass_DemoMan);
pred@1963
   420
		trie.insert("medic", TFClass_Medic);
pred@1963
   421
		trie.insert("heavy", TFClass_Heavy);
pred@1963
   422
		trie.insert("hwg", TFClass_Heavy);
pred@1963
   423
		trie.insert("pyro", TFClass_Pyro);
pred@1963
   424
		trie.insert("spy", TFClass_Spy);
pred@1963
   425
		trie.insert("engineer", TFClass_Engineer);
pred@1963
   426
		trie.insert("engy", TFClass_Engineer);
pred@1963
   427
pred@1963
   428
		filled = true;	
pred@1963
   429
	}
pred@1963
   430
	
pred@1963
   431
	TFClassType *value;
pred@1963
   432
pred@1963
   433
	if (!(value = trie.retrieve(classname)))
pred@1963
   434
	{
pred@1963
   435
		return TFClass_Unknown;	
pred@1963
   436
	}
pred@1963
   437
pred@1963
   438
	return *value;
pred@1963
   439
}
pred@1963
   440
pred@1963
   441
pred@1963
   442
pred@1963
   443
/**
pred@1963
   444
 * A picture of a blue crab given to me as a gift and stored here for safe keeping
pred@1963
   445
 *
pred@1963
   446
 * http://www.democracycellproject.net/blog/archives/Clown%20car.jpg
pred@1963
   447
 */
pred@1963
   448