ShipEntity(OOAIPrivate) Category Reference

Instance Methods
(void)	- checkFoundTarget
(BOOL)	- performHyperSpaceExitReplace:
(BOOL)	- performHyperSpaceExitReplace:toSystem:
(void)	- scanForNearestShipWithPredicate:parameter:
(void)	- scanForNearestShipWithNegatedPredicate:parameter:
(void)	- acceptDistressMessageFrom:

Detailed Description

Definition at line 50 of file ShipEntityAI.m.

Method Documentation

acceptDistressMessageFrom:

- (void) acceptDistressMessageFrom:

(ShipEntity *)

other

Definition at line 1 of file ShipEntityAI.m.

                                  :(ShipEntity *)other
{
    [self setFoundTarget:[other primaryTarget]];
    if ([self isPolice])
    {
        [(ShipEntity*)[self foundTarget] markAsOffender:8 withReason:kOOLegalStatusReasonDistressCall];  // you have been warned!!
    }
    
    NSString *context = nil;
#ifndef NDEBUG
    context = [NSString stringWithFormat:@"%@ broadcastDistressMessage", [other shortDescription]];
#endif
    [shipAI reactToMessage:@"ACCEPT_DISTRESS_CALL" context:context];
    
}

checkFoundTarget

- (void) checkFoundTarget

Definition at line 1 of file ShipEntityAI.m.

{
    if ([self foundTarget] != nil) 
    {
        [shipAI message:@"TARGET_FOUND"];
    }
    else
    {
        [shipAI message:@"NOTHING_FOUND"];
    }
}

performHyperSpaceExitReplace:

- (BOOL) performHyperSpaceExitReplace:

(BOOL)

replace

Definition at line 1 of file ShipEntityAI.m.

                                     :(BOOL)replace
{
    return [self performHyperSpaceExitReplace:replace toSystem:-1];
}

performHyperSpaceExitReplace:toSystem:

- (BOOL) performHyperSpaceExitReplace:		(BOOL)	replace
toSystem:		(OOSystemID)	systemID

Definition at line 1 of file ShipEntityAI.m.

                                     :(BOOL)replace toSystem:(OOSystemID)systemID
{
    if(![self hasHyperspaceMotor])
    {
        [shipAI reactToMessage:@"WITCHSPACE UNAVAILABLE" context:@"performHyperSpaceExit"];
        return NO;
    }
    if([self status] == STATUS_ENTERING_WITCHSPACE)
    {
// already in a wormhole
        return NO;
    }
    
    NSArray         *sDests = nil;
    OOSystemID      targetSystem;
    NSUInteger      i = 0;
    
    // get a list of destinations within range
    sDests = [UNIVERSE nearbyDestinationsWithinRange: 0.1f * fuel];
    NSUInteger n_dests = [sDests count];
    
    // if none available report to the AI and exit
    if (n_dests == 0)
    {
        [shipAI reactToMessage:@"WITCHSPACE UNAVAILABLE" context:@"performHyperSpaceExit"];
        
        // If no systems exist near us, the AI is switched to a different state, so we do not need
        // the nearby destinations array anymore.
        return NO;
    }
    
    // check if we're clear of nearby masses
    ShipEntity *blocker = [UNIVERSE entityForUniversalID:[self checkShipsInVicinityForWitchJumpExit]];
    if (blocker)
    {
        [self setFoundTarget:blocker];
        [shipAI reactToMessage:@"WITCHSPACE BLOCKED" context:@"performHyperSpaceExit"];
        [self doScriptEvent:OOJSID("shipWitchspaceBlocked") withArgument:blocker];
 
        return NO;
    }
    
    if (systemID == -1)
    {
        // select one at random
        if (n_dests > 1)
        {
            i = ranrot_rand() % n_dests;
        }
        
        
        targetSystem = [[sDests oo_dictionaryAtIndex:i] oo_intForKey:@"sysID"];
    }
    else
    {
        targetSystem = systemID;
        
        for (i = 0; i < n_dests; i++)
        {
            if (systemID == [[sDests oo_dictionaryAtIndex:i] oo_intForKey:@"sysID"]) break;
        }
        
        if (i == n_dests)   // no match found
        {
            return NO;
        }
    }
    float dist = [[sDests oo_dictionaryAtIndex:i] oo_floatForKey:@"distance"];
    if (dist > [self maxHyperspaceDistance] || dist > fuel/10.0f) 
    {
        OOLogWARN(@"script.debug", @"DEBUG: %@ Jumping %f which is further than allowed.  I have %d fuel", self, dist, fuel);
    }
    fuel -= 10 * dist;
    
    // create wormhole
    WormholeEntity  *whole = [[[WormholeEntity alloc] initWormholeTo: targetSystem fromShip:self] autorelease];
    [UNIVERSE addEntity: whole];
    
    [self enterWormhole:whole replacing:replace];
    
    // we've no need for the destinations array anymore.
    return YES;
}

scanForNearestShipWithNegatedPredicate:parameter:

- (void) scanForNearestShipWithNegatedPredicate:		(EntityFilterPredicate)	predicate
parameter:		(void *)	parameter

Definition at line 1 of file ShipEntityAI.m.

                                               :(EntityFilterPredicate)predicate parameter:(void *)parameter
{
    ChainedEntityPredicateParameter param = { predicate, parameter };
    [self scanForNearestShipWithPredicate:NOTPredicate parameter:&param];
}

scanForNearestShipWithPredicate:parameter:

- (void) scanForNearestShipWithPredicate:		(EntityFilterPredicate)	predicate
parameter:		(void *)	parameter

Definition at line 1 of file ShipEntityAI.m.

                                        :(EntityFilterPredicate)predicate parameter:(void *)parameter
{
    // Locates all the ships in range for which predicate returns YES, and chooses the nearest.
    unsigned        i;
    ShipEntity      *candidate;
    float           d2, found_d2 = scannerRange * scannerRange;
    
    DESTROY(_foundTarget);
    [self checkScanner];
    
    if (predicate == NULL)  return;
    
    for (i = 0; i < n_scanned_ships ; i++)
    {
        candidate = scanned_ships[i];
        d2 = distance2_scanned_ships[i];
        if ((d2 < found_d2) && (candidate->scanClass != CLASS_CARGO) && ([candidate status] != STATUS_DOCKED) 
                    && predicate(candidate, parameter) && ![candidate isCloaked])
        {
            [self setFoundTarget:candidate];
            found_d2 = d2;
        }
    }
    
    [self checkFoundTarget];
}

---

The documentation for this category was generated from the following file:

• src/Core/Entities/ShipEntityAI.m