PlayerEntity(ContractsPrivate) Category Reference

Instance Methods
(OOCreditsQuantity)	- tradeInValue
(NSArray *)	- contractsListFromArray:forCargo:forParcels:

Detailed Description

Definition at line 53 of file PlayerEntityContracts.m.

Method Documentation

contractsListFromArray:forCargo:forParcels:

- (NSArray *) contractsListFromArray:		(NSArray *)	contracts_array
forCargo:		(BOOL)	forCargo
forParcels:		(BOOL)	forParcels

Extends class PlayerEntity.

Definition at line 1998 of file PlayerEntityContracts.m.

                                   :(NSArray *) contracts_array forCargo:(BOOL) forCargo forParcels:(BOOL)forParcels
{
    // check  contracts
    NSMutableArray  *result = [NSMutableArray arrayWithCapacity:5];
    NSString        *formatString = (forCargo||forParcels) ? @"oolite-manifest-item-delivery" : @"oolite-manifest-person-travelling";
    unsigned i;
    for (i = 0; i < [contracts_array count]; i++)
    {
        NSDictionary* contract_info = (NSDictionary *)[contracts_array objectAtIndex:i];
        NSString* label = [contract_info oo_stringForKey:forCargo ? CARGO_KEY_DESCRIPTION : PASSENGER_KEY_NAME];
        // the system name can change via script. The following PASSENGER_KEYs are identical to the corresponding CONTRACT_KEYs
        NSString* destination = [UNIVERSE getSystemName: [contract_info oo_intForKey:CONTRACT_KEY_DESTINATION]];
        int dest_eta = [contract_info oo_doubleForKey:CONTRACT_KEY_ARRIVAL_TIME] - ship_clock;
        NSString *deadline = [UNIVERSE shortTimeDescription:dest_eta];
 
        OOCreditsQuantity fee = [contract_info oo_intForKey:CONTRACT_KEY_FEE];
        NSString *feeDesc = OOIntCredits(fee);
 
        [result addObject:OOExpandKey(formatString, label, destination, deadline, feeDesc)];
 
    }
    
    return result;
}

tradeInValue

- (OOCreditsQuantity) tradeInValue

Extends class PlayerEntity.

Definition at line 1443 of file PlayerEntityContracts.m.

{
    // returns down to ship_trade_in_factor% of the full credit value of your ship
    
    /*  FIXME: the trade-in value can be more than the sale value, and
        ship_trade_in_factor starts at 100%, so it can be profitable to sit
        and buy the same ship over and over again. This bug predates Oolite
        1.65.
        Partial fix: make effective trade-in value 75% * ship_trade_in_factor%
        of the "raw" trade-in value. This still allows profitability! A better
        solution would be to unify the price calculation for trade-in and
        for-sale ships.
        -- Ahruman 20070707, fix applied 20070708
    */
    unsigned long long value = [UNIVERSE tradeInValueForCommanderDictionary:[self commanderDataDictionary]];
    value -= value * 0.006 * [self missingSubEntitiesAdjustment];   // TODO: 0.006 might need rethinking.
    value = cunningFee(((value * 75 * ship_trade_in_factor) + 5000) / 10000, 0.005);    // Multiply by two percentages, divide by 100*100. The +5000 is to get normal rounding.
    return value * 10;
}

---

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

• src/Core/Entities/PlayerEntityContracts.m