OOJSEntity.m File Reference

import "OOJSEntity.h"
import "OOJSVector.h"
import "OOJSQuaternion.h"
import "OOJavaScriptEngine.h"
import "OOConstToJSString.h"
import "EntityOOJavaScriptExtensions.h"
import "OOJSCall.h"
import "OOJSPlayer.h"
import "PlayerEntity.h"
import "ShipEntity.h"

Include dependency graph for OOJSEntity.m:

Go to the source code of this file.

Enumerations
enum	{   kEntity_collisionRadius , kEntity_distanceTravelled , kEntity_energy , kEntity_heading ,   kEntity_mass , kEntity_maxEnergy , kEntity_orientation , kEntity_owner ,   kEntity_position , kEntity_scanClass , kEntity_spawnTime , kEntity_status ,   kEntity_isPlanet , kEntity_isPlayer , kEntity_isShip , kEntity_isStation ,   kEntity_isDock , kEntity_isSubEntity , kEntity_isSun , kEntity_isSunlit ,   kEntity_isValid , kEntity_isInSpace , kEntity_isVisible , kEntity_isVisualEffect ,   kEntity_isWormhole }

Functions
static JSBool	EntityGetProperty (JSContext *context, JSObject *this, jsid propID, jsval *value)
static JSBool	EntitySetProperty (JSContext *context, JSObject *this, jsid propID, JSBool strict, jsval *value)
static JSBool	EntityDumpState (JSContext *context, uintN argc, jsval *vp)
void	InitOOJSEntity (JSContext *context, JSObject *global)
BOOL	JSValueToEntity (JSContext *context, jsval value, Entity **outEntity)
BOOL	EntityFromArgumentList (JSContext *context, NSString *scriptClass, NSString *function, uintN argc, jsval *argv, Entity **outEntity, uintN *outConsumed)

Variables
JSObject *	gOOEntityJSPrototype
JSClass	gOOEntityJSClass
static JSPropertySpec	sEntityProperties []
static JSFunctionSpec	sEntityMethods []

Enumeration Type Documentation

anonymous enum

anonymous enum

Enumerator
kEntity_collisionRadius
kEntity_distanceTravelled
kEntity_energy
kEntity_heading
kEntity_mass
kEntity_maxEnergy
kEntity_orientation
kEntity_owner
kEntity_position
kEntity_scanClass
kEntity_spawnTime
kEntity_status
kEntity_isPlanet
kEntity_isPlayer
kEntity_isShip
kEntity_isStation
kEntity_isDock
kEntity_isSubEntity
kEntity_isSun
kEntity_isSunlit
kEntity_isValid
kEntity_isInSpace
kEntity_isVisible
kEntity_isVisualEffect
kEntity_isWormhole

Definition at line 65 of file OOJSEntity.m.

{
    // Property IDs
    kEntity_collisionRadius,    // collision radius, double, read-only.
    kEntity_distanceTravelled,  // distance travelled, double, read-only.
    kEntity_energy,             // energy, double, read-write.
    kEntity_heading,            // heading, vector, read-only (like orientation but ignoring twist angle)
    kEntity_mass,               // mass, double, read-only
    kEntity_maxEnergy,          // maxEnergy, double, read-only.
    kEntity_orientation,        // orientation, quaternion, read/write
    kEntity_owner,              // owner, Entity, read-only. (Parent ship for subentities, station for defense ships, launching ship for missiles etc)
    kEntity_position,           // position in system space, Vector, read/write
    kEntity_scanClass,          // scan class, string, read-only
    kEntity_spawnTime,          // spawn time, double, read-only.
    kEntity_status,             // entity status, string, read-only
    kEntity_isPlanet,           // is planet, boolean, read-only.
    kEntity_isPlayer,           // is player, boolean, read-only.
    kEntity_isShip,             // is ship, boolean, read-only.
    kEntity_isStation,          // is station, boolean, read-only.
    kEntity_isDock,             // is dock, boolean, read-only.
    kEntity_isSubEntity,        // is subentity, boolean, read-only.
    kEntity_isSun,              // is sun, boolean, read-only.
    kEntity_isSunlit,           // is sunlit, boolean, read-only.
    kEntity_isValid,            // is not stale, boolean, read-only.
    kEntity_isInSpace,          // is in space, boolean, read-only.
    kEntity_isVisible,          // is within drawing distance, boolean, read-only.
    kEntity_isVisualEffect,     // is visual effect, boolean, read-only.
    kEntity_isWormhole,     // is visual effect, boolean, read-only.
};

Function Documentation

EntityDumpState()

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

static

Definition at line 400 of file OOJSEntity.m.

{
    OOJS_PROFILE_ENTER
    
    Entity *thisEnt = nil;
    OOJSEntityGetEntity(context, OOJS_THIS, &thisEnt);
    [thisEnt dumpState];
    
    OOJS_RETURN_VOID;
    
    OOJS_PROFILE_EXIT   
}

References nil, OOJS_PROFILE_ENTER, OOJS_PROFILE_EXIT, OOJS_RETURN_VOID, and OOJS_THIS.

EntityFromArgumentList()

BOOL EntityFromArgumentList	(	JSContext *	context,
		NSString *	scriptClass,
		NSString *	function,
		uintN	argc,
		jsval *	argv,
		Entity **	outEntity,
		uintN *	outConsumed )

Definition at line 157 of file OOJSEntity.m.

{
    OOJS_PROFILE_ENTER
    
    // Sanity checks.
    if (outConsumed != NULL)  *outConsumed = 0;
    if (EXPECT_NOT(argc == 0 || argv == NULL || outEntity == NULL))
    {
        OOLogGenericParameterError();
        return NO;
    }
    
    // Get value, if possible.
    if (EXPECT_NOT(!JSValueToEntity(context, argv[0], outEntity)))
    {
        // Failed; report bad parameters, if given a class and function.
        if (scriptClass != nil && function != nil)
        {
            OOJSReportWarning(context, @"%@.%@(): expected entity, got %@.", scriptClass, function, [NSString stringWithJavaScriptParameters:argv count:1 inContext:context]);
            return NO;
        }
    }
    
    // Success.
    if (outConsumed != NULL)  *outConsumed = 1;
    return YES;
    
    OOJS_PROFILE_EXIT
}

References count, EXPECT_NOT, JSValueToEntity(), nil, OOJS_PROFILE_ENTER, OOJS_PROFILE_EXIT, OOJSReportWarning(), and OOLogGenericParameterError.

Here is the call graph for this function:

EntityGetProperty()

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

static

Definition at line 188 of file OOJSEntity.m.

{
    if (!JSID_IS_INT(propID))  return YES;
    
    OOJS_NATIVE_ENTER(context)
    
    Entity                      *entity = nil;
    id                          result = nil;
    
    if (EXPECT_NOT(!OOJSEntityGetEntity(context, this, &entity))) return NO;
    if (OOIsStaleEntity(entity))
    { 
        if (JSID_TO_INT(propID) == kEntity_isValid)  *value = JSVAL_FALSE;
        else  { *value = JSVAL_VOID; }
        return YES;
    }
    
    switch (JSID_TO_INT(propID))
    {
        case kEntity_collisionRadius:
            return JS_NewNumberValue(context, [entity collisionRadius], value);
    
        case kEntity_position:
            return HPVectorToJSValue(context, [entity position], value);
        
        case kEntity_orientation:
            return QuaternionToJSValue(context, [entity normalOrientation], value);
        
        case kEntity_heading:
            return VectorToJSValue(context, vector_forward_from_quaternion([entity normalOrientation]), value);
        
        case kEntity_status:
            *value = OOJSValueFromEntityStatus(context, [entity status]);
            return YES;
        
        case kEntity_scanClass:
            *value = OOJSValueFromScanClass(context, [entity scanClass]);
            return YES;
        
        case kEntity_mass:
            return JS_NewNumberValue(context, [entity mass], value);
        
        case kEntity_owner:
            result = [entity owner];
            if (result == entity)  result = nil;
            break;
        
        case kEntity_energy:
            return JS_NewNumberValue(context, [entity energy], value);
        
        case kEntity_maxEnergy:
            return JS_NewNumberValue(context, [entity maxEnergy], value);
        
        case kEntity_isValid:
            *value = [entity status] == STATUS_DEAD ? JSVAL_FALSE : JSVAL_TRUE;
            return YES;
 
        case kEntity_isInSpace:
            *value = OOJSValueFromBOOL([entity isInSpace]);
            return YES;
        
        case kEntity_isShip:
            *value = OOJSValueFromBOOL([entity isShip]);
            return YES;
        
        case kEntity_isStation:
            *value = OOJSValueFromBOOL([entity isStation]);
            return YES;
 
        case kEntity_isDock:
            *value = OOJSValueFromBOOL([entity isDock]);
            return YES;
            
        case kEntity_isSubEntity:
            *value = OOJSValueFromBOOL([entity isSubEntity]);
            return YES;
        
        case kEntity_isPlayer:
            *value = OOJSValueFromBOOL([entity isPlayer]);
            return YES;
            
        case kEntity_isPlanet:
            *value = OOJSValueFromBOOL([entity isPlanet]);
            return YES;
            
        case kEntity_isSun:
            *value = OOJSValueFromBOOL([entity isSun]);
            return YES;
        
        case kEntity_isSunlit:
            *value = OOJSValueFromBOOL([entity isSunlit]);
            return YES;
            
        case kEntity_isVisible:
            *value = OOJSValueFromBOOL([entity isVisible]);
            return YES;
 
        case kEntity_isVisualEffect:
            *value = OOJSValueFromBOOL([entity isVisualEffect]);
            return YES;
 
        case kEntity_isWormhole:
            *value = OOJSValueFromBOOL([entity isWormhole]);
            return YES;
            
        case kEntity_distanceTravelled:
            return JS_NewNumberValue(context, [entity distanceTravelled], value);
        
        case kEntity_spawnTime:
            return JS_NewNumberValue(context, [entity spawnTime], value);
        
        default:
            OOJSReportBadPropertySelector(context, this, propID, sEntityProperties);
    }
    
    *value = OOJSValueFromNativeObject(context, result);
    return YES;
    
    OOJS_NATIVE_EXIT
}

References EXPECT_NOT, HPVectorToJSValue(), kEntity_collisionRadius, kEntity_distanceTravelled, kEntity_energy, kEntity_heading, kEntity_isDock, kEntity_isInSpace, kEntity_isPlanet, kEntity_isPlayer, kEntity_isShip, kEntity_isStation, kEntity_isSubEntity, kEntity_isSun, kEntity_isSunlit, kEntity_isValid, kEntity_isVisible, kEntity_isVisualEffect, kEntity_isWormhole, kEntity_mass, kEntity_maxEnergy, kEntity_orientation, kEntity_owner, kEntity_position, kEntity_scanClass, kEntity_spawnTime, kEntity_status, nil, OOIsStaleEntity(), OOJS_NATIVE_ENTER, OOJS_NATIVE_EXIT, OOJSReportBadPropertySelector(), OOJSValueFromBOOL(), OOJSValueFromEntityStatus(), OOJSValueFromNativeObject(), OOJSValueFromScanClass(), Entity::owner, QuaternionToJSValue(), sEntityProperties, Entity::status, vector_forward_from_quaternion(), and VectorToJSValue().

Here is the call graph for this function:

EntitySetProperty()

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

static

Definition at line 310 of file OOJSEntity.m.

{
    if (!JSID_IS_INT(propID))  return YES;
    
    OOJS_NATIVE_ENTER(context)
    
    Entity              *entity = nil;
    double              fValue;
    HPVector                hpvValue;
    Quaternion          qValue;
    
    if (EXPECT_NOT(!OOJSEntityGetEntity(context, this, &entity)))  return NO;
    if (OOIsStaleEntity(entity))  return YES;
    
    switch (JSID_TO_INT(propID))
    {
        case kEntity_position:
            if (JSValueToHPVector(context, *value, &hpvValue))
            {
                [entity setPosition:hpvValue];
                if ([entity isShip])
                {
                    [(ShipEntity *)entity resetExhaustPlumes];
                    [(ShipEntity *)entity forceAegisCheck];
                }
                return YES;
            }
            break;
            
        case kEntity_orientation:
            if (JSValueToQuaternion(context, *value, &qValue))
            {
                [entity setNormalOrientation:qValue];
                return YES;
            }
            break;
            
        case kEntity_energy:
            if (JS_ValueToNumber(context, *value, &fValue))
            {
                fValue = OOClamp_0_max_d(fValue, [entity maxEnergy]);
                [entity setEnergy:fValue];
                return YES;
            }
            break;
 
        case kEntity_maxEnergy:
            if (JS_ValueToNumber(context, *value, &fValue))
            {
                if (fValue <= 0.0)
                {
                    OOJSReportError(context, @"entity.maxEnergy must be positive.");
                    return NO;
                }
                [entity setMaxEnergy:fValue];
                return YES;
            }
            break;
 
 
        case kEntity_scanClass:
            if ([entity isShip] && ![entity isPlayer])
            {
                OOScanClass newClass = OOScanClassFromJSValue(context, *value);
                if (newClass == CLASS_NOT_SET || newClass == CLASS_NO_DRAW || newClass == CLASS_TARGET || newClass == CLASS_WORMHOLE || newClass == CLASS_PLAYER || newClass == CLASS_VISUAL_EFFECT)
                {
                    OOJSReportError(context, @"entity.scanClass cannot be set to that value.");
                    return NO;
                }
                [entity setScanClass:newClass];
                return YES;
            }
            else
            {
                OOJSReportError(context, @"entity.scanClass is read-only except on NPC ships.");
                return NO;
            }
        default:
            OOJSReportBadPropertySelector(context, this, propID, sEntityProperties);
            return NO;
    }
    
    OOJSReportBadPropertyValue(context, this, propID, sEntityProperties, *value);
    return NO;
    
    OOJS_NATIVE_EXIT
}

References EXPECT_NOT, JSValueToHPVector(), JSValueToQuaternion(), kEntity_energy, kEntity_maxEnergy, kEntity_orientation, kEntity_position, kEntity_scanClass, nil, OOIsStaleEntity(), OOJS_NATIVE_ENTER, OOJS_NATIVE_EXIT, OOJSReportBadPropertySelector(), OOJSReportBadPropertyValue(), OOJSReportError(), OOScanClassFromJSValue(), sEntityProperties, Entity::setEnergy:, Entity::setMaxEnergy:, Entity::setNormalOrientation:, Entity::setPosition:, and Entity::setScanClass:.

Here is the call graph for this function:

InitOOJSEntity()

void InitOOJSEntity	(	JSContext *	context,
		JSObject *	global )

Definition at line 139 of file OOJSEntity.m.

{
    gOOEntityJSPrototype = JS_InitClass(context, global, NULL, &gOOEntityJSClass, OOJSUnconstructableConstruct, 0, sEntityProperties, sEntityMethods, NULL, NULL);
    OOJSRegisterObjectConverter(&gOOEntityJSClass, OOJSBasicPrivateObjectConverter);
}

References gOOEntityJSClass, gOOEntityJSPrototype, OOJSBasicPrivateObjectConverter(), OOJSRegisterObjectConverter(), OOJSUnconstructableConstruct(), sEntityMethods, and sEntityProperties.

Here is the call graph for this function:

JSValueToEntity()

BOOL JSValueToEntity	(	JSContext *	context,
		jsval	value,
		Entity **	outEntity )

Definition at line 146 of file OOJSEntity.m.

{
    if (JSVAL_IS_OBJECT(value))
    {
        return OOJSEntityGetEntity(context, JSVAL_TO_OBJECT(value), outEntity);
    }
    
    return NO;
}

Referenced by ConsoleInspectEntity(), EntityFromArgumentList(), GetRelativeToAndRange(), PlayerShipSetProperty(), and ShipSetProperty().

Here is the caller graph for this function:

Variable Documentation

gOOEntityJSClass

JSClass gOOEntityJSClass

Initial value:

=
{
    "Entity",
    JSCLASS_HAS_PRIVATE,
    
    JS_PropertyStub,        
    JS_PropertyStub,        
    EntityGetProperty,      
    EntitySetProperty,      
    JS_EnumerateStub,       
    JS_ResolveStub,         
    JS_ConvertStub,         
    OOJSObjectWrapperFinalize,
    JSCLASS_NO_OPTIONAL_MEMBERS
}

Definition at line 48 of file OOJSEntity.m.

{
    "Entity",
    JSCLASS_HAS_PRIVATE,
    
    JS_PropertyStub,        // addProperty
    JS_PropertyStub,        // delProperty
    EntityGetProperty,      // getProperty
    EntitySetProperty,      // setProperty
    JS_EnumerateStub,       // enumerate
    JS_ResolveStub,         // resolve
    JS_ConvertStub,         // convert
    OOJSObjectWrapperFinalize,// finalize
    JSCLASS_NO_OPTIONAL_MEMBERS
};

Referenced by InitOOJSEntity(), and JSEntityClass().

gOOEntityJSPrototype

JSObject* gOOEntityJSPrototype

Definition at line 38 of file OOJSEntity.m.

Referenced by InitOOJSEntity(), and JSEntityPrototype().

sEntityMethods

JSFunctionSpec sEntityMethods[]

static

Initial value:

=
{
    
    { "toString",               OOJSObjectWrapperToString,  0 },
 
    { "dumpState",              EntityDumpState,            0 },
 
    { 0 }
}

Definition at line 128 of file OOJSEntity.m.

{
    // JS name                  Function                    min args
    { "toString",               OOJSObjectWrapperToString,  0 },
#ifndef NDEBUG
    { "dumpState",              EntityDumpState,            0 },
#endif
    { 0 }
};

Referenced by InitOOJSEntity().

sEntityProperties

JSPropertySpec sEntityProperties[]

static

Initial value:

=
{
    
    { "collisionRadius",        kEntity_collisionRadius,    OOJS_PROP_READONLY_CB },
    { "distanceTravelled",      kEntity_distanceTravelled,  OOJS_PROP_READONLY_CB },
    { "energy",                 kEntity_energy,             OOJS_PROP_READWRITE_CB },
    { "heading",                kEntity_heading,            OOJS_PROP_READONLY_CB },
    { "mass",                   kEntity_mass,               OOJS_PROP_READONLY_CB },
    { "maxEnergy",              kEntity_maxEnergy,          OOJS_PROP_READWRITE_CB },
    { "orientation",            kEntity_orientation,        OOJS_PROP_READWRITE_CB },
    { "owner",                  kEntity_owner,              OOJS_PROP_READONLY_CB },
    { "position",               kEntity_position,           OOJS_PROP_READWRITE_CB },
    { "scanClass",              kEntity_scanClass,          OOJS_PROP_READWRITE_CB },
    { "spawnTime",              kEntity_spawnTime,          OOJS_PROP_READONLY_CB },
    { "status",                 kEntity_status,             OOJS_PROP_READONLY_CB },
    { "isPlanet",               kEntity_isPlanet,           OOJS_PROP_READONLY_CB },
    { "isPlayer",               kEntity_isPlayer,           OOJS_PROP_READONLY_CB },
    { "isShip",                 kEntity_isShip,             OOJS_PROP_READONLY_CB },
    { "isDock",                 kEntity_isDock,             OOJS_PROP_READONLY_CB },
    { "isStation",              kEntity_isStation,          OOJS_PROP_READONLY_CB },
    { "isSubEntity",            kEntity_isSubEntity,        OOJS_PROP_READONLY_CB },
    { "isSun",                  kEntity_isSun,              OOJS_PROP_READONLY_CB },
    { "isSunlit",               kEntity_isSunlit,           OOJS_PROP_READONLY_CB },
    { "isValid",                kEntity_isValid,            OOJS_PROP_READONLY_CB },
    { "isInSpace",              kEntity_isInSpace,          OOJS_PROP_READONLY_CB },
    { "isVisible",              kEntity_isVisible,          OOJS_PROP_READONLY_CB },
    { "isVisualEffect",         kEntity_isVisualEffect,     OOJS_PROP_READONLY_CB },
    { "isWormhole",         kEntity_isWormhole,     OOJS_PROP_READONLY_CB },
    { 0 }
}

Definition at line 96 of file OOJSEntity.m.

{
    // JS name                  ID                          flags
    { "collisionRadius",        kEntity_collisionRadius,    OOJS_PROP_READONLY_CB },
    { "distanceTravelled",      kEntity_distanceTravelled,  OOJS_PROP_READONLY_CB },
    { "energy",                 kEntity_energy,             OOJS_PROP_READWRITE_CB },
    { "heading",                kEntity_heading,            OOJS_PROP_READONLY_CB },
    { "mass",                   kEntity_mass,               OOJS_PROP_READONLY_CB },
    { "maxEnergy",              kEntity_maxEnergy,          OOJS_PROP_READWRITE_CB },
    { "orientation",            kEntity_orientation,        OOJS_PROP_READWRITE_CB },
    { "owner",                  kEntity_owner,              OOJS_PROP_READONLY_CB },
    { "position",               kEntity_position,           OOJS_PROP_READWRITE_CB },
    { "scanClass",              kEntity_scanClass,          OOJS_PROP_READWRITE_CB },
    { "spawnTime",              kEntity_spawnTime,          OOJS_PROP_READONLY_CB },
    { "status",                 kEntity_status,             OOJS_PROP_READONLY_CB },
    { "isPlanet",               kEntity_isPlanet,           OOJS_PROP_READONLY_CB },
    { "isPlayer",               kEntity_isPlayer,           OOJS_PROP_READONLY_CB },
    { "isShip",                 kEntity_isShip,             OOJS_PROP_READONLY_CB },
    { "isDock",                 kEntity_isDock,             OOJS_PROP_READONLY_CB },
    { "isStation",              kEntity_isStation,          OOJS_PROP_READONLY_CB },
    { "isSubEntity",            kEntity_isSubEntity,        OOJS_PROP_READONLY_CB },
    { "isSun",                  kEntity_isSun,              OOJS_PROP_READONLY_CB },
    { "isSunlit",               kEntity_isSunlit,           OOJS_PROP_READONLY_CB },
    { "isValid",                kEntity_isValid,            OOJS_PROP_READONLY_CB },
    { "isInSpace",              kEntity_isInSpace,          OOJS_PROP_READONLY_CB },
    { "isVisible",              kEntity_isVisible,          OOJS_PROP_READONLY_CB },
    { "isVisualEffect",         kEntity_isVisualEffect,     OOJS_PROP_READONLY_CB },
    { "isWormhole",         kEntity_isWormhole,     OOJS_PROP_READONLY_CB },
    { 0 }
};

Referenced by EntityGetProperty(), EntitySetProperty(), and InitOOJSEntity().