OOJSMission.h File Reference

import <Foundation/Foundation.h>
#include <jsapi.h>

Include dependency graph for OOJSMission.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Functions
void	InitOOJSMission (JSContext *context, JSObject *global)
void	MissionRunCallback (void)

Function Documentation

InitOOJSMission()

void InitOOJSMission	(	JSContext *	context,
		JSObject *	global )

Definition at line 108 of file OOJSMission.m.

{
    sCallbackFunction = JSVAL_NULL;
    sCallbackThis = JSVAL_NULL;
    
    JSObject *missionPrototype = JS_InitClass(context, global, NULL, &sMissionClass, OOJSUnconstructableConstruct, 0, sMissionProperties, sMissionMethods, NULL, NULL);
    sMissionObject = JS_DefineObject(context, global, "mission", &sMissionClass, missionPrototype, OOJS_PROP_READONLY);
    
    // Ensure JS objects are rooted.
    OOJSAddGCValueRoot(context, &sCallbackFunction, "Pending mission callback function");
    OOJSAddGCValueRoot(context, &sCallbackThis, "Pending mission callback this");
}

References OOJS_PROP_READONLY, OOJSAddGCValueRoot, OOJSUnconstructableConstruct(), sCallbackFunction, sCallbackThis, sMissionClass, sMissionMethods, sMissionObject, and sMissionProperties.

Here is the call graph for this function:

MissionRunCallback()

void MissionRunCallback

(

void

)

Definition at line 122 of file OOJSMission.m.

{
    // don't do anything if we don't have a function.
    if (JSVAL_IS_NULL(sCallbackFunction) || JSVAL_IS_VOID(sCallbackFunction))  return;
    
    jsval               argval = JSVAL_VOID;
    jsval               argval2 = JSVAL_VOID;
    jsval               rval = JSVAL_VOID;
    PlayerEntity        *player = OOPlayerForScripting();
    OOJavaScriptEngine  *engine  = [OOJavaScriptEngine sharedEngine];
    JSContext           *context = OOJSAcquireContext();
    
    /*  Create temporarily-rooted local copies of sCallbackFunction and
        sCallbackThis, then clear the statics. This must be done in advance
        since the callback might call runScreen() and clobber the statics.
    */
    jsval               cbFunction = JSVAL_VOID;
    JSObject            *cbThis = NULL;
    OOJSScript          *cbScript = sCallbackScript;
    
    OOJSAddGCValueRoot(context, &cbFunction, "Mission callback function");
    OOJSAddGCObjectRoot(context, &cbThis, "Mission callback this");
    cbFunction = sCallbackFunction;
    cbScript = sCallbackScript;
    JS_ValueToObject(context, sCallbackThis, &cbThis);
    
    sCallbackScript = nil;
    sCallbackFunction = JSVAL_NULL;
    sCallbackThis = JSVAL_NULL;
    
    jsval args[2];
    argval = OOJSValueFromNativeObject(context, [player missionChoice_string]);
    argval2 = OOJSValueFromNativeObject(context, [player missionKeyPress_string]);
    args[0] = argval;
    args[1] = argval2;
 
    // now reset the mission choice silently, before calling the callback script.
    [player setMissionChoice:nil keyPress:@"" withEvent:NO];
    
    // Call the callback.
    @try
    {
        [OOJSScript pushScript:cbScript];
        [engine callJSFunction:cbFunction
                     forObject:cbThis
                          argc:2
                          argv:args
                        result:&rval];
    }
    @catch (NSException *exception)
    {
        // Squash any exception, allow cleanup to happen and so forth.
        OOLog(kOOLogException, @"Ignoring exception %@:%@ during handling of mission screen completion callback.", [exception name], [exception reason]);
    }
    [OOJSScript popScript:cbScript];
    
    // Manage that memory.
    [cbScript release];
    JS_RemoveValueRoot(context, &cbFunction);
    JS_RemoveObjectRoot(context, &cbThis);
    
    OOJSRelinquishContext(context);
}

References OOJavaScriptEngine::callJSFunction:forObject:argc:argv:result:, kOOLogException, nil, OOJSAcquireContext(), OOJSAddGCObjectRoot, OOJSAddGCValueRoot, OOJSRelinquishContext(), OOJSValueFromNativeObject(), OOLog, OOPlayerForScripting(), OOJSScript::popScript:, OOJSScript::pushScript:, sCallbackFunction, sCallbackScript, sCallbackThis, PlayerEntity::setMissionChoice:keyPress:withEvent:, and OOJavaScriptEngine::sharedEngine.

Here is the call graph for this function: