Function RunScriptFunction

Engine/script/script.cpp:409–473

}

RunScFuncResult RunScriptFunction(const RuntimeScript *script, const String &tsname, size_t numParam, const RuntimeScriptValue *params)
{
    assert(script);
    int oldRestoreCount = gameHasBeenRestored;
    // TODO: research why this is really necessary, and refactor to avoid such hacks!
    // First, save the current ccError state
    // This is necessary because we might be attempting
    // to run Script B, while Script A is still running in the
    // background.
    // If CallInstance here has an error, it would otherwise
    // also abort Script A because ccError is a global variable.
    ScriptError cachedCcError = cc_get_error();

    const RunScFuncResult res = PrepareTextScript(script, tsname);
    if (res != kScFnRes_Done)
    {
        if (res != kScFnRes_NotFound)
            quit_with_script_error(tsname);
        cc_error(cachedCcError); // restore cached error state
        return res;
    }

    // Choose a script thread. Use main thread by default if it's free
    // (does not have any script loaded up). Otherwise, create a new dynamic
    // callback thread and push to stack of threads.
    ScriptThread *script_thread = scriptThreadMain.get();
    if (scriptThreadMain->IsBusy())
    {
        script_thread = AllocateDynamicScriptThread();
    }

    const ScriptExecError inst_ret = scriptExecutor->Run(script_thread,
        curExecScript->Script, tsname, params, numParam);
    if ((inst_ret != kScExecErr_None) && (inst_ret != kScExecErr_FuncNotFound) && (inst_ret != kScExecErr_Aborted))
    {
        quit_with_script_error(tsname);
    }

    if (script_thread != scriptThreadMain.get())
    {
        FreeDynamicScriptThread(script_thread);
    }

    // FIXME: here we save the return value of the current called function,
    // because anything scheduled for the post-script processing will be run by the same executor,
    // and may replace "return value" field saved in a executor.
    // That's ugly. Should revise and redesign this later. BTW, ScriptExecutor keeping
    // last return value is also a hack, used currently only by dialogs. This should be done differently.
    const int ret_value = scriptExecutor->GetReturnValue();
    PostScriptProcessing();
    scriptExecutor->SetReturnValue(ret_value); // restore saved ret value

    // restore cached error state
    cc_error(cachedCcError);

    // if the game has been restored, ensure that any further scripts are not run
    if ((oldRestoreCount != gameHasBeenRestored) && (eventClaimed == EVENT_INPROGRESS))
        eventClaimed = EVENT_CLAIMED;