WormholeEntity.m

Go to the documentation of this file.

/*
 
WormholeEntity.m
 
Oolite
Copyright (C) 2004-2013 Giles C Williams and contributors
 
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.
 
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.
 
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
MA 02110-1301, USA.
 
*/
 
#import "WormholeEntity.h"
 
#import "ShipEntity.h"
#import "OOSunEntity.h"
#import "OOPlanetEntity.h"
#import "PlayerEntity.h"
#import "ShipEntityLoadRestore.h"
 
#import "Universe.h"
#import "AI.h"
#import "OORoleSet.h"
#import "OOShipRegistry.h"
#import "OOShipGroup.h"
#import "OOStringParsing.h"
#import "OOCollectionExtractors.h"
#import "OOLoggingExtended.h"
#import "OOSystemDescriptionManager.h"
 
#define OO_WORMHOLE_COLOR_BOOST 25.0
#define OO_WORMHOLE_COLOR_FVEC4 { 0.067, 0.067, 1.0, 0.25 }
 
// Hidden interface
@interface WormholeEntity (Private)
 
-(id) init;
 
@end
 
// Static local functions
static void DrawWormholeCorona(GLfloat inner_radius, GLfloat outer_radius, int step, GLfloat z_distance, GLfloat *col4v1);
 
 
@implementation WormholeEntity (Private)
 
-(id) init
{
    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;
}
-(id) init {…}
 
@end // Private interface implementation
 
 
//
// Public Wormhole Implementation
//
 
@implementation WormholeEntity
 
- (WormholeEntity*)initWithDict:(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;
}
- (WormholeEntity*)initWithDict:(NSDictionary*)dict {…}
 
- (WormholeEntity*) initWormholeTo:(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;
}
- (WormholeEntity*) initWormholeTo:(OOSystemID) s fromShip:(ShipEntity *) ship {…}
 
 
- (void) setMisjump
{
    // 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;
    }
}
- (void) setMisjump {…}
 
 
- (void) setMisjumpWithRange:(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;
    }
}
- (void) setMisjumpWithRange:(GLfloat)range {…}
 
 
- (BOOL) withMisjump
{
    return _misjump;
}
- (BOOL) withMisjump {…}
 
 
- (GLfloat) misjumpRange
{
    return _misjumpRange;
}
- (GLfloat) misjumpRange {…}
 
 
- (BOOL) suckInShip:(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;
}
- (BOOL) suckInShip:(ShipEntity *) ship {…}
 
 
- (void) disgorgeShips
{
    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
}
- (void) disgorgeShips {…}
 
 
- (void) setContainsPlayer:(BOOL)val
{
    containsPlayer = val;
}
- (void) setContainsPlayer:(BOOL)val {…}
 
 
- (void) setExitPosition:(HPVector)pos
{
    [self setPosition: pos];
    hasExitPosition = YES;
}
- (void) setExitPosition:(HPVector)pos {…}
 
- (OOSystemID) origin
{
    return origin;
}
- (OOSystemID) origin {…};
 
- (OOSystemID) destination
{
    return destination;
}
- (OOSystemID) destination {…};
 
- (NSPoint) originCoordinates
{
    return originCoords;
}
- (NSPoint) originCoordinates {…}
 
- (NSPoint) destinationCoordinates
{
    return destinationCoords;
}
- (NSPoint) destinationCoordinates {…}
 
- (double) exitSpeed
{
    return exit_speed;
}
- (double) exitSpeed {…}
 
 
- (void) setExitSpeed:(double) speed
{
    exit_speed = speed;
}
- (void) setExitSpeed:(double) speed {…}
 
 
- (double) expiryTime
{
    return expiry_time;
}
- (double) expiryTime {…}
 
- (double) arrivalTime
{
    return arrival_time;
}
- (double) arrivalTime {…}
 
- (double) estimatedArrivalTime
{
    return estimated_arrival_time;
}
- (double) estimatedArrivalTime {…}
 
- (double) travelTime
{
    return travel_time;
}
- (double) travelTime {…}
 
- (double) scanTime
{
    return scan_time;
}
- (double) scanTime {…}
 
- (BOOL) isScanned
{
    return scan_info > WH_SCANINFO_NONE;
}
- (BOOL) isScanned {…}
 
- (void) setScannedAt:(double)p_scanTime
{
    if( scan_info == WH_SCANINFO_NONE )
    {
        scan_time = p_scanTime;
        scan_info = WH_SCANINFO_SCANNED;
    }
    // else we previously scanned this wormhole
}
- (void) setScannedAt:(double)p_scanTime {…}
 
- (WORMHOLE_SCANINFO) scanInfo
{
    return scan_info;
}
- (WORMHOLE_SCANINFO) scanInfo {…}
 
- (void) setScanInfo:(WORMHOLE_SCANINFO)p_scanInfo
{
    scan_info = p_scanInfo;
}
- (void) setScanInfo:(WORMHOLE_SCANINFO)p_scanInfo {…}
 
- (NSArray*) shipsInTransit
{
    return shipsInTransit;
}
- (NSArray*) shipsInTransit {…};
 
- (void) dealloc
{
    [shipsInTransit release];
    
    [super dealloc];
}
- (void) dealloc {…}
 
 
- (NSString *) descriptionComponents
{
    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)];
}
- (NSString *) descriptionComponents {…}
 
 
- (NSString *) identFromShip:(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;
    }
 
}
- (NSString *) identFromShip:(ShipEntity*)ship {…}
 
 
- (BOOL) canCollide
{
    /* 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);
}
- (BOOL) canCollide {…}
 
 
- (BOOL) checkCloseCollisionWith:(Entity *)other
{
    return ![other isEffect];
}
- (BOOL) checkCloseCollisionWith:(Entity *)other {…}
 
 
- (void) update:(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];
    }
}
- (void) update:(OOTimeDelta) delta_t {…}
 
 
- (void) drawImmediate:(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);
}
- (void) drawImmediate:(bool)immediate translucent:(bool)translucent {…}
 
 
static void DrawWormholeCorona(GLfloat inner_radius, GLfloat outer_radius, int step, GLfloat z_distance, GLfloat *col4v1)
{
    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();
}
static void DrawWormholeCorona(GLfloat inner_radius, GLfloat outer_radius, int step, GLfloat z_distance, GLfloat *col4v1) {…}
 
- (NSDictionary *) getDict
{
    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;
}
- (NSDictionary *) getDict {…}
 
- (NSString *) scanInfoString
{
    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
}
- (NSString *) scanInfoString {…}
 
- (void)dumpSelfState
{
    [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));
    }
}
- (void)dumpSelfState {…}
 
@end