Build against MM:S 1.10.
2 * vim: set ts=4 sw=4 tw=99 noet :
3 * =============================================================================
5 * Copyright (C) 2004-2008 AlliedModders LLC. All rights reserved.
6 * =============================================================================
8 * This program is free software; you can redistribute it and/or modify it under
9 * the terms of the GNU General Public License, version 3.0, as published by the
10 * Free Software Foundation.
12 * This program is distributed in the hope that it will be useful, but WITHOUT
13 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
14 * FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
17 * You should have received a copy of the GNU General Public License along with
18 * this program. If not, see <http://www.gnu.org/licenses/>.
20 * As a special exception, AlliedModders LLC gives you permission to link the
21 * code of this program (as well as its derivative works) to "Half-Life 2," the
22 * "Source Engine," the "SourcePawn JIT," and any Game MODs that run on software
23 * by the Valve Corporation. You must obey the GNU General Public License in
24 * all respects for all other code used. Additionally, AlliedModders LLC grants
25 * this exception to all derivative works. AlliedModders LLC defines further
26 * exceptions, found in LICENSE.txt (as of this writing, version JULY-31-2007),
27 * or <http://www.sourcemod.net/license.php>.
35 #include "ForwardSys.h"
36 #include "logic_bridge.h"
38 CForwardManager g_Forwards;
41 * Genesis turns to its source, reduction occurs stepwise although the essence is all one.
42 * End of line. FTL system check.
44 * :TODO: WHAT NEEDS TO BE TESTED IN THIS BEAST
46 * - Pushing no varargs
49 // :TODO: IMPORTANT!!! The result pointer arg in the execute function maybe invalid if the forward fails
50 // so later evaluation of this result may cause problems on higher levels of abstraction. DOCUMENT OR FIX ALL FORWARDS!
52 CForwardManager::~CForwardManager()
54 CStack<CForward *>::iterator iter;
55 for (iter=m_FreeForwards.begin(); iter!=m_FreeForwards.end(); iter++)
59 m_FreeForwards.popall();
62 void CForwardManager::OnSourceModAllInitialized()
64 scripts->AddPluginsListener(this);
65 sharesys->AddInterface(NULL, this);
68 IForward *CForwardManager::CreateForward(const char *name, ExecType et, unsigned int num_params, const ParamType *types, ...)
74 fwd = CForward::CreateForward(name, et, num_params, types, ap);
80 scripts->AddFunctionsToForward(name, fwd);
82 m_managed.push_back(fwd);
88 IChangeableForward *CForwardManager::CreateForwardEx(const char *name, ExecType et, int num_params, const ParamType *types, ...)
94 fwd = CForward::CreateForward(name, et, num_params, types, ap);
100 m_unmanaged.push_back(fwd);
106 void CForwardManager::OnPluginLoaded(IPlugin *plugin)
108 /* Attach any globally managed forwards */
109 List<CForward *>::iterator iter;
112 for (iter=m_managed.begin(); iter!=m_managed.end(); iter++)
115 IPluginFunction *pFunc = plugin->GetBaseContext()->GetFunctionByName(fwd->GetForwardName());
118 fwd->AddFunction(pFunc);
123 void CForwardManager::OnPluginUnloaded(IPlugin *plugin)
125 List<CForward *>::iterator iter;
128 for (iter=m_managed.begin(); iter!=m_managed.end(); iter++)
131 fwd->RemoveFunctionsOfPlugin(plugin);
134 for (iter=m_unmanaged.begin(); iter!=m_unmanaged.end(); iter++)
137 fwd->RemoveFunctionsOfPlugin(plugin);
141 IForward *CForwardManager::FindForward(const char *name, IChangeableForward **ifchng)
143 List<CForward *>::iterator iter;
146 for (iter=m_managed.begin(); iter!=m_managed.end(); iter++)
149 if (strcmp(fwd->GetForwardName(), name) == 0)
159 for (iter=m_unmanaged.begin(); iter!=m_unmanaged.end(); iter++)
162 if (strcmp(fwd->GetForwardName(), name) == 0)
180 void CForwardManager::ReleaseForward(IForward *forward)
182 ForwardFree(static_cast<CForward *>(forward));
185 void CForwardManager::ForwardFree(CForward *fwd)
192 m_FreeForwards.push(fwd);
193 m_managed.remove(fwd);
196 CForward *CForwardManager::ForwardMake()
199 if (m_FreeForwards.empty())
203 fwd = m_FreeForwards.front();
204 m_FreeForwards.pop();
209 void CForwardManager::OnPluginPauseChange(IPlugin *plugin, bool paused)
214 /*************************************
215 * ACTUAL FORWARD API IMPLEMENTATION *
216 *************************************/
218 CForward *CForward::CreateForward(const char *name, ExecType et, unsigned int num_params, const ParamType *types, va_list ap)
220 ParamType _types[SP_MAX_EXEC_PARAMS];
222 if (num_params > SP_MAX_EXEC_PARAMS)
227 if (types == NULL && num_params)
229 for (unsigned int i=0; i<num_params; i++)
231 _types[i] = (ParamType)va_arg(ap, int);
232 if (_types[i] == Param_VarArgs && (i != num_params - 1))
239 for (unsigned int i=0; i<num_params; i++)
241 _types[i] = types[i];
242 if (types[i] == Param_VarArgs && (i != num_params - 1))
249 /* First parameter can never be varargs */
250 if (num_params && _types[0] == Param_VarArgs)
255 CForward *pForward = g_Forwards.ForwardMake();
256 pForward->m_IterGuard = NULL;
257 pForward->m_curparam = 0;
258 pForward->m_ExecType = et;
259 snprintf(pForward->m_name, FORWARDS_NAME_MAX, "%s", name ? name : "");
261 for (unsigned int i=0; i<num_params; i++)
263 pForward->m_types[i] = _types[i];
266 if (num_params && _types[num_params-1] == Param_VarArgs)
268 pForward->m_varargs = num_params--;
270 pForward->m_varargs = false;
273 pForward->m_numparams = num_params;
274 pForward->m_errstate = SP_ERROR_NONE;
276 pForward->m_functions.clear();
281 int CForward::Execute(cell_t *result, IForwardFilter *filter)
285 int err = m_errstate;
290 FuncIter iter = m_functions.begin();
291 IPluginFunction *func;
292 cell_t cur_result = 0;
293 cell_t high_result = 0;
294 cell_t low_result = 0;
296 unsigned int success=0;
297 unsigned int num_params = m_curparam;
298 FwdParamInfo temp_info[SP_MAX_EXEC_PARAMS];
302 /* Save local, reset */
303 memcpy(temp_info, m_params, sizeof(m_params));
306 FuncIteratorGuard guard(&m_IterGuard, &iter);
308 while (iter != m_functions.end())
313 filter->Preprocess(func, temp_info);
315 for (unsigned int i=0; i<num_params; i++)
317 int err = SP_ERROR_PARAM;
318 param = &temp_info[i];
320 if (i >= m_numparams || m_types[i] == Param_Any)
322 type = param->pushedas;
329 if ((i >= m_numparams) || (type & SP_PARAMFLAG_BYREF))
331 /* If we're byref or we're vararg, we always push everything by ref.
332 * Even if they're byval, we must push them byref.
334 if (type == Param_String)
336 err = func->PushStringEx((char *)param->byref.orig_addr, param->byref.cells, param->byref.sz_flags, param->byref.flags);
338 else if (type == Param_Float || type == Param_Cell)
340 err = func->PushCellByRef(¶m->val);
344 err = func->PushArray(param->byref.orig_addr, param->byref.cells, param->byref.flags);
345 assert(type == Param_Array || type == Param_FloatByRef || type == Param_CellByRef);
350 /* If we're not byref or not vararg, our job is a bit easier. */
351 assert(type == Param_Cell || type == Param_Float);
352 err = func->PushCell(param->val);
355 if (err != SP_ERROR_NONE)
357 logicore.GenerateError(func->GetParentContext(),
358 func->GetFunctionID(),
360 "Failed to push parameter while executing forward");
365 /* Call the function and deal with the return value. */
366 if ((err=func->Execute(&cur_result)) == SP_ERROR_NONE)
373 if (cur_result > high_result)
375 high_result = cur_result;
381 if (cur_result > high_result)
383 high_result = cur_result;
384 if ((ResultType)high_result == Pl_Stop)
393 /* Check if the current result is the lowest so far (or if it's the first result) */
394 if (cur_result < low_result || success == 1)
396 low_result = cur_result;
407 if (!guard.Triggered())
425 cur_result = high_result;
430 cur_result = low_result;
441 *result = cur_result;
445 return SP_ERROR_NONE;
448 int CForward::PushCell(cell_t cell)
450 if (m_curparam < m_numparams)
452 if (m_types[m_curparam] == Param_Any)
454 m_params[m_curparam].pushedas = Param_Cell;
455 } else if (m_types[m_curparam] != Param_Cell) {
456 return SetError(SP_ERROR_PARAM);
459 if (!m_varargs || m_numparams > SP_MAX_EXEC_PARAMS)
461 return SetError(SP_ERROR_PARAMS_MAX);
463 m_params[m_curparam].pushedas = Param_Cell;
466 m_params[m_curparam++].val = cell;
468 return SP_ERROR_NONE;
471 int CForward::PushFloat(float number)
473 if (m_curparam < m_numparams)
475 if (m_types[m_curparam] == Param_Any)
477 m_params[m_curparam].pushedas = Param_Float;
478 } else if (m_types[m_curparam] != Param_Float) {
479 return SetError(SP_ERROR_PARAM);
482 if (!m_varargs || m_numparams > SP_MAX_EXEC_PARAMS)
484 return SetError(SP_ERROR_PARAMS_MAX);
486 m_params[m_curparam].pushedas = Param_Float;
489 m_params[m_curparam++].val = *(cell_t *)&number;
491 return SP_ERROR_NONE;
494 int CForward::PushCellByRef(cell_t *cell, int flags)
496 if (m_curparam < m_numparams)
498 if (m_types[m_curparam] == Param_Any)
500 m_params[m_curparam].pushedas = Param_CellByRef;
501 } else if (m_types[m_curparam] != Param_CellByRef) {
502 return SetError(SP_ERROR_PARAM);
505 if (!m_varargs || m_numparams > SP_MAX_EXEC_PARAMS)
507 return SetError(SP_ERROR_PARAMS_MAX);
509 m_params[m_curparam].pushedas = Param_CellByRef;
512 _Int_PushArray(cell, 1, flags);
515 return SP_ERROR_NONE;
518 int CForward::PushFloatByRef(float *num, int flags)
520 if (m_curparam < m_numparams)
522 if (m_types[m_curparam] == Param_Any)
524 m_params[m_curparam].pushedas = Param_FloatByRef;
525 } else if (m_types[m_curparam] != Param_FloatByRef) {
526 return SetError(SP_ERROR_PARAM);
529 if (!m_varargs || m_numparams > SP_MAX_EXEC_PARAMS)
531 return SetError(SP_ERROR_PARAMS_MAX);
533 m_params[m_curparam].pushedas = Param_FloatByRef;
536 _Int_PushArray((cell_t *)num, 1, flags);
539 return SP_ERROR_NONE;
542 void CForward::_Int_PushArray(cell_t *inarray, unsigned int cells, int flags)
544 m_params[m_curparam].byref.cells = cells;
545 m_params[m_curparam].byref.flags = flags;
546 m_params[m_curparam].byref.orig_addr = inarray;
549 int CForward::PushArray(cell_t *inarray, unsigned int cells, int flags)
551 /* We don't allow this here */
554 return SetError(SP_ERROR_PARAM);
557 if (m_curparam < m_numparams)
559 if (m_types[m_curparam] == Param_Any)
561 m_params[m_curparam].pushedas = Param_Array;
562 } else if (m_types[m_curparam] != Param_Array) {
563 return SetError(SP_ERROR_PARAM);
566 if (!m_varargs || m_curparam > SP_MAX_EXEC_PARAMS)
568 return SetError(SP_ERROR_PARAMS_MAX);
570 m_params[m_curparam].pushedas = Param_Array;
573 _Int_PushArray(inarray, cells, flags);
577 return SP_ERROR_NONE;
580 void CForward::_Int_PushString(cell_t *inarray, unsigned int cells, int sz_flags, int cp_flags)
582 m_params[m_curparam].byref.cells = cells; /* Notice this contains the char count not cell count */
583 m_params[m_curparam].byref.flags = cp_flags;
584 m_params[m_curparam].byref.orig_addr = inarray;
585 m_params[m_curparam].byref.sz_flags = sz_flags;
588 int CForward::PushString(const char *string)
590 if (m_curparam < m_numparams)
592 if (m_types[m_curparam] == Param_Any)
594 m_params[m_curparam].pushedas = Param_String;
595 } else if (m_types[m_curparam] != Param_String) {
596 return SetError(SP_ERROR_PARAM);
599 if (!m_varargs || m_curparam > SP_MAX_EXEC_PARAMS)
601 return SetError(SP_ERROR_PARAMS_MAX);
603 m_params[m_curparam].pushedas = Param_String;
606 _Int_PushString((cell_t *)string, strlen(string)+1, SM_PARAM_STRING_COPY, 0);
609 return SP_ERROR_NONE;
612 int CForward::PushStringEx(char *buffer, size_t length, int sz_flags, int cp_flags)
614 if (m_curparam < m_numparams)
616 if (m_types[m_curparam] == Param_Any)
618 m_params[m_curparam].pushedas = Param_String;
619 } else if (m_types[m_curparam] != Param_String) {
620 return SetError(SP_ERROR_PARAM);
623 if (!m_varargs || m_curparam > SP_MAX_EXEC_PARAMS)
625 return SetError(SP_ERROR_PARAMS_MAX);
627 m_params[m_curparam].pushedas = Param_String;
630 _Int_PushString((cell_t *)buffer, length, sz_flags, cp_flags);
633 return SP_ERROR_NONE;
636 void CForward::Cancel()
644 m_errstate = SP_ERROR_NONE;
647 bool CForward::AddFunction(IPluginContext *pContext, funcid_t index)
649 IPluginFunction *pFunc = pContext->GetFunctionById(index);
656 return AddFunction(pFunc);
659 bool CForward::RemoveFunction(IPluginContext *pContext, funcid_t index)
661 IPluginFunction *pFunc = pContext->GetFunctionById(index);
668 return RemoveFunction(pFunc);
671 bool CForward::RemoveFunction(IPluginFunction *func)
675 List<IPluginFunction *> *lst;
677 if (func->IsRunnable())
684 for (iter=m_functions.begin(); iter!=m_functions.end(); iter++)
688 m_IterGuard->FixIteratorChain(iter);
695 /* Cancel a call, if any */
696 if (found || m_curparam)
704 unsigned int CForward::RemoveFunctionsOfPlugin(IPlugin *plugin)
707 IPluginFunction *func;
708 unsigned int removed = 0;
709 IPluginContext *pContext = plugin->GetBaseContext();
710 for (iter=m_functions.begin(); iter!=m_functions.end();)
713 if (func->GetParentContext() == pContext)
715 iter = m_functions.erase(iter);
725 bool CForward::AddFunction(IPluginFunction *func)
732 if (func->IsRunnable())
734 m_functions.push_back(func);
736 m_paused.push_back(func);
742 const char *CForward::GetForwardName()
747 unsigned int CForward::GetFunctionCount()
749 return m_functions.size();
752 ExecType CForward::GetExecType()