OOJSGlobal.m File Reference

import "OOJSGlobal.h"
import "OOJavaScriptEngine.h"
import "OOJSPlayer.h"
import "PlayerEntityScriptMethods.h"
import "OOStringExpander.h"
import "OOConstToString.h"
import "OOConstToJSString.h"
import "OOCollectionExtractors.h"
import "OOTexture.h"
import "GuiDisplayGen.h"
import "MyOpenGLView.h"
import "ResourceManager.h"
import "OOSystemDescriptionManager.h"
import "NSFileManagerOOExtensions.h"
import "OOJSGuiScreenKeyDefinition.h"

Include dependency graph for OOJSGlobal.m:

Go to the source code of this file.

Enumerations
enum	{ kGlobal_galaxyNumber , kGlobal_global , kGlobal_guiScreen , kGlobal_timeAccelerationFactor }

Functions
static JSBool	GlobalGetProperty (JSContext *context, JSObject *this, jsid propID, jsval *value)
static JSBool	GlobalSetProperty (JSContext *context, JSObject *this, jsid propID, JSBool strict, jsval *value)
static JSBool	GlobalLog (JSContext *context, uintN argc, jsval *vp)
static JSBool	GlobalExpandDescription (JSContext *context, uintN argc, jsval *vp)
static JSBool	GlobalKeyBindingDescription (JSContext *context, uintN argc, jsval *vp)
static JSBool	GlobalExpandMissionText (JSContext *context, uintN argc, jsval *vp)
static JSBool	GlobalDisplayNameForCommodity (JSContext *context, uintN argc, jsval *vp)
static JSBool	GlobalRandomName (JSContext *context, uintN argc, jsval *vp)
static JSBool	GlobalRandomInhabitantsDescription (JSContext *context, uintN argc, jsval *vp)
static JSBool	GlobalSetScreenBackground (JSContext *context, uintN argc, jsval *vp)
static JSBool	GlobalSetScreenOverlay (JSContext *context, uintN argc, jsval *vp)
static JSBool	GlobalGetScreenBackgroundForKey (JSContext *context, uintN argc, jsval *vp)
static JSBool	GlobalSetScreenBackgroundForKey (JSContext *context, uintN argc, jsval *vp)
static JSBool	GlobalAutoAIForRole (JSContext *context, uintN argc, jsval *vp)
static JSBool	GlobalPauseGame (JSContext *context, uintN argc, jsval *vp)
static JSBool	GlobalQuitGame (JSContext *context, uintN argc, jsval *vp)
static JSBool	GlobalGetGuiColorSettingForKey (JSContext *context, uintN argc, jsval *vp)
static JSBool	GlobalSetGuiColorSettingForKey (JSContext *context, uintN argc, jsval *vp)
static JSBool	GlobalSetExtraGuiScreenKeys (JSContext *context, uintN argc, jsval *vp)
static JSBool	GlobalClearExtraGuiScreenKeys (JSContext *context, uintN argc, jsval *vp)
static JSBool	GlobalTakeSnapShot (JSContext *context, uintN argc, jsval *vp)
void	CreateOOJSGlobal (JSContext *context, JSObject **outGlobal)
void	SetUpOOJSGlobal (JSContext *context, JSObject *global)

Variables
static NSString *const	kOOLogDebugMessage = @"script.debug.message"
static JSClass	sGlobalClass
static JSPropertySpec	sGlobalProperties []
static JSFunctionSpec	sGlobalMethods []

Enumeration Type Documentation

anonymous enum

anonymous enum

Enumerator
kGlobal_galaxyNumber
kGlobal_global
kGlobal_guiScreen
kGlobal_timeAccelerationFactor

Definition at line 109 of file OOJSGlobal.m.

{
    // Property IDs
    kGlobal_galaxyNumber,       // galaxy number, integer, read-only
    kGlobal_global,             // global.global.global.global, integer, read-only
    kGlobal_guiScreen,          // current GUI screen, string, read-only
#ifndef NDEBUG
    kGlobal_timeAccelerationFactor  // time acceleration, float, read/write
#endif
};

Function Documentation

CreateOOJSGlobal()

void CreateOOJSGlobal	(	JSContext *	context,
		JSObject **	outGlobal
	)

Definition at line 162 of file OOJSGlobal.m.

{
    assert(outGlobal != NULL);
    
    *outGlobal = JS_NewCompartmentAndGlobalObject(context, &sGlobalClass, NULL);
    
    JS_SetGlobalObject(context, *outGlobal);
    JS_DefineProperty(context, *outGlobal, "global", OBJECT_TO_JSVAL(*outGlobal), NULL, NULL, OOJS_PROP_READONLY);
}

References OOJS_PROP_READONLY, and sGlobalClass.

GlobalAutoAIForRole()

static JSBool GlobalAutoAIForRole ( JSContext *  context, uintN  argc, jsval *  vp  )

static

Definition at line 810 of file OOJSGlobal.m.

{
    OOJS_NATIVE_ENTER(context)
    
    NSString            *string = nil;
    
    if (argc > 0)  string = OOStringFromJSValue(context,OOJS_ARGV[0]);
    if (string == nil)
    {
        OOJSReportBadArguments(context, nil, @"autoAIForRole", MIN(argc, 1U), OOJS_ARGV, nil, @"string");
        return NO;
    }
 
    NSDictionary *autoAIMap = [ResourceManager dictionaryFromFilesNamed:@"autoAImap.plist" inFolder:@"Config" andMerge:YES];
    NSString *autoAI = [autoAIMap oo_stringForKey:string];
 
    OOJS_RETURN_OBJECT(autoAI);
    
    OOJS_NATIVE_EXIT
}

References ResourceManager::dictionaryFromFilesNamed:inFolder:andMerge:, MIN, nil, OOJS_ARGV, OOJS_NATIVE_ENTER, OOJS_NATIVE_EXIT, OOJS_RETURN_OBJECT, OOJSReportBadArguments(), and OOStringFromJSValue().

Here is the call graph for this function:

GlobalClearExtraGuiScreenKeys()

static JSBool GlobalClearExtraGuiScreenKeys ( JSContext *  context, uintN  argc, jsval *  vp  )

static

Definition at line 434 of file OOJSGlobal.m.

{
    OOJS_NATIVE_ENTER(context)
 
    BOOL                result = NO;
    PlayerEntity        *player = OOPlayerForScripting();
 
    if (EXPECT_NOT(argc < 2))
    {
        OOJSReportBadArguments(context, nil, @"setExtraGuiScreenKeys", 0, OOJS_ARGV, nil, @"missing arguments");
        return NO;
    }
 
    NSString *key = OOStringFromJSValue(context, OOJS_ARGV[0]);
    if (EXPECT_NOT(key == nil || [key isEqualToString:@""]))
    {
        OOJSReportBadArguments(context, nil, @"clearExtraGuiScreenKeys", 1, OOJS_ARGV, nil, @"key");
        return NO;
    }
 
    OOGUIScreenID gui = OOGUIScreenIDFromJSValue(context, OOJS_ARGV[1]);
    if (!gui)
    {
        OOJSReportBadArguments(context, nil, @"clearExtraGuiScreenKeys", 0, OOJS_ARGV, nil, @"guiScreen invalid entry");
        return NO;
    }
 
    [player clearExtraGuiScreenKeys:gui key:key];
 
    result = YES;
    OOJS_RETURN_BOOL(result);
    
    OOJS_NATIVE_EXIT
}

References PlayerEntity::clearExtraGuiScreenKeys:key:, EXPECT_NOT, nil, OOGUIScreenIDFromJSValue(), OOJS_ARGV, OOJS_NATIVE_ENTER, OOJS_NATIVE_EXIT, OOJS_RETURN_BOOL, OOJSReportBadArguments(), OOPlayerForScripting(), and OOStringFromJSValue().

Here is the call graph for this function:

GlobalDisplayNameForCommodity()

static JSBool GlobalDisplayNameForCommodity ( JSContext *  context, uintN  argc, jsval *  vp  )

static

Definition at line 371 of file OOJSGlobal.m.

{
    OOJS_NATIVE_ENTER(context)
    
    NSString            *string = nil;
    
    if (argc > 0)  string = OOStringFromJSValue(context,OOJS_ARGV[0]);
    if (string == nil)
    {
        OOJSReportBadArguments(context, nil, @"displayNameForCommodity", MIN(argc, 1U), OOJS_ARGV, nil, @"string");
        return NO;
    }
    OOJS_RETURN_OBJECT(CommodityDisplayNameForSymbolicName(string));
    
    OOJS_NATIVE_EXIT
}

References CommodityDisplayNameForSymbolicName(), MIN, nil, OOJS_ARGV, OOJS_NATIVE_ENTER, OOJS_NATIVE_EXIT, OOJS_RETURN_OBJECT, OOJSReportBadArguments(), and OOStringFromJSValue().

Here is the call graph for this function:

GlobalExpandDescription()

static JSBool GlobalExpandDescription ( JSContext *  context, uintN  argc, jsval *  vp  )

static

Definition at line 291 of file OOJSGlobal.m.

{
    OOJS_NATIVE_ENTER(context)
    
    NSString            *string = nil;
    NSDictionary        *overrides = nil;
    
    if (argc > 0)  string = OOStringFromJSValue(context, OOJS_ARGV[0]);
    if (string == nil)
    {
        OOJSReportBadArguments(context, nil, @"expandDescription", MIN(argc, 1U), OOJS_ARGV, nil, @"string");
        return NO;
    }
    if (argc > 1)
    {
        overrides = OOJSDictionaryFromStringTable(context, OOJS_ARGV[1]);
    }
    
    OOJS_BEGIN_FULL_NATIVE(context)
    string = OOExpandDescriptionString(kNilRandomSeed, string, overrides, nil, nil, kOOExpandForJavaScript | kOOExpandGoodRNG);
    OOJS_END_FULL_NATIVE
    
    OOJS_RETURN_OBJECT(string);
    
    OOJS_NATIVE_EXIT
}

References kNilRandomSeed, kOOExpandForJavaScript, kOOExpandGoodRNG, MIN, nil, OOExpandDescriptionString(), OOJS_ARGV, OOJS_BEGIN_FULL_NATIVE, OOJS_END_FULL_NATIVE, OOJS_NATIVE_ENTER, OOJS_NATIVE_EXIT, OOJS_RETURN_OBJECT, OOJSDictionaryFromStringTable(), OOJSReportBadArguments(), and OOStringFromJSValue().

Here is the call graph for this function:

GlobalExpandMissionText()

static JSBool GlobalExpandMissionText ( JSContext *  context, uintN  argc, jsval *  vp  )

static

Definition at line 343 of file OOJSGlobal.m.

{
    OOJS_NATIVE_ENTER(context)
    
    NSString            *string = nil;
    NSDictionary        *overrides = nil;
    
    if (argc > 0)  string = OOStringFromJSValue(context, OOJS_ARGV[0]);
    if (string == nil)
    {
        OOJSReportBadArguments(context, nil, @"expandMissionText", MIN(argc, 1U), OOJS_ARGV, nil, @"string");
        return NO;
    }
    if (argc > 1)
    {
        overrides = OOJSDictionaryFromStringTable(context, OOJS_ARGV[1]);
    }
    
    string = [[UNIVERSE missiontext] oo_stringForKey:string];
    string = OOExpandDescriptionString(kNilRandomSeed, string, overrides, nil, nil, kOOExpandForJavaScript | kOOExpandBackslashN | kOOExpandGoodRNG);
    
    OOJS_RETURN_OBJECT(string);
    
    OOJS_NATIVE_EXIT
}

References kNilRandomSeed, kOOExpandBackslashN, kOOExpandForJavaScript, kOOExpandGoodRNG, MIN, nil, OOExpandDescriptionString(), OOJS_ARGV, OOJS_NATIVE_ENTER, OOJS_NATIVE_EXIT, OOJS_RETURN_OBJECT, OOJSDictionaryFromStringTable(), OOJSReportBadArguments(), and OOStringFromJSValue().

Here is the call graph for this function:

GlobalGetGuiColorSettingForKey()

static JSBool GlobalGetGuiColorSettingForKey ( JSContext *  context, uintN  argc, jsval *  vp  )

static

Definition at line 686 of file OOJSGlobal.m.

{
    OOJS_NATIVE_ENTER(context)
    
    if (EXPECT_NOT(argc == 0))
    {
        OOJSReportBadArguments(context, nil, @"getGuiColorForKey", 0, OOJS_ARGV, nil, @"missing arguments");
        return NO;
    }
    NSString        *key = OOStringFromJSValue(context, OOJS_ARGV[0]);
    if (EXPECT_NOT(key == nil || [key isEqualToString:@""]))
    {
        OOJSReportBadArguments(context, nil, @"getGuiColorForKey", 0, OOJS_ARGV, nil, @"key");
        return NO;
    }
    if ([key rangeOfString:@"color"].location == NSNotFound)
    {
        OOJSReportBadArguments(context, nil, @"getGuiColorForKey", 0, OOJS_ARGV, nil, @"valid color key setting");
        return NO;
    }
 
    GuiDisplayGen   *gui = [UNIVERSE gui];
    OOColor *col = [gui colorFromSetting:key defaultValue:nil];
 
    OOJS_RETURN_OBJECT([col normalizedArray]);
    
    OOJS_NATIVE_EXIT
}

References GuiDisplayGen::colorFromSetting:defaultValue:, EXPECT_NOT, nil, OOJS_ARGV, OOJS_NATIVE_ENTER, OOJS_NATIVE_EXIT, OOJS_RETURN_OBJECT, OOJSReportBadArguments(), and OOStringFromJSValue().

Here is the call graph for this function:

GlobalGetProperty()

static JSBool GlobalGetProperty ( JSContext *  context, JSObject *  this, jsid  propID, jsval *  value  )

static

Definition at line 180 of file OOJSGlobal.m.

{
    if (!JSID_IS_INT(propID))  return YES;
    
    OOJS_NATIVE_ENTER(context)
    
    PlayerEntity                *player = OOPlayerForScripting();
    
    switch (JSID_TO_INT(propID))
    {
        case kGlobal_galaxyNumber:
            *value = INT_TO_JSVAL([player currentGalaxyID]);
            return YES;
            
        case kGlobal_guiScreen:
            *value = OOJSValueFromGUIScreenID(context, [player guiScreen]);
            return YES;
            
#ifndef NDEBUG
        case kGlobal_timeAccelerationFactor:
            return JS_NewNumberValue(context, [UNIVERSE timeAccelerationFactor], value);
#endif
            
        default:
            OOJSReportBadPropertySelector(context, this, propID, sGlobalProperties);
            return NO;
    }
    
    OOJS_NATIVE_EXIT
}

References kGlobal_galaxyNumber, kGlobal_guiScreen, kGlobal_timeAccelerationFactor, OOJS_NATIVE_ENTER, OOJS_NATIVE_EXIT, OOJSReportBadPropertySelector(), OOJSValueFromGUIScreenID(), OOPlayerForScripting(), sGlobalProperties, and UNIVERSE.

Here is the call graph for this function:

GlobalGetScreenBackgroundForKey()

static JSBool GlobalGetScreenBackgroundForKey ( JSContext *  context, uintN  argc, jsval *  vp  )

static

Definition at line 599 of file OOJSGlobal.m.

{
    OOJS_NATIVE_ENTER(context)
    
    if (EXPECT_NOT(argc == 0))
    {
        OOJSReportBadArguments(context, nil, @"getScreenBackgroundDefault", 0, OOJS_ARGV, nil, @"missing arguments");
        return NO;
    }
    NSString        *key = OOStringFromJSValue(context, OOJS_ARGV[0]);
    if (EXPECT_NOT(key == nil || [key isEqualToString:@""]))
    {
        OOJSReportBadArguments(context, nil, @"getScreenBackgroundDefault", 0, OOJS_ARGV, nil, @"key");
        return NO;
    }
    NSDictionary *descriptor = [UNIVERSE screenTextureDescriptorForKey:key];
 
    OOJS_RETURN_OBJECT(descriptor);
    
    OOJS_NATIVE_EXIT
} 

References EXPECT_NOT, nil, OOJS_ARGV, OOJS_NATIVE_ENTER, OOJS_NATIVE_EXIT, OOJS_RETURN_OBJECT, OOJSReportBadArguments(), and OOStringFromJSValue().

Here is the call graph for this function:

GlobalKeyBindingDescription()

static JSBool GlobalKeyBindingDescription ( JSContext *  context, uintN  argc, jsval *  vp  )

static

Definition at line 318 of file OOJSGlobal.m.

{
    OOJS_NATIVE_ENTER(context)
    
    NSString            *string = nil;
    PlayerEntity                *player = OOPlayerForScripting();
    
    if (argc > 0)  string = OOStringFromJSValue(context, OOJS_ARGV[0]);
    if (string == nil)
    {
        OOJSReportBadArguments(context, nil, @"keyBindingDescription", MIN(argc, 1U), OOJS_ARGV, nil, @"string");
        return NO;
    }
    
    OOJS_BEGIN_FULL_NATIVE(context)
    string = [player keyBindingDescription2:string];
    OOJS_END_FULL_NATIVE
    
    OOJS_RETURN_OBJECT(string);
    
    OOJS_NATIVE_EXIT
}

References PlayerEntity::keyBindingDescription2:, MIN, nil, OOJS_ARGV, OOJS_BEGIN_FULL_NATIVE, OOJS_END_FULL_NATIVE, OOJS_NATIVE_ENTER, OOJS_NATIVE_EXIT, OOJS_RETURN_OBJECT, OOJSReportBadArguments(), OOPlayerForScripting(), and OOStringFromJSValue().

Here is the call graph for this function:

GlobalLog()

static JSBool GlobalLog ( JSContext *  context, uintN  argc, jsval *  vp  )

static

Definition at line 246 of file OOJSGlobal.m.

{
    OOJS_NATIVE_ENTER(context)
    
    NSString            *message = nil;
    NSString            *messageClass = nil;
    
    if (EXPECT_NOT(argc < 1))
    {
        OOJS_RETURN_VOID;
    }
    if (argc < 2)
    {
        messageClass = kOOLogDebugMessage;
        message = OOStringFromJSValue(context, OOJS_ARGV[0]);
    }
    else
    {
        messageClass = OOStringFromJSValueEvenIfNull(context, OOJS_ARGV[0]);
        if (!OOLogWillDisplayMessagesInClass(messageClass))
        {
            // Do nothing (and short-circuit) if message class is filtered out.
            OOJS_RETURN_VOID;
        }
        
        message = [NSString concatenationOfStringsFromJavaScriptValues:OOJS_ARGV + 1 count:argc - 1 separator:@", " inContext:context];
    }
    
    OOJS_BEGIN_FULL_NATIVE(context)
    OOLog(messageClass, @"%@", message);
    
#if OOJSENGINE_MONITOR_SUPPORT
    [[OOJavaScriptEngine sharedEngine] sendMonitorLogMessage:message
                                            withMessageClass:nil
                                                   inContext:context];
#endif
    OOJS_END_FULL_NATIVE
    
    OOJS_RETURN_VOID;
    
    OOJS_NATIVE_EXIT
}

References EXPECT_NOT, kOOLogDebugMessage, nil, OOJS_ARGV, OOJS_BEGIN_FULL_NATIVE, OOJS_END_FULL_NATIVE, OOJS_NATIVE_ENTER, OOJS_NATIVE_EXIT, OOJS_RETURN_VOID, OOLog, OOLogWillDisplayMessagesInClass(), OOStringFromJSValue(), OOStringFromJSValueEvenIfNull(), and OOJavaScriptEngine::sharedEngine.

Here is the call graph for this function:

GlobalPauseGame()

static JSBool GlobalPauseGame ( JSContext *  context, uintN  argc, jsval *  vp  )

static

Definition at line 832 of file OOJSGlobal.m.

{
    OOJS_NATIVE_ENTER(context)
    
    BOOL            result = NO;
    PlayerEntity    *player = PLAYER;
    
    if (player)
    {
        OOGUIScreenID guiScreen = [player guiScreen];
        
        if  (guiScreen != GUI_SCREEN_LONG_RANGE_CHART &&
             guiScreen != GUI_SCREEN_MISSION &&
             guiScreen != GUI_SCREEN_REPORT &&
             guiScreen != GUI_SCREEN_KEYBOARD_ENTRY &&
             guiScreen != GUI_SCREEN_SAVE)
        {
            [UNIVERSE pauseGame];
            result = YES;
        }
    }
    
    OOJS_RETURN_BOOL(result);
    
    OOJS_NATIVE_EXIT
}

References PlayerEntity::guiScreen, OOJS_NATIVE_ENTER, OOJS_NATIVE_EXIT, OOJS_RETURN_BOOL, and PLAYER.

Here is the call graph for this function:

GlobalQuitGame()

static JSBool GlobalQuitGame ( JSContext *  context, uintN  argc, jsval *  vp  )

static

Definition at line 860 of file OOJSGlobal.m.

{
    OOJS_NATIVE_ENTER(context)
 
    OOLog(@"script.debug.quit", @"%@", @"Quit requested via JavaScript global.quitGame()");
 
    [UNIVERSE quitGame];
 
    OOJS_RETURN_BOOL(YES);
 
    OOJS_NATIVE_EXIT
}

References OOJS_NATIVE_ENTER, OOJS_NATIVE_EXIT, OOJS_RETURN_BOOL, and OOLog.

GlobalRandomInhabitantsDescription()

static JSBool GlobalRandomInhabitantsDescription ( JSContext *  context, uintN  argc, jsval *  vp  )

static

Definition at line 412 of file OOJSGlobal.m.

{
    OOJS_NATIVE_ENTER(context)
    
    NSString            *string = nil;
    Random_Seed         aSeed;
    JSBool              isPlural = YES;
    
    if (argc > 0 && !JS_ValueToBoolean(context, OOJS_ARGV[0], &isPlural))
    {
        OOJSReportBadArguments(context, nil, @"randomInhabitantsDescription", 1, OOJS_ARGV, nil, @"boolean");
        return NO;
    }
    
    make_pseudo_random_seed(&aSeed);
    string = [UNIVERSE getSystemInhabitants:Ranrot()%OO_SYSTEMS_PER_GALAXY plural:isPlural];
    OOJS_RETURN_OBJECT(string);
    
    OOJS_NATIVE_EXIT
}

References make_pseudo_random_seed(), nil, OOJS_ARGV, OOJS_NATIVE_ENTER, OOJS_NATIVE_EXIT, OOJS_RETURN_OBJECT, and OOJSReportBadArguments().

Here is the call graph for this function:

GlobalRandomName()

static JSBool GlobalRandomName ( JSContext *  context, uintN  argc, jsval *  vp  )

static

Definition at line 390 of file OOJSGlobal.m.

{
    OOJS_NATIVE_ENTER(context)
    
    /*  Temporarily set the system generation seed to a "really random" seed,
        so randomName() isn't repeatable.
    */
    RNG_Seed savedSeed = currentRandomSeed();
    setRandomSeed((RNG_Seed){ Ranrot(), Ranrot(), Ranrot(), Ranrot() });
    
    NSString *result = OOExpand(@"%N");
    
    // Restore seed.
    setRandomSeed(savedSeed);
    
    OOJS_RETURN_OBJECT(result);
    
    OOJS_NATIVE_EXIT
}

References currentRandomSeed(), OOExpand, OOJS_NATIVE_ENTER, OOJS_NATIVE_EXIT, OOJS_RETURN_OBJECT, Ranrot(), and setRandomSeed().

Here is the call graph for this function:

GlobalSetExtraGuiScreenKeys()

static JSBool GlobalSetExtraGuiScreenKeys ( JSContext *  context, uintN  argc, jsval *  vp  )

static

Definition at line 469 of file OOJSGlobal.m.

{
    OOJS_NATIVE_ENTER(context)
 
    BOOL                result = NO;
    jsval               callback = JSVAL_NULL;
    JSObject            *callbackThis = NULL;
    jsval               value = JSVAL_NULL;
    NSString            *key = nil;
    OOGUIScreenID       gui;
    NSDictionary        *keydefs = NULL;
    JSObject            *params = NULL;
    PlayerEntity        *player = OOPlayerForScripting();
 
    if (EXPECT_NOT(argc < 1))
    {
        OOJSReportBadArguments(context, nil, @"setExtraGuiScreenKeys", 0, OOJS_ARGV, nil, @"key, definition");
        return NO;
    }
    key = OOStringFromJSValue(context, OOJS_ARGV[0]);
 
    // Validate arguments.
    if (argc < 2 || !JS_ValueToObject(context, OOJS_ARGV[1], &params))
    {
        OOJSReportBadArguments(context, @"global", @"setExtraGuiScreenKeys", 2, &OOJS_ARGV[1], nil, @"key, definition: definition is not a valid dictionary.");
        return NO;
    }
 
    if (JS_GetProperty(context, params, "guiScreen", &value) == JS_FALSE || JSVAL_IS_VOID(value))
    {
        OOJSReportBadArguments(context, @"global", @"setExtraGuiScreenKeys", 2, &OOJS_ARGV[1], nil, @"key, definition: must have a 'guiScreen' property.");
        return NO;
    }
 
    gui = OOGUIScreenIDFromJSValue(context, value);
    // gui will be 0 for invalid screen id's as well as GUI_SCREEN_MAIN
    if (gui == 0 || gui == GUI_SCREEN_LOAD || gui == GUI_SCREEN_SAVE || gui == GUI_SCREEN_STICKMAPPER || gui == GUI_SCREEN_OXZMANAGER || 
        gui == GUI_SCREEN_NEWGAME || gui == GUI_SCREEN_SAVE_OVERWRITE || gui == GUI_SCREEN_KEYBOARD || gui == GUI_SCREEN_STICKPROFILE || gui == GUI_SCREEN_KEYBOARD_CONFIRMCLEAR ||
        gui == GUI_SCREEN_KEYBOARD_CONFIG || gui == GUI_SCREEN_KEYBOARD_ENTRY || gui == GUI_SCREEN_KEYBOARD_LAYOUT)
    {
        OOJSReportBadArguments(context, @"global", @"setExtraGuiScreenKeys", 2, &OOJS_ARGV[1], nil, @"key, definition: 'guiScreen' property must be a permitted and valid GUI_SCREEN idenfifier.");
        return NO;
    }
 
    if (JS_GetProperty(context, params, "registerKeys", &value) == JS_FALSE || JSVAL_IS_VOID(value))
    {
        OOJSReportBadArguments(context, @"global", @"setExtraGuiScreenKeys", 2, &OOJS_ARGV[1], nil, @"key, definition: must have a 'registerKeys' property.");
        return NO;
    }
    if (!JSVAL_IS_NULL(value))
    {
        if (JSVAL_IS_OBJECT(value))
        {
            keydefs = OOJSNativeObjectFromJSObject(context, JSVAL_TO_OBJECT(value));
        }
        else 
        {
            OOJSReportBadArguments(context, @"global", @"setExtraGuiScreenKeys", 2, &OOJS_ARGV[1], nil, @"key, definition: registerKeys is not a valid dictionary.");
            return NO;
        }
    }
 
    if (JS_GetProperty(context, params, "callback", &callback) == JS_FALSE || JSVAL_IS_VOID(callback))
    {
        OOJSReportBadArguments(context, @"global", @"setExtraGuiScreenKeys", 2, &OOJS_ARGV[1], NULL, @"key, definition; must have a 'callback' property.");
        return NO;
    }
    if (!OOJSValueIsFunction(context,callback))
    {
        OOJSReportBadArguments(context, @"global", @"setExtraGuiScreenKeys", 2, &OOJS_ARGV[1], NULL, @"key, definition; 'callback' property must be a function.");
        return NO;
    }
 
    OOJSGuiScreenKeyDefinition* definition = [[OOJSGuiScreenKeyDefinition alloc] init];
    [definition setName:key];
    [definition setRegisterKeys:keydefs];
    [definition setCallback:callback];
 
    // get callback 'this'
    if (JS_GetProperty(context, params, "cbThis", &value) == JS_TRUE && !JSVAL_IS_VOID(value))
    {
        JS_ValueToObject(context, value, &callbackThis);
        [definition setCallbackThis:callbackThis];
        // can do .bind(this) for callback instead
    }
 
    result = [player setExtraGuiScreenKeys:gui definition:definition];
    [definition release];
 
    OOJS_RETURN_BOOL(result);
    
    OOJS_NATIVE_EXIT
}

References EXPECT_NOT, nil, OOGUIScreenIDFromJSValue(), OOJS_ARGV, OOJS_NATIVE_ENTER, OOJS_NATIVE_EXIT, OOJS_RETURN_BOOL, OOJSNativeObjectFromJSObject(), OOJSReportBadArguments(), OOJSValueIsFunction(), OOPlayerForScripting(), OOStringFromJSValue(), OOJSGuiScreenKeyDefinition::setCallback:, OOJSGuiScreenKeyDefinition::setCallbackThis:, PlayerEntity::setExtraGuiScreenKeys:definition:, OOJSGuiScreenKeyDefinition::setName:, and OOJSGuiScreenKeyDefinition::setRegisterKeys:.

Here is the call graph for this function:

GlobalSetGuiColorSettingForKey()

static JSBool GlobalSetGuiColorSettingForKey ( JSContext *  context, uintN  argc, jsval *  vp  )

static

Definition at line 717 of file OOJSGlobal.m.

{
    OOJS_NATIVE_ENTER(context)
    
    BOOL            result = NO;
    OOColor         *col = nil;
    
    if (EXPECT_NOT(argc != 2))
    {
        OOJSReportBadArguments(context, nil, @"setGuiColorForKey", 0, OOJS_ARGV, nil, @"missing arguments");
        return NO;
    }
 
    NSString        *key = OOStringFromJSValue(context, OOJS_ARGV[0]);
    jsval           value = OOJS_ARGV[1];
    if (EXPECT_NOT(key == nil || [key isEqualToString:@""]))
    {
        OOJSReportBadArguments(context, nil, @"setGuiColorForKey", 0, OOJS_ARGV, nil, @"key");
        return NO;
    }
    if ([key rangeOfString:@"color"].location == NSNotFound)
    {
        OOJSReportBadArguments(context, nil, @"setGuiColorForKey", 0, OOJS_ARGV, nil, @"valid color key setting");
        return NO;
    }
 
    if (!JSVAL_IS_NULL(value))
    {
        col = [OOColor colorWithDescription:OOJSNativeObjectFromJSValue(context, value)];
        if (col == nil)
        {
            OOJSReportBadArguments(context, nil, @"setGuiColorForKey", 1, OOJS_ARGV, nil, @"color descriptor");
            return NO;
        }
    }
 
    GuiDisplayGen   *gui = [UNIVERSE gui];
    [gui setGuiColorSettingFromKey:key color:col];
    result = YES;
    
    OOJS_RETURN_BOOL(result);
    
    OOJS_NATIVE_EXIT
}

References OOColor::colorWithDescription:, EXPECT_NOT, nil, OOJS_ARGV, OOJS_NATIVE_ENTER, OOJS_NATIVE_EXIT, OOJS_RETURN_BOOL, OOJSReportBadArguments(), OOStringFromJSValue(), and GuiDisplayGen::setGuiColorSettingFromKey:color:.

Here is the call graph for this function:

GlobalSetProperty()

static JSBool GlobalSetProperty ( JSContext *  context, JSObject *  this, jsid  propID, JSBool  strict, jsval *  value  )

static

Definition at line 213 of file OOJSGlobal.m.

{
    if (!JSID_IS_INT(propID))  return YES;
    
    OOJS_NATIVE_ENTER(context)
    
    jsdouble                    fValue;
    
    switch (JSID_TO_INT(propID))
    {
        case kGlobal_timeAccelerationFactor:
            if (JS_ValueToNumber(context, *value, &fValue))
            {
                [UNIVERSE setTimeAccelerationFactor:fValue];
                return YES;
            }
            break;
    
        default:
            OOJSReportBadPropertySelector(context, this, propID, sGlobalProperties);
    }
    
    OOJSReportBadPropertyValue(context, this, propID, sGlobalProperties, *value);
    return NO;
    
    OOJS_NATIVE_EXIT
}

References kGlobal_timeAccelerationFactor, OOJS_NATIVE_ENTER, OOJS_NATIVE_EXIT, OOJSReportBadPropertySelector(), OOJSReportBadPropertyValue(), and sGlobalProperties.

Here is the call graph for this function:

GlobalSetScreenBackground()

static JSBool GlobalSetScreenBackground ( JSContext *  context, uintN  argc, jsval *  vp  )

static

Definition at line 565 of file OOJSGlobal.m.

{
    OOJS_NATIVE_ENTER(context)
    
    BOOL            result = NO;
    jsval           value = (argc > 0) ? OOJS_ARGV[0] : JSVAL_NULL;
    
    if (EXPECT_NOT(argc == 0))
    {
        OOJSReportWarning(context, @"Usage error: %@() called with no arguments. Treating as %@(null). This call may fail in a future version of Oolite.", @"setScreenBackground", @"setScreenBackground");
    }
    else if (EXPECT_NOT(JSVAL_IS_VOID(value)))
    {
        OOJSReportBadArguments(context, nil, @"setScreenBackground", 1, &value, nil, @"GUI texture descriptor");
        return NO;
    }
    
    if ([UNIVERSE viewDirection] == VIEW_GUI_DISPLAY)
    {
        GuiDisplayGen   *gui = [UNIVERSE gui];
        NSDictionary    *descriptor = [gui textureDescriptorFromJSValue:value inContext:context callerDescription:@"setScreenBackground()"];
        
        result = [gui setBackgroundTextureDescriptor:descriptor];
        
        // add some permanence to the override if we're in the equip ship screen
        if (result && [PLAYER guiScreen] == GUI_SCREEN_EQUIP_SHIP)  [PLAYER setEquipScreenBackgroundDescriptor:descriptor];
    }
    
    OOJS_RETURN_BOOL(result);
    
    OOJS_NATIVE_EXIT
}

References EXPECT_NOT, nil, OOJS_ARGV, OOJS_NATIVE_ENTER, OOJS_NATIVE_EXIT, OOJS_RETURN_BOOL, OOJSReportBadArguments(), OOJSReportWarning(), PLAYER, GuiDisplayGen::setBackgroundTextureDescriptor:, GuiDisplayGen::textureDescriptorFromJSValue:inContext:callerDescription:, and UNIVERSE.

Here is the call graph for this function:

GlobalSetScreenBackgroundForKey()

static JSBool GlobalSetScreenBackgroundForKey ( JSContext *  context, uintN  argc, jsval *  vp  )

static

Definition at line 622 of file OOJSGlobal.m.

{
    OOJS_NATIVE_ENTER(context)
    
    BOOL            result = NO;
    
    if (EXPECT_NOT(argc < 2))
    {
        OOJSReportBadArguments(context, nil, @"setScreenBackgroundDefault", 0, OOJS_ARGV, nil, @"missing arguments");
        return NO;
    }
 
    NSString        *key = OOStringFromJSValue(context, OOJS_ARGV[0]);
    jsval           value = OOJS_ARGV[1];
    if (EXPECT_NOT(key == nil || [key isEqualToString:@""]))
    {
        OOJSReportBadArguments(context, nil, @"setScreenBackgroundDefault", 0, OOJS_ARGV, nil, @"key");
        return NO;
    }
 
    GuiDisplayGen   *gui = [UNIVERSE gui];
    NSDictionary    *descriptor = [gui textureDescriptorFromJSValue:value inContext:context callerDescription:@"setScreenBackgroundDefault()"];
    
    [UNIVERSE setScreenTextureDescriptorForKey:key descriptor:descriptor];
    result = YES;
    
    OOJS_RETURN_BOOL(result);
    
    OOJS_NATIVE_EXIT
}

References EXPECT_NOT, nil, OOJS_ARGV, OOJS_NATIVE_ENTER, OOJS_NATIVE_EXIT, OOJS_RETURN_BOOL, OOJSReportBadArguments(), OOStringFromJSValue(), and GuiDisplayGen::textureDescriptorFromJSValue:inContext:callerDescription:.

Here is the call graph for this function:

GlobalSetScreenOverlay()

static JSBool GlobalSetScreenOverlay ( JSContext *  context, uintN  argc, jsval *  vp  )

static

Definition at line 655 of file OOJSGlobal.m.

{
    OOJS_NATIVE_ENTER(context)
    
    BOOL            result = NO;
    jsval           value = (argc > 0) ? OOJS_ARGV[0] : JSVAL_NULL;
    
    if (EXPECT_NOT(argc == 0))
    {
        OOJSReportWarning(context, @"Usage error: %@() called with no arguments. Treating as %@(null). This call may fail in a future version of Oolite.", @"setScreenOverlay", @"setScreenOverlay");
    }
    else if (EXPECT_NOT(JSVAL_IS_VOID(value)))
    {
        OOJSReportBadArguments(context, nil, @"setScreenOverlay", 1, &value, nil, @"GUI texture descriptor");
        return NO;
    }
    
    if ([UNIVERSE viewDirection] == VIEW_GUI_DISPLAY)
    {
        GuiDisplayGen   *gui = [UNIVERSE gui];
        NSDictionary    *descriptor = [gui textureDescriptorFromJSValue:value inContext:context callerDescription:@"setScreenOverlay()"];
        
        result = [gui setForegroundTextureDescriptor:descriptor];
    }
    
    OOJS_RETURN_BOOL(result);
    
    OOJS_NATIVE_EXIT
}

References EXPECT_NOT, nil, OOJS_ARGV, OOJS_NATIVE_ENTER, OOJS_NATIVE_EXIT, OOJS_RETURN_BOOL, OOJSReportBadArguments(), OOJSReportWarning(), GuiDisplayGen::setForegroundTextureDescriptor:, GuiDisplayGen::textureDescriptorFromJSValue:inContext:callerDescription:, and UNIVERSE.

Here is the call graph for this function:

GlobalTakeSnapShot()

static JSBool GlobalTakeSnapShot ( JSContext *  context, uintN  argc, jsval *  vp  )

static

Definition at line 765 of file OOJSGlobal.m.

{
    OOJS_NATIVE_ENTER(context)
    
    NSString                *value = nil;
    NSMutableCharacterSet   *allowedChars = (NSMutableCharacterSet *)[NSMutableCharacterSet alphanumericCharacterSet];
    BOOL                    result = NO;    
    
    [allowedChars addCharactersInString:@"_-"];
    
    if (argc > 0)
    {
        value = OOStringFromJSValue(context, OOJS_ARGV[0]);
        if (EXPECT_NOT(value == nil || [value rangeOfCharacterFromSet:[allowedChars invertedSet]].location != NSNotFound))
        {
            OOJSReportBadArguments(context, nil, @"takeSnapShot", argc, OOJS_ARGV, nil, @"alphanumeric string");
            return NO;
        }
    }
    
    NSString                *playerFileDirectory = [[NSFileManager defaultManager] defaultCommanderPath];
    NSDictionary            *attr = [[NSFileManager defaultManager] oo_fileSystemAttributesAtPath:playerFileDirectory];
    
    if (attr != nil)
    {
        double freeSpace = [attr oo_doubleForKey:NSFileSystemFreeSize];
        if (freeSpace < 1073741824) // less than 1 GB free on disk?
        {
            OOJSReportWarning(context, @"takeSnapShot: function disabled when free disk space is less than 1GB.");
            OOJS_RETURN_BOOL(NO);
        }
    }
    
    
    OOJS_BEGIN_FULL_NATIVE(context)
    result = [[UNIVERSE gameView] snapShot:value];
    OOJS_END_FULL_NATIVE
    
    OOJS_RETURN_BOOL(result);
    
    OOJS_NATIVE_EXIT
}

References EXPECT_NOT, nil, OOJS_ARGV, OOJS_BEGIN_FULL_NATIVE, OOJS_END_FULL_NATIVE, OOJS_NATIVE_ENTER, OOJS_NATIVE_EXIT, OOJS_RETURN_BOOL, OOJSReportBadArguments(), OOJSReportWarning(), and OOStringFromJSValue().

Here is the call graph for this function:

SetUpOOJSGlobal()

void SetUpOOJSGlobal	(	JSContext *	context,
		JSObject *	global
	)

Definition at line 173 of file OOJSGlobal.m.

{
    JS_DefineProperties(context, global, sGlobalProperties);
    JS_DefineFunctions(context, global, sGlobalMethods);
}

References sGlobalMethods, and sGlobalProperties.

Variable Documentation

kOOLogDebugMessage

NSString* const kOOLogDebugMessage = @"script.debug.message"

static

Definition at line 56 of file OOJSGlobal.m.

sGlobalClass

JSClass sGlobalClass

static

Initial value:

=
{
    "Global",
    JSCLASS_GLOBAL_FLAGS,
    
    JS_PropertyStub,
    JS_PropertyStub,
    GlobalGetProperty,
 
    GlobalSetProperty,
 
 
 
 
    JS_EnumerateStub,
    JS_ResolveStub,
    JS_ConvertStub,
    JS_FinalizeStub
}

Definition at line 88 of file OOJSGlobal.m.

{
    "Global",
    JSCLASS_GLOBAL_FLAGS,
    
    JS_PropertyStub,
    JS_PropertyStub,
    GlobalGetProperty,
#ifndef NDEBUG
    GlobalSetProperty,
#else
    // No writeable properties in non-debug builds
    JS_StrictPropertyStub,
#endif
    JS_EnumerateStub,
    JS_ResolveStub,
    JS_ConvertStub,
    JS_FinalizeStub
};

Referenced by CreateOOJSGlobal().

sGlobalMethods

JSFunctionSpec sGlobalMethods[]

static

Initial value:

=
{
    
    { "log",                            GlobalLog,                          1 },
    { "autoAIForRole",                  GlobalAutoAIForRole,                1 },
    { "expandDescription",              GlobalExpandDescription,            1 },
    { "expandMissionText",              GlobalExpandMissionText,            1 },
    { "displayNameForCommodity",        GlobalDisplayNameForCommodity,      1 },
    { "randomName",                     GlobalRandomName,                   0 },
    { "randomInhabitantsDescription",   GlobalRandomInhabitantsDescription, 1 },
    { "setScreenBackground",            GlobalSetScreenBackground,          1 },
    { "getScreenBackgroundForKey",      GlobalGetScreenBackgroundForKey,    1 },
    { "setScreenBackgroundForKey",      GlobalSetScreenBackgroundForKey,    2 },
    { "setScreenOverlay",               GlobalSetScreenOverlay,             1 },
    { "getGuiColorSettingForKey",       GlobalGetGuiColorSettingForKey,     1 },
    { "setGuiColorSettingForKey",       GlobalSetGuiColorSettingForKey,     2 },
    { "keyBindingDescription",          GlobalKeyBindingDescription,        1 },
    { "setExtraGuiScreenKeys",          GlobalSetExtraGuiScreenKeys,        2 },
    { "clearExtraGuiScreenKeys",        GlobalClearExtraGuiScreenKeys,      2 },
 
 
    { "takeSnapShot",                   GlobalTakeSnapShot,                 1 },
    { "quitGame",                       GlobalQuitGame,                     0 },
 
    { "pauseGame",                      GlobalPauseGame,                    0 },
    { 0 }
}

Definition at line 133 of file OOJSGlobal.m.

{
    // JS name                          Function                                min args
    { "log",                            GlobalLog,                          1 },
    { "autoAIForRole",                  GlobalAutoAIForRole,                1 },
    { "expandDescription",              GlobalExpandDescription,            1 },
    { "expandMissionText",              GlobalExpandMissionText,            1 },
    { "displayNameForCommodity",        GlobalDisplayNameForCommodity,      1 },
    { "randomName",                     GlobalRandomName,                   0 },
    { "randomInhabitantsDescription",   GlobalRandomInhabitantsDescription, 1 },
    { "setScreenBackground",            GlobalSetScreenBackground,          1 },
    { "getScreenBackgroundForKey",      GlobalGetScreenBackgroundForKey,    1 },
    { "setScreenBackgroundForKey",      GlobalSetScreenBackgroundForKey,    2 },
    { "setScreenOverlay",               GlobalSetScreenOverlay,             1 },
    { "getGuiColorSettingForKey",       GlobalGetGuiColorSettingForKey,     1 },
    { "setGuiColorSettingForKey",       GlobalSetGuiColorSettingForKey,     2 },
    { "keyBindingDescription",          GlobalKeyBindingDescription,        1 },
    { "setExtraGuiScreenKeys",          GlobalSetExtraGuiScreenKeys,        2 },
    { "clearExtraGuiScreenKeys",        GlobalClearExtraGuiScreenKeys,      2 },
 
#ifndef NDEBUG
    { "takeSnapShot",                   GlobalTakeSnapShot,                 1 },
    { "quitGame",                       GlobalQuitGame,                     0 },
#endif
    { "pauseGame",                      GlobalPauseGame,                    0 },
    { 0 }
};

Referenced by SetUpOOJSGlobal().

sGlobalProperties

JSPropertySpec sGlobalProperties[]

static

Initial value:

=
{
    
    { "galaxyNumber",           kGlobal_galaxyNumber,       OOJS_PROP_READONLY_CB },
    { "guiScreen",              kGlobal_guiScreen,          OOJS_PROP_READONLY_CB },
 
    { "timeAccelerationFactor", kGlobal_timeAccelerationFactor, OOJS_PROP_READWRITE_CB },
 
    { 0 }
}

Definition at line 121 of file OOJSGlobal.m.

{
    // JS name                  ID                          flags
    { "galaxyNumber",           kGlobal_galaxyNumber,       OOJS_PROP_READONLY_CB },
    { "guiScreen",              kGlobal_guiScreen,          OOJS_PROP_READONLY_CB },
#ifndef NDEBUG
    { "timeAccelerationFactor", kGlobal_timeAccelerationFactor, OOJS_PROP_READWRITE_CB },
#endif
    { 0 }
};

Referenced by GlobalGetProperty(), GlobalSetProperty(), and SetUpOOJSGlobal().