#include <WormholeEntity.h>

Inheritance diagram for WormholeEntity:

Collaboration diagram for WormholeEntity:

Instance Methods
(WormholeEntity *)	- initWithDict:

(WormholeEntity *)	- initWormholeTo:fromShip:

(BOOL)	- suckInShip:

(void)	- disgorgeShips

(void)	- setExitPosition:

(OOSystemID)	- origin

(OOSystemID)	- destination

(NSPoint)	- originCoordinates

(NSPoint)	- destinationCoordinates

(void)	- setMisjump

(void)	- setMisjumpWithRange:

(BOOL)	- withMisjump

(GLfloat)	- misjumpRange

(double)	- exitSpeed

(void)	- setExitSpeed:

(double)	- expiryTime

(double)	- arrivalTime

(double)	- estimatedArrivalTime

(double)	- travelTime

(double)	- scanTime

(void)	- setScannedAt:

(void)	- setContainsPlayer:

(BOOL)	- isScanned

(WORMHOLE_SCANINFO)	- scanInfo

(void)	- setScanInfo:

(NSArray *)	- shipsInTransit

(NSString *)	- identFromShip:

(NSDictionary *)	- getDict

(void)	- dealloc `[implementation]`

(NSString *)	- descriptionComponents `[implementation]`

(BOOL)	- canCollide `[implementation]`

(BOOL)	- checkCloseCollisionWith: `[implementation]`

(void)	- update: `[implementation]`

(void)	- drawImmediate:translucent: `[implementation]`

(NSString *)	- scanInfoString `[implementation]`

(void)	- dumpSelfState `[implementation]`

(void)	- getJSClass:andPrototype:

(NSString *)	- oo_jsClassName

(BOOL)	- isVisibleToScripts

(id)	- init `[implementation]`

Instance Methods inherited from Entity
(NSUInteger)	- sessionID

(BOOL)	- isShip

(BOOL)	- isDock

(BOOL)	- isStation

(BOOL)	- isSubEntity

(BOOL)	- isPlayer

(BOOL)	- isPlanet

(BOOL)	- isSun

(BOOL)	- isSunlit

(BOOL)	- isStellarObject

(BOOL)	- isSky

(BOOL)	- isWormhole

(BOOL)	- isEffect

(BOOL)	- isVisualEffect

(BOOL)	- isWaypoint

(BOOL)	- validForAddToUniverse

(void)	- addToLinkedLists

(void)	- removeFromLinkedLists

(void)	- updateLinkedLists

(void)	- wasAddedToUniverse

(void)	- wasRemovedFromUniverse

(void)	- warnAboutHostiles

(CollisionRegion *)	- collisionRegion

(void)	- setCollisionRegion:

(void)	- setUniversalID:

(OOUniversalID)	- universalID

(BOOL)	- throwingSparks

(void)	- setThrowSparks:

(void)	- throwSparks

(void)	- setOwner:

(id)	- owner

(ShipEntity *)	- parentEntity

(ShipEntity *)	- rootShipEntity

(void)	- setPosition:

(void)	- setPositionX:y:z:

(HPVector)	- position

(Vector)	- cameraRelativePosition

(GLfloat)	- cameraRangeFront

(GLfloat)	- cameraRangeBack

(void)	- updateCameraRelativePosition

(Vector)	- vectorTo:

(HPVector)	- absolutePositionForSubentity

(HPVector)	- absolutePositionForSubentityOffset:

(double)	- zeroDistance

(double)	- camZeroDistance

(NSComparisonResult)	- compareZeroDistance:

(BoundingBox)	- boundingBox

(GLfloat)	- mass

(Quaternion)	- orientation

(void)	- setOrientation:

(Quaternion)	- normalOrientation

(void)	- setNormalOrientation:

(void)	- orientationChanged

(void)	- setVelocity:

(Vector)	- velocity

(double)	- speed

(GLfloat)	- distanceTravelled

(void)	- setDistanceTravelled:

(void)	- setStatus:

(OOEntityStatus)	- status

(void)	- setScanClass:

(OOScanClass)	- scanClass

(void)	- setEnergy:

(GLfloat)	- energy

(void)	- setMaxEnergy:

(GLfloat)	- maxEnergy

(void)	- applyRoll:andClimb:

(void)	- applyRoll:climb:andYaw:

(void)	- moveForward:

(OOMatrix)	- rotationMatrix

(OOMatrix)	- drawRotationMatrix

(OOMatrix)	- transformationMatrix

(OOMatrix)	- drawTransformationMatrix

(GLfloat)	- collisionRadius

(GLfloat)	- frustumRadius

(void)	- setCollisionRadius:

(NSMutableArray *)	- collisionArray

(void)	- applyVelocity:

(void)	- takeEnergyDamage:from:becauseOf:weaponIdentifier:

(void)	- dumpState

(double)	- findCollisionRadius

(BOOL)	- isVisible

(BOOL)	- isInSpace

(BOOL)	- isImmuneToBreakPatternHide

(GLfloat)	- universalTime

(GLfloat)	- spawnTime

(GLfloat)	- timeElapsedSinceSpawn

(void)	- setAtmosphereFogging:

(OOColor *)	- fogUniform

(NSString *)	- descriptionForObjDumpBasic

(NSString *)	- descriptionForObjDump

(NSSet *)	- allTextures

(BOOL)	- checkLinkedLists `[implementation]`

(id< OOWeakReferenceSupport >)	- superShaderBindingTarget `[implementation]`

(Vector)	- relativePosition `[implementation]`

(void)	- subEntityReallyDied: `[implementation]`

(BOOL)	- isBreakPattern

(void)	- inspect `[implementation]`

(BOOL)	- isECMBlast

(NSArray *)	- debugInspectorModules `[implementation]`

(NSString *)	- inspScanClassLine

(NSString *)	- inspStatusLine

(NSString *)	- inspRetainCountLine

(NSString *)	- inspPositionLine

(NSString *)	- inspVelocityLine

(NSString *)	- inspOrientationLine

(NSString *)	- inspEnergyLine

(NSString *)	- inspOwnerLine

(NSString *)	- inspTargetLine

(NSString *)	- inspDescription `[implementation]`

(NSString *)	- inspBasicIdentityLine `[implementation]`

(BOOL)	- isExhaust

(BOOL)	- isFlasher

(void)	- deleteJSSelf

(jsval)	- oo_jsValueInContext: `[implementation]`

(BOOL)	- isCascadeWeapon

(BOOL)	- isPlayerLikeShip

(GLfloat)	- clock `[implementation]`

(unsigned)	- pseudoFixedD100 `[implementation]`

(unsigned)	- pseudoFixedD256 `[implementation]`

(unsigned)	- systemGovernment `[implementation]`

(unsigned)	- systemEconomy `[implementation]`

(unsigned)	- systemTechLevel `[implementation]`

(unsigned)	- systemPopulation `[implementation]`

(unsigned)	- systemProductivity `[implementation]`

(BOOL)	- isShipWithSubEntityShip:

(void)	- drawSubEntityImmediate:translucent: `[implementation]`

Instance Methods inherited from OOWeakRefObject
(id)	- weakSelf

(id)	- weakRetain `[implementation]`

(void)	- weakRefDied: `[implementation]`

Instance Methods inherited from <OOWeakReferenceSupport>
(id)	- OO_RETURNS_RETAINED

Class Methods
(static void)	+ DrawWormholeCorona `[implementation]`

Private Attributes
double	expiry_time

double	travel_time

double	arrival_time

double	estimated_arrival_time

double	scan_time

OOSystemID	origin

OOSystemID	destination

NSPoint	originCoords

NSPoint	destinationCoords

NSMutableArray *	shipsInTransit

double	witch_mass

double	shrink_factor

double	exit_speed

WORMHOLE_SCANINFO	scan_info

BOOL	hasExitPosition

BOOL	_misjump

GLfloat	_misjumpRange

BOOL	containsPlayer

Additional Inherited Members
Public Attributes inherited from Entity
OOUniversalID	universalID

unsigned	isShip: 1

unsigned	isStation: 1

unsigned	isPlayer: 1

unsigned	isWormhole: 1

unsigned	isSubEntity: 1

unsigned	hasMoved: 1

unsigned	hasRotated: 1

unsigned	hasCollided: 1

unsigned	isSunlit: 1

unsigned	collisionTestFilter: 2

unsigned	throw_sparks: 1

unsigned	isImmuneToBreakPatternHide: 1

unsigned	isExplicitlyNotMainStation: 1

unsigned	isVisualEffect: 1

OOScanClass	scanClass

GLfloat	zero_distance

GLfloat	cam_zero_distance

GLfloat	no_draw_distance

GLfloat	collision_radius

HPVector	position

Vector	cameraRelativePosition

Quaternion	orientation

OOColor *	atmosphereFogging

int	zero_index

Entity *	x_previous

Entity *	x_next

Entity *	y_previous

Entity *	y_next

Entity *	z_previous

Entity *	z_next

Entity *	collision_chain

OOUniversalID	shadingEntityID

Entity *	collider

CollisionRegion *	collisionRegion

Protected Attributes inherited from Entity
HPVector	lastPosition

Quaternion	lastOrientation

GLfloat	distanceTravelled

OOMatrix	rotMatrix

Vector	velocity

GLfloat	energy

GLfloat	maxEnergy

BoundingBox	boundingBox

GLfloat	mass

NSMutableArray *	collidingEntities

OOTimeAbsolute	spawnTime

struct JSObject *	_jsSelf

Protected Attributes inherited from OOWeakRefObject
OOWeakReference *	weakSelf

Detailed Description

Definition at line 47 of file WormholeEntity.h.

Method Documentation

◆ arrivalTime

- (double) arrivalTime

Definition at line 54 of file WormholeEntity.m.

{
    return arrival_time;
}

References Entity::setStatus:.

Here is the call graph for this function:

◆ canCollide

- (BOOL) canCollide

implementation

Reimplemented from Entity.

Definition at line 54 of file WormholeEntity.m.

{
    /* Correct test for far end of wormhole */
    if (origin != [UNIVERSE currentSystemID])
    {
        // if we're no longer in the origin system, can't suck in
        return NO;
    }
    if ([PLAYER galaxy_coordinates].x != originCoords.x || [PLAYER galaxy_coordinates].y != originCoords.y)
    {
        // if we're no longer at the origin coordinates, can't suck in (handles interstellar space case)
        return NO;
    }
 
    return (witch_mass > 0.0);
}

◆ checkCloseCollisionWith:

- (BOOL) checkCloseCollisionWith: (Entity *) other

implementation

Reimplemented from Entity.

Definition at line 54 of file WormholeEntity.m.

                                :(Entity *)other
{
    return ![other isEffect];
}

◆ dealloc

- (void) dealloc

implementation

Reimplemented from Entity.

Definition at line 54 of file WormholeEntity.m.

{
    [shipsInTransit release];
    
    [super dealloc];
}

◆ descriptionComponents

- (NSString *) descriptionComponents

implementation

Reimplemented from Entity.

Definition at line 54 of file WormholeEntity.m.

{
    double now = [PLAYER clockTime];
    return [NSString stringWithFormat:@"destination: %@ ttl: %.2fs arrival: %@",
        _misjump ? (NSString *)@"Interstellar Space" : [UNIVERSE getSystemName:destination],
        expiry_time - now,
        ClockToString(arrival_time, false)];
}

◆ destination

- (OOSystemID) destination

◆ destinationCoordinates

- (NSPoint) destinationCoordinates

Definition at line 54 of file WormholeEntity.m.

{
    return destinationCoords;
}

◆ disgorgeShips

- (void) disgorgeShips

Definition at line 54 of file WormholeEntity.m.

{
    double now = [PLAYER clockTimeAdjusted];
    NSMutableArray* shipsStillInTransit = [[NSMutableArray alloc] initWithCapacity:[shipsInTransit count]];
    BOOL hasShiftedExitPosition = NO;
    BOOL useExitXYScatter = NO;
    
    NSDictionary *shipInfo = nil;
    foreach (shipInfo, shipsInTransit)
    {
        ShipEntity *ship = [shipInfo objectForKey:@"ship"];
        NSString *shipBeacon = [shipInfo objectForKey:@"shipBeacon"];
        double  ship_arrival_time = arrival_time + [shipInfo oo_doubleForKey:@"time"];
        double  time_passed = now - ship_arrival_time;
        
        if ([ship status] == STATUS_DEAD) continue; // skip dead ships.
        
        if (ship_arrival_time > now)
        {
            [shipsStillInTransit addObject:shipInfo];
        }
        else
        {
            // Only calculate exit position once so that all ships arrive from the same point
            if (!hasExitPosition)
            {
                position = [UNIVERSE getWitchspaceExitPosition];    // no need to reset PRNG.
                GLfloat min_d1 = [UNIVERSE safeWitchspaceExitDistance];
                Quaternion  q1;
                quaternion_set_random(&q1);
                double      d1 = SCANNER_MAX_RANGE*((ranrot_rand() % 256)/256.0 - 0.5);
                Vector      v1 = vector_forward_from_quaternion(q1);
                if (dot_product(v1,kBasisZVector) < -0.99)
                {
                    // a bit more safe distance if right behind the buoy
                    min_d1 *= 3.0;
                }
 
                if (fabs(d1) < min_d1)  // no closer than 750m to edge of buoy
                {
                    d1 += ((d1 > 0.0)? min_d1: -min_d1);
                }
                position.x += v1.x * d1; // randomise exit position
                position.y += v1.y * d1;
                position.z += v1.z * d1;
            }
            
            if (hasExitPosition && (!containsPlayer || useExitXYScatter))
            {
                HPVector shippos;
                Vector exit_vector_x = vector_right_from_quaternion([UNIVERSE getWitchspaceExitRotation]);          
                Vector exit_vector_y = vector_up_from_quaternion([UNIVERSE getWitchspaceExitRotation]);
// entry wormhole has a radius of around 100m (or perhaps more)
// so randomise exit positions slightly too for second and subsequent ships
// helps avoid collisions when two ships enter wormhole at same time
                double offset_x = randf()*150.0-75.0;
                double offset_y = randf()*150.0-75.0;
                shippos.x = position.x + (offset_x*exit_vector_x.x)+(offset_y*exit_vector_y.x);
                shippos.y = position.y + (offset_x*exit_vector_x.y)+(offset_y*exit_vector_y.y);
                shippos.z = position.z + (offset_x*exit_vector_x.z)+(offset_y*exit_vector_y.z);
                [ship setPosition:shippos];
            }
            else
            {
                // this is the first ship out of the wormhole
                [self setExitSpeed:[ship maxFlightSpeed]*WORMHOLE_LEADER_SPEED_FACTOR];
                if (containsPlayer)
                { // reset the player's speed to the new speed
                    [PLAYER setSpeed:exit_speed];
                }
                useExitXYScatter = YES;
                [ship setPosition:position];
            }
 
            if (shipBeacon != nil)
            {
                [ship setBeaconCode:shipBeacon];
            }
            
            // Don't reduce bounty on misjump. Fixes #17992
            // - MKW 2011.03.10 
            if (!_misjump)  [ship setBounty:[ship bounty]/2 withReason:kOOLegalStatusReasonNewSystem];  // adjust legal status for new system
            
            // now the cargo is defined in advance, this is unnecessary
/*          if ([ship cargoFlag] == CARGO_FLAG_FULL_PLENTIFUL)
            {
                [ship setCargoFlag: CARGO_FLAG_FULL_SCARCE];
                }*/
            
            if (time_passed < 2.0)
            {
                [ship witchspaceLeavingEffects]; // adds the ship to the universe with effects.
            }
            else
            {
                // arrived 2 seconds or more before the player. Rings have faded out.
                [ship setOrientation: [UNIVERSE getWitchspaceExitRotation]];
                [ship setPitch: 0.0];
                [ship setRoll: 0.0];
                [ship setVelocity: kZeroVector];
                [UNIVERSE addEntity:ship];  // AI and status get initialised here
            }
            [ship setSpeed:[self exitSpeed]]; // all ships from this wormhole have same velocity
 
            // awaken JS-based AIs
            [ship doScriptEvent:OOJSID("aiStarted")];
 
            // Wormholes now have a JS representation, so we could provide it
            // but is it worth it for the exit wormhole?
            [ship doScriptEvent:OOJSID("shipExitedWormhole") andReactToAIMessage:@"EXITED WITCHSPACE"];
        
            // update the ships's position
            if (!hasExitPosition)
            {
                hasExitPosition = YES;
                hasShiftedExitPosition = YES; // exitPosition is shifted towards the lead ship update position.
                [ship update: time_passed]; // do this only for one ship or the next ships might appear at very different locations.
                position = [ship position]; // e.g. when the player docks first before following, time_passed is already > 10 minutes.
            }
            else if (time_passed > 1) // Only update the ship position if it was some time ago, otherwise we're in 'real time'.
            {
                if (hasShiftedExitPosition)
                {
                    // only update the time delay to the lead ship. Sign is not correct but updating gives a small spacial distribution.
                    [ship update: (ship_arrival_time - arrival_time)];
                }
                else
                {
                    // Exit position was externally set, e.g. by player ship following through this wormhole.
                    // Use the real time difference.
                    [ship update:time_passed];
                }
            }
        }
    }
    [shipsInTransit release];
    shipsInTransit = shipsStillInTransit;
 
    if (containsPlayer)
    {
        // ships exiting the wormhole after now are following the player
        // so appear behind them
        position = HPvector_add([PLAYER position], vectorToHPVector(vector_multiply_scalar([PLAYER forwardVector], -500.0f)));
        containsPlayer = NO;
    }
// else, the wormhole doesn't now (or never) contained the player, so
// no need to move it
}

◆ drawImmediate:translucent:

- (void) drawImmediate:		(bool)	immediate
translucent:		(bool)	translucent

implementation

Reimplemented from Entity.

Definition at line 54 of file WormholeEntity.m.

                      :(bool)immediate translucent:(bool)translucent
{   
    if ([UNIVERSE breakPatternHide])
        return;     // DON'T DRAW DURING BREAK PATTERN
    
    if (cam_zero_distance > no_draw_distance)
        return; // TOO FAR AWAY TO SEE
        
    if (witch_mass <= 0.0)
        return;
    
    if (collision_radius <= 0.0)
        return;
    
    if ([self scanClass] == CLASS_NO_DRAW)
        return;
    
    if (translucent)
    {
        // for now, a simple copy of the energy bomb draw routine
        float srzd = sqrt(cam_zero_distance);
        
        GLfloat color_fv[4] = OO_WORMHOLE_COLOR_FVEC4;
        
        OOSetOpenGLState(OPENGL_STATE_TRANSLUCENT_PASS);
        OOGL(glDisable(GL_CULL_FACE));
        OOGL(glEnable(GL_BLEND));
        
        OOGL(glColor4fv(color_fv));
        OOGLBEGIN(GL_TRIANGLE_FAN);
            GLDrawBallBillboard(0.45 * collision_radius, 4, srzd);
        OOGLEND();
                
        color_fv[3] = fmin(color_fv[3] * 2.0, 1.0);
        DrawWormholeCorona(0.45 * collision_radius, collision_radius, 4, srzd, color_fv);
                    
        OOGL(glEnable(GL_CULL_FACE));
        OOGL(glDisable(GL_BLEND));
    }
    
    OOVerifyOpenGLState();
    OOCheckOpenGLErrors(@"WormholeEntity after drawing %@", self);
}

◆ DrawWormholeCorona

+ (static void) DrawWormholeCorona	(GLfloat)	inner_radius
	(GLfloat)	outer_radius
	(int)	step
	(GLfloat)	z_distance
	(GLfloat *)	col4v1

implementation

Definition at line 741 of file WormholeEntity.m.

{
    if (outer_radius >= z_distance) // inside the sphere
        return;
    int i;
    
    NSRange             activity = { 0.34, 1.0 };
    
    GLfloat             s0, c0, s1, c1;
    
    GLfloat             r0, r1;
    GLfloat             rv0, rv1, q;
    
    GLfloat             theta, delta, halfStep;
    
    r0 = outer_radius * z_distance / sqrt(z_distance * z_distance - outer_radius * outer_radius); 
    r1 = inner_radius * z_distance / sqrt(z_distance * z_distance - inner_radius * inner_radius); 
    
    delta = step * M_PI / 180.0f;
    halfStep = 0.5f * delta;
    theta = 0.0f;
        
    OOGLBEGIN(GL_TRIANGLE_STRIP);
        for (i = 0; i < 360; i += step )
        {
            rv0 = randf();
            rv1 = randf();
            
            q = activity.location + rv0 * activity.length;
            
            s0 = r0 * sin(theta);
            c0 = r0 * cos(theta);
            glColor4f(col4v1[0] * q, col4v1[1] * q, col4v1[2] * q, col4v1[3] * rv0);
            glVertex3f(s0, c0, 0.0);
 
            s1 = r1 * sin(theta - halfStep) * 0.5 * (1.0 + rv1);
            c1 = r1 * cos(theta - halfStep) * 0.5 * (1.0 + rv1);
            glColor4f(col4v1[0] * OO_WORMHOLE_COLOR_BOOST, col4v1[1] * OO_WORMHOLE_COLOR_BOOST, col4v1[2] * OO_WORMHOLE_COLOR_BOOST, col4v1[3] * rv0);
            glVertex3f(s1, c1, 0.0);
            
            theta += delta;
        }
        // repeat last values to close
        rv0 = randf();
        rv1 = randf();
            
        q = activity.location + rv0 * activity.length;
        
        s0 = 0.0f;  // r0 * sin(0);
        c0 = r0;    // r0 * cos(0);
        glColor4f(col4v1[0] * q, col4v1[1] * q, col4v1[2] * q, col4v1[3] * rv0);
        glVertex3f(s0, c0, 0.0);
 
        s1 = r1 * sin(halfStep) * 0.5 * (1.0 + rv1);
        c1 = r1 * cos(halfStep) * 0.5 * (1.0 + rv1);
        glColor4f(col4v1[0] * OO_WORMHOLE_COLOR_BOOST, col4v1[1] * OO_WORMHOLE_COLOR_BOOST, col4v1[2] * OO_WORMHOLE_COLOR_BOOST, col4v1[3] * rv0);
        glVertex3f(s1, c1, 0.0);
    OOGLEND();
}

References M_PI, OO_WORMHOLE_COLOR_BOOST, OOGLBEGIN, OOGLEND, and randf().

Here is the call graph for this function:

◆ dumpSelfState

- (void) dumpSelfState

implementation

Reimplemented from Entity.

Definition at line 741 of file WormholeEntity.m.

{
    [super dumpSelfState];
    OOLog(@"dumpState.wormholeEntity", @"Origin                 : %@", [UNIVERSE getSystemName:origin]);
    OOLog(@"dumpState.wormholeEntity", @"Destination            : %@", [UNIVERSE getSystemName:destination]);
    OOLog(@"dumpState.wormholeEntity", @"Expiry Time            : %@", ClockToString(expiry_time, false));
    OOLog(@"dumpState.wormholeEntity", @"Arrival Time           : %@", ClockToString(arrival_time, false));
    OOLog(@"dumpState.wormholeEntity", @"Projected Arrival Time : %@", ClockToString(estimated_arrival_time, false));
    OOLog(@"dumpState.wormholeEntity", @"Scanned Time           : %@", ClockToString(scan_time, false));
    OOLog(@"dumpState.wormholeEntity", @"Scanned State          : %@", [self scanInfoString]);
 
    OOLog(@"dumpState.wormholeEntity", @"Mass                   : %.2lf", witch_mass);
    OOLog(@"dumpState.wormholeEntity", @"Ships                  : %ld", [shipsInTransit count]);
    unsigned i;
    for (i = 0; i < [shipsInTransit count]; ++i)
    {
        NSDictionary *shipDict = [shipsInTransit oo_dictionaryAtIndex:i];
        ShipEntity* ship = (ShipEntity*)[shipDict objectForKey:@"ship"];
        double  ship_arrival_time = arrival_time + [shipDict oo_doubleForKey:@"time"];
        OOLog(@"dumpState.wormholeEntity.ships", @"Ship %d: %@  mass %.2f  arrival time %@", i+1, ship, [ship mass], ClockToString(ship_arrival_time, false));
    }
}

◆ estimatedArrivalTime

- (double) estimatedArrivalTime

Definition at line 54 of file WormholeEntity.m.

{
    return estimated_arrival_time;
}

◆ exitSpeed

- (double) exitSpeed

Definition at line 54 of file WormholeEntity.m.

{
    return exit_speed;
}

◆ expiryTime

- (double) expiryTime

Definition at line 54 of file WormholeEntity.m.

{
    return expiry_time;
}

◆ getDict

- (NSDictionary *) getDict

Definition at line 741 of file WormholeEntity.m.

{
    NSMutableDictionary *myDict = [NSMutableDictionary dictionary];
 
    [myDict oo_setInteger:origin forKey:@"origin_id"];
    [myDict oo_setInteger:destination forKey:@"dest_id"];
    [myDict setObject:StringFromPoint(originCoords) forKey:@"origin_coords"];
    [myDict setObject:StringFromPoint(destinationCoords) forKey:@"dest_coords"];
    // Anything converting a wormhole to a dictionary should already have 
    // modified its time to shipClock time
    [myDict oo_setFloat:(expiry_time) forKey:@"expiry_time"];
    [myDict oo_setFloat:(arrival_time) forKey:@"arrival_time"];
    [myDict oo_setFloat:(estimated_arrival_time) forKey:@"estimated_arrival_time"];
    [myDict oo_setHPVector:position forKey:@"position"];
    [myDict oo_setBool:_misjump forKey:@"misjump"];
    
    NSMutableArray * shipArray = [NSMutableArray arrayWithCapacity:[shipsInTransit count]];
    NSEnumerator * ships = [shipsInTransit objectEnumerator];
    NSDictionary * currShipDict = nil;
    NSMutableDictionary *context = [NSMutableDictionary dictionary];
    while ((currShipDict = [ships nextObject]) != nil)
    {
        id ship = [currShipDict objectForKey:@"ship"];
        [shipArray addObject:[NSDictionary dictionaryWithObjectsAndKeys:
                              [NSNumber numberWithDouble:[currShipDict oo_doubleForKey:@"time"]], @"time_delta",
                              [ship savedShipDictionaryWithContext:context], @"ship_info",
                              nil]];
    }
    [myDict setObject:shipArray forKey:@"ships"];
 
    return myDict;
}

◆ getJSClass:andPrototype:

- (void) getJSClass:		(JSClass **)	outClass
andPrototype:		(JSObject **)	outPrototype

Reimplemented from Entity.

Provided by category WormholeEntity(OOJavaScriptExtensions).

Definition at line 179 of file OOJSWormhole.m.

                  :(JSClass **)outClass andPrototype:(JSObject **)outPrototype
{
    *outClass = &sWormholeClass;
    *outPrototype = sWormholePrototype;
}

◆ identFromShip:

- (NSString *) identFromShip: (ShipEntity*) ship

Definition at line 54 of file WormholeEntity.m.

                            :(ShipEntity*)ship
{
    if ([ship hasEquipmentItem:@"EQ_WORMHOLE_SCANNER"])
    {
        if ([self scanInfo] >= WH_SCANINFO_DESTINATION)
        {
            return [NSString stringWithFormat:DESC(@"wormhole-to-@"), [UNIVERSE getSystemName:destination]];
        }
        else
        {
            return DESC(@"wormhole-desc");
        }
    }
    else
    {
        OOLogERR(kOOLogInconsistentState, @"%@", @"Wormhole identified when ship has no EQ_WORMHOLE_SCANNER.");
        /*
            This was previously an assertion, but a player reported hitting it.
            http://aegidian.org/bb/viewtopic.php?p=128110#p128110
            -- Ahruman 2011-01-27
        */
        return nil;
    }
 
}

◆ init

- (id) init

implementation

Reimplemented from Entity.

Provided by category WormholeEntity(Private).

Definition at line 54 of file WormholeEntity.m.

{
    if ((self = [super init]))
    {
        witch_mass = 0.0;
        shipsInTransit = [[NSMutableArray arrayWithCapacity:4] retain];
        collision_radius = 0.0;
        [self setStatus:STATUS_EFFECT];
        scanClass = CLASS_WORMHOLE;
        isWormhole = YES;
        scan_info = WH_SCANINFO_NONE;
        scan_time = 0;
        hasExitPosition = NO;
        containsPlayer = NO;
        exit_speed = 50.0;
    }
    return self;
}

◆ initWithDict:

- (WormholeEntity *) initWithDict: (NSDictionary*) dict

Definition at line 54 of file WormholeEntity.m.

                               :(NSDictionary*)dict
{
    assert(dict != nil);
 
    if ((self = [self init]))
    {
        NSAutoreleasePool * pool = [[NSAutoreleasePool alloc] init];
 
        // wormholes from pre-1.80 savegames using "origin_seed" and "dest_seed"
        // currently get defaults set; will probably disappear unnoticed
        origin = [dict oo_intForKey:@"origin_id" defaultValue:0];
        destination = [dict oo_intForKey:@"dest_id" defaultValue:255];
 
        originCoords = [[UNIVERSE systemManager] getCoordinatesForSystem:origin inGalaxy:[PLAYER galaxyNumber]];
        destinationCoords = [[UNIVERSE systemManager] getCoordinatesForSystem:destination inGalaxy:[PLAYER galaxyNumber]];
 
        // We only ever init from dictionary if we're loaded by the player, so
        // by definition we have been scanned
        scan_info = WH_SCANINFO_SCANNED;
 
        // Remember, times are stored as Ship Clock - but anything
        // saving/restoring wormholes from dictionaries should know this!
        expiry_time = [dict oo_doubleForKey:@"expiry_time"];
        arrival_time = [dict oo_doubleForKey:@"arrival_time"];
        // just in case an old save game has one with crossed times
        if (expiry_time > arrival_time)
        {
            expiry_time = arrival_time - 1.0; 
        }
 
        // Since this is new for 1.75.1, we must give it a default values as we could be loading an old savegame
        estimated_arrival_time = [dict oo_doubleForKey:@"estimated_arrival_time" defaultValue:arrival_time];
        position = [dict oo_hpvectorForKey:@"position"];
        _misjump = [dict oo_boolForKey:@"misjump" defaultValue:NO];
        
        
        // Setup shipsInTransit
        NSArray * shipDictsArray = [dict oo_arrayForKey:@"ships"];
        NSEnumerator *shipDicts = [shipDictsArray objectEnumerator];
        NSDictionary *currShipDict = nil;
        [shipsInTransit removeAllObjects];
        NSMutableDictionary *restoreContext = [NSMutableDictionary dictionary];
        
        while ((currShipDict = [shipDicts nextObject]) != nil)
        {
            NSDictionary *shipInfo = [currShipDict oo_dictionaryForKey:@"ship_info"];
            if (shipInfo != nil)
            {
                ShipEntity *ship = [ShipEntity shipRestoredFromDictionary:shipInfo
                                                              useFallback:YES
                                                                  context:restoreContext];
                if (ship != nil)
                {
                    [shipsInTransit addObject:[NSDictionary dictionaryWithObjectsAndKeys:
                                               ship, @"ship",
                                               [currShipDict objectForKey:@"time_delta"], @"time",
                                               nil]];
                }
                else
                {
                    OOLog(@"wormhole.load.warning", @"Wormhole ship \"%@\" failed to initialize - missing OXP or old-style saved wormhole data.", [shipInfo oo_stringForKey:@"ship_key"]);
                }
            }
        }
        [pool release];
    }
    return self;
}

◆ initWormholeTo:fromShip:

- (WormholeEntity *) initWormholeTo:		(OOSystemID)	s
fromShip:		(ShipEntity *)	ship

Definition at line 54 of file WormholeEntity.m.

                                  :(OOSystemID) s fromShip:(ShipEntity *) ship
{
    assert(ship != nil);
 
    if ((self = [self init]))
    {
        double      now = [PLAYER clockTimeAdjusted];
        double      distance;
        OOSunEntity *sun = [UNIVERSE sun];
        
        _misjump = NO;
        origin = [UNIVERSE currentSystemID];
        destination = s;
        originCoords = [PLAYER galaxy_coordinates];
        destinationCoords = [[UNIVERSE systemManager] getCoordinatesForSystem:destination inGalaxy:[PLAYER galaxyNumber]];
        distance = distanceBetweenPlanetPositions(originCoords.x, originCoords.y, destinationCoords.x, destinationCoords.y);
        distance = fmax(distance, 0.1);
        witch_mass = 200000.0; // MKW 2010.11.21 - originally the ship's mass was added twice - once here and once in suckInShip.  Instead, we give each wormhole a minimum mass.
        if ([ship isPlayer])
            witch_mass += [ship mass]; // The player ship never gets sucked in, so add its mass here.
 
        if (sun && ([sun willGoNova] || [sun goneNova]) && [ship mass] > 240000) 
            shrink_factor = [ship mass] / 240000; // don't allow longstanding wormholes in nova systems. (60 sec * WORMHOLE_SHRINK_RATE = 240 000)
        else
            shrink_factor = 1;
            
        collision_radius = 0.5 * M_PI * pow(witch_mass, 1.0/3.0);
        expiry_time = now + (witch_mass / WORMHOLE_SHRINK_RATE / shrink_factor);
        travel_time = (distance * distance * 3600); // Taken from PlayerEntity.h
        arrival_time = now + travel_time;
        estimated_arrival_time = arrival_time;
 
        /* There are a number of bugs where the arrival time is < than the
         * expiry time (i.e. both ends open at once).
         * Rather than try to flatten all of them, having been unsuccessful twice
         * it seems easier to declare as a matter of wormhole physics that it 
         * _can't_ be open at both ends at once. - CIM: 13/12/12 */
        if (expiry_time > arrival_time)
        {
            expiry_time = arrival_time - 1.0; 
        }
        position = [ship position];
        zero_distance = HPdistance2([PLAYER position], position);
    }   
    return self;
}

◆ isScanned

- (BOOL) isScanned

Definition at line 54 of file WormholeEntity.m.

{
    return scan_info > WH_SCANINFO_NONE;
}

◆ isVisibleToScripts

- (BOOL) isVisibleToScripts

Reimplemented from Entity.

Provided by category WormholeEntity(OOJavaScriptExtensions).

Definition at line 179 of file OOJSWormhole.m.

{
    return YES;
}

◆ misjumpRange

- (GLfloat) misjumpRange

Definition at line 54 of file WormholeEntity.m.

{
    return _misjumpRange;
}

◆ oo_jsClassName

- (NSString *) oo_jsClassName

Reimplemented from Entity.

Provided by category WormholeEntity(OOJavaScriptExtensions).

Definition at line 179 of file OOJSWormhole.m.

{
    return @"Wormhole";
}

◆ origin

- (OOSystemID) origin

◆ originCoordinates

- (NSPoint) originCoordinates

Definition at line 54 of file WormholeEntity.m.

{
    return originCoords;
}

◆ scanInfo

- (WORMHOLE_SCANINFO) scanInfo

Definition at line 54 of file WormholeEntity.m.

{
    return scan_info;
}

◆ scanInfoString

- (NSString *) scanInfoString

implementation

Definition at line 741 of file WormholeEntity.m.

{
    switch(scan_info)
    {
        case WH_SCANINFO_NONE: return @"WH_SCANINFO_NONE";
        case WH_SCANINFO_SCANNED: return @"WH_SCANINFO_SCANNED";
        case WH_SCANINFO_COLLAPSE_TIME: return @"WH_SCANINFO_COLLAPSE_TIME";
        case WH_SCANINFO_ARRIVAL_TIME: return @"WH_SCANINFO_ARRIVAL_TIME";
        case WH_SCANINFO_DESTINATION: return @"WH_SCANINFO_DESTINATION";
        case WH_SCANINFO_SHIP: return @"WH_SCANINFO_SHIP";
    }
    return @"WH_SCANINFO_UNDEFINED"; // should never get here
}

◆ scanTime

- (double) scanTime

Definition at line 54 of file WormholeEntity.m.

{
    return scan_time;
}

◆ setContainsPlayer:

- (void) setContainsPlayer: (BOOL) val

Definition at line 54 of file WormholeEntity.m.

                          :(BOOL)val
{
    containsPlayer = val;
}

◆ setExitPosition:

- (void) setExitPosition: (HPVector) pos

Definition at line 54 of file WormholeEntity.m.

                        :(HPVector)pos
{
    [self setPosition: pos];
    hasExitPosition = YES;
}

◆ setExitSpeed:

- (void) setExitSpeed: (double) speed

Definition at line 54 of file WormholeEntity.m.

                     :(double) speed
{
    exit_speed = speed;
}

◆ setMisjump

- (void) setMisjump

Definition at line 54 of file WormholeEntity.m.

{
    // Test for misjump first - it's entirely possibly that the wormhole
    // has already been marked for misjumping when another ship enters it.
    if (!_misjump)
    {
        double distance = distanceBetweenPlanetPositions(originCoords.x, originCoords.y, destinationCoords.x, destinationCoords.y);
        double time_adjust = distance * distance * (3600 - 2700); // NB: Time adjustment is calculated using original distance. Formula matches the one in [PlayerEntity witchJumpTo]
        arrival_time -= time_adjust;
        travel_time -= time_adjust;
        destinationCoords.x = (originCoords.x + destinationCoords.x) / 2;
        destinationCoords.y = (originCoords.y + destinationCoords.y) / 2;
        _misjump = YES;
    }
}

◆ setMisjumpWithRange:

- (void) setMisjumpWithRange: (GLfloat) range

Definition at line 54 of file WormholeEntity.m.

                            :(GLfloat)range
{
    if (range <= 0.0 || range >= 1.0)
    {
        range = 0.5; // for safety, though nothing should be setting this
    }
    _misjumpRange = range;
    // Test for misjump first - it's entirely possibly that the wormhole
    // has already been marked for misjumping when another ship enters it.
    if (!_misjump)
    {
        double distance = distanceBetweenPlanetPositions(originCoords.x, originCoords.y, destinationCoords.x, destinationCoords.y);
        double time_adjust = (distance * (1-_misjumpRange))*(distance * (1-_misjumpRange))*3600.0;
        // time adjustment ensures that misjumps not faster than normal jumps
        // formulae for time and distance by mwerle at http://developer.berlios.de/pm/task.php?func=detailtask&project_task_id=4703&group_id=3577&group_project_id=1753
        arrival_time -= time_adjust;
        travel_time -= time_adjust;
    
        destinationCoords.x = (originCoords.x * (1-_misjumpRange)) + (destinationCoords.x * _misjumpRange);
        destinationCoords.y = (originCoords.y * (1-_misjumpRange)) + (destinationCoords.y * _misjumpRange);
        _misjump = YES;
    }
}

◆ setScanInfo:

- (void) setScanInfo: (WORMHOLE_SCANINFO) scanInfo

Definition at line 54 of file WormholeEntity.m.

                    :(WORMHOLE_SCANINFO)p_scanInfo
{
    scan_info = p_scanInfo;
}

◆ setScannedAt:

- (void) setScannedAt: (double) time

Definition at line 54 of file WormholeEntity.m.

                     :(double)p_scanTime
{
    if( scan_info == WH_SCANINFO_NONE )
    {
        scan_time = p_scanTime;
        scan_info = WH_SCANINFO_SCANNED;
    }
    // else we previously scanned this wormhole
}

◆ shipsInTransit

- (NSArray *) shipsInTransit

◆ suckInShip:

- (BOOL) suckInShip: (ShipEntity *) ship

Definition at line 54 of file WormholeEntity.m.

                   :(ShipEntity *) ship
{
    if (!ship || [ship status] == STATUS_ENTERING_WITCHSPACE)
    {
        return NO;
    }
    if (origin != [UNIVERSE currentSystemID])
    {
        // if we're no longer in the origin system, can't suck in
        return NO;
    }
    if ([PLAYER galaxy_coordinates].x != originCoords.x || [PLAYER galaxy_coordinates].y != originCoords.y)
    {
        // if we're no longer at the origin coordinates, can't suck in (handles interstellar space case)
        return NO;
    }
    double now = [PLAYER clockTimeAdjusted];
 
/* CIM: removed test. Not valid for wormholes which last longer than their travel time. Most likely for short distances e.g. zero-distance doubles. equal_seeds test above should cover it, with expiry_time test for safety.  */
/*  if (now > arrival_time)
        return NO;  // far end of the wormhole! */
    if( now > expiry_time )
        return NO;
    // MKW 2010.11.18 - calculate time it takes for ship to reach wormhole
    // This is for AI ships which get told to enter the wormhole even though they
    // may still be some distance from it when the player exits the system
    float d = HPdistance(position, [ship position]);
    d -= [ship collisionRadius] + [self collisionRadius];
    if (d > 0.0f)
    {
        float afterburnerFactor = [ship hasFuelInjection] && [ship fuel] > MIN_FUEL ? [ship afterburnerFactor] : 1.0;
        float shipSpeed = [ship maxFlightSpeed] * afterburnerFactor;
        // MKW 2011.02.27 - calculate speed based on group leader, if any, to
        // try and prevent escorts from entering the wormhole before their mother.
        ShipEntity *leader = [[ship group] leader];
        if (leader && (leader != ship))
        {
            afterburnerFactor = [leader hasFuelInjection] && [leader fuel] > MIN_FUEL ? [leader afterburnerFactor] : 1.0;
            float leaderShipSpeed = [leader maxFlightSpeed] * afterburnerFactor;
            if (leaderShipSpeed < shipSpeed ) shipSpeed = leaderShipSpeed;
        }
        if (shipSpeed <= 0.0f ) shipSpeed = 0.1f;
        now += d / shipSpeed;
        if( now > expiry_time ) 
        {
            return NO;
        }
    }
    
    [shipsInTransit addObject:[NSDictionary dictionaryWithObjectsAndKeys:
                        ship, @"ship",
                        [NSNumber numberWithDouble: now + travel_time - arrival_time], @"time",
                        [ship beaconCode], @"shipBeacon",   // in case a beacon code has been set, nil otherwise
                        nil]];
    witch_mass += [ship mass];
    expiry_time = now + (witch_mass / WORMHOLE_SHRINK_RATE / shrink_factor);
    // and, again, cap to be earlier than arrival time
    if (expiry_time > arrival_time)
    {
        expiry_time = arrival_time - 1.0; 
    }
 
    collision_radius = 0.5 * M_PI * pow(witch_mass, 1.0/3.0);
    
    [UNIVERSE addWitchspaceJumpEffectForShip:ship];
    
    // Should probably pass the wormhole, but they have no JS representation
    [ship setStatus:STATUS_ENTERING_WITCHSPACE];
    [ship doScriptEvent:OOJSID("shipWillEnterWormhole")];
    [[ship getAI] message:@"ENTERED_WITCHSPACE"];
 
    [UNIVERSE removeEntity:ship];
    [[ship getAI] clearStack];  // get rid of any preserved states
 
    if ([ship isStation])
    {
        if ([PLAYER dockedStation] == (StationEntity*)ship)
        {
            // the carrier has jumped while the player is docked
            [ship retain];
            [UNIVERSE carryPlayerOn:(StationEntity*)ship inWormhole:self];
            [ship release];
        }
    }       
 
    return YES;
}

◆ travelTime

- (double) travelTime

Definition at line 54 of file WormholeEntity.m.

{
    return travel_time;
}

◆ update:

- (void) update: (OOTimeDelta) delta_t

implementation

Reimplemented from Entity.

Definition at line 54 of file WormholeEntity.m.

               :(OOTimeDelta) delta_t
{
    [super update:delta_t];
    
    PlayerEntity    *player = PLAYER;
    assert(player != nil);
    rotMatrix = OOMatrixForBillboard(position, [player viewpointPosition]);
    double now = [player clockTimeAdjusted];
    
    if (witch_mass > 0.0)
    {
 
        witch_mass -= WORMHOLE_SHRINK_RATE * delta_t * shrink_factor;
        witch_mass = fmax(witch_mass, 0.0);
        collision_radius = 0.5 * M_PI * pow(witch_mass, 1.0/3.0);
        no_draw_distance = collision_radius * collision_radius * NO_DRAW_DISTANCE_FACTOR * NO_DRAW_DISTANCE_FACTOR;
    }
 
    scanClass = (witch_mass > 0.0)? CLASS_WORMHOLE : CLASS_NO_DRAW;
    
    if (now > expiry_time)
    {
        scanClass = CLASS_NO_DRAW; // witch_mass not certain to be limiting factor on extremely short jumps, so make sure now
 
        // If we're a saved wormhole waiting to disgorge more ships, it's safe
        // to remove self from UNIVERSE, but we need the current position!
        [UNIVERSE removeEntity: self];
    }
}

◆ withMisjump

- (BOOL) withMisjump

Definition at line 54 of file WormholeEntity.m.

{
    return _misjump;
}

Member Data Documentation

◆ _misjump

- (BOOL) _misjump

private

Definition at line 71 of file WormholeEntity.h.

◆ _misjumpRange

- (GLfloat) _misjumpRange

private

Definition at line 72 of file WormholeEntity.h.

◆ arrival_time

- (double) arrival_time

private

Definition at line 52 of file WormholeEntity.h.

◆ containsPlayer

- (BOOL) containsPlayer

private

Definition at line 73 of file WormholeEntity.h.

◆ destination

- (OOSystemID) destination

private

Definition at line 57 of file WormholeEntity.h.

◆ destinationCoords

- (NSPoint) destinationCoords

private

Definition at line 60 of file WormholeEntity.h.

◆ estimated_arrival_time

- (double) estimated_arrival_time

private

Definition at line 53 of file WormholeEntity.h.

◆ exit_speed

- (double) exit_speed

private

Definition at line 67 of file WormholeEntity.h.

◆ expiry_time

- (double) expiry_time

private

Definition at line 50 of file WormholeEntity.h.

◆ hasExitPosition

- (BOOL) hasExitPosition

private

Definition at line 70 of file WormholeEntity.h.

◆ origin

- (OOSystemID) origin

private

Definition at line 56 of file WormholeEntity.h.

◆ originCoords

- (NSPoint) originCoords

private

Definition at line 59 of file WormholeEntity.h.

◆ scan_info

- (WORMHOLE_SCANINFO) scan_info

private

Definition at line 69 of file WormholeEntity.h.

◆ scan_time

- (double) scan_time

private

Definition at line 54 of file WormholeEntity.h.

◆ shipsInTransit

- (NSArray *) shipsInTransit

private

Definition at line 62 of file WormholeEntity.h.

◆ shrink_factor

- (double) shrink_factor

private

Definition at line 65 of file WormholeEntity.h.

◆ travel_time

- (double) travel_time

private

Definition at line 51 of file WormholeEntity.h.

◆ witch_mass

- (double) witch_mass

private

Definition at line 64 of file WormholeEntity.h.

The documentation for this class was generated from the following files:

src/Core/Entities/WormholeEntity.h
src/Core/Entities/WormholeEntity.m

Instance Methods

Class Methods

Private Attributes

Additional Inherited Members

Detailed Description

Method Documentation

◆ arrivalTime

◆ canCollide

◆ checkCloseCollisionWith:

◆ dealloc

◆ descriptionComponents

◆ destination

◆ destinationCoordinates

◆ disgorgeShips

◆ drawImmediate:translucent:

◆ DrawWormholeCorona

◆ dumpSelfState

◆ estimatedArrivalTime

◆ exitSpeed

◆ expiryTime

◆ getDict

◆ getJSClass:andPrototype:

◆ identFromShip:

◆ init

◆ initWithDict:

◆ initWormholeTo:fromShip:

◆ isScanned

◆ isVisibleToScripts

◆ misjumpRange

◆ oo_jsClassName

◆ origin

◆ originCoordinates

◆ scanInfo

◆ scanInfoString

◆ scanTime

◆ setContainsPlayer:

◆ setExitPosition:

◆ setExitSpeed:

◆ setMisjump

◆ setMisjumpWithRange:

◆ setScanInfo:

◆ setScannedAt:

◆ shipsInTransit

◆ suckInShip:

◆ travelTime

◆ update:

◆ withMisjump

Member Data Documentation

◆ _misjump

◆ _misjumpRange

◆ arrival_time

◆ containsPlayer

◆ destination

◆ destinationCoords

◆ estimated_arrival_time

◆ exit_speed

◆ expiry_time

◆ hasExitPosition

◆ origin

◆ originCoords

◆ scan_info

◆ scan_time

◆ shipsInTransit

◆ shrink_factor

◆ travel_time

◆ witch_mass