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.

Classes
category	OOJavaScriptEngine(OOMonitorSupportInternal)

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	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 108 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 160 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.

Referenced by OOJavaScriptEngine(Private)::createMainThreadContext.

Here is the caller graph for this function:

GlobalAutoAIForRole()

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

static

Definition at line 808 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()

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

static

Definition at line 432 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()

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

static

Definition at line 369 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()

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

static

Definition at line 289 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()

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

static

Definition at line 341 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()

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

static

Definition at line 684 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()

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

static

Definition at line 178 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()

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

static

Definition at line 597 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()

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

static

Definition at line 316 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()

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

static

Definition at line 244 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(), OOJavaScriptEngine::sendMonitorLogMessage:withMessageClass:inContext:, and OOJavaScriptEngine::sharedEngine.

Here is the call graph for this function:

GlobalPauseGame()

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

static

Definition at line 830 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:

GlobalRandomInhabitantsDescription()

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

static

Definition at line 410 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()

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

static

Definition at line 388 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()

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

static

Definition at line 467 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()

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

static

Definition at line 715 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()

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

static

Definition at line 211 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()

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

static

Definition at line 563 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()

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

static

Definition at line 620 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()

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

static

Definition at line 653 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()

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

static

Definition at line 763 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 171 of file OOJSGlobal.m.

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

References sGlobalMethods, and sGlobalProperties.

Referenced by OOJavaScriptEngine(Private)::createMainThreadContext.

Here is the caller graph for this function:

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 87 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 },
 
    { "pauseGame",                      GlobalPauseGame,                 0 },
    { 0 }
}

Definition at line 132 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 },
#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 120 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().