ShipEntity Class Reference

#include <ShipEntity.h>

Inheritance diagram for ShipEntity:

Collaboration diagram for ShipEntity:

Instance Methods
(void)	- setStateMachine:
(void)	- setAI:
(AI *)	- getAI
(BOOL)	- hasAutoAI
(BOOL)	- hasNewAI
(void)	- setShipScript:
(void)	- removeScript
(OOScript *)	- shipScript
(OOScript *)	- shipAIScript
(OOTimeAbsolute)	- shipAIScriptWakeTime
(void)	- setAIScriptWakeTime:
(double)	- frustration
(void)	- setLaunchDelay:
(void)	- interpretAIMessage:
(GLfloat)	- accuracy
(void)	- setAccuracy:
(OOMesh *)	- mesh
(void)	- setMesh:
(BoundingBox)	- totalBoundingBox
(Vector)	- forwardVector
(Vector)	- upVector
(Vector)	- rightVector
(NSArray *)	- subEntities
(NSUInteger)	- subEntityCount
(BOOL)	- hasSubEntity:
(NSEnumerator *)	- subEntityEnumerator
(NSEnumerator *)	- shipSubEntityEnumerator
(NSEnumerator *)	- flasherEnumerator
(NSEnumerator *)	- exhaustEnumerator
(ShipEntity *)	- subEntityTakingDamage
(void)	- setSubEntityTakingDamage:
(void)	- clearSubEntities
(Quaternion)	- subEntityRotationalVelocity
(void)	- setSubEntityRotationalVelocity:
(NSString *)	- serializeShipSubEntities
(void)	- deserializeShipSubEntitiesFrom:
(NSUInteger)	- maxShipSubEntities
(void)	- setSubIdx:
(NSUInteger)	- subIdx
(Octree *)	- octree
(float)	- volume
(GLfloat)	- doesHitLine:v0:
(GLfloat)	- doesHitLine:v0:v1:
(GLfloat)	- doesHitLine:v0:withPosition:andIJK:i:j:
(BoundingBox)	- findBoundingBoxRelativeToPosition:InVectors:i:j:
(HPVector)	- absoluteTractorPosition
(void)	- setIsBoulder:
(BOOL)	- isBoulder
(BOOL)	- isMinable
(BOOL)	- countsAsKill
(void)	- setUpEscorts
(void)	- updateEscortFormation
(id)	- initWithKey:definition:
(BOOL)	- setUpFromDictionary:
(BOOL)	- setUpShipFromDictionary:
(BOOL)	- setUpSubEntities
(BOOL)	- setUpOneStandardSubentity:asTurret:
(GLfloat)	- frustumRadius
(NSString *)	- shipDataKey
(NSString *)	- shipDataKeyAutoRole
(void)	- setShipDataKey:
(NSDictionary *)	- shipInfoDictionary
(NSArray *)	- getWeaponOffsetFrom:withKey:inMode:
(NSArray *)	- aftWeaponOffset
(NSArray *)	- forwardWeaponOffset
(NSArray *)	- portWeaponOffset
(NSArray *)	- starboardWeaponOffset
(BOOL)	- hasAutoWeapons
(BOOL)	- isFrangible
(BOOL)	- suppressFlightNotifications
(void)	- respondToAttackFrom:becauseOf:
(OOWeaponFacingSet)	- weaponFacings
(BOOL)	- hasEquipmentItem:includeWeapons:whileLoading:
(BOOL)	- hasEquipmentItem:
(NSUInteger)	- countEquipmentItem:
(NSString *)	- equipmentItemProviding:
(BOOL)	- hasEquipmentItemProviding:
(BOOL)	- hasAllEquipment:includeWeapons:whileLoading:
(BOOL)	- hasAllEquipment:
(BOOL)	- setWeaponMount:toWeapon:
(BOOL)	- canAddEquipment:inContext:
(BOOL)	- equipmentValidToAdd:inContext:
(BOOL)	- equipmentValidToAdd:whileLoading:inContext:
(BOOL)	- addEquipmentItem:inContext:
(BOOL)	- addEquipmentItem:withValidation:inContext:
(BOOL)	- hasHyperspaceMotor
(float)	- hyperspaceSpinTime
(void)	- setHyperspaceSpinTime:
(NSEnumerator *)	- equipmentEnumerator
(NSUInteger)	- equipmentCount
(void)	- removeEquipmentItem:
(void)	- removeAllEquipment
(OOEquipmentType *)	- selectMissile
(OOCreditsQuantity)	- removeMissiles
(BOOL)	- hasOneEquipmentItem:includeWeapons:whileLoading:
(BOOL)	- hasOneEquipmentItem:includeMissiles:whileLoading:
(BOOL)	- hasPrimaryWeapon:
(BOOL)	- removeExternalStore:
(NSUInteger)	- parcelCount
(NSUInteger)	- passengerCount
(NSUInteger)	- passengerCapacity
(NSUInteger)	- missileCount
(NSUInteger)	- missileCapacity
(NSUInteger)	- extraCargo
(BOOL)	- hasScoop
(BOOL)	- hasFuelScoop
(BOOL)	- hasCargoScoop
(BOOL)	- hasECM
(BOOL)	- hasCloakingDevice
(BOOL)	- hasMilitaryScannerFilter
(BOOL)	- hasMilitaryJammer
(BOOL)	- hasExpandedCargoBay
(BOOL)	- hasShieldBooster
(BOOL)	- hasMilitaryShieldEnhancer
(BOOL)	- hasHeatShield
(BOOL)	- hasFuelInjection
(BOOL)	- hasCascadeMine
(BOOL)	- hasEscapePod
(BOOL)	- hasDockingComputer
(BOOL)	- hasGalacticHyperdrive
(float)	- shieldBoostFactor
(float)	- maxForwardShieldLevel
(float)	- maxAftShieldLevel
(float)	- shieldRechargeRate
(double)	- maxHyperspaceDistance
(float)	- afterburnerFactor
(float)	- afterburnerRate
(void)	- setAfterburnerFactor:
(void)	- setAfterburnerRate:
(float)	- maxThrust
(float)	- thrust
(void)	- setMaxThrust:
(void)	- setMaxFlightPitch:
(void)	- setMaxFlightSpeed:
(void)	- setMaxFlightRoll:
(void)	- setMaxFlightYaw:
(void)	- setEnergyRechargeRate:
(void)	- processBehaviour:
(void)	- behaviour_stop_still:
(void)	- behaviour_idle:
(void)	- behaviour_tumble:
(void)	- behaviour_tractored:
(void)	- behaviour_track_target:
(void)	- behaviour_intercept_target:
(void)	- behaviour_attack_target:
(void)	- behaviour_attack_slow_dogfight:
(void)	- behaviour_evasive_action:
(void)	- behaviour_attack_break_off_target:
(void)	- behaviour_fly_to_target_six:
(void)	- behaviour_attack_mining_target:
(void)	- behaviour_attack_fly_to_target:
(void)	- behaviour_attack_fly_from_target:
(void)	- behaviour_running_defense:
(void)	- behaviour_flee_target:
(void)	- behaviour_attack_broadside:
(void)	- behaviour_attack_broadside_left:
(void)	- behaviour_attack_broadside_right:
(void)	- behaviour_close_to_broadside_range:
(void)	- behaviour_close_with_target:
(void)	- behaviour_attack_broadside_target:leftside:
(void)	- behaviour_attack_sniper:
(void)	- behaviour_fly_range_from_destination:
(void)	- behaviour_face_destination:
(void)	- behaviour_land_on_planet:
(void)	- behaviour_formation_form_up:
(void)	- behaviour_fly_to_destination:
(void)	- behaviour_fly_from_destination:
(void)	- behaviour_avoid_collision:
(void)	- behaviour_track_as_turret:
(void)	- behaviour_fly_thru_navpoints:
(void)	- behaviour_scripted_ai:
(float)	- reactionTime
(void)	- setReactionTime:
(HPVector)	- calculateTargetPosition
(void)	- startTrackingCurve
(void)	- updateTrackingCurve
(void)	- calculateTrackingCurve
(GLfloat *)	- scannerDisplayColorForShip:otherShip:isHostile:flash:scannerDisplayColor1:scannerDisplayColor2:scannerDisplayColorH1:
(void)	- setScannerDisplayColor1:
(void)	- setScannerDisplayColor2:
(OOColor *)	- scannerDisplayColor1
(OOColor *)	- scannerDisplayColor2
(void)	- setScannerDisplayColorHostile1:
(void)	- setScannerDisplayColorHostile2:
(OOColor *)	- scannerDisplayColorHostile1
(OOColor *)	- scannerDisplayColorHostile2
(BOOL)	- isCloaked
(void)	- setCloaked:
(BOOL)	- hasAutoCloak
(void)	- setAutoCloak:
(void)	- applyThrust:
(void)	- applyAttitudeChanges:
(void)	- avoidCollision
(void)	- resumePostProximityAlert
(double)	- messageTime
(void)	- setMessageTime:
(OOShipGroup *)	- group
(void)	- setGroup:
(OOShipGroup *)	- escortGroup
(void)	- setEscortGroup:
(OOShipGroup *)	- stationGroup
(BOOL)	- hasEscorts
(NSEnumerator *)	- escortEnumerator
(NSArray *)	- escortArray
(uint8_t)	- escortCount
(uint8_t)	- pendingEscortCount
(void)	- setPendingEscortCount:
(uint8_t)	- maxEscortCount
(void)	- setMaxEscortCount:
(NSUInteger)	- turretCount
(NSString *)	- name
(NSString *)	- shipUniqueName
(NSString *)	- shipClassName
(NSString *)	- displayName
(NSString *)	- scanDescription
(NSString *)	- scanDescriptionForScripting
(void)	- setName:
(void)	- setShipUniqueName:
(void)	- setShipClassName:
(void)	- setDisplayName:
(void)	- setScanDescription:
(NSString *)	- identFromShip:
(BOOL)	- hasRole:
(OORoleSet *)	- roleSet
(void)	- addRole:
(void)	- addRole:withProbability:
(void)	- removeRole:
(NSString *)	- primaryRole
(void)	- setPrimaryRole:
(BOOL)	- hasPrimaryRole:
(BOOL)	- isPolice
(BOOL)	- isThargoid
(BOOL)	- isTrader
(BOOL)	- isPirate
(BOOL)	- isMissile
(BOOL)	- isMine
(BOOL)	- isWeapon
(BOOL)	- isEscort
(BOOL)	- isShuttle
(BOOL)	- isTurret
(BOOL)	- isPirateVictim
(BOOL)	- isExplicitlyUnpiloted
(BOOL)	- isUnpiloted
(OOAlertCondition)	- alertCondition
(OOAlertCondition)	- realAlertCondition
(BOOL)	- hasHostileTarget
(BOOL)	- isHostileTo:
(NSUInteger)	- defenseTargetCount
(NSArray *)	- allDefenseTargets
(NSEnumerator *)	- defenseTargetEnumerator
(void)	- validateDefenseTargets
(BOOL)	- addDefenseTarget:
(BOOL)	- isDefenseTarget:
(void)	- removeDefenseTarget:
(void)	- removeAllDefenseTargets
(NSArray *)	- collisionExceptions
(void)	- addCollisionException:
(void)	- removeCollisionException:
(BOOL)	- collisionExceptedFor:
(GLfloat)	- weaponRange
(void)	- setWeaponRange:
(void)	- setWeaponDataFromType:
(float)	- energyRechargeRate
(float)	- weaponRechargeRate
(void)	- setWeaponRechargeRate:
(void)	- setWeaponEnergy:
(OOWeaponFacing)	- currentWeaponFacing
(GLfloat)	- scannerRange
(void)	- setScannerRange:
(Vector)	- reference
(void)	- setReference:
(BOOL)	- reportAIMessages
(void)	- setReportAIMessages:
(void)	- transitionToAegisNone
(OOPlanetEntity *)	- findNearestPlanet
(Entity< OOStellarBody > *)	- findNearestStellarBody
(OOPlanetEntity *)	- findNearestPlanetExcludingMoons
(OOAegisStatus)	- checkForAegis
(void)	- forceAegisCheck
(BOOL)	- withinStationAegis
(void)	- setLastAegisLock:
(OOSystemID)	- homeSystem
(OOSystemID)	- destinationSystem
(void)	- setHomeSystem:
(void)	- setDestinationSystem:
(NSArray *)	- crew
(NSArray *)	- crewForScripting
(void)	- setCrew:
(void)	- setSingleCrewWithRole:
(OOFuelQuantity)	- fuel
(void)	- setFuel:
(OOFuelQuantity)	- fuelCapacity
(GLfloat)	- fuelChargeRate
(void)	- setRoll:
(void)	- setRawRoll:
(void)	- setPitch:
(void)	- setYaw:
(void)	- setThrust:
(void)	- applySticks:
(void)	- setThrustForDemo:
(void)	- setBounty:
(void)	- setBounty:withReason:
(void)	- setBounty:withReasonAsString:
(OOCreditsQuantity)	- bounty
(int)	- legalStatus
(BOOL)	- isTemplateCargoPod
(void)	- setUpCargoType:
(void)	- setCommodity:andAmount:
(void)	- setCommodityForPod:andAmount:
(OOCommodityType)	- commodityType
(OOCargoQuantity)	- commodityAmount
(OOCargoQuantity)	- maxAvailableCargoSpace
(void)	- setMaxAvailableCargoSpace:
(OOCargoQuantity)	- availableCargoSpace
(OOCargoQuantity)	- cargoQuantityOnBoard
(OOCargoType)	- cargoType
(NSArray *)	- cargoListForScripting
(NSMutableArray *)	- cargo
(void)	- setCargo:
(BOOL)	- addCargo:
(BOOL)	- removeCargo:amount:
(BOOL)	- showScoopMessage
(NSArray *)	- passengerListForScripting
(NSArray *)	- parcelListForScripting
(NSArray *)	- contractListForScripting
(NSArray *)	- equipmentListForScripting
(OOWeaponType)	- weaponTypeIDForFacing:strict:
(OOEquipmentType *)	- weaponTypeForFacing:strict:
(NSArray *)	- missilesList
(OOCargoFlag)	- cargoFlag
(void)	- setCargoFlag:
(void)	- setSpeed:
(double)	- desiredSpeed
(void)	- setDesiredSpeed:
(double)	- desiredRange
(void)	- setDesiredRange:
(double)	- cruiseSpeed
(Vector)	- thrustVector
(void)	- setTotalVelocity:
(void)	- increase_flight_speed:
(void)	- decrease_flight_speed:
(void)	- increase_flight_roll:
(void)	- decrease_flight_roll:
(void)	- increase_flight_pitch:
(void)	- decrease_flight_pitch:
(void)	- increase_flight_yaw:
(void)	- decrease_flight_yaw:
(GLfloat)	- flightRoll
(GLfloat)	- flightPitch
(GLfloat)	- flightYaw
(GLfloat)	- flightSpeed
(GLfloat)	- maxFlightPitch
(GLfloat)	- maxFlightSpeed
(GLfloat)	- maxFlightRoll
(GLfloat)	- maxFlightYaw
(GLfloat)	- speedFactor
(GLfloat)	- temperature
(void)	- setTemperature:
(GLfloat)	- heatInsulation
(void)	- setHeatInsulation:
(float)	- randomEjectaTemperature
(float)	- randomEjectaTemperatureWithMaxFactor:
(int)	- damage
(void)	- dealEnergyDamage:atRange:withBias:
(void)	- dealEnergyDamageWithinDesiredRange
(void)	- dealMomentumWithinDesiredRange:
(void)	- noteTakingDamage:from:type:
(void)	- noteKilledBy:damageType:
(void)	- getDestroyedBy:damageType:
(void)	- becomeExplosion
(void)	- becomeLargeExplosion:
(void)	- becomeEnergyBlast
(void)	- broadcastEnergyBlastImminent
(void)	- setIsWreckage:
(BOOL)	- showDamage
(Vector)	- positionOffsetForAlignment:
(Vector)	- positionOffsetForShipInRotationToAlignment
(void)	- collectBountyFor:
(BoundingBox)	- findSubentityBoundingBox
(Triangle)	- absoluteIJKForSubentity
(GLfloat)	- weaponRecoveryTime
(GLfloat)	- laserHeatLevel
(GLfloat)	- laserHeatLevelAft
(GLfloat)	- laserHeatLevelForward
(GLfloat)	- laserHeatLevelPort
(GLfloat)	- laserHeatLevelStarboard
(GLfloat)	- hullHeatLevel
(GLfloat)	- entityPersonality
(GLint)	- entityPersonalityInt
(void)	- setEntityPersonalityInt:
(void)	- setSuppressExplosion:
(void)	- resetExhaustPlumes
(void)	- removeExhaust:
(void)	- removeFlasher:
(void)	- checkScanner
(void)	- checkScannerIgnoringUnpowered
(ShipEntity **)	- scannedShips
(int)	- numberOfScannedShips
(Entity *)	- foundTarget
(Entity *)	- primaryAggressor
(Entity *)	- lastEscortTarget
(Entity *)	- thankedShip
(Entity *)	- rememberedShip
(Entity *)	- proximityAlert
(void)	- setFoundTarget:
(void)	- setPrimaryAggressor:
(void)	- setLastEscortTarget:
(void)	- setThankedShip:
(void)	- setRememberedShip:
(void)	- setProximityAlert:
(void)	- setTargetStation:
(BOOL)	- isValidTarget:
(void)	- addTarget:
(void)	- removeTarget:
(BOOL)	- canStillTrackPrimaryTarget
(id)	- primaryTarget
(id)	- primaryTargetWithoutValidityCheck
(StationEntity *)	- targetStation
(BOOL)	- isFriendlyTo:
(ShipEntity *)	- shipHitByLaser
(void)	- noteLostTarget
(void)	- noteLostTargetAndGoIdle
(void)	- noteTargetDestroyed:
(OOBehaviour)	- behaviour
(void)	- setBehaviour:
(void)	- trackOntoTarget:withDForward:
(double)	- ballTrackLeadingTarget:atTarget:
(GLfloat)	- rollToMatchUp:rotating:
(GLfloat)	- rangeToDestination
(double)	- trackDestination:delta_t:
(void)	- setCoordinate:
(HPVector)	- coordinates
(HPVector)	- destination
(HPVector)	- distance_six:
(HPVector)	- distance_twelve:withOffset:
(void)	- setEvasiveJink:
(void)	- evasiveAction:
(double)	- trackPrimaryTarget:delta_t:
(double)	- trackSideTarget:delta_t:
(double)	- missileTrackPrimaryTarget:
(double)	- rangeToPrimaryTarget
(double)	- approachAspectToPrimaryTarget
(double)	- rangeToSecondaryTarget:
(BOOL)	- hasProximityAlertIgnoringTarget:
(GLfloat)	- currentAimTolerance
(GLfloat)	- lookingAtSunWithThresholdAngleCos:
(BOOL)	- onTarget:withWeapon:
(OOTimeDelta)	- shotTime
(void)	- resetShotTime
(BOOL)	- fireMainWeapon:
(BOOL)	- fireAftWeapon:
(BOOL)	- firePortWeapon:
(BOOL)	- fireStarboardWeapon:
(BOOL)	- fireTurretCannon:
(void)	- setLaserColor:
(void)	- setExhaustEmissiveColor:
(OOColor *)	- laserColor
(OOColor *)	- exhaustEmissiveColor
(BOOL)	- fireSubentityLaserShot:
(BOOL)	- fireDirectLaserShot:
(BOOL)	- fireDirectLaserDefensiveShot
(BOOL)	- fireDirectLaserShotAt:
(NSArray *)	- laserPortOffset:
(BOOL)	- fireLaserShotInDirection:weaponIdentifier:
(void)	- adjustMissedShots:
(int)	- missedShots
(void)	- considerFiringMissile:
(Vector)	- missileLaunchPosition
(ShipEntity *)	- fireMissile
(ShipEntity *)	- fireMissileWithIdentifier:andTarget:
(BOOL)	- isMissileFlagSet
(void)	- setIsMissileFlag:
(OOTimeDelta)	- missileLoadTime
(void)	- setMissileLoadTime:
(void)	- noticeECM
(BOOL)	- fireECM
(BOOL)	- cascadeIfAppropriateWithDamageAmount:cascadeOwner:
(BOOL)	- activateCloakingDevice
(void)	- deactivateCloakingDevice
(BOOL)	- launchCascadeMine
(ShipEntity *)	- launchEscapeCapsule
(OOCommodityType)	- dumpCargo
(ShipEntity *)	- dumpCargoItem:
(OOCargoType)	- dumpItem:
(void)	- manageCollisions
(BOOL)	- collideWithShip:
(void)	- adjustVelocity:
(void)	- addImpactMoment:fraction:
(BOOL)	- canScoop:
(void)	- getTractoredBy:
(void)	- scoopIn:
(void)	- scoopUp:
(void)	- scoopUpProcess:processEvents:processMessages:
(BOOL)	- abandonShip
(void)	- takeScrapeDamage:from:
(void)	- takeHeatDamage:
(void)	- enterDock:
(void)	- leaveDock:
(void)	- enterWormhole:
(void)	- enterWormhole:replacing:
(void)	- enterWitchspace
(void)	- leaveWitchspace
(BOOL)	- witchspaceLeavingEffects
(void)	- markAsOffender:
(void)	- markAsOffender:withReason:
(void)	- switchLightsOn
(void)	- switchLightsOff
(BOOL)	- lightsActive
(void)	- setDestination:
(void)	- setEscortDestination:
(BOOL)	- canAcceptEscort:
(BOOL)	- acceptAsEscort:
(void)	- deployEscorts
(void)	- dockEscorts
(void)	- setTargetToNearestFriendlyStation
(void)	- setTargetToNearestStation
(void)	- setTargetToSystemStation
(void)	- landOnPlanet:
(void)	- abortDocking
(NSDictionary *)	- dockingInstructions
(void)	- broadcastThargoidDestroyed
(void)	- broadcastHitByLaserFrom:
(GLfloat)	- sunGlareFilter
(void)	- setSunGlareFilter:
(void)	- sendExpandedMessage:toShip:
(void)	- sendMessage:toShip:withUnpilotedOverride:
(void)	- broadcastAIMessage:
(void)	- broadcastMessage:withUnpilotedOverride:
(void)	- setCommsMessageColor
(void)	- receiveCommsMessage:from:
(void)	- commsMessage:withUnpilotedOverride:
(BOOL)	- markedForFines
(BOOL)	- markForFines
(BOOL)	- isMining
(void)	- spawn:
(int)	- checkShipsInVicinityForWitchJumpExit
(BOOL)	- trackCloseContacts
(void)	- setTrackCloseContacts:
(void)	- setHulk:
(BOOL)	- isHulk
(OOJSScript *)	- script
(NSDictionary *)	- scriptInfo
(void)	- overrideScriptInfo:
(BOOL)	- scriptedMisjump
(void)	- setScriptedMisjump:
(GLfloat)	- scriptedMisjumpRange
(void)	- setScriptedMisjumpRange:
(Entity *)	- entityForShaderProperties
(void)	- setDemoShip:
(BOOL)	- isDemoShip
(void)	- setDemoStartTime:
(void)	- doScriptEvent:
(void)	- doScriptEvent:withArgument:
(void)	- doScriptEvent:withArgument:andArgument:
(void)	- doScriptEvent:withArguments:
(void)	- doScriptEvent:withArguments:count:
(void)	- doScriptEvent:inContext:withArguments:count:
(void)	- reactToAIMessage:context:
(void)	- sendAIMessage:
(void)	- doScriptEvent:andReactToAIMessage:
(void)	- doScriptEvent:withArgument:andReactToAIMessage:
(id)	- init [implementation]
(id)	- initBypassForPlayer [implementation]
(NSString *)	- repeatString:times: [implementation]
(BOOL)	- setUpOneSubentity: [implementation]
(BOOL)	- setUpOneFlasher: [implementation]
(void)	- dealloc [implementation]
(NSString *)	- descriptionComponents [implementation]
(NSString *)	- shortDescriptionComponents [implementation]
(BoundingBox)	- findBoundingBoxRelativeToPosition:InVectors:_i:_j: [implementation]
(void)	- wasAddedToUniverse [implementation]
(void)	- wasRemovedFromUniverse [implementation]
(NSString *)	- beaconCode [implementation]
(void)	- setBeaconCode: [implementation]
(NSString *)	- beaconLabel [implementation]
(void)	- setBeaconLabel: [implementation]
(BOOL)	- isVisible [implementation]
(BOOL)	- isBeacon [implementation]
(id< OOHUDBeaconIcon >)	- beaconDrawable [implementation]
(Entity< OOBeaconEntity > *)	- prevBeacon [implementation]
(Entity< OOBeaconEntity > *)	- nextBeacon [implementation]
(void)	- setPrevBeacon: [implementation]
(void)	- setNextBeacon: [implementation]
(void)	- setUpMixedEscorts [implementation]
(void)	- setUpOneEscort:inGroup:withRole:atPosition:andCount: [implementation]
(OOScanClass)	- scanClass [implementation]
(BOOL)	- canCollide [implementation]
(ShipEntity *)	- doOctreesCollide [implementation]
(BOOL)	- checkCloseCollisionWith: [implementation]
(void)	- addSubentityToCollisionRadius: [implementation]
(ShipEntity *)	- launchPodWithCrew: [implementation]
(BOOL)	- validForAddToUniverse [implementation]
(void)	- update: [implementation]
(void)	- noteFrustration: [implementation]
(OOEquipmentType *)	- generateMissileEquipmentTypeFrom: [implementation]
(OOEquipmentType *)	- verifiedMissileTypeFromRole: [implementation]
(void)	- drawImmediate:translucent: [implementation]
(void)	- drawDebugStuff [implementation]
(void)	- drawSubEntityImmediate:translucent: [implementation]
(BOOL)	- isJammingScanning [implementation]
(void)	- addSubEntity: [implementation]
(void)	- setOwner: [implementation]
(void)	- orientationChanged [implementation]
(void)	- applyRoll:andClimb: [implementation]
(void)	- applyRoll:climb:andYaw: [implementation]
(OOShipGroup *)	- rawEscortGroup [implementation]
(NSComparisonResult)	- ComparePlanetsBySurfaceDistance [implementation]
(Entity< OOStellarBody > *)	- lastAegisLock [implementation]
(void)	- setStatus: [implementation]
(void)	- rescaleBy: [implementation]
(void)	- rescaleBy:writeToCache: [implementation]
(void)	- releaseCargoPodsDebris [implementation]
(void)	- subEntityDied: [implementation]
(void)	- subEntityReallyDied: [implementation]
(NSComparisonResult)	- compareBeaconCodeWith: [implementation]
(uint32_t)	- randomSeedForShaders [implementation]
(void)	- setShipHitByLaser: [implementation]
(BOOL)	- fireWeapon:direction:range: [implementation]
(void)	- throwSparks [implementation]
(Vector)	- velocity [implementation]
(void)	- suppressTargetLost [implementation]
(void)	- takeEnergyDamage:from:becauseOf:weaponIdentifier: [implementation]
(void)	- refreshEscortPositions [implementation]
(HPVector)	- coordinatesForEscortPosition: [implementation]
(void)	- setTargetToNearestStationIncludingHostiles: [implementation]
(BoundingBox)	- findBoundingBoxRelativeTo:InVectors:_i:_j: [implementation]
(void)	- dumpSelfState [implementation]
(OOTimeAbsolute)	- getDemoStartTime [implementation]
(void)	- doNothing [implementation]
(NSString *)	- descriptionForObjDump [implementation]
(void)	- setAITo:
(void)	- setAIScript:
(void)	- switchAITo:
(void)	- scanForHostiles
(BOOL)	- performHyperSpaceToSpecificSystem:
(void)	- scanForNearestIncomingMissile
(void)	- enterTargetWormhole
(void)	- enterPlayerWormhole
(void)	- wormholeEscorts
(void)	- wormholeEntireGroup
(BOOL)	- suggestEscortTo:
(void)	- groupAttackTarget
(void)	- performAttack
(void)	- performCollect
(void)	- performEscort
(void)	- performFaceDestination
(void)	- performFlee
(void)	- performFlyToRangeFromDestination
(void)	- performHold
(void)	- performIdle
(void)	- performIntercept
(void)	- performLandOnPlanet
(void)	- performMining
(void)	- performScriptedAI
(void)	- performScriptedAttackAI
(void)	- performStop
(void)	- performTumble
(void)	- broadcastDistressMessage
(void)	- broadcastDistressMessageWithDumping:
(void)	- requestDockingCoordinates
(void)	- recallDockingInstructions
(void)	- performBuoyTumble [implementation]
(NSDictionary *)	- savedShipDictionaryWithContext:
(void)	- simplifyShipdata:andGetDeletes: [implementation]
(void)	- checkFoundTarget [implementation]
(BOOL)	- performHyperSpaceExitReplace: [implementation]
(BOOL)	- performHyperSpaceExitReplace:toSystem: [implementation]
(void)	- scanForNearestShipWithPredicate:parameter: [implementation]
(void)	- scanForNearestShipWithNegatedPredicate:parameter: [implementation]
(void)	- acceptDistressMessageFrom: [implementation]
(BOOL)	- launchPatrol [implementation]
(BOOL)	- inspHasSecondaryIdentityLine [implementation]
(NSString *)	- inspSecondaryIdentityLine [implementation]
(NSString *)	- inspDescription [implementation]
(NSString *)	- inspTargetLine [implementation]
(BOOL)	- inspCanBecomeTarget [implementation]
(void)	- inspBecomeTarget [implementation]
(NSArray *)	- subEntitiesForScript
(void)	- setTargetForScript:
(BOOL)	- isVisibleToScripts [implementation]
(void)	- getJSClass:andPrototype: [implementation]
(NSString *)	- oo_jsClassName [implementation]
(NSArray *)	- debugInspectorModules [implementation]
(void)	- setStateTo: [implementation]
(void)	- pauseAI: [implementation]
(void)	- randomPauseAI: [implementation]
(void)	- dropMessages: [implementation]
(void)	- debugDumpPendingMessages [implementation]
(void)	- setDestinationToCurrentLocation [implementation]
(void)	- setDesiredRangeTo: [implementation]
(void)	- setDesiredRangeForWaypoint [implementation]
(void)	- setSpeedTo: [implementation]
(void)	- setSpeedFactorTo: [implementation]
(void)	- setSpeedToCruiseSpeed [implementation]
(void)	- setThrustFactorTo: [implementation]
(void)	- setTargetToPrimaryAggressor [implementation]
(void)	- scanForNearestMerchantman [implementation]
(void)	- scanForRandomMerchantman [implementation]
(void)	- scanForLoot [implementation]
(void)	- scanForRandomLoot [implementation]
(void)	- setTargetToFoundTarget [implementation]
(void)	- checkForFullHold [implementation]
(void)	- getWitchspaceEntryCoordinates [implementation]
(void)	- setDestinationFromCoordinates [implementation]
(void)	- setCoordinatesFromPosition [implementation]
(void)	- fightOrFleeMissile [implementation]
(void)	- setCourseToPlanet [implementation]
(void)	- setTakeOffFromPlanet [implementation]
(void)	- landOnPlanet [implementation]
(void)	- checkTargetLegalStatus [implementation]
(void)	- checkOwnLegalStatus [implementation]
(void)	- exitAIWithMessage: [implementation]
(void)	- setDestinationToTarget [implementation]
(void)	- setDestinationWithinTarget [implementation]
(void)	- checkCourseToDestination [implementation]
(void)	- checkAegis [implementation]
(void)	- checkEnergy [implementation]
(void)	- checkHeatInsulation [implementation]
(void)	- scanForOffenders [implementation]
(void)	- setCourseToWitchpoint [implementation]
(void)	- setDestinationToWitchpoint [implementation]
(void)	- setDestinationToStationBeacon [implementation]
(void)	- performHyperSpaceExit [implementation]
(void)	- performHyperSpaceExitWithoutReplacing [implementation]
(void)	- wormholeGroup [implementation]
(void)	- commsMessage: [implementation]
(void)	- commsMessageByUnpiloted: [implementation]
(void)	- ejectCargo [implementation]
(void)	- scanForThargoid [implementation]
(void)	- scanForNonThargoid [implementation]
(void)	- thargonCheckMother [implementation]
(void)	- becomeUncontrolledThargon [implementation]
(void)	- checkDistanceTravelled [implementation]
(void)	- fightOrFleeHostiles [implementation]
(void)	- suggestEscort [implementation]
(void)	- escortCheckMother [implementation]
(void)	- checkGroupOddsVersusTarget [implementation]
(void)	- scanForFormationLeader [implementation]
(void)	- messageMother: [implementation]
(void)	- setPlanetPatrolCoordinates [implementation]
(void)	- setSunSkimStartCoordinates [implementation]
(void)	- setSunSkimEndCoordinates [implementation]
(void)	- setSunSkimExitCoordinates [implementation]
(void)	- patrolReportIn [implementation]
(void)	- checkForMotherStation [implementation]
(void)	- sendTargetCommsMessage: [implementation]
(void)	- markTargetForFines [implementation]
(void)	- markTargetForOffence: [implementation]
(void)	- storeTarget [implementation]
(void)	- recallStoredTarget [implementation]
(void)	- scanForRocks [implementation]
(void)	- setDestinationToDockingAbort [implementation]
(void)	- requestNewTarget [implementation]
(void)	- rollD: [implementation]
(void)	- scanForNearestShipWithPrimaryRole: [implementation]
(void)	- scanForNearestShipHavingRole: [implementation]
(void)	- scanForNearestShipWithAnyPrimaryRole: [implementation]
(void)	- scanForNearestShipHavingAnyRole: [implementation]
(void)	- scanForNearestShipWithScanClass: [implementation]
(void)	- scanForNearestShipWithoutPrimaryRole: [implementation]
(void)	- scanForNearestShipNotHavingRole: [implementation]
(void)	- scanForNearestShipWithoutAnyPrimaryRole: [implementation]
(void)	- scanForNearestShipNotHavingAnyRole: [implementation]
(void)	- scanForNearestShipWithoutScanClass: [implementation]
(void)	- setCoordinates: [implementation]
(void)	- checkForNormalSpace [implementation]
(void)	- setTargetToRandomStation [implementation]
(void)	- setTargetToLastStation [implementation]
(void)	- addFuel: [implementation]
(void)	- scriptActionOnTarget: [implementation]
(void)	- sendScriptMessage: [implementation]
(void)	- ai_throwSparks [implementation]
(void)	- explodeSelf [implementation]
(void)	- ai_debugMessage: [implementation]
(void)	- targetFirstBeaconWithCode: [implementation]
(void)	- targetNextBeaconWithCode: [implementation]
(void)	- setRacepointsFromTarget [implementation]
(void)	- performFlyRacepoints [implementation]
(void)	- addPrimaryAggressorAsDefenseTarget [implementation]
(void)	- addFoundTargetAsDefenseTarget [implementation]
(void)	- findNewDefenseTarget [implementation]
(void)	- setDestinationToJinkPosition [implementation]
(void)	- disengageAutopilot [implementation]
(void)	- messageSelf: [implementation]
(void)	- scanForNearestShipMatchingPredicate: [implementation]
(void)	- safeScriptActionOnTarget: [implementation]
(ShipEntity *)	- ejectShipOfType:
(ShipEntity *)	- ejectShipOfRole:
(NSArray *)	- spawnShipsWithRole:count:
(BOOL)	- isShipWithSubEntityShip: [implementation]
Instance Methods inherited from OOEntityWithDrawable
(OODrawable *)	- drawable
(void)	- setDrawable:
(double)	- findCollisionRadius [implementation]
(NSSet *)	- allTextures [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
(void)	- addToLinkedLists
(void)	- removeFromLinkedLists
(void)	- updateLinkedLists
(void)	- warnAboutHostiles
(CollisionRegion *)	- collisionRegion
(void)	- setCollisionRegion:
(void)	- setUniversalID:
(OOUniversalID)	- universalID
(BOOL)	- throwingSparks
(void)	- setThrowSparks:
(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)	- setVelocity:
(double)	- speed
(GLfloat)	- distanceTravelled
(void)	- setDistanceTravelled:
(OOEntityStatus)	- status
(void)	- setScanClass:
(void)	- setEnergy:
(GLfloat)	- energy
(void)	- setMaxEnergy:
(GLfloat)	- maxEnergy
(void)	- moveForward:
(OOMatrix)	- rotationMatrix
(OOMatrix)	- drawRotationMatrix
(OOMatrix)	- transformationMatrix
(OOMatrix)	- drawTransformationMatrix
(GLfloat)	- collisionRadius
(void)	- setCollisionRadius:
(NSMutableArray *)	- collisionArray
(void)	- applyVelocity:
(void)	- dumpState
(BOOL)	- isInSpace
(BOOL)	- isImmuneToBreakPatternHide
(GLfloat)	- universalTime
(GLfloat)	- spawnTime
(GLfloat)	- timeElapsedSinceSpawn
(void)	- setAtmosphereFogging:
(OOColor *)	- fogUniform
(NSString *)	- descriptionForObjDumpBasic
(BOOL)	- checkLinkedLists [implementation]
(id< OOWeakReferenceSupport >)	- superShaderBindingTarget [implementation]
(Vector)	- relativePosition [implementation]
(BOOL)	- isBreakPattern
(void)	- inspect [implementation]
(BOOL)	- isECMBlast
(NSString *)	- inspScanClassLine
(NSString *)	- inspStatusLine
(NSString *)	- inspRetainCountLine
(NSString *)	- inspPositionLine
(NSString *)	- inspVelocityLine
(NSString *)	- inspOrientationLine
(NSString *)	- inspEnergyLine
(NSString *)	- inspOwnerLine
(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]
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 BOOL)	+ IsBehaviourHostile [implementation]
(static float)	+ SurfaceDistanceSqaredV [implementation]
(static float)	+ SurfaceDistanceSqared [implementation]
(static BOOL)	+ AuthorityPredicate [implementation]
(id)	+ shipRestoredFromDictionary:useFallback:context:

Public Attributes
OOTimeDelta	shot_time
Vector	v_forward
Vector	v_up
Vector	v_right
HPVector	_destination
GLfloat	desired_range
GLfloat	desired_speed
GLfloat	stick_roll
GLfloat	stick_pitch
GLfloat	stick_yaw
OOBehaviour	behaviour
BoundingBox	totalBoundingBox
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
NSDictionary *	shipinfoDictionary
Quaternion	subentityRotationalVelocity
OOJSScript *	script
OOJSScript *	aiScript
OOTimeAbsolute	aiScriptWakeTime
NSDictionary *	dockingInstructions
OOColor *	laser_color
OOColor *	default_laser_color
OOColor *	exhaust_emissive_color
OOColor *	scanner_display_color1
OOColor *	scanner_display_color2
OOColor *	scanner_display_color_hostile1
OOColor *	scanner_display_color_hostile2
GLfloat	maxFlightSpeed
GLfloat	max_flight_roll
GLfloat	max_flight_pitch
GLfloat	max_flight_yaw
GLfloat	cruiseSpeed
GLfloat	max_thrust
GLfloat	thrust
float	hyperspaceMotorSpinTime
unsigned	military_jammer_active: 1
unsigned	docking_match_rotation: 1
unsigned	pitching_over: 1
unsigned	rolling_over: 1
unsigned	reportAIMessages: 1
unsigned	being_mined: 1
unsigned	being_fined: 1
unsigned	isHulk: 1
unsigned	trackCloseContacts: 1
unsigned	isNearPlanetSurface: 1
unsigned	isFrangible: 1
unsigned	cloaking_device_active: 1
unsigned	cloakPassive: 1
unsigned	cloakAutomatic: 1
unsigned	canFragment: 1
unsigned	isWreckage: 1
unsigned	_showDamage: 1
unsigned	suppressExplosion: 1
unsigned	suppressAegisMessages: 1
unsigned	isMissile: 1
unsigned	_explicitlyUnpiloted: 1
unsigned	hasScoopMessage: 1
unsigned	scripted_misjump: 1
unsigned	haveExecutedSpawnAction: 1
unsigned	haveStartedJSAI: 1
unsigned	noRocks: 1
unsigned	_lightsActive: 1
GLfloat	_scriptedMisjumpRange
GLfloat	sunGlareFilter
OOFuelQuantity	fuel
GLfloat	fuel_accumulator
GLfloat	afterburner_rate
GLfloat	afterburner_speed_factor
OOCargoQuantity	likely_cargo
OOCargoQuantity	max_cargo
OOCargoQuantity	extra_cargo
OOCargoQuantity	equipment_weight
OOCargoType	cargo_type
OOCargoFlag	cargo_flag
OOCreditsQuantity	bounty
GLfloat	energy_recharge_rate
OOWeaponFacingSet	weapon_facings
OOWeaponType	forward_weapon_type
OOWeaponType	aft_weapon_type
OOWeaponType	port_weapon_type
OOWeaponType	starboard_weapon_type
GLfloat	weapon_damage
GLfloat	weapon_damage_override
GLfloat	weaponRange
OOWeaponFacing	currentWeaponFacing
GLfloat	weapon_energy_use
GLfloat	weapon_temp
GLfloat	weapon_shot_temperature
GLfloat	forward_weapon_temp
GLfloat	aft_weapon_temp
GLfloat	port_weapon_temp
GLfloat	starboard_weapon_temp
GLfloat	scannerRange
unsigned	missiles
unsigned	max_missiles
NSString *	_missileRole
OOTimeDelta	missile_load_time
OOTimeAbsolute	missile_launch_time
AI *	shipAI
NSString *	name
NSString *	shipUniqueName
NSString *	shipClassName
NSString *	displayName
NSString *	scan_description
OORoleSet *	roleSet
NSString *	primaryRole
NSArray *	explosionType
Vector	jink
HPVector	coordinates
Vector	reference
NSUInteger	_subIdx
NSUInteger	_maxShipSubIdx
double	launch_time
double	launch_delay
OOUniversalID	planetForLanding
GLfloat	frustration
GLfloat	success_factor
int	patrol_counter
NSMutableDictionary *	previousCondition
float	weapon_recharge_rate
int	shot_counter
OOTimeAbsolute	cargo_dump_time
OOTimeAbsolute	last_shot_time
NSMutableArray *	cargo
OOCommodityType	commodity_type
OOCargoQuantity	commodity_amount
GLfloat	flightSpeed
GLfloat	flightRoll
GLfloat	flightPitch
GLfloat	flightYaw
GLfloat	accuracy
GLfloat	pitch_tolerance
GLfloat	aim_tolerance
int	_missed_shots
OOAegisStatus	aegis_status
OOSystemID	home_system
OOSystemID	destination_system
double	messageTime
double	next_spark_time
Vector	collision_vector
GLfloat	_scaleFactor
BOOL	_multiplyWeapons
NSArray *	forwardWeaponOffset
NSArray *	aftWeaponOffset
NSArray *	portWeaponOffset
NSArray *	starboardWeaponOffset
NSArray *	crew
NSMutableDictionary *	closeContactsInfo
NSString *	lastRadioMessage
Vector	tractor_position
float	ship_temperature
ShipEntity *	scanned_ships [MAX_SCAN_NUMBER+1]
GLfloat	distance2_scanned_ships [MAX_SCAN_NUMBER+1]
unsigned	n_scanned_ships
HPVector	navpoints [32]
unsigned	next_navpoint_index
unsigned	number_of_navpoints
Octree *	octree
OOBehaviour	debugLastBehaviour
uint16_t	entity_personality
NSDictionary *	scriptInfo
NSMutableArray *	subEntities
OOEquipmentType *	missile_list [SHIPENTITY_MAX_MISSILES]
OOWeakReference *	_primaryTarget
OOWeakReference *	_primaryAggressor
OOWeakReference *	_targetStation
OOWeakReference *	_foundTarget
OOWeakReference *	_lastEscortTarget
OOWeakReference *	_thankedShip
OOWeakReference *	_rememberedShip
OOWeakReference *	_proximityAlert
float	reactionTime
HPVector	trackingCurvePositions [4]
OOTimeAbsolute	trackingCurveTimes [4]
HPVector	trackingCurveCoeffs [3]
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

Private Attributes
OOWeakReference *	_subEntityTakingDamage
NSString *	_shipKey
NSMutableArray *	_equipment
float	_heatInsulation
OOWeakReference *	_lastAegisLock
OOShipGroup *	_group
OOShipGroup *	_escortGroup
uint8_t	_maxEscortCount
uint8_t	_pendingEscortCount
Vector	_escortPositions [MAX_ESCORTS]
BOOL	_escortPositionsValid
OOWeakSet *	_defenseTargets
OOWeakSet *	_collisionExceptions
GLfloat	_profileRadius
OOWeakReference *	_shipHitByLaser
NSString *	_beaconCode
NSString *	_beaconLabel
OOWeakReference *	_prevBeacon
OOWeakReference *	_nextBeacon
id< OOHUDBeaconIcon >	_beaconDrawable
double	_nextAegisCheck
BOOL	isDemoShip
OOScalar	demoRate
OOTimeAbsolute	demoStartTime
Quaternion	demoStartOrientation

Detailed Description

Definition at line 192 of file ShipEntity.h.

Method Documentation

abandonShip

- (BOOL) abandonShip

Definition at line 13308 of file ShipEntity.m.

{
    BOOL OK = NO;
    if ([self isPlayer] && [(PlayerEntity *)self isDocked])
    {
        OOLog(@"ShipEntity.abandonShip.failed", @"%@", @"Player cannot abandon ship while docked.");
        return OK;
    }
    
    if (![self hasEscapePod])
    {
        OOLog(@"ShipEntity.abandonShip.failed", @"Ship abandonment was requested for %@, but this ship does not carry escape pod(s).", self);
        return OK;
    }
        
    if (EXPECT([self launchEscapeCapsule] != NO_TARGET))  // -launchEscapeCapsule takes care of everything for the player
    {
        if (![self isPlayer])
        {
            OK = YES;
            // if multiple items providing escape pod, remove all of them (NPC process)
            while ([self hasEquipmentItemProviding:@"EQ_ESCAPE_POD"])
            {
                [self removeEquipmentItem:[self equipmentItemProviding:@"EQ_ESCAPE_POD"]];
            }
            [self setAITo:@"nullAI.plist"];
            behaviour = BEHAVIOUR_IDLE;
            frustration = 0.0;
            [self setScanClass: CLASS_CARGO];           // we're unmanned now!
            thrust = thrust * 0.5;
            if (thrust > 5) thrust = 5; // 5 is the thrust of an escape-capsule
            desired_speed = 0.0;
            if ([self group]) [self setGroup:nil]; // remove self from group.
            if (![self isSubEntity] && [self owner]) [self setOwner:nil]; //unset owner, but not if we are a subent
            if ([self hasEscorts])
            {
                OOShipGroup         *escortGroup = [self escortGroup];
                NSEnumerator        *escortEnum = nil;
                ShipEntity          *escort = nil;
                // Note: works on escortArray rather than escortEnumerator because escorts may be mutated.
                for (escortEnum = [[self escortArray] objectEnumerator]; (escort = [escortEnum nextObject]); )
                {
                    // act individually now!
                    if ([escort group] == escortGroup)  [escort setGroup:nil];
                    if ([escort owner] == self)  [escort setOwner:escort];
                }
                
                // We now have no escorts.
                [_escortGroup release];
                _escortGroup = nil;
            }
        }
    }
    else if (EXPECT([self isSubEntity]))
    {
        // may still have launched passenger pods even if no crew
        // if multiple items providing escape pod, remove all of them (NPC process)
        while ([self hasEquipmentItemProviding:@"EQ_ESCAPE_POD"])
        {
            [self removeEquipmentItem:[self equipmentItemProviding:@"EQ_ESCAPE_POD"]];
        }
 
    }
    else
    {
        // this shouldn't happen any more!
        OOLog(@"ShipEntity.abandonShip.notPossible", @"Ship %@ cannot be abandoned at this time.", self);
    }
    return OK;
}

References _escortGroup, abandonShip, behaviour, desired_speed, equipmentItemProviding:, escortArray, escortGroup, EXPECT, frustration, group, hasEscapePod, hasEscorts, Entity::isPlayer, Entity::isSubEntity, launchEscapeCapsule, nil, NO_TARGET, OOLog, Entity::owner, removeEquipmentItem:, setAITo:, setGroup:, setOwner:, Entity::setScanClass:, and thrust.

Referenced by abandonShip, coordinates, and takeEnergyDamage:from:becauseOf:weaponIdentifier:.

Here is the call graph for this function:

Here is the caller graph for this function:

abortDocking

- (void) abortDocking

Definition at line 14047 of file ShipEntity.m.

{
    [[UNIVERSE findEntitiesMatchingPredicate:IsStationPredicate
                                   parameter:nil
                                     inRange:-1
                                    ofEntity:nil]
            makeObjectsPerformSelector:@selector(abortDockingForShip:) withObject:self];
}

References abortDocking.

Referenced by abortDocking, coordinates, PlayerEntity::disengageAutopilot, and getDestroyedBy:damageType:.

Here is the call graph for this function:

Here is the caller graph for this function:

absoluteIJKForSubentity

- (Triangle) absoluteIJKForSubentity

Definition at line 2234 of file ShipEntity.m.

{
    Triangle    result = {{ kBasisXVector, kBasisYVector, kBasisZVector }};
    Entity      *last = nil;
    Entity      *father = self;
    OOMatrix    r_mat;
    
    while ((father)&&(father != last) && (father != NO_TARGET))
    {
        r_mat = [father drawRotationMatrix];
        result.v[0] = OOVectorMultiplyMatrix(result.v[0], r_mat);
        result.v[1] = OOVectorMultiplyMatrix(result.v[1], r_mat);
        result.v[2] = OOVectorMultiplyMatrix(result.v[2], r_mat);
        
        last = father;
        if (![last isSubEntity]) break;
        father = [father owner];
    }
    return result;
}

References absoluteIJKForSubentity, Entity::drawRotationMatrix, Entity::isSubEntity, kBasisXVector, kBasisYVector, kBasisZVector, nil, NO_TARGET, OOVectorMultiplyMatrix(), and Entity::owner.

Referenced by absoluteIJKForSubentity, PlayerEntity::doesHitLine:v0:v1:, doesHitLine:v0:v1:, doOctreesCollide, and maxFlightSpeed.

Here is the call graph for this function:

Here is the caller graph for this function:

absoluteTractorPosition

- (HPVector) absoluteTractorPosition

Definition at line 1540 of file ShipEntity.m.

{
    return HPvector_add(position, vectorToHPVector(quaternion_rotate_vector([self normalOrientation], tractor_position)));
}

References absoluteTractorPosition, Entity::normalOrientation, Entity::position, quaternion_rotate_vector(), and tractor_position.

Referenced by absoluteTractorPosition, behaviour_tractored:, and findBoundingBoxRelativeToPosition:InVectors:i:j:.

Here is the call graph for this function:

Here is the caller graph for this function:

acceptAsEscort:

- (BOOL) acceptAsEscort:

(ShipEntity *)

other_ship

Definition at line 13710 of file ShipEntity.m.

                       :(ShipEntity *) other_ship
{
    // can't pair with self
    if (self == other_ship)  return NO;
    
    // no longer in flight, probably entered wormhole without telling escorts.
    if ([self status] != STATUS_IN_FLIGHT)  return NO;
    
    //increased stack depth at which it can accept escorts to avoid rejections at this stage.
    //doesn't seem to have any adverse effect for now. - Kaks.
    if ([shipAI stackDepth] > 3)
    {
        OOLog(@"ship.escort.reject", @"%@ rejecting escort %@ because AI stack depth is %lu.",self, other_ship, [shipAI stackDepth]);
        return NO;
    }
    
    if ([self canAcceptEscort:other_ship])
    {
        OOShipGroup *escortGroup = [self escortGroup];
        
        if ([escortGroup containsShip:other_ship])  return YES;
        
        // check total number acceptable
        // the system's patrols don't have escorts set inside their dictionary, but accept max escorts.
        if (_maxEscortCount == 0 && ([self hasPrimaryRole:@"police"] || [self hasPrimaryRole:@"hunter"] || [self hasRole:@"thargoid-mothership"])) 
        {
            _maxEscortCount = MAX_ESCORTS;
        }
        
        NSUInteger maxEscorts = _maxEscortCount;     // never bigger than MAX_ESCORTS.
        NSUInteger escortCount = [escortGroup count] - 1;   // always 0 or higher.
        
        if (escortCount < maxEscorts)
        {
            [other_ship setGroup:escortGroup];
            if ([self group] == nil)
            {
                [self setGroup:escortGroup];
            }
            else if ([self group] != escortGroup)  [[self group] addShip:other_ship];
            
            if (([other_ship maxFlightSpeed] < cruiseSpeed) && ([other_ship maxFlightSpeed] > cruiseSpeed * 0.3))
            {
                cruiseSpeed = [other_ship maxFlightSpeed] * 0.99;
            }
            
            OOLog(@"ship.escort.accept", @"%@ accepting escort %@.", self, other_ship);
            
            [self doScriptEvent:OOJSID("shipAcceptedEscort") withArgument:other_ship];
            [other_ship doScriptEvent:OOJSID("escortAccepted") withArgument:self];
            [shipAI message:@"ACCEPTED_ESCORT"];
            return YES;
        }
        else
        {
            OOLog(@"ship.escort.reject", @"%@ already got max escorts(%ld). Escort rejected: %@.", self, escortCount, other_ship);
        }
    }
    else
    {
        OOLog(@"ship.escort.reject", @"%@ failed canAcceptEscort for escort %@.", self, other_ship);
    }
 
    
    return NO;
}

References _maxEscortCount, OOShipGroup::addShip:, OOShipGroup::count, cruiseSpeed, doScriptEvent:withArgument:, escortCount, escortGroup, group, MAX_ESCORTS, maxFlightSpeed, AI::message:, nil, OOLog, setGroup:, shipAI, and Entity::status.

Referenced by ShipGroupAddShip().

Here is the call graph for this function:

Here is the caller graph for this function:

acceptDistressMessageFrom:

- (void) acceptDistressMessageFrom: (ShipEntity *) other

implementation

Reimplemented in StationEntity.

Provided by category ShipEntity(OOAIPrivate).

Definition at line 2884 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];
    
}

Referenced by ShipEntity(AI)::broadcastDistressMessageWithDumping:.

Here is the caller graph for this function:

accuracy

- (GLfloat) accuracy

References mesh, and totalBoundingBox.

Here is the call graph for this function:

activateCloakingDevice

- (BOOL) activateCloakingDevice

Reimplemented in PlayerEntity.

Definition at line 12365 of file ShipEntity.m.

{
    if (![self hasCloakingDevice] || cloaking_device_active)  return cloaking_device_active; // no changes.
    
    if (!cloaking_device_active)  cloaking_device_active = (energy > CLOAKING_DEVICE_START_ENERGY * maxEnergy);
    if (cloaking_device_active)  [self doScriptEvent:OOJSID("shipCloakActivated")];
    return cloaking_device_active;
}

References activateCloakingDevice, cloaking_device_active, CLOAKING_DEVICE_START_ENERGY, doScriptEvent:, Entity::energy, hasCloakingDevice, and Entity::maxEnergy.

Referenced by activateCloakingDevice, behaviour_attack_break_off_target:, behaviour_attack_broadside:, behaviour_attack_broadside_target:leftside:, behaviour_attack_fly_from_target:, behaviour_attack_fly_to_target:, behaviour_attack_slow_dogfight:, behaviour_attack_sniper:, behaviour_attack_target:, behaviour_evasive_action:, behaviour_flee_target:, behaviour_fly_to_target_six:, behaviour_running_defense:, coordinates, and setCloaked:.

Here is the call graph for this function:

Here is the caller graph for this function:

addCargo:

- (BOOL) addCargo:

(NSArray *)

some_cargo

Definition at line 8456 of file ShipEntity.m.

                 :(NSArray *) some_cargo
{
    if ([cargo count] + [some_cargo count] > [self maxAvailableCargoSpace])
    {
        return NO;
    }
    else
    {
        [cargo addObjectsFromArray:some_cargo];
        return YES;
    }
}

References cargo, count, and maxAvailableCargoSpace.

Here is the call graph for this function:

addCollisionException:

- (void) addCollisionException:

(ShipEntity *)

ship

Definition at line 11128 of file ShipEntity.m.

                              :(ShipEntity *)ship
{
    if (_collisionExceptions == nil)
    {
        // Allocate lazily for the benefit of the ships that never need this.
        _collisionExceptions = [[OOWeakSet alloc] init];
    }
    [_collisionExceptions addObject:ship];
}

References _collisionExceptions, OOWeakSet::addObject:, and nil.

Referenced by ShipAddCollisionException().

Here is the call graph for this function:

Here is the caller graph for this function:

addDefenseTarget:

- (BOOL) addDefenseTarget:

(Entity *)

target

Definition at line 11177 of file ShipEntity.m.

                         :(Entity *)target
{
    if ([self defenseTargetCount] >= MAX_TARGETS)
    {
        return NO;
    }
    // primary target can be a wormhole, defense targets shouldn't be
    if (target == nil || [self isDefenseTarget:target] || ![target isShip])
    {
        return NO;
    }
    if (_defenseTargets == nil)
    {
        // Allocate lazily for the benefit of the ships that never get in fights.
        _defenseTargets = [[OOWeakSet alloc] init];
    }
    
    [_defenseTargets addObject:target];
    return YES;
}

References _defenseTargets, OOWeakSet::addObject:, defenseTargetCount, Entity::isShip, MAX_TARGETS, and nil.

Referenced by ShipEntity(PureAI)::addFoundTargetAsDefenseTarget, ShipEntity(PureAI)::addPrimaryAggressorAsDefenseTarget, ShipEntity(PureAI)::fightOrFleeHostiles, ShipEntity(PureAI)::fightOrFleeMissile, ShipEntity(PureAI)::findNewDefenseTarget, and ShipEntity(PureAI)::setTargetToPrimaryAggressor.

Here is the call graph for this function:

Here is the caller graph for this function:

addEquipmentItem:inContext:

- (BOOL) addEquipmentItem:		(NSString *)	equipmentKey
inContext:		(NSString *)	context

Reimplemented in PlayerEntity.

Definition at line 3531 of file ShipEntity.m.

                         :(NSString *)equipmentKey inContext:(NSString *)context
{
    return [self addEquipmentItem:equipmentKey withValidation:YES inContext:context];
}

References addEquipmentItem:withValidation:inContext:.

Referenced by setUpShipFromDictionary:.

Here is the call graph for this function:

Here is the caller graph for this function:

addEquipmentItem:withValidation:inContext:

- (BOOL) addEquipmentItem:		(NSString *)	equipmentKey
withValidation:		(BOOL)	validateAddition
inContext:		(NSString *)	context

Reimplemented in PlayerEntity.

Definition at line 3537 of file ShipEntity.m.

                         :(NSString *)equipmentKey withValidation:(BOOL)validateAddition inContext:(NSString *)context
{
    OOEquipmentType         *eqType = nil;
    NSString                *lcEquipmentKey = [equipmentKey lowercaseString];
    NSString                *damagedKey;
    BOOL                    isEqThargon = [lcEquipmentKey hasSuffix:@"thargon"] || [lcEquipmentKey hasPrefix:@"thargon"];
    BOOL                    isRepairedEquipment = NO;
    
    if([lcEquipmentKey isEqualToString:@"thargon"]) equipmentKey = @"EQ_THARGON";
    
    // canAddEquipment always checks if the undamaged version is equipped.
    if (validateAddition == YES && ![self canAddEquipment:equipmentKey inContext:context])  return NO;
    
    if ([equipmentKey hasSuffix:@"_DAMAGED"])
    {
        eqType = [OOEquipmentType equipmentTypeWithIdentifier:[equipmentKey substringToIndex:[equipmentKey length] - [@"_DAMAGED" length]]];
    }
    else 
    {
        eqType = [OOEquipmentType equipmentTypeWithIdentifier:equipmentKey];
        // in case we have the damaged version!
        if (![eqType canCarryMultiple])
        {
            damagedKey = [equipmentKey stringByAppendingString:@"_DAMAGED"];
            if ([_equipment containsObject:damagedKey])
            {
                [_equipment removeObject:damagedKey];
                isRepairedEquipment = YES;
            }
        }
    }
    
    // does this equipment actually exist?
    if (eqType == nil)  return NO;
    
    // special cases
    if ([eqType isMissileOrMine] || ([self isThargoid] && isEqThargon))
    {
        if (missiles >= max_missiles) return NO;
        
        missile_list[missiles] = eqType;
        missiles++;
        return YES;
    }
    
    // don't add any thargons to non-thargoid ships.
    if(isEqThargon) return NO;
    
    // we can theoretically add a damaged weapon, but not a working one.
    if([equipmentKey hasPrefix:@"EQ_WEAPON"] && ![equipmentKey hasSuffix:@"_DAMAGED"])
    {
        return NO;
    }
    // end special cases
    
    if (_equipment == nil)  _equipment = [[NSMutableArray alloc] init];
    
    if (![equipmentKey isEqualToString:@"EQ_PASSENGER_BERTH"] && !isRepairedEquipment) 
    {
        // Add to equipment_weight with all other equipment.
        equipment_weight += [eqType requiredCargoSpace];
        if (equipment_weight > max_cargo)
        {
            // should not even happen with old save games. Reject equipment now.
            equipment_weight -= [eqType requiredCargoSpace];
            return NO;
        }
    }
    
    
    if (!isPlayer)
    {
        if ([equipmentKey isEqual:@"EQ_CARGO_BAY"])
        {
            max_cargo += extra_cargo;
        }
        else if([equipmentKey isEqualToString:@"EQ_SHIELD_BOOSTER"]) 
        {
            maxEnergy += 256.0f;
        }
        if([equipmentKey isEqualToString:@"EQ_SHIELD_ENHANCER"]) 
        {
            maxEnergy += 256.0f;
            energy_recharge_rate *= 1.5;
        }
    } 
    // add the equipment
    [_equipment addObject:equipmentKey];
    [self doScriptEvent:OOJSID("equipmentAdded") withArgument:equipmentKey];
    return YES;
}

References _equipment, doScriptEvent:withArgument:, energy_recharge_rate, equipment_weight, OOEquipmentType::equipmentTypeWithIdentifier:, extra_cargo, Entity::isPlayer, isThargoid, max_cargo, max_missiles, Entity::maxEnergy, missile_list, missiles, nil, and OOEquipmentType::requiredCargoSpace.

Referenced by addEquipmentItem:inContext:, PlayerEntity::addEquipmentItem:withValidation:inContext:, ShipAwardEquipment(), ShipEntity(LoadRestore)::shipRestoredFromDictionary:useFallback:context:, and ShipSetEquipmentStatus().

Here is the call graph for this function:

Here is the caller graph for this function:

addFoundTargetAsDefenseTarget

- (void) addFoundTargetAsDefenseTarget

implementation

Provided by category ShipEntity(PureAI).

Definition at line 1155 of file ShipEntityAI.m.

{
    Entity* fTarget = [self foundTarget];
    if (fTarget != nil)
    {
        if ([fTarget isShip] && ![(ShipEntity *)fTarget isFriendlyTo:self])
        {
            [self addDefenseTarget:fTarget];
        }
    }
}

addFuel:

- (void) addFuel: (NSString *) fuel_number

implementation

Provided by category ShipEntity(PureAI).

Definition at line 2560 of file ShipEntityAI.m.

                :(NSString*) fuel_number
{
    [self setFuel:[self fuel] + [fuel_number intValue] * 10];
}

addImpactMoment:fraction:

- (void) addImpactMoment:		(Vector)	moment
fraction:		(GLfloat)	howmuch

Definition at line 12855 of file ShipEntity.m.

                        :(Vector) moment fraction:(GLfloat) howmuch
{
    velocity = vector_add(velocity, vector_multiply_scalar(moment, howmuch / mass));
}

References Entity::mass, and velocity.

Referenced by dealMomentumWithinDesiredRange:.

Here is the call graph for this function:

Here is the caller graph for this function:

addPrimaryAggressorAsDefenseTarget

- (void) addPrimaryAggressorAsDefenseTarget

implementation

Provided by category ShipEntity(PureAI).

Definition at line 979 of file ShipEntityAI.m.

{
    Entity *primeAggressor = [self primaryAggressor];
    if (!primeAggressor)
        return;
    if ([self isDefenseTarget:primeAggressor])
        return;
    
    if ([primeAggressor isShip] && ![(ShipEntity*)primeAggressor isFriendlyTo:self])
    {
        [self addDefenseTarget:primeAggressor];
    }
}

addRole:

- (void) addRole:

(NSString *)

role

Definition at line 7266 of file ShipEntity.m.

                :(NSString *)role
{
    [self addRole:role withProbability:0.0f];
}

References addRole:withProbability:.

Referenced by setIsBoulder:.

Here is the call graph for this function:

Here is the caller graph for this function:

addRole:withProbability:

- (void) addRole:		(NSString *)	role
withProbability:		(float)	probability

Definition at line 7272 of file ShipEntity.m.

                :(NSString *)role withProbability:(float)probability
{
    if (![self hasRole:role])
    {
        OORoleSet *newRoles = nil;
        if (roleSet != nil)  newRoles = [roleSet roleSetWithAddedRole:role probability:probability];
        else  newRoles = [OORoleSet roleSetWithRole:role probability:probability];
        if (newRoles != nil)
        {
            [roleSet release];
            roleSet = [newRoles retain];
        }
    }
}

References nil, roleSet, OORoleSet::roleSetWithAddedRole:probability:, and OORoleSet::roleSetWithRole:probability:.

Referenced by addRole:.

Here is the call graph for this function:

Here is the caller graph for this function:

addSubEntity:

- (void) addSubEntity: (Entity<OOSubEntity> *) sub

implementation

Provided by category ShipEntity(Private).

Definition at line 6707 of file ShipEntity.m.

                     :(Entity<OOSubEntity> *)sub
{
    if (sub == nil)  return;
    
    if (subEntities == nil)  subEntities = [[NSMutableArray alloc] init];
    sub->isSubEntity = YES;
    // Order matters - need consistent state in setOwner:. -- Ahruman 2008-04-20
    [subEntities addObject:sub];
    [sub setOwner:self];
    
    [self addSubentityToCollisionRadius:sub];
}

References addSubentityToCollisionRadius:, Entity::isSubEntity, nil, and setOwner:.

Referenced by ShipEntity(Private)::setUpOneFlasher:, setUpOneStandardSubentity:asTurret:, and setUpSubEntities.

Here is the call graph for this function:

Here is the caller graph for this function:

addSubentityToCollisionRadius:

- (void) addSubentityToCollisionRadius: (Entity<OOSubEntity> *) subent

implementation

Provided by category ShipEntity(Private).

Definition at line 2256 of file ShipEntity.m.

                                      :(Entity<OOSubEntity> *)subent
{
    if (!subent)  return;
    
    double distance = HPmagnitude([subent position]) + [subent findCollisionRadius];
    if ([subent isKindOfClass:[ShipEntity class]])  // Solid subentity
    {
        if (distance > collision_radius)
        {
            collision_radius = distance;
        }
        
        mass += [subent mass];
    }
    if (distance > _profileRadius)
    {
        _profileRadius = distance;
    }
}

Referenced by ShipEntity(Private)::addSubEntity:.

Here is the caller graph for this function:

addTarget:

- (void) addTarget:

(Entity *)

targetEntity

Reimplemented in PlayerEntity.

Definition at line 10058 of file ShipEntity.m.

                  :(Entity *) targetEntity
{
    if (targetEntity == self)  return;
    if (targetEntity != nil) 
    {
        DESTROY(_primaryTarget);
        _primaryTarget = [targetEntity weakRetain];
        [self startTrackingCurve];
    }
    
    [[self shipSubEntityEnumerator] makeObjectsPerformSelector:@selector(addTarget:) withObject:targetEntity];
    if (![self isSubEntity])  [self doScriptEvent:OOJSID("shipTargetAcquired") withArgument:targetEntity];
}

References _primaryTarget, DESTROY, doScriptEvent:withArgument:, Entity::isSubEntity, nil, shipSubEntityEnumerator, startTrackingCurve, and OOWeakRefObject::weakRetain.

Referenced by PlayerEntity::addTarget:, deployEscorts, enterWormhole:replacing:, ShipEntity(PureAI)::fightOrFleeHostiles, ShipEntity(PureAI)::fightOrFleeMissile, fireMissileWithIdentifier:andTarget:, getTractoredBy:, launchCascadeMine, StationEntity::launchDefenseShip, StationEntity::launchPirateShip, StationEntity::launchPolice, PlayerEntity::moveTargetMemoryBy:, ShipEntity(AI)::recallDockingInstructions, PlayerEntity::selectNextMissile, ShipEntity(OOJavaScriptExtensions)::setTargetForScript:, ShipEntity(PureAI)::setTargetToFoundTarget, ShipEntity(PureAI)::setTargetToLastStation, setTargetToNearestStationIncludingHostiles:, ShipEntity(PureAI)::setTargetToPrimaryAggressor, ShipEntity(PureAI)::setTargetToRandomStation, setTargetToSystemStation, ShipEntity(ScriptMethods)::spawnShipsWithRole:count:, ShipEntity(PureAI)::targetFirstBeaconWithCode:, ShipEntity(PureAI)::targetNextBeaconWithCode:, ShipEntity(AI)::wormholeEscorts, and ShipEntity(PureAI)::wormholeGroup.

Here is the call graph for this function:

Here is the caller graph for this function:

adjustMissedShots:

- (void) adjustMissedShots:

(int)

delta

Definition at line 12068 of file ShipEntity.m.

                          :(int) delta
{
    if ([self isSubEntity])
    {
        [[self owner] adjustMissedShots:delta];
    }
    else
    {
        _missed_shots += delta;
        if (_missed_shots < 0)
        {
            _missed_shots = 0;
        }
    }
}

References _missed_shots, adjustMissedShots:, Entity::isSubEntity, and Entity::owner.

Referenced by adjustMissedShots:, fireLaserShotInDirection:weaponIdentifier:, and fireSubentityLaserShot:.

Here is the call graph for this function:

Here is the caller graph for this function:

adjustVelocity:

- (void) adjustVelocity:

(Vector)

xVel

Reimplemented in StationEntity.

Definition at line 12849 of file ShipEntity.m.

                       :(Vector) xVel
{
    velocity = vector_add(velocity, xVel);
}

References velocity.

Referenced by StationEntity::adjustVelocity:, behaviour_land_on_planet:, collideWithShip:, and DockEntity::shipIsInDockingCorridor:.

Here is the call graph for this function:

Here is the caller graph for this function:

afterburnerFactor

- (float) afterburnerFactor

Definition at line 4095 of file ShipEntity.m.

{
    return afterburner_speed_factor;
}

References afterburner_speed_factor, and afterburnerFactor.

Referenced by afterburnerFactor, applyThrust:, behaviour_attack_break_off_target:, behaviour_attack_broadside:, behaviour_attack_broadside_target:leftside:, behaviour_attack_fly_from_target:, behaviour_attack_fly_to_target:, behaviour_attack_sniper:, behaviour_evasive_action:, behaviour_flee_target:, behaviour_fly_to_target_six:, PlayerEntity::doBookkeeping:, increase_flight_speed:, isFrangible, PlayerEntity(OOPrivate)::performInFlightUpdates:, and WormholeEntity::suckInShip:.

Here is the call graph for this function:

Here is the caller graph for this function:

afterburnerRate

- (float) afterburnerRate

Definition at line 4101 of file ShipEntity.m.

{
    return afterburner_rate;
}

References afterburner_rate, and afterburnerRate.

Referenced by afterburnerRate, and isFrangible.

Here is the call graph for this function:

Here is the caller graph for this function:

aftWeaponOffset

- (NSArray *) aftWeaponOffset

References forwardWeaponOffset.

ai_debugMessage:

- (void) ai_debugMessage: (NSString *) message

implementation

Provided by category ShipEntity(PureAI).

Definition at line 2650 of file ShipEntityAI.m.

                        :(NSString *)message
{
    NSString *desc = [NSString stringWithFormat:@"%@ %d", [self name], [self universalID]];
    if ([self isPlayer])  desc = @"player autopilot";
    OOLog(@"ai.takeAction.debugMessage", @"DEBUG: AI MESSAGE from %@: %@", desc, message);
}

ai_throwSparks

- (void) ai_throwSparks

implementation

Provided by category ShipEntity(PureAI).

Definition at line 2638 of file ShipEntityAI.m.

{
    [self setThrowSparks:YES];
}

alertCondition

- (OOAlertCondition) alertCondition

Reimplemented in PlayerEntity, and ProxyPlayerEntity.

Definition at line 14745 of file ShipEntity.m.

{
    if ([self status] == STATUS_DOCKED) 
    {
        return ALERT_CONDITION_DOCKED;
    }
    if ([self hasHostileTarget] || energy < maxEnergy / 4)
    {
        return ALERT_CONDITION_RED;
    }
    return ALERT_CONDITION_YELLOW;
}

References ALERT_CONDITION_DOCKED, ALERT_CONDITION_RED, ALERT_CONDITION_YELLOW, alertCondition, Entity::energy, hasHostileTarget, Entity::maxEnergy, and Entity::status.

Referenced by alertCondition, and isMissile.

Here is the call graph for this function:

Here is the caller graph for this function:

allDefenseTargets

- (NSArray *) allDefenseTargets

Definition at line 11165 of file ShipEntity.m.

{
    return [_defenseTargets allObjects];
}

References allDefenseTargets, and OOWeakSet::allObjects.

Referenced by allDefenseTargets, isMissile, and validateDefenseTargets.

Here is the call graph for this function:

Here is the caller graph for this function:

applyAttitudeChanges:

- (void) applyAttitudeChanges:

(double)

delta_t

Reimplemented in PlayerEntity.

Definition at line 6830 of file ShipEntity.m.

                             :(double) delta_t
{
    [self applyRoll:flightRoll*delta_t climb:flightPitch*delta_t andYaw:flightYaw*delta_t];
}

References applyRoll:climb:andYaw:.

Referenced by processBehaviour:, and update:.

Here is the call graph for this function:

Here is the caller graph for this function:

applyRoll:andClimb:

- (void) applyRoll: (GLfloat) roll1 andClimb: (GLfloat) climb1

implementation

Reimplemented from Entity.

Reimplemented in PlayerEntity.

Definition at line 6797 of file ShipEntity.m.

                  :(GLfloat) roll1 andClimb:(GLfloat) climb1
{
    Quaternion q1 = kIdentityQuaternion;
 
    if (!roll1 && !climb1 && !hasRotated)  return;
 
    if (roll1)  quaternion_rotate_about_z(&q1, -roll1);
    if (climb1)  quaternion_rotate_about_x(&q1, -climb1);
 
    orientation = quaternion_multiply(q1, orientation);
    [self orientationChanged];
}

References Entity::hasRotated, kIdentityQuaternion, Entity::orientation, orientationChanged, quaternion_multiply(), quaternion_rotate_about_x(), and quaternion_rotate_about_z().

Here is the call graph for this function:

applyRoll:climb:andYaw:

- (void) applyRoll: (GLfloat) roll1 climb: (GLfloat) climb1 andYaw: (GLfloat) yaw1

implementation

Reimplemented from Entity.

Definition at line 6811 of file ShipEntity.m.

                  :(GLfloat) roll1 climb:(GLfloat) climb1 andYaw:(GLfloat) yaw1
{
    if ((roll1 == 0.0)&&(climb1 == 0.0)&&(yaw1 == 0.0)&&(!hasRotated))
        return;
 
    Quaternion q1 = kIdentityQuaternion;
 
    if (roll1)
        quaternion_rotate_about_z(&q1, -roll1);
    if (climb1)
        quaternion_rotate_about_x(&q1, -climb1);
    if (yaw1)
        quaternion_rotate_about_y(&q1, -yaw1);
 
    orientation = quaternion_multiply(q1, orientation);
    [self orientationChanged];
}

References Entity::hasRotated, kIdentityQuaternion, Entity::orientation, orientationChanged, quaternion_multiply(), quaternion_rotate_about_x(), quaternion_rotate_about_y(), and quaternion_rotate_about_z().

Referenced by applyAttitudeChanges:.

Here is the call graph for this function:

Here is the caller graph for this function:

applySticks:

- (void) applySticks:

(double)

delta_t

Definition at line 8143 of file ShipEntity.m.

                    :(double)delta_t
{
    
    double  rate1 = 2.0 * delta_t; //roll 
    double  rate2 = 4.0 * delta_t; //pitch
    double  rate3 = 4.0 * delta_t; //yaw
 
    if (((stick_roll > 0.0)&&(flightRoll < 0.0))||((stick_roll < 0.0)&&(flightRoll > 0.0)))
        rate1 *= 4.0;   // much faster correction
    if (((stick_pitch > 0.0)&&(flightPitch < 0.0))||((stick_pitch < 0.0)&&(flightPitch > 0.0)))
        rate2 *= 4.0;   // much faster correction
    if (((stick_yaw > 0.0)&&(flightYaw < 0.0))||((stick_yaw < 0.0)&&(flightYaw > 0.0)))
        rate3 *= 4.0;   // much faster correction
 
    if (accuracy >= COMBAT_AI_TRACKS_CLOSER) 
    {
        if (stick_roll == 0.0)
            rate1 *= 2.0;   // faster correction
        if (stick_pitch == 0.0)
            rate2 *= 2.0;   // faster correction
        if (stick_yaw == 0.0)
            rate3 *= 2.0;   // faster correction
    }
 
    // apply stick movement limits
    if (flightRoll < stick_roll - rate1)
    {
        flightRoll = flightRoll + rate1;
    }
    else if (flightRoll > stick_roll + rate1)
    {
        flightRoll = flightRoll - rate1;
    }
    else
    {
        flightRoll = stick_roll;
    }
 
    if (flightPitch < stick_pitch - rate2)
    {
        flightPitch = flightPitch + rate2;
    }
    else if (flightPitch > stick_pitch + rate2)
    {
        flightPitch = flightPitch - rate2;
    }
    else
    {
        flightPitch = stick_pitch;
    }
 
    if (flightYaw < stick_yaw - rate3)
    {
        flightYaw = flightYaw + rate3;
    }
    else if (flightYaw > stick_yaw + rate3)
    {
        flightYaw = flightYaw - rate3;
    }
    else
    {
        flightYaw = stick_yaw;
    }
 
}

References accuracy, COMBAT_AI_TRACKS_CLOSER, flightPitch, flightRoll, flightYaw, stick_pitch, stick_roll, and stick_yaw.

Referenced by behaviour_idle:, behaviour_scripted_ai:, behaviour_stop_still:, behaviour_tumble:, evasiveAction:, missileTrackPrimaryTarget:, trackDestination:delta_t:, trackPrimaryTarget:delta_t:, and trackSideTarget:delta_t:.

Here is the caller graph for this function:

applyThrust:

- (void) applyThrust:

(double)

delta_t

Definition at line 6737 of file ShipEntity.m.

                    :(double) delta_t
{
    GLfloat dt_thrust = SHIP_THRUST_FACTOR * thrust * delta_t;
    BOOL    canBurn = [self hasFuelInjection] && (fuel > MIN_FUEL);
    BOOL    isUsingAfterburner = (canBurn && (flightSpeed > maxFlightSpeed) && (desired_speed >= flightSpeed));
    float   max_available_speed = maxFlightSpeed;
    if (canBurn) max_available_speed *= [self afterburnerFactor];
    
    if (thrust)
    {
        // If we have Newtonian (non-thrust) velocity, brake it.
        GLfloat velmag = magnitude(velocity);
        if (velmag)
        {
            GLfloat vscale = fmaxf((velmag - dt_thrust) / velmag, 0.0f);
            scale_vector(&velocity, vscale);
        }
    }
 
    if (behaviour == BEHAVIOUR_TUMBLE)  return;
 
    // check for speed
    if (desired_speed > max_available_speed)
        desired_speed = max_available_speed;
 
    if (flightSpeed > desired_speed)
    {
        [self decrease_flight_speed: dt_thrust];
        if (flightSpeed < desired_speed)   flightSpeed = desired_speed;
    }
    if (flightSpeed < desired_speed)
    {
        [self increase_flight_speed: dt_thrust];
        if (flightSpeed > desired_speed)   flightSpeed = desired_speed;
    }
    [self moveForward: delta_t*flightSpeed];
 
    // burn fuel at the appropriate rate
    if (isUsingAfterburner) // no fuelconsumption on slowdown
    {
        fuel_accumulator -= delta_t * afterburner_rate;
        while (fuel_accumulator < 0.0)
        {
            fuel--;
            fuel_accumulator += 1.0;
        }
    }
}

References afterburner_rate, afterburnerFactor, behaviour, decrease_flight_speed:, desired_speed, flightSpeed, fuel, fuel_accumulator, hasFuelInjection, increase_flight_speed:, maxFlightSpeed, MIN_FUEL, Entity::moveForward:, SHIP_THRUST_FACTOR, thrust, and velocity.

Referenced by processBehaviour:, and update:.

Here is the call graph for this function:

Here is the caller graph for this function:

approachAspectToPrimaryTarget

- (double) approachAspectToPrimaryTarget

Definition at line 11257 of file ShipEntity.m.

{
    Vector delta;
    Entity  *target = [self primaryTarget];
    if (target == nil || ![target isShip])   // leave now!
    {
        return 0.0;
    }
    ShipEntity  *ship_target = (ShipEntity *)target;
 
    delta = HPVectorToVector(HPvector_subtract(position, target->position));
    
    return dot_product(vector_normal(delta), ship_target->v_forward);
}

References approachAspectToPrimaryTarget, Entity::isShip, nil, Entity::position, primaryTarget, and v_forward.

Referenced by approachAspectToPrimaryTarget, behaviour_attack_break_off_target:, behaviour_attack_fly_from_target:, behaviour_attack_fly_to_target:, behaviour_attack_slow_dogfight:, behaviour_attack_target:, behaviour_fly_to_target_six:, and coordinates.

Here is the call graph for this function:

Here is the caller graph for this function:

AuthorityPredicate

+ (static BOOL) AuthorityPredicate (Entity *) entity (void *) parameter

implementation

Definition at line 14073 of file ShipEntity.m.

{
    ShipEntity          *victim = parameter;
    
    // Select main station, if victim is in aegis
    if (entity == [UNIVERSE station] && [victim withinStationAegis])
    {
        return YES;
    }
    
    // Select police units in typical scanner range
    if ([entity scanClass] == CLASS_POLICE &&
        HPdistance2([victim position], [entity position]) < SCANNER_MAX_RANGE2)
    {
        return YES;
    }
    
    // Reject others
    return NO;
}

References Entity::position, scanClass, SCANNER_MAX_RANGE2, UNIVERSE, and withinStationAegis.

Here is the call graph for this function:

availableCargoSpace

- (OOCargoQuantity) availableCargoSpace

Definition at line 8380 of file ShipEntity.m.

{
    // OOCargoQuantity is unsigned, we need to check for underflows.
    if (EXPECT_NOT([self cargoQuantityOnBoard] + equipment_weight >= max_cargo)) return 0;
    return [self maxAvailableCargoSpace] - [self cargoQuantityOnBoard];
}

References availableCargoSpace, cargoQuantityOnBoard, equipment_weight, EXPECT_NOT, max_cargo, and maxAvailableCargoSpace.

Referenced by availableCargoSpace, bounty, PlayerEntity::enterWitchspace, equipmentValidToAdd:whileLoading:inContext:, PlayerEntity::setCargoQuantityForType:amount:, ShipAwardEquipment(), ShipSetProperty(), and PlayerEntity::tryBuyingCommodity:all:.

Here is the call graph for this function:

Here is the caller graph for this function:

avoidCollision

- (void) avoidCollision

Definition at line 6836 of file ShipEntity.m.

{
    if (scanClass == CLASS_MISSILE)
        return;                     // missiles are SUPPOSED to collide!
    
    ShipEntity* prox_ship = (ShipEntity*)[self proximityAlert];
 
    if (prox_ship)
    {
        if (previousCondition)
        {
            [previousCondition release];
            previousCondition = nil;
        }
 
        previousCondition = [[NSMutableDictionary dictionaryWithCapacity:5] retain];
        
        [previousCondition oo_setInteger:behaviour forKey:@"behaviour"];
        if ([self primaryTarget] != nil)
        {
            // must use the weak ref here to prevent potential over-retention
            [previousCondition setObject:[[self primaryTarget] weakSelf] forKey:@"primaryTarget"];
        }
        [previousCondition oo_setFloat:desired_range forKey:@"desired_range"];
        [previousCondition oo_setFloat:desired_speed forKey:@"desired_speed"];
        [previousCondition oo_setHPVector:_destination forKey:@"destination"];
        
        _destination = [prox_ship position];
        _destination = OOHPVectorInterpolate(position, [prox_ship position], 0.5);      // point between us and them
        
        desired_range = prox_ship->collision_radius * PROXIMITY_AVOID_DISTANCE_FACTOR;
        
        behaviour = BEHAVIOUR_AVOID_COLLISION;
        pitching_over = YES;
    }
}

References _destination, avoidCollision, behaviour, Entity::collision_radius, desired_range, nil, pitching_over, Entity::position, previousCondition, primaryTarget, PROXIMITY_AVOID_DISTANCE_FACTOR, proximityAlert, and scanClass.

Referenced by avoidCollision, behaviour_attack_break_off_target:, behaviour_attack_broadside_target:leftside:, behaviour_attack_fly_from_target:, behaviour_attack_fly_to_target:, behaviour_attack_mining_target:, behaviour_attack_slow_dogfight:, behaviour_close_to_broadside_range:, behaviour_close_with_target:, behaviour_evasive_action:, behaviour_face_destination:, behaviour_flee_target:, behaviour_fly_from_destination:, behaviour_fly_range_from_destination:, behaviour_fly_to_destination:, behaviour_fly_to_target_six:, behaviour_formation_form_up:, behaviour_intercept_target:, behaviour_land_on_planet:, behaviour_running_defense:, behaviour_track_target:, reactionTime, and trackPrimaryTarget:delta_t:.

Here is the call graph for this function:

Here is the caller graph for this function:

ballTrackLeadingTarget:atTarget:

- (double) ballTrackLeadingTarget:		(double)	delta_t
atTarget:		(Entity *)	target

Definition at line 10330 of file ShipEntity.m.

                                 :(double) delta_t atTarget:(Entity *)target
{
    if (!target)
    {
        return -2.0; // no target
    }
 
    Vector      vector_to_target;
    Vector      axis_to_track_by;
    Vector      my_aim = vector_forward_from_quaternion(orientation);
    Vector      my_ref = reference;
    double      aim_cos, ref_cos;
    Vector      leading = [target velocity];
 
    // need to get vector to target in terms of this entities coordinate system
    HPVector my_position = [self absolutePositionForSubentity];
    vector_to_target = HPVectorToVector(HPvector_subtract([target position], my_position));
    // this is in absolute coordinates, so now rotate it
 
    Entity      *last = nil;
    Entity      *father = [self parentEntity];
 
    Quaternion  q = kIdentityQuaternion;
    while ((father)&&(father != last) && (father != NO_TARGET))
    {
        /* Fix orientation */
        Quaternion fo = [father normalOrientation];
        fo.w = -fo.w;
        /* The below code works for player turrets where the
         * orientation is different, but not for NPC turrets. Taking
         * the normal orientation with -w works: there is probably a
         * neater way which someone who understands quaternions can
         * find, but this works well enough for 1.82 - CIM */
        q = quaternion_multiply(q,quaternion_conjugate(fo));
        last = father;
        if (![last isSubEntity]) break;
        father = [father owner];
    }
    q = quaternion_conjugate(q);
    // q now contains the rotation to the turret's reference system
 
    vector_to_target = quaternion_rotate_vector(q,vector_to_target);
 
    leading = quaternion_rotate_vector(q,leading);
    // rotate the vector to target and its velocity
    
    if (magnitude(vector_to_target) > weaponRange * 1.01)
    {
        return -2.0; // out of range
    }
 
    float lead = magnitude(vector_to_target) / TURRET_SHOT_SPEED;
        
    vector_to_target = vector_add(vector_to_target, vector_multiply_scalar(leading, lead));
    vector_to_target = vector_normal_or_fallback(vector_to_target, kBasisZVector);
        
    // do the tracking!
    aim_cos = dot_product(vector_to_target, my_aim);
    ref_cos = dot_product(vector_to_target, my_ref);
 
    
    if (ref_cos > TURRET_MINIMUM_COS)  // target is forward of self
    {
        axis_to_track_by = cross_product(vector_to_target, my_aim);
    }
    else
    {
        return -2.0; // target is out of fire arc
    }
    
    quaternion_rotate_about_axis(&orientation, axis_to_track_by, thrust * delta_t);
    [self orientationChanged];
    
    [self setStatus:STATUS_ACTIVE];
    
    return aim_cos;
}

References Entity::absolutePositionForSubentity, Entity::isSubEntity, kBasisZVector, kIdentityQuaternion, nil, NO_TARGET, Entity::normalOrientation, Entity::orientation, orientationChanged, Entity::owner, Entity::parentEntity, Entity::position, quaternion_multiply(), quaternion_rotate_about_axis(), quaternion_rotate_vector(), reference, setStatus:, thrust, TURRET_MINIMUM_COS, TURRET_SHOT_SPEED, vector_forward_from_quaternion(), Entity::velocity, and weaponRange.

Referenced by behaviour_track_as_turret:.

Here is the call graph for this function:

Here is the caller graph for this function:

beaconCode

- (NSString *) beaconCode

implementation

Reimplemented from <OOBeaconEntity>.

Definition at line 1546 of file ShipEntity.m.

{
    return _beaconCode;
}

References _beaconCode, and beaconCode.

Referenced by beaconCode, beaconDrawable, compareBeaconCodeWith:, dumpSelfState, isBeacon, ShipGetProperty(), and WormholeEntity::suckInShip:.

Here is the call graph for this function:

Here is the caller graph for this function:

beaconDrawable

- (id< OOHUDBeaconIcon >) beaconDrawable

implementation

Reimplemented from <OOBeaconEntity>.

Definition at line 1601 of file ShipEntity.m.

{
    if (_beaconDrawable == nil)
    {
        NSString    *beaconCode = [self beaconCode];
        NSUInteger  length = [beaconCode length];
        
        if (length > 1)
        {
            NSArray *iconData = [[UNIVERSE descriptions] oo_arrayForKey:beaconCode];
            if (iconData != nil)  _beaconDrawable = [[OOPolygonSprite alloc] initWithDataArray:iconData outlineWidth:0.5 name:beaconCode];
        }
        
        if (_beaconDrawable == nil)
        {
            if (length > 0)  _beaconDrawable = [[beaconCode substringToIndex:1] retain];
            else  _beaconDrawable = @"";
        }
    }
    
    return _beaconDrawable;
}

References _beaconDrawable, beaconCode, beaconDrawable, and nil.

Referenced by beaconDrawable.

Here is the call graph for this function:

Here is the caller graph for this function:

beaconLabel

- (NSString *) beaconLabel

implementation

Reimplemented from <OOBeaconEntity>.

Definition at line 1571 of file ShipEntity.m.

{
    return _beaconLabel;
}

References _beaconLabel, and beaconLabel.

Referenced by beaconLabel, and ShipGetProperty().

Here is the call graph for this function:

Here is the caller graph for this function:

becomeEnergyBlast

- (void) becomeEnergyBlast

Reimplemented in StationEntity.

Definition at line 9474 of file ShipEntity.m.

{
    [UNIVERSE addEntity:[OOQuiriumCascadeEntity quiriumCascadeFromShip:self]];
    [self broadcastEnergyBlastImminent];
    [self noteKilledBy:nil damageType:kOODamageTypeCascadeWeapon];
    [UNIVERSE removeEntity:self];
}

References becomeEnergyBlast, broadcastEnergyBlastImminent, noteKilledBy:damageType:, and OOQuiriumCascadeEntity::quiriumCascadeFromShip:.

Referenced by becomeEnergyBlast, StationEntity::becomeEnergyBlast, and maxFlightSpeed.

Here is the call graph for this function:

Here is the caller graph for this function:

becomeExplosion

- (void) becomeExplosion

Reimplemented in StationEntity.

Definition at line 9170 of file ShipEntity.m.

{
    
    // check if we're destroying a subentity
    ShipEntity *parent = [self parentEntity];
    if (parent != nil)
    {
        ShipEntity *this_ship = [self retain];
        HPVector this_pos = [self absolutePositionForSubentity];
        
        // remove this ship from its parent's subentity list
        [parent subEntityDied:self];
        [UNIVERSE addEntity:this_ship];
        [this_ship setPosition:this_pos];
        [this_ship release];
        if ([parent isPlayer])
        {
            // make the parent ship less reliable.
            [(PlayerEntity *)parent adjustTradeInFactorBy:-PLAYER_SHIP_SUBENTITY_TRADE_IN_VALUE];
        }
    }
    
    HPVector xposition = position;
    NSUInteger i;
    Vector v;
    Quaternion q;
    int speed_low = 200;
    GLfloat n_alloys = sqrtf(sqrtf(mass / 6000.0f));
    NSUInteger numAlloys = 0;
    BOOL canReleaseSubWreckage = isWreckage && ([UNIVERSE detailLevel] >= DETAIL_LEVEL_EXTRAS);
 
    if ([self status] == STATUS_DEAD)
    {
        [UNIVERSE removeEntity:self];
        return;
    }
    [self setStatus:STATUS_DEAD];
    
    @try
    {
        if ([self isThargoid] && [roleSet hasRole:@"thargoid-mothership"])  [self broadcastThargoidDestroyed];
        
        if (!suppressExplosion && ([self isVisible] || HPdistance2([self position], [PLAYER position]) < SCANNER_MAX_RANGE2))
        {
            if (!isWreckage && mass > 500000.0f && randf() < 0.25f) // big!
            {
                // draw an expanding ring
                OORingEffectEntity *ring = [OORingEffectEntity ringFromEntity:self];
                [ring setVelocity:vector_multiply_scalar([self velocity], 0.25f)];
                [UNIVERSE addEntity:ring];
            }
            
            BOOL add_debris = (UNIVERSE->n_entities < 0.95 * UNIVERSE_MAX_ENTITIES) &&
                                      ([UNIVERSE getTimeDelta] < 0.125);      // FPS > 8
            
            
            // There are several parts to explosions, show only the main
            // explosion effect if UNIVERSE is almost full.
            
            if (add_debris)
            {
                if ([UNIVERSE reducedDetail])
                {
                    // Quick explosion effects for reduced detail mode
                    
                    // 1. fast sparks
                    [UNIVERSE addEntity:[OOSmallFragmentBurstEntity fragmentBurstFromEntity:self]];
                    // 2. slow clouds
                    [UNIVERSE addEntity:[OOBigFragmentBurstEntity fragmentBurstFromEntity:self]];
                    // 3. flash
                    [UNIVERSE addEntity:[OOFlashEffectEntity explosionFlashFromEntity:self]];
                    /* This mode used to be the default for
                     * cargo/munitions but this now must be explicitly
                     * specified. */
                }
                else
                {
                    NSString *explosionKey = @"oolite-default-ship-explosion";
                    NSDictionary *explosion = nil;
                    if (explosionType == nil)
                    {
                        explosion = [UNIVERSE explosionSetting:explosionKey];
                        [UNIVERSE addEntity:[OOExplosionCloudEntity explosionCloudFromEntity:self withSettings:explosion]];
                        // 3. flash
                        [UNIVERSE addEntity:[OOFlashEffectEntity explosionFlashFromEntity:self]];
                    }
                    for (NSUInteger i=0;i<[explosionType count];i++)
                    {
                        explosionKey = [explosionType oo_stringAtIndex:i defaultValue:nil];
                        if (explosionKey != nil)
                        {
                            // three special-case builtins
                            if ([explosionKey isEqualToString:@"oolite-builtin-flash"])
                            {
                                [UNIVERSE addEntity:[OOFlashEffectEntity explosionFlashFromEntity:self]];
                            }
                            else if ([explosionKey isEqualToString:@"oolite-builtin-slowcloud"])
                            {
                                [UNIVERSE addEntity:[OOBigFragmentBurstEntity fragmentBurstFromEntity:self]];
                            }
                            else if ([explosionKey isEqualToString:@"oolite-builtin-fastspark"])
                            {
                                [UNIVERSE addEntity:[OOSmallFragmentBurstEntity fragmentBurstFromEntity:self]];
                            }
                            else
                            {
                                explosion = [UNIVERSE explosionSetting:explosionKey];
                                [UNIVERSE addEntity:[OOExplosionCloudEntity explosionCloudFromEntity:self withSettings:explosion]];
                            }
                        }
                    }
                    // "fireball" explosion effect
 
                }
            }
             
            // If UNIVERSE is nearing limit for entities don't add to it!
            if (add_debris)
            {
                // we need to throw out cargo at this point.
                [self releaseCargoPodsDebris];
                
                //  Throw out rocks and alloys to be scooped up
                if ([self hasRole:@"asteroid"] || [self isBoulder])
                {
                    if (!noRocks && (being_mined || randf() < 0.20))
                    {
                        NSString *defaultRole = @"boulder";
                        float defaultSpeed = 50.0;
                        if ([self isBoulder])
                        {
                            defaultRole = @"splinter";
                            defaultSpeed = 20.0;
                            if (likely_cargo == 0)
                            {
                                likely_cargo = 4; // compatibility with older boulders
                            }
                        }
                        else if ([[self primaryAggressor] isPlayer])
                        {
                            [PLAYER addRoleForMining];
                        }
                        NSUInteger n_rocks = 2 + (Ranrot() % (likely_cargo + 1));
                        
                        NSString *debrisRole = [[self shipInfoDictionary] oo_stringForKey:@"debris_role" defaultValue:defaultRole];
                        for (i = 0; i < n_rocks; i++)
                        {
                            ShipEntity* rock = [UNIVERSE newShipWithRole:debrisRole];   // retain count = 1
                            if (rock)
                            {
                                float  r_speed = [rock maxFlightSpeed] > 0 ? 2.0 * [rock maxFlightSpeed] : defaultSpeed;
                                float cr = (collision_radius < rock->collision_radius) ? collision_radius : 2 * rock->collision_radius;
                                v.x = ((randf() * r_speed) - r_speed / 2);
                                v.y = ((randf() * r_speed) - r_speed / 2);
                                v.z = ((randf() * r_speed) - r_speed / 2);
                                [rock setVelocity:vector_add(v,[self velocity])];
                                HPVector rpos = HPvector_add(xposition,vectorToHPVector(vector_multiply_scalar(vector_normal(v),cr)));
                                [rock setPosition:rpos];
 
                                quaternion_set_random(&q);
                                [rock setOrientation:q];
                                
                                [rock setTemperature:[self randomEjectaTemperature]];
                                if ([self isBoulder])
                                {
                                    [rock setScanClass: CLASS_CARGO];
                                    [rock setBounty: 0 withReason:kOOLegalStatusReasonSetup];
                                    // only make the rock have minerals if something isn't already defined for the rock
                                    if ([[rock shipInfoDictionary] oo_stringForKey:@"cargo_carried"] == nil)
                                        [rock setCommodity:@"minerals" andAmount: 1];
                                }
                                else
                                {
                                    [rock setScanClass:CLASS_ROCK];
                                    [rock setIsBoulder:YES];
                                }
                                [UNIVERSE addEntity:rock];  // STATUS_IN_FLIGHT, AI state GLOBAL
                                [rock release];
                            }
                        }
                    }
                    return;
                }
 
                // throw out burning chunks of wreckage
                //
                if ((n_alloys && canFragment) || canReleaseSubWreckage)
                {
                    NSUInteger n_wreckage = 0;
                    
                    if (UNIVERSE->n_entities < 0.50 * UNIVERSE_MAX_ENTITIES)
                    {
                        // Create wreckage only when UNIVERSE is less than half full.
                        // (condition set in r906 - was < 0.75 before) --Kaks 2011.10.17
                        NSUInteger maxWrecks = 3;
                        if (n_alloys == 0)
                        {
                            // must be sub-wreckage here
                            n_wreckage = (mass > 600.0 && randf() < 0.2)?2:0;
                        }
                        else
                        {
                            n_wreckage = (n_alloys < maxWrecks)? floorf(randf()*(n_alloys+2)) : maxWrecks;
                        }
                    }
                    
                    for (i = 0; i < n_wreckage; i++)
                    {
                        Vector r1 = [octree randomPoint];
                        Vector dir = quaternion_rotate_vector([self normalOrientation], r1);
                        HPVector rpos = HPvector_add(vectorToHPVector(dir), xposition);
                        GLfloat lifetime = 750.0 * randf() + 250.0 * i + 100.0;
                        ShipEntity *wreck = [UNIVERSE addWreckageFrom:self withRole:@"wreckage" at:rpos scale:1.0 lifetime:lifetime/2];
 
                        [wreck setVelocity:vector_add([wreck velocity],vector_multiply_scalar(vector_normal(dir),randf()*[wreck collisionRadius]))];
 
                    }
                    n_alloys = randf() * n_alloys;
                }
            } 
 
            if (!canFragment)
            {
                n_alloys = 0.0;
            }
            // If UNIVERSE is almost full, don't create more than 1 piece of scrap metal.
            else if (!add_debris)
            {
                n_alloys = (n_alloys > 1.0) ? 1.0 : 0.0;
            }
 
            // now convert to uint
            numAlloys = floorf(n_alloys);
 
            // Throw out scrap metal
            //
            for (i = 0; i < numAlloys; i++)
            {
                ShipEntity* plate = [UNIVERSE newShipWithRole:@"alloy"];   // retain count = 1
                if (plate)
                {
                    HPVector  rpos = xposition;
                    Vector  rrand = OORandomPositionInBoundingBox(boundingBox);
                    rpos.x += rrand.x; rpos.y += rrand.y; rpos.z += rrand.z;
                    rpos.x += (ranrot_rand() % 7) - 3;
                    rpos.y += (ranrot_rand() % 7) - 3;
                    rpos.z += (ranrot_rand() % 7) - 3;
                    [plate setPosition:rpos];
                    v.x = 0.1 *((ranrot_rand() % speed_low) - speed_low / 2);
                    v.y = 0.1 *((ranrot_rand() % speed_low) - speed_low / 2);
                    v.z = 0.1 *((ranrot_rand() % speed_low) - speed_low / 2);
                    [plate setVelocity:vector_add(v,[self velocity])];
                    quaternion_set_random(&q);
                    [plate setOrientation:q];
                    
                    [plate setTemperature:[self randomEjectaTemperature]];
                    [plate setScanClass: CLASS_CARGO];
                    [plate setCommodity:@"alloys" andAmount:1];
                    [UNIVERSE addEntity:plate]; // STATUS_IN_FLIGHT, AI state GLOBAL
                    
                    [plate release];
                }
            }
        }
        
        // Explode subentities.
        NSEnumerator    *subEnum = nil;
        ShipEntity      *se = nil;
        for (subEnum = [self shipSubEntityEnumerator]; (se = [subEnum nextObject]); )
        {
            [se setSuppressExplosion:suppressExplosion];
            [se becomeExplosion];
        }
        [self clearSubEntities];
 
        // momentum from explosions
        if (!suppressExplosion)
        {
            desired_range = collision_radius * 2.5f;
            [self dealMomentumWithinDesiredRange:0.125f * mass];
        }
        
        if (self != PLAYER)   // was if !isPlayer - but I think this may cause ghosts (Who's "I"? -- Ahruman)
        {
            if (isPlayer)
            {
    #ifndef NDEBUG
                OOLog(@"becomeExplosion.suspectedGhost.confirm", @"%@", @"Ship spotted with isPlayer set when not actually the player.");
    #endif
                isPlayer = NO;
            }
        }
    }
    @finally
    {
        if (self != PLAYER)
        {
            [UNIVERSE removeEntity:self];
        }
    }
}

References Entity::absolutePositionForSubentity, PlayerEntity::adjustTradeInFactorBy:, becomeExplosion, being_mined, Entity::boundingBox, broadcastThargoidDestroyed, canFragment, clearSubEntities, Entity::collision_radius, Entity::collisionRadius, dealMomentumWithinDesiredRange:, desired_range, DETAIL_LEVEL_EXTRAS, OOExplosionCloudEntity::explosionCloudFromEntity:withSettings:, OOFlashEffectEntity::explosionFlashFromEntity:, explosionType, OOBigFragmentBurstEntity::fragmentBurstFromEntity:, OOSmallFragmentBurstEntity::fragmentBurstFromEntity:, isBoulder, Entity::isPlayer, isThargoid, isVisible, isWreckage, likely_cargo, Entity::mass, maxFlightSpeed, nil, Entity::normalOrientation, noRocks, OOLog, OORandomPositionInBoundingBox(), Entity::parentEntity, PLAYER, Entity::position, primaryAggressor, quaternion_rotate_vector(), quaternion_set_random(), randf(), randomEjectaTemperature, Octree::randomPoint, Ranrot(), ranrot_rand, releaseCargoPodsDebris, OORingEffectEntity::ringFromEntity:, roleSet, SCANNER_MAX_RANGE2, setBounty:withReason:, setCommodity:andAmount:, setIsBoulder:, Entity::setOrientation:, Entity::setPosition:, Entity::setScanClass:, setStatus:, setSuppressExplosion:, setTemperature:, Entity::setVelocity:, shipInfoDictionary, shipSubEntityEnumerator, Entity::status, subEntityDied:, suppressExplosion, UNIVERSE, UNIVERSE_MAX_ENTITIES, and velocity.

Referenced by becomeExplosion, StationEntity::becomeExplosion, becomeLargeExplosion:, PlayerEntity::doBookkeeping:, getDestroyedBy:damageType:, and maxFlightSpeed.

Here is the call graph for this function:

Here is the caller graph for this function:

becomeLargeExplosion:

- (void) becomeLargeExplosion:

(double)

factor

Reimplemented in StationEntity.

Definition at line 9644 of file ShipEntity.m.

                             :(double)factor
{
    
    if ([self status] == STATUS_DEAD)  return;
    [self setStatus:STATUS_DEAD];
    
    @try
    {
        // two parts to the explosion:
        // 1. fast sparks
        float how_many = factor;
        while (how_many > 0.5f)
        {
            [UNIVERSE addEntity:[OOSmallFragmentBurstEntity fragmentBurstFromEntity:self]];
            how_many -= 1.0f;
        }
        // 2. slow clouds
        how_many = factor;
        while (how_many > 0.5f)
        {
            [UNIVERSE addEntity:[OOBigFragmentBurstEntity fragmentBurstFromEntity:self]];
            how_many -= 1.0f;
        }
 
        [self releaseCargoPodsDebris];
        
        NSEnumerator    *subEnum = nil;
        ShipEntity      *se = nil;
        for (subEnum = [self shipSubEntityEnumerator]; (se = [subEnum nextObject]); )
        {
            [se setSuppressExplosion:suppressExplosion];
            [se becomeExplosion];
        }
        [self clearSubEntities];
        
    }
    @finally
    {
        if (!isPlayer)  [UNIVERSE removeEntity:self];
    }
}

References becomeExplosion, clearSubEntities, OOBigFragmentBurstEntity::fragmentBurstFromEntity:, OOSmallFragmentBurstEntity::fragmentBurstFromEntity:, Entity::isPlayer, nil, releaseCargoPodsDebris, setStatus:, setSuppressExplosion:, shipSubEntityEnumerator, and Entity::status.

Referenced by StationEntity::becomeLargeExplosion:, and PlayerEntity::getDestroyedBy:damageType:.

Here is the call graph for this function:

Here is the caller graph for this function:

becomeUncontrolledThargon

- (void) becomeUncontrolledThargon

implementation

Provided by category ShipEntity(PureAI).

Definition at line 1750 of file ShipEntityAI.m.

{
    int         ent_count =     UNIVERSE->n_entities;
    Entity**    uni_entities =  UNIVERSE->sortedEntities;   // grab the public sorted list
    int i;
    for (i = 0; i < ent_count; i++) if (uni_entities[i]->isShip)
    {
        ShipEntity *other = (ShipEntity*)uni_entities[i];
        if ([other primaryTarget] == self)
        {
            [other removeTarget:self];
        }
        if ([other isDefenseTarget:self])
        {
            [other removeDefenseTarget:self];
        }
    }
    // now we're just a bunch of alien artefacts!
    scanClass = CLASS_CARGO;
    reportAIMessages = NO;
    [self setAITo:@"dumbAI.plist"];
    DESTROY(_primaryTarget);
    [self setSpeed: 0.0];
    [self setGroup:nil];
}

behaviour

- (OOBehaviour) behaviour

References coordinates, and rangeToDestination.

Here is the call graph for this function:

behaviour_attack_break_off_target:

- (void) behaviour_attack_break_off_target:

(double)

delta_t

Definition at line 4371 of file ShipEntity.m.

                                          :(double) delta_t
{
    if (![self canStillTrackPrimaryTarget])
    {
        [self noteLostTargetAndGoIdle];
        return;
    }
    BOOL    canBurn = [self hasFuelInjection] && (fuel > MIN_FUEL);
    float   max_available_speed = maxFlightSpeed;
    double  range = [self rangeToPrimaryTarget];
    if (canBurn) max_available_speed *= [self afterburnerFactor];
 
    desired_speed = max_available_speed;
 
    Entity* target = [self primaryTarget];
 
    if (desired_speed > maxFlightSpeed)
    {
        double target_speed = [target speed];
        if (desired_speed > target_speed * 3.0)
        {
            desired_speed = maxFlightSpeed; // don't overuse the injectors
        }
    }
 
    if (cloakAutomatic) [self activateCloakingDevice];
    if ([self hasProximityAlertIgnoringTarget:NO])
    {
        [self avoidCollision];
        return;
    }
 
    frustration += delta_t;
    if (frustration > 15.0 && accuracy >= COMBAT_AI_DOGFIGHTER && !canBurn)
    {
        desired_speed = maxFlightSpeed / 2.0;
    }
    double aspect = [self approachAspectToPrimaryTarget];
    if (range > 3000.0 || ([target isShip] && [(ShipEntity*)target primaryTarget] != self) || frustration - floor(frustration) > fmin(1.6/max_flight_roll,aspect))
    {
        [self trackPrimaryTarget:delta_t:YES];
    }
    else
    {
// less useful at long range if not under direct fire
        [self evasiveAction:delta_t];
    }
 
    if (range > COMBAT_OUT_RANGE_FACTOR * weaponRange)
    {
        behaviour = BEHAVIOUR_ATTACK_TARGET;
    }
    else if (aspect < -0.75 && accuracy >= COMBAT_AI_DOGFIGHTER)
    {
        behaviour = BEHAVIOUR_ATTACK_SLOW_DOGFIGHT;
    }
    else if (frustration > 10.0 && [self approachAspectToPrimaryTarget] < 0.85 && forward_weapon_temp < COMBAT_AI_WEAPON_TEMP_READY)
    {
        frustration = 0.0;
        if (accuracy >= COMBAT_AI_DOGFIGHTER)
        {
            behaviour = BEHAVIOUR_ATTACK_SLOW_DOGFIGHT;
        }
        else
        {
            behaviour = BEHAVIOUR_ATTACK_FLY_TO_TARGET;
        }
    }
 
    flightYaw = 0.0;
}

References accuracy, activateCloakingDevice, afterburnerFactor, approachAspectToPrimaryTarget, avoidCollision, behaviour, canStillTrackPrimaryTarget, cloakAutomatic, COMBAT_AI_DOGFIGHTER, COMBAT_AI_WEAPON_TEMP_READY, COMBAT_OUT_RANGE_FACTOR, desired_speed, evasiveAction:, flightYaw, forward_weapon_temp, frustration, fuel, hasFuelInjection, Entity::isShip, max_flight_roll, maxFlightSpeed, MIN_FUEL, noteLostTargetAndGoIdle, primaryTarget, rangeToPrimaryTarget, Entity::speed, trackPrimaryTarget:delta_t:, and weaponRange.

Referenced by processBehaviour:.

Here is the call graph for this function:

Here is the caller graph for this function:

behaviour_attack_broadside:

- (void) behaviour_attack_broadside:

(double)

delta_t

Definition at line 4759 of file ShipEntity.m.

                                   :(double) delta_t
{
    BOOL    canBurn = [self hasFuelInjection] && (fuel > MIN_FUEL);
    float   max_available_speed = maxFlightSpeed;
    double  range = [self rangeToPrimaryTarget];
    if (canBurn) max_available_speed *= [self afterburnerFactor];
    
    if (cloakAutomatic) [self activateCloakingDevice];
 
    if (![self canStillTrackPrimaryTarget])
    {
        [self noteLostTargetAndGoIdle];
        return;
    }
    
    desired_speed = max_available_speed;
    if (range < COMBAT_BROADSIDE_IN_RANGE_FACTOR * weaponRange)
    {
        behaviour = BEHAVIOUR_ATTACK_TARGET;
    }
    else
    {
        if (port_weapon_temp < starboard_weapon_temp)
        {
            if (isWeaponNone(port_weapon_type))
            {
                behaviour = BEHAVIOUR_ATTACK_BROADSIDE_RIGHT;
                [self setWeaponDataFromType:starboard_weapon_type];
            }
            else
            {
                behaviour = BEHAVIOUR_ATTACK_BROADSIDE_LEFT;
                [self setWeaponDataFromType:port_weapon_type];
            }
        }
        else
        {
            if (isWeaponNone(starboard_weapon_type))
            {
                behaviour = BEHAVIOUR_ATTACK_BROADSIDE_RIGHT;
                [self setWeaponDataFromType:starboard_weapon_type];
            }
            else
            {
                behaviour = BEHAVIOUR_ATTACK_BROADSIDE_LEFT;
                [self setWeaponDataFromType:port_weapon_type];
            }
        }
        jink = kZeroVector;
        if (weapon_damage == 0.0)
        { // safety in case side lasers no longer exist
            behaviour = BEHAVIOUR_ATTACK_TARGET;
        }
        else if (range > 0.9 * weaponRange)
        {
            behaviour = BEHAVIOUR_CLOSE_TO_BROADSIDE_RANGE;
        }
    }
 
    frustration = 0.0;   // behaviour changed, so reset frustration
 
    
    
}

References activateCloakingDevice, afterburnerFactor, behaviour, canStillTrackPrimaryTarget, cloakAutomatic, COMBAT_BROADSIDE_IN_RANGE_FACTOR, desired_speed, frustration, fuel, hasFuelInjection, isWeaponNone(), jink, kZeroVector, maxFlightSpeed, MIN_FUEL, noteLostTargetAndGoIdle, port_weapon_temp, port_weapon_type, rangeToPrimaryTarget, setWeaponDataFromType:, starboard_weapon_temp, starboard_weapon_type, weapon_damage, and weaponRange.

Referenced by processBehaviour:.

Here is the call graph for this function:

Here is the caller graph for this function:

behaviour_attack_broadside_left:

- (void) behaviour_attack_broadside_left:

(double)

delta_t

Definition at line 4825 of file ShipEntity.m.

                                        :(double) delta_t
{
    [self behaviour_attack_broadside_target:delta_t leftside:YES];
}

References behaviour_attack_broadside_target:leftside:.

Referenced by processBehaviour:.

Here is the call graph for this function:

Here is the caller graph for this function:

behaviour_attack_broadside_right:

- (void) behaviour_attack_broadside_right:

(double)

delta_t

Definition at line 4831 of file ShipEntity.m.

                                         :(double) delta_t
{
    [self behaviour_attack_broadside_target:delta_t leftside:NO];
}

References behaviour_attack_broadside_target:leftside:.

Referenced by processBehaviour:.

Here is the call graph for this function:

Here is the caller graph for this function:

behaviour_attack_broadside_target:leftside:

- (void) behaviour_attack_broadside_target:		(double)	delta_t
leftside:		(BOOL)	leftside

Definition at line 4837 of file ShipEntity.m.

                                          :(double) delta_t leftside:(BOOL) leftside
{
    BOOL    canBurn = [self hasFuelInjection] && (fuel > MIN_FUEL);
    float   max_available_speed = maxFlightSpeed;
    double  range = [self rangeToPrimaryTarget];
    if (canBurn) max_available_speed *= [self afterburnerFactor];
    if ([self primaryTarget] == nil)
    {
        [self noteLostTargetAndGoIdle];
        return;
    }
    GLfloat currentWeaponRange = getWeaponRangeFromType(leftside?port_weapon_type:starboard_weapon_type);
    if (range > COMBAT_BROADSIDE_RANGE_FACTOR * currentWeaponRange)
    {
        behaviour = BEHAVIOUR_CLOSE_TO_BROADSIDE_RANGE;
        return;
    }
 
// can get closer on broadsides since there's less risk of a collision
    if ((range < COMBAT_BROADSIDE_IN_RANGE_FACTOR * currentWeaponRange)||([self proximityAlert] != nil))
    {
        if (![self hasProximityAlertIgnoringTarget:YES])
        {
            behaviour = BEHAVIOUR_ATTACK_TARGET;
        }
        else
        {
            [self avoidCollision];
            return;
        }
    }
    else
    {
        if (![self canStillTrackPrimaryTarget])
        {
            [self noteLostTargetAndGoIdle];
            return;
        }
    }
    // control speed
    //
    BOOL isUsingAfterburner = canBurn && (flightSpeed > maxFlightSpeed);
    double slow_down_range = currentWeaponRange * COMBAT_WEAPON_RANGE_FACTOR * ((isUsingAfterburner)? 3.0 * [self afterburnerFactor] : 1.0);
//  double target_speed = [target speed];
    if (range <= slow_down_range)
        desired_speed = fmin(0.8 * maxFlightSpeed, fmax((2.0-frustration)*maxFlightSpeed, 0.1 * maxFlightSpeed));   // within the weapon's range slow down to aim
    else
        desired_speed = max_available_speed; // use afterburner to approach
 
    double last_success_factor = success_factor;
    success_factor = [self trackSideTarget:delta_t:leftside]; // do the actual piloting
    if (weapon_temp > COMBAT_AI_WEAPON_TEMP_USABLE)
    { // will probably have more luck with the other laser or picking a different attack method
        if (leftside)
        {
            if (!isWeaponNone(starboard_weapon_type))
            {
                behaviour = BEHAVIOUR_ATTACK_BROADSIDE_RIGHT;
            }
            else
            {
                behaviour = BEHAVIOUR_ATTACK_TARGET;
            }
        }
        else
        {
            if (!isWeaponNone(port_weapon_type))
            {
                behaviour = BEHAVIOUR_ATTACK_BROADSIDE_LEFT;
            }
            else 
            {
                behaviour = BEHAVIOUR_ATTACK_TARGET;
            }
        }
    }
 
/* FIXME: again, basically all of this next bit common with standard attack  */
    if ((success_factor > 0.999)||(success_factor > last_success_factor))
    {
        frustration -= delta_t;
        if (frustration < 0.0)
            frustration = 0.0;
    }
    else
    {
        frustration += delta_t;
        if (frustration > 3.0)   // 3s of frustration
        {
            
            [self noteFrustration:@"BEHAVIOUR_ATTACK_BROADSIDE"];
            [self setEvasiveJink:1000.0];
            behaviour = BEHAVIOUR_ATTACK_FLY_FROM_TARGET;
            frustration = 0.0;
            desired_speed = maxFlightSpeed;
        }
    }
 
    if (missiles) [self considerFiringMissile:delta_t];
 
    if (cloakAutomatic) [self activateCloakingDevice];
    if (leftside)
    {
        [self firePortWeapon:range];
    }
    else 
    {
        [self fireStarboardWeapon:range];
    }
    
    
 
    if (weapon_temp > COMBAT_AI_WEAPON_TEMP_USABLE)
    {
        behaviour = BEHAVIOUR_ATTACK_TARGET;
    }
}

References activateCloakingDevice, afterburnerFactor, avoidCollision, behaviour, canStillTrackPrimaryTarget, cloakAutomatic, COMBAT_AI_WEAPON_TEMP_USABLE, COMBAT_BROADSIDE_IN_RANGE_FACTOR, COMBAT_BROADSIDE_RANGE_FACTOR, COMBAT_WEAPON_RANGE_FACTOR, considerFiringMissile:, desired_speed, firePortWeapon:, fireStarboardWeapon:, flightSpeed, frustration, fuel, getWeaponRangeFromType(), hasFuelInjection, isWeaponNone(), maxFlightSpeed, MIN_FUEL, missiles, nil, noteFrustration:, noteLostTargetAndGoIdle, port_weapon_type, primaryTarget, proximityAlert, rangeToPrimaryTarget, setEvasiveJink:, starboard_weapon_type, success_factor, trackSideTarget:delta_t:, and weapon_temp.

Referenced by behaviour_attack_broadside_left:, and behaviour_attack_broadside_right:.

Here is the call graph for this function:

Here is the caller graph for this function:

behaviour_attack_fly_from_target:

- (void) behaviour_attack_fly_from_target:

(double)

delta_t

Definition at line 5470 of file ShipEntity.m.

                                         :(double) delta_t
{
    double  range = [self rangeToPrimaryTarget];
    double last_success_factor = success_factor;
    success_factor = range;
    
    if ([self primaryTarget] == nil)
    {
        [self noteLostTargetAndGoIdle];
        return;
    }
    if (last_success_factor > success_factor) // our target is closing in.
    {
        frustration += delta_t;
    }
    else
    { // not getting away fast enough?
        frustration += delta_t / 4.0 ;
    }
 
    if (frustration > 10.0)
    {
        if (randf() < 0.3) {
            desired_speed = maxFlightSpeed * (([self hasFuelInjection] && (fuel > MIN_FUEL)) ? [self afterburnerFactor] : 1);
        }
        else if (range > COMBAT_IN_RANGE_FACTOR * weaponRange && randf() < 0.3)
        {
            behaviour = BEHAVIOUR_ATTACK_TARGET;
        }
        GLfloat z = jink.z;
        if (randf() < 0.3)
        {
            z /= 2; // move the z-offset closer to the target to let him fly away from the target.
            desired_speed = flightSpeed * 2; // increase speed a bit.
        }
        [self setEvasiveJink:z];
 
        frustration /= 2.0;
    }
    if (desired_speed > maxFlightSpeed)
    {
        ShipEntity* target = [self primaryTarget];
        double target_speed = [target speed];
        if (desired_speed > target_speed * 2.0)
        {
            desired_speed = maxFlightSpeed; // don't overuse the injectors
        }
    }
    else if (desired_speed < maxFlightSpeed * 0.5)
    {
        desired_speed = maxFlightSpeed;
    }
 
    if (range > COMBAT_OUT_RANGE_FACTOR * weaponRange + 15.0 * jink.x || 
            flightSpeed > (scannerRange - range) * max_flight_pitch / 6.28)
    {
        jink = kZeroVector;
        behaviour = BEHAVIOUR_ATTACK_TARGET;
        frustration = 0.0;
    }
    [self trackPrimaryTarget:delta_t:YES];
 
    if (missiles) [self considerFiringMissile:delta_t];
 
    if (cloakAutomatic) [self activateCloakingDevice];
    if ([self hasProximityAlertIgnoringTarget:YES])
        [self avoidCollision];
 
    if (accuracy >= COMBAT_AI_FLEES_BETTER_2) 
    {
        double aspect = [self approachAspectToPrimaryTarget];
        // if we're right in their gunsights, dodge!
        // need to dodge sooner if in aft sights
        if (aspect > 0.99999 || aspect < -0.999) 
        {
            frustration = 0.0;
            behaviour = BEHAVIOUR_EVASIVE_ACTION;
        }
    }
    
}

References accuracy, activateCloakingDevice, afterburnerFactor, approachAspectToPrimaryTarget, avoidCollision, behaviour, cloakAutomatic, COMBAT_AI_FLEES_BETTER_2, COMBAT_IN_RANGE_FACTOR, COMBAT_OUT_RANGE_FACTOR, considerFiringMissile:, desired_speed, flightSpeed, frustration, fuel, hasFuelInjection, jink, kZeroVector, max_flight_pitch, maxFlightSpeed, MIN_FUEL, missiles, nil, noteLostTargetAndGoIdle, primaryTarget, randf(), rangeToPrimaryTarget, scannerRange, setEvasiveJink:, Entity::speed, success_factor, trackPrimaryTarget:delta_t:, and weaponRange.

Referenced by behaviour_close_to_broadside_range:, behaviour_close_with_target:, behaviour_fly_to_target_six:, and processBehaviour:.

Here is the call graph for this function:

Here is the caller graph for this function:

behaviour_attack_fly_to_target:

- (void) behaviour_attack_fly_to_target:

(double)

delta_t

Definition at line 5303 of file ShipEntity.m.

                                       :(double) delta_t
{
    BOOL    canBurn = [self hasFuelInjection] && (fuel > MIN_FUEL);
    float   max_available_speed = maxFlightSpeed;
    double  range = [self rangeToPrimaryTarget];
    if (canBurn) max_available_speed *= [self afterburnerFactor];
    if ([self primaryTarget] == nil)
    {
        [self noteLostTargetAndGoIdle];
        return;
    }
    Entity* rawTarget = [self primaryTarget];
    if (![rawTarget isShip])
    {
        // can't attack a wormhole
        [self noteLostTargetAndGoIdle];
        return;
    }
 
    ShipEntity *target = (ShipEntity *)rawTarget;
    if ((range < COMBAT_IN_RANGE_FACTOR * weaponRange)||([self proximityAlert] != nil))
    {
        if (![self hasProximityAlertIgnoringTarget:YES])
        {
            behaviour = BEHAVIOUR_ATTACK_TARGET;
        }
        else
        {
            [self avoidCollision];
            return;
        }
    }
    else
    {
        if (![self canStillTrackPrimaryTarget])
        {
            [self noteLostTargetAndGoIdle];
            return;
        }
    }
 
    // control speed
    //
    BOOL isUsingAfterburner = canBurn && (flightSpeed > maxFlightSpeed);
    BOOL closeQuickly = (canBurn && [target weaponRange] > weaponRange && range > weaponRange);
    double slow_down_range = weaponRange * COMBAT_WEAPON_RANGE_FACTOR * ((isUsingAfterburner)? 3.0 * [self afterburnerFactor] : 1.0);
    if (closeQuickly)
    {
        slow_down_range = weaponRange * COMBAT_OUT_RANGE_FACTOR;
    }
    double  back_off_range = 10000 * COMBAT_OUT_RANGE_FACTOR * ((isUsingAfterburner)? 3.0 * [self afterburnerFactor] : 1.0);
    double target_speed = [target speed];
    double aspect = [self approachAspectToPrimaryTarget];
 
    if (range <= slow_down_range)
    {
        if (range < back_off_range)
        {
            if (accuracy < COMBAT_AI_IS_SMART || ([target primaryTarget] == self && aspect > 0.8) || aim_tolerance*range > COMBAT_AI_CONFIDENCE_FACTOR)
            {
                if (accuracy >= COMBAT_AI_FLEES_BETTER && aspect > 0.8)
                {
                    desired_speed = fmax(target_speed * 1.25, 0.8 * maxFlightSpeed);
                    // stay at high speed if might be taking return fire
                }
                else
                {
                    desired_speed = fmax(target_speed * 1.05, 0.25 * maxFlightSpeed);   // within the weapon's range match speed
 
                }
            }
            else
            { // smart, and not being shot at right now - slow down to attack
                desired_speed = fmax(0.1 * target_speed, 0.1 * maxFlightSpeed);
            }
        }
        else
        {
            if (accuracy < COMBAT_AI_IS_SMART || ([target isShip] && [(ShipEntity *)target primaryTarget] == self) || range > weaponRange / 2.0)
            {
                desired_speed = fmax(target_speed * 1.5, maxFlightSpeed);
            }
            else
            { // smart, and not being shot at right now - slow down to attack
                if (aspect > -0.25)
                {
                    desired_speed = fmax(0.5 * target_speed, 0.5 * maxFlightSpeed);
                }
                else
                {
                    desired_speed = fmax(1.25 * target_speed, 0.5 * maxFlightSpeed);
                }
            }
        }
    }
    else
    {
        if (closeQuickly)
        {
            desired_speed = max_available_speed; // use afterburner to approach
        }
        else
        {
            desired_speed = fmax(maxFlightSpeed,fmin(3.0 * target_speed, max_available_speed)); // possibly use afterburner to approach
        }
    }
 
 
    double last_success_factor = success_factor;
    success_factor = [self trackPrimaryTarget:delta_t:NO];    // do the actual piloting
 
    if ((success_factor > 0.999)||(success_factor > last_success_factor))
    {
        frustration -= delta_t;
        if (frustration < 0.0)
            frustration = 0.0;
    }
    else
    {
        frustration += delta_t;
        if (frustration > 3.0)   // 3s of frustration
        {
            [self noteFrustration:@"BEHAVIOUR_ATTACK_FLY_TO_TARGET"];
            [self setEvasiveJink:1000.0];
            behaviour = BEHAVIOUR_ATTACK_TARGET;
            frustration = 0.0;
            desired_speed = maxFlightSpeed;
        }
    }
 
    if (missiles) [self considerFiringMissile:delta_t];
 
    if (cloakAutomatic) [self activateCloakingDevice];
    [self fireMainWeapon:range];
    
    
 
    if (weapon_temp > COMBAT_AI_WEAPON_TEMP_USABLE && accuracy >= COMBAT_AI_ISNT_AWFUL && aim_tolerance * range < COMBAT_AI_CONFIDENCE_FACTOR)
    {
        // don't do this if the target is fleeing and the front laser is
        // the only weapon, or if we're too far away to use non-front
        // lasers effectively
        if (aspect < 0 || 
            !isWeaponNone(aft_weapon_type) ||
            !isWeaponNone(port_weapon_type) ||
            !isWeaponNone(starboard_weapon_type))
        {
            frustration = 0.0;
            behaviour = BEHAVIOUR_ATTACK_TARGET;
        }
    }
    else if (accuracy >= COMBAT_AI_FLEES_BETTER_2) 
    {
        // if we're right in their gunsights, dodge!
        // need to dodge sooner if in aft sights
        if ([target behaviour] != BEHAVIOUR_FLEE_TARGET && [target behaviour] != BEHAVIOUR_FLEE_EVASIVE_ACTION)
        {
            if ((aspect > 0.99999 && !isWeaponNone([target weaponTypeForFacing:WEAPON_FACING_FORWARD strict:NO])) || (aspect < -0.999 && !isWeaponNone([target weaponTypeForFacing:WEAPON_FACING_AFT strict:NO])))
            {
                frustration = 0.0;
                behaviour = BEHAVIOUR_EVASIVE_ACTION;
            }
        }
    }
}

References accuracy, activateCloakingDevice, aft_weapon_type, afterburnerFactor, aim_tolerance, approachAspectToPrimaryTarget, avoidCollision, behaviour, canStillTrackPrimaryTarget, cloakAutomatic, COMBAT_AI_CONFIDENCE_FACTOR, COMBAT_AI_FLEES_BETTER, COMBAT_AI_FLEES_BETTER_2, COMBAT_AI_IS_SMART, COMBAT_AI_ISNT_AWFUL, COMBAT_AI_WEAPON_TEMP_USABLE, COMBAT_IN_RANGE_FACTOR, COMBAT_OUT_RANGE_FACTOR, COMBAT_WEAPON_RANGE_FACTOR, considerFiringMissile:, desired_speed, fireMainWeapon:, flightSpeed, frustration, fuel, hasFuelInjection, Entity::isShip, isWeaponNone(), maxFlightSpeed, MIN_FUEL, missiles, nil, noteFrustration:, noteLostTargetAndGoIdle, port_weapon_type, primaryTarget, proximityAlert, rangeToPrimaryTarget, setEvasiveJink:, Entity::speed, starboard_weapon_type, success_factor, trackPrimaryTarget:delta_t:, WEAPON_FACING_AFT, WEAPON_FACING_FORWARD, weapon_temp, and weaponRange.

Referenced by processBehaviour:.

Here is the call graph for this function:

Here is the caller graph for this function:

behaviour_attack_mining_target:

- (void) behaviour_attack_mining_target:

(double)

delta_t

Definition at line 5262 of file ShipEntity.m.

                                       :(double) delta_t
{
    double  range = [self rangeToPrimaryTarget];
    if (![self canStillTrackPrimaryTarget])
    {
        [self noteLostTargetAndGoIdle];
        desired_speed = maxFlightSpeed * 0.375;
        return;
    }
    else if ((range < 650) || ([self proximityAlert] != nil))
    {
        if ([self proximityAlert] == NO_TARGET)
        {
            desired_speed = range * maxFlightSpeed / (650.0 * 16.0);
        }
        else
        {
            [self avoidCollision];
        }
    }
    else
    {
        //we have a target, its within scanner range, and outside 650
        desired_speed = maxFlightSpeed * 0.875;
    }
 
    [self trackPrimaryTarget:delta_t:NO];
 
    /* Don't open fire until within 3km - it doesn't take many mining
     * laser shots to destroy an asteroid, but some of these mining
     * ships are way too slow to effectively chase down the debris:
     * wait until reasonably close before trying to split it. */
    if (range < 3000)
    {
        [self fireMainWeapon:range];
    }
    
    
}

References avoidCollision, canStillTrackPrimaryTarget, desired_speed, fireMainWeapon:, maxFlightSpeed, nil, NO_TARGET, noteLostTargetAndGoIdle, proximityAlert, rangeToPrimaryTarget, and trackPrimaryTarget:delta_t:.

Referenced by processBehaviour:.

Here is the call graph for this function:

Here is the caller graph for this function:

behaviour_attack_slow_dogfight:

- (void) behaviour_attack_slow_dogfight:

(double)

delta_t

Definition at line 4444 of file ShipEntity.m.

                                       :(double) delta_t
{
    if (![self canStillTrackPrimaryTarget])
    {
        [self noteLostTargetAndGoIdle];
        return;
    }
    if ([self hasProximityAlertIgnoringTarget:YES])
    {
        [self avoidCollision];
        return;
    } 
    double  range = [self rangeToPrimaryTarget];
    ShipEntity* target = [self primaryTarget];
    double aspect = [self approachAspectToPrimaryTarget];
    if (range < 2.5*(collision_radius+target->collision_radius) && [self proximityAlert] == target && aspect > 0) {
        desired_speed = maxFlightSpeed;
        [self avoidCollision];
        return;
    }
    if (aspect < -0.5 && range > COMBAT_IN_RANGE_FACTOR * weaponRange * 2.0)
    {
        behaviour = BEHAVIOUR_ATTACK_TARGET;
    }
    else if (aspect < -0.5)
    {
// mostly behind target - try to stay there and keep up
        desired_speed = fmin(maxFlightSpeed * 0.5,[target speed]*0.5);      
    }
    else if (aspect < 0.3)
    {
// to side of target - slow right down
        desired_speed = maxFlightSpeed * 0.1;
    }
    else
    {
// coming to front of target - accelerate for a quick getaway
        desired_speed = maxFlightSpeed * fmin(aspect*2.5,1.0);
    }
    if (aspect > 0.85)
    {
        behaviour = BEHAVIOUR_ATTACK_BREAK_OFF_TARGET;
    }
    if (aspect > 0.0)
    {
        frustration += delta_t;
    }
    else
    {
        frustration -= delta_t;
    }
    if (frustration > 10.0)
    {
        desired_speed /= 2.0;
    }
    else if (frustration < 0.0)
        frustration = 0.0;
    
    [self trackPrimaryTarget:delta_t:NO];
    
    if (missiles) [self considerFiringMissile:delta_t];
 
    if (cloakAutomatic) [self activateCloakingDevice];
 
}

References activateCloakingDevice, approachAspectToPrimaryTarget, avoidCollision, behaviour, canStillTrackPrimaryTarget, cloakAutomatic, Entity::collision_radius, COMBAT_IN_RANGE_FACTOR, considerFiringMissile:, desired_speed, frustration, maxFlightSpeed, missiles, noteLostTargetAndGoIdle, primaryTarget, proximityAlert, rangeToPrimaryTarget, Entity::speed, trackPrimaryTarget:delta_t:, and weaponRange.

Referenced by processBehaviour:.

Here is the call graph for this function:

Here is the caller graph for this function:

behaviour_attack_sniper:

- (void) behaviour_attack_sniper:

(double)

delta_t

Definition at line 5038 of file ShipEntity.m.

                                :(double) delta_t
{
    if (![self canStillTrackPrimaryTarget])
    {
        [self noteLostTargetAndGoIdle];
        return;
    }
    Entity* rawTarget = [self primaryTarget];
    if (![rawTarget isShip])
    {
        // can't attack a wormhole
        [self noteLostTargetAndGoIdle];
        return;
    }
    ShipEntity *target = (ShipEntity *)rawTarget;
 
    double  range = [self rangeToPrimaryTarget];
    float   max_available_speed = maxFlightSpeed;
 
    if (range < 15000)
    {
        behaviour = BEHAVIOUR_ATTACK_TARGET;
    }
    else 
    {
        if (range > weaponRange || range > scannerRange * 0.8)
        {
            BOOL    canBurn = [self hasFuelInjection] && (fuel > MIN_FUEL);
            if (canBurn && [target weaponRange] > weaponRange && range > weaponRange)
            {
                // if outside maximum weapon range, but inside target weapon range
                // close to fight ASAP!
                max_available_speed *= [self afterburnerFactor];
            }
            desired_speed = max_available_speed;
        }
        else
        {
            desired_speed = max_available_speed / 10.0f;
        }
 
        double last_success_factor = success_factor;
        success_factor = [self trackPrimaryTarget:delta_t:NO];
        
        if ((success_factor > 0.999)||(success_factor > last_success_factor))
        {
            frustration -= delta_t;
            if (frustration < 0.0)
                frustration = 0.0;
        }
        else
        {
            frustration += delta_t;
            if (frustration > 3.0)   // 3s of frustration
            {
                [self noteFrustration:@"BEHAVIOUR_ATTACK_SNIPER"];
                [self setEvasiveJink:1000.0];
                behaviour = BEHAVIOUR_ATTACK_TARGET;
                frustration = 0.0;
                desired_speed = maxFlightSpeed;
            }
        }
 
    }
 
    if (missiles) [self considerFiringMissile:delta_t];
 
    if (cloakAutomatic) [self activateCloakingDevice];
    [self fireMainWeapon:range];
 
    if (weapon_temp > COMBAT_AI_WEAPON_TEMP_USABLE && accuracy >= COMBAT_AI_ISNT_AWFUL)
    {
        behaviour = BEHAVIOUR_ATTACK_TARGET;
    }
 
}

References accuracy, activateCloakingDevice, afterburnerFactor, behaviour, canStillTrackPrimaryTarget, cloakAutomatic, COMBAT_AI_ISNT_AWFUL, COMBAT_AI_WEAPON_TEMP_USABLE, considerFiringMissile:, desired_speed, fireMainWeapon:, frustration, fuel, hasFuelInjection, Entity::isShip, maxFlightSpeed, MIN_FUEL, missiles, noteFrustration:, noteLostTargetAndGoIdle, primaryTarget, rangeToPrimaryTarget, scannerRange, setEvasiveJink:, success_factor, trackPrimaryTarget:delta_t:, weapon_temp, and weaponRange.

Referenced by processBehaviour:.

Here is the call graph for this function:

Here is the caller graph for this function:

behaviour_attack_target:

- (void) behaviour_attack_target:

(double)

delta_t

Definition at line 4560 of file ShipEntity.m.

                                :(double) delta_t
{
    double  range = [self rangeToPrimaryTarget];
    
    if (cloakAutomatic) [self activateCloakingDevice];
 
/* Start of behaviour selection:
 * Anything beyond the basics should require accuracy >= COMBAT_AI_ISNT_AWFUL
 * Anything fancy should require accuracy >= COMBAT_AI_IS_SMART
 * If precise aim is required, behaviour should have accuracy >= COMBAT_AI_TRACKS_CLOSER
 * - CIM
 */
 
    OOWeaponType forward_weapon_real_type = forward_weapon_type;
    GLfloat forward_weapon_real_temp = forward_weapon_temp;
 
// if forward weapon is actually on a subent
    if (isWeaponNone(forward_weapon_real_type))
    {
        BOOL hasTurrets = NO;
        NSEnumerator    *subEnum = [self shipSubEntityEnumerator];
        ShipEntity      *se = nil;
        while (isWeaponNone(forward_weapon_real_type) && (se = [subEnum nextObject]))
        {
            forward_weapon_real_type = se->forward_weapon_type;
            forward_weapon_real_temp = se->forward_weapon_temp;
            if (se->behaviour == BEHAVIOUR_TRACK_AS_TURRET)
            {
                hasTurrets = YES;
            }
        }
        if (isWeaponNone(forward_weapon_real_type) && hasTurrets)
        { // safety for ships only equipped with turrets
            forward_weapon_real_type = OOWeaponTypeFromEquipmentIdentifierSloppy(@"EQ_WEAPON_PULSE_LASER");
            forward_weapon_real_temp = COMBAT_AI_WEAPON_TEMP_USABLE * 0.9;
        }
    }
 
    if ([forward_weapon_real_type isTurretLaser]) 
    {
        behaviour = BEHAVIOUR_ATTACK_FLY_TO_TARGET_TWELVE;
    } 
    else 
    {
        BOOL in_good_range = aim_tolerance*range < COMBAT_AI_CONFIDENCE_FACTOR;
 
        BOOL aft_weapon_ready = !isWeaponNone(aft_weapon_type) && (aft_weapon_temp < COMBAT_AI_WEAPON_TEMP_READY) && in_good_range;
        BOOL forward_weapon_ready = !isWeaponNone(forward_weapon_real_type) && (forward_weapon_real_temp < COMBAT_AI_WEAPON_TEMP_READY); // does not require in_good_range
        BOOL port_weapon_ready = !isWeaponNone(port_weapon_type) && (port_weapon_temp < COMBAT_AI_WEAPON_TEMP_READY) && in_good_range;
        BOOL starboard_weapon_ready = !isWeaponNone(starboard_weapon_type) && (starboard_weapon_temp < COMBAT_AI_WEAPON_TEMP_READY) && in_good_range;
// if no weapons cool enough to be good choices, be less picky
        BOOL weapons_heating = NO;
        if (!forward_weapon_ready && !aft_weapon_ready && !port_weapon_ready && !starboard_weapon_ready)
        {
            weapons_heating = YES;
            aft_weapon_ready = !isWeaponNone(aft_weapon_type) && (aft_weapon_temp < COMBAT_AI_WEAPON_TEMP_USABLE) && in_good_range;
            forward_weapon_ready = !isWeaponNone(forward_weapon_real_type) && (forward_weapon_real_temp < COMBAT_AI_WEAPON_TEMP_USABLE); // does not require in_good_range
            port_weapon_ready = !isWeaponNone(port_weapon_type) && (port_weapon_temp < COMBAT_AI_WEAPON_TEMP_USABLE) && in_good_range;
        starboard_weapon_ready = !isWeaponNone(starboard_weapon_type) && (starboard_weapon_temp < COMBAT_AI_WEAPON_TEMP_USABLE) && in_good_range;
        }
 
        Entity* target = [self primaryTarget];
        double aspect = [self approachAspectToPrimaryTarget];
 
        if (!forward_weapon_ready && !aft_weapon_ready && !port_weapon_ready && !starboard_weapon_ready)
        { // no usable weapons! Either not fitted or overheated
            
            // if unarmed
            if (isWeaponNone(forward_weapon_real_type) && 
                isWeaponNone(aft_weapon_type) && 
                isWeaponNone(port_weapon_type) && 
                isWeaponNone(starboard_weapon_type))
            {
                behaviour = BEHAVIOUR_ATTACK_FLY_FROM_TARGET;
            }
            else if (aspect > 0)
            {
                if (in_good_range)
                {
                    if (accuracy >= COMBAT_AI_IS_SMART && randf() < 0.75)
                    {
                        behaviour = BEHAVIOUR_EVASIVE_ACTION;
                    }
                    else 
                    {
                        behaviour = BEHAVIOUR_ATTACK_FLY_FROM_TARGET;
                    }
                }
                else 
                {
                    // ready to get more accurate shots later
                    behaviour = BEHAVIOUR_ATTACK_FLY_TO_TARGET;
                }
            } 
            else
            {
                // if target is running away, stay on target
                // unless too close for safety
                if (range < COMBAT_IN_RANGE_FACTOR * weaponRange) {
                    behaviour = BEHAVIOUR_ATTACK_FLY_FROM_TARGET;
                } else {
                    behaviour = BEHAVIOUR_ATTACK_FLY_TO_TARGET;
                }
            }
        }
// if our current target isn't targeting us, and we have some idea of how to fight, and our weapons are running hot, and we're fairly nearby
        else if (weapons_heating && accuracy >= COMBAT_AI_ISNT_AWFUL && [target isShip] && [(ShipEntity *)target primaryTarget] != self && range < COMBAT_OUT_RANGE_FACTOR * weaponRange) 
        {
// then back off a bit for weapons to cool so we get a good attack run later, rather than weaving closer
            float relativeSpeed = magnitude(vector_subtract([self velocity], [target velocity]));
            [self setEvasiveJink:(range + COMBAT_JINK_OFFSET - relativeSpeed / max_flight_pitch)];
            behaviour = BEHAVIOUR_ATTACK_FLY_FROM_TARGET;
        }
        else 
        {
            BOOL nearby = range < COMBAT_IN_RANGE_FACTOR * getWeaponRangeFromType(forward_weapon_type);
            BOOL midrange = range < COMBAT_OUT_RANGE_FACTOR * getWeaponRangeFromType(aft_weapon_type);
 
 
            if (nearby && aft_weapon_ready)
            {
                jink = kZeroVector; // almost all behaviours
                behaviour = BEHAVIOUR_RUNNING_DEFENSE;
            }
            else if (nearby && (port_weapon_ready || starboard_weapon_ready))
            {
                jink = kZeroVector; // almost all behaviours
                behaviour = BEHAVIOUR_ATTACK_BROADSIDE;
            }
            else if (nearby)
            {
                if (!pitching_over) // don't change jink in the middle of a sharp turn.
                {
                    /*
                        For most AIs, is behaviour_attack_target called as starting behaviour on every hit.
                        Target can both fly towards or away from ourselves here. Both situations
                        need a different jink.z for optimal collision avoidance at high speed approach and low speed dogfighting.
                        The COMBAT_JINK_OFFSET intentionally over-compensates the range for collision radii to send ships towards
                        the target at low speeds.
                    */
                    float relativeSpeed = magnitude(vector_subtract([self velocity], [target velocity]));
                    [self setEvasiveJink:(range + COMBAT_JINK_OFFSET - relativeSpeed / max_flight_pitch)];
                }
                // good pilots use behaviour_attack_break_off_target instead
                if (accuracy >= COMBAT_AI_FLEES_BETTER)
                {
                    behaviour = BEHAVIOUR_ATTACK_BREAK_OFF_TARGET;
                }
                else
                {
                    behaviour = BEHAVIOUR_ATTACK_FLY_FROM_TARGET;
                }
            }
            else if (forward_weapon_ready)
            {
                jink = kZeroVector; // almost all behaviours
 
                // TODO: good pilots use behaviour_attack_sniper sometimes
                if (getWeaponRangeFromType(forward_weapon_real_type) > 12500 && range > 12500)
                {
                    behaviour = BEHAVIOUR_ATTACK_SNIPER;
                }
// generally not good tactics the next two
                else if (accuracy < COMBAT_AI_ISNT_AWFUL && aspect < 0)
                {
                    behaviour = BEHAVIOUR_ATTACK_FLY_TO_TARGET_SIX;
                }
                else if (accuracy < COMBAT_AI_ISNT_AWFUL)
                {
                    behaviour = BEHAVIOUR_ATTACK_FLY_TO_TARGET_TWELVE;
                }
                else
                {
                    behaviour = BEHAVIOUR_ATTACK_FLY_TO_TARGET;
                }
            }
            else if (port_weapon_ready || starboard_weapon_ready)
            {
                jink = kZeroVector; // almost all behaviours
                behaviour = BEHAVIOUR_ATTACK_BROADSIDE;
            }
            else if (aft_weapon_ready && midrange)
            {
                jink = kZeroVector; // almost all behaviours
                behaviour = BEHAVIOUR_RUNNING_DEFENSE;
            } 
            else
            {
                jink = kZeroVector; // almost all behaviours
                behaviour = BEHAVIOUR_ATTACK_FLY_TO_TARGET;
            }
        }
    }
 
    frustration = 0.0;   // behaviour changed, so reset frustration
    
}

References accuracy, activateCloakingDevice, aft_weapon_temp, aft_weapon_type, aim_tolerance, approachAspectToPrimaryTarget, behaviour, cloakAutomatic, COMBAT_AI_CONFIDENCE_FACTOR, COMBAT_AI_FLEES_BETTER, COMBAT_AI_IS_SMART, COMBAT_AI_ISNT_AWFUL, COMBAT_AI_WEAPON_TEMP_READY, COMBAT_AI_WEAPON_TEMP_USABLE, COMBAT_IN_RANGE_FACTOR, COMBAT_OUT_RANGE_FACTOR, forward_weapon_temp, forward_weapon_type, frustration, getWeaponRangeFromType(), Entity::isShip, isWeaponNone(), jink, kZeroVector, nil, OOWeaponTypeFromEquipmentIdentifierSloppy(), pitching_over, port_weapon_temp, port_weapon_type, primaryTarget, randf(), rangeToPrimaryTarget, setEvasiveJink:, shipSubEntityEnumerator, starboard_weapon_temp, starboard_weapon_type, velocity, and weaponRange.

Referenced by processBehaviour:.

Here is the call graph for this function:

Here is the caller graph for this function:

behaviour_avoid_collision:

- (void) behaviour_avoid_collision:

(double)

delta_t

Definition at line 5979 of file ShipEntity.m.

                                  :(double) delta_t
{
    double distance = [self rangeToDestination];
    if (distance > desired_range)
    {
        [self resumePostProximityAlert];
    }
    else
    {
        ShipEntity* prox_ship = (ShipEntity*)[self proximityAlert];
        if (prox_ship)
        {
            desired_range = prox_ship->collision_radius * PROXIMITY_AVOID_DISTANCE_FACTOR;
            _destination = prox_ship->position;
        }
        double dq = [self trackDestination:delta_t:YES]; // returns 0 when heading towards prox_ship
        // Heading towards target with desired_speed > 0, avoids collisions better than setting desired_speed to zero.
        // (tested with boa class cruiser on collisioncourse with buoy)
        desired_speed = maxFlightSpeed * (0.5 * dq + 0.5);
    }
 
    
    
}

References _destination, Entity::collision_radius, desired_range, desired_speed, maxFlightSpeed, Entity::position, PROXIMITY_AVOID_DISTANCE_FACTOR, proximityAlert, rangeToDestination, resumePostProximityAlert, and trackDestination:delta_t:.

Referenced by processBehaviour:.

Here is the call graph for this function:

Here is the caller graph for this function:

behaviour_close_to_broadside_range:

- (void) behaviour_close_to_broadside_range:

(double)

delta_t

Definition at line 4956 of file ShipEntity.m.

                                           :(double) delta_t
{
    double  range = [self rangeToPrimaryTarget];
    if ([self proximityAlert] != nil)
    {
        if ([self proximityAlert] == [self primaryTarget])
        {
            behaviour = BEHAVIOUR_ATTACK_FLY_TO_TARGET; // this behaviour will handle proximity_alert.
            [self behaviour_attack_fly_from_target: delta_t]; // do it now.
        }
        else
        {
            [self avoidCollision];
        }
        return;
    }
    if (![self canStillTrackPrimaryTarget])
    {
        [self noteLostTargetAndGoIdle];
        return;
    }
 
    behaviour = BEHAVIOUR_ATTACK_FLY_TO_TARGET_TWELVE;
    [self behaviour_fly_to_target_six:delta_t];
    if (!isWeaponNone(port_weapon_type))
    {
        [self setWeaponDataFromType:port_weapon_type];
    }
    else
    {
        [self setWeaponDataFromType:starboard_weapon_type];
    }
    if (range <= COMBAT_BROADSIDE_RANGE_FACTOR * weaponRange)
    {
        behaviour = BEHAVIOUR_ATTACK_BROADSIDE;
    }
    else
    {
        behaviour = BEHAVIOUR_CLOSE_TO_BROADSIDE_RANGE;
    }
}

References avoidCollision, behaviour, behaviour_attack_fly_from_target:, behaviour_fly_to_target_six:, canStillTrackPrimaryTarget, COMBAT_BROADSIDE_RANGE_FACTOR, isWeaponNone(), nil, noteLostTargetAndGoIdle, port_weapon_type, primaryTarget, proximityAlert, rangeToPrimaryTarget, setWeaponDataFromType:, and weaponRange.

Referenced by processBehaviour:.

Here is the call graph for this function:

Here is the caller graph for this function:

behaviour_close_with_target:

- (void) behaviour_close_with_target:

(double)

delta_t

Definition at line 4999 of file ShipEntity.m.

                                    :(double) delta_t
{
    double  range = [self rangeToPrimaryTarget];
    if ([self proximityAlert] != nil)
    {
        if ([self proximityAlert] == [self primaryTarget])
        {
            behaviour = BEHAVIOUR_ATTACK_FLY_TO_TARGET; // this behaviour will handle proximity_alert.
            [self behaviour_attack_fly_from_target: delta_t]; // do it now.
        }
        else
        {
            [self avoidCollision];
        }
        return;
    }
    if (![self canStillTrackPrimaryTarget])
    {
        [self noteLostTargetAndGoIdle];
        return;
    }
    behaviour = BEHAVIOUR_ATTACK_FLY_TO_TARGET_TWELVE;
    double saved_frustration = frustration;
    [self behaviour_fly_to_target_six:delta_t];
    frustration = saved_frustration; // ignore fly-to-12 frustration
    frustration += delta_t;
    if (range <= COMBAT_IN_RANGE_FACTOR * weaponRange || frustration > 5.0)
    {
        behaviour = BEHAVIOUR_ATTACK_TARGET;
    }
    else
    {
        behaviour = BEHAVIOUR_CLOSE_WITH_TARGET;
    }
 
 
}

References avoidCollision, behaviour, behaviour_attack_fly_from_target:, behaviour_fly_to_target_six:, canStillTrackPrimaryTarget, frustration, nil, noteLostTargetAndGoIdle, primaryTarget, proximityAlert, and rangeToPrimaryTarget.

Referenced by processBehaviour:.

Here is the call graph for this function:

Here is the caller graph for this function:

behaviour_evasive_action:

- (void) behaviour_evasive_action:

(double)

delta_t

Definition at line 4511 of file ShipEntity.m.

                                 :(double) delta_t
{
    BOOL    canBurn = [self hasFuelInjection] && (fuel > MIN_FUEL);
    float   max_available_speed = maxFlightSpeed;
//  double  range = [self rangeToPrimaryTarget];
    if (canBurn) max_available_speed *= [self afterburnerFactor];
    desired_speed = max_available_speed;
    if (desired_speed > maxFlightSpeed)
    {
        ShipEntity* target = [self primaryTarget];
        double target_speed = [target speed];
        if (desired_speed > target_speed)
        {
            desired_speed = maxFlightSpeed; // don't overuse the injectors
        }
    }
    
    if (cloakAutomatic) [self activateCloakingDevice];
    if ([self proximityAlert] != nil)
    {
        [self avoidCollision];
        return;
    }
 
    [self evasiveAction:delta_t];
 
    frustration += delta_t;
    
    if (frustration > 0.5)
    {
        if (behaviour == BEHAVIOUR_FLEE_EVASIVE_ACTION)
        {
            [self setEvasiveJink:400.0];
            behaviour = BEHAVIOUR_FLEE_TARGET;
        }
        else
        {
            behaviour = BEHAVIOUR_ATTACK_TARGET;
        }
    }
 
    flightYaw = 0.0;
 
    // probably only useful for Thargoids, except for the occasional opportunist
    [self fireMainWeapon:[self rangeToPrimaryTarget]];
    
}

References activateCloakingDevice, afterburnerFactor, avoidCollision, behaviour, cloakAutomatic, desired_speed, evasiveAction:, fireMainWeapon:, flightYaw, frustration, fuel, hasFuelInjection, maxFlightSpeed, MIN_FUEL, nil, primaryTarget, proximityAlert, rangeToPrimaryTarget, setEvasiveJink:, and Entity::speed.

Referenced by processBehaviour:.

Here is the call graph for this function:

Here is the caller graph for this function:

behaviour_face_destination:

- (void) behaviour_face_destination:

(double)

delta_t

Definition at line 5699 of file ShipEntity.m.

                                   :(double) delta_t
{
    double max_cos = MAX_COS;
    double distance = [self rangeToDestination];
    double old_pitch = flightPitch;
    desired_speed = 0.0;
    if (desired_range > 1.0 && distance > desired_range)
    {
        max_cos = sqrt(1 - 0.90 * desired_range*desired_range/(distance * distance));   // Head for a point within 95% of desired_range (must match the value in trackDestination)
    }
    double confidenceFactor = [self trackDestination:delta_t:NO];
    if (confidenceFactor >= max_cos && flightPitch == 0.0)
    {
        // desired facing achieved and movement stabilised.
        [shipAI message:@"FACING_DESTINATION"];
        [self doScriptEvent:OOJSID("shipNowFacingDestination")];
        frustration = 0.0;
        if(docking_match_rotation)  // IDLE stops rotating while docking
        {
            behaviour = BEHAVIOUR_FLY_TO_DESTINATION;
        }
        else
        {
            behaviour = BEHAVIOUR_IDLE;
        }
    }
 
    if(flightSpeed == 0) frustration += delta_t;
    if (frustration > 15.0 / max_flight_pitch)   // allow more time for slow ships.
    {
        frustration = 0.0;
        [self noteFrustration:@"BEHAVIOUR_FACE_DESTINATION"];
        if(flightPitch == old_pitch) flightPitch = 0.5 * max_flight_pitch; // hack to get out of frustration.
    }   
    
    /* 2009-7-18 Eric: the condition check below is intended to eliminate the flippering between two positions for fast turning ships
       during low FPS conditions. This flippering is particular frustrating on slow computers during docking. But with my current computer I can't
       induce those low FPS conditions so I can't properly test if it helps.
       I did try with the TAF time acceleration that also generated larger frame jumps and than it seemed to help.
    */
    if(flightSpeed == 0 && frustration > 5 && confidenceFactor > 0.5 && ((flightPitch > 0 && old_pitch < 0) || (flightPitch < 0 && old_pitch > 0)))
    {
        flightPitch += 0.5 * old_pitch; // damping with last pitch value.
    }
    
    if ([self hasProximityAlertIgnoringTarget:YES])
    {
        [self avoidCollision];
    }
    
    
}

References avoidCollision, behaviour, desired_range, desired_speed, docking_match_rotation, doScriptEvent:, flightPitch, flightSpeed, frustration, MAX_COS, max_flight_pitch, AI::message:, noteFrustration:, rangeToDestination, and trackDestination:delta_t:.

Referenced by processBehaviour:.

Here is the call graph for this function:

Here is the caller graph for this function:

behaviour_flee_target:

- (void) behaviour_flee_target:

(double)

delta_t

Definition at line 5602 of file ShipEntity.m.

                              :(double) delta_t
{
    BOOL    canBurn = [self hasFuelInjection] && (fuel > MIN_FUEL);
    float   max_available_speed = maxFlightSpeed;
    double  range = [self rangeToPrimaryTarget];
    if ([self primaryTarget] == nil)
    {
        [self noteLostTargetAndGoIdle];
        return;
    }
    if (canBurn) max_available_speed *= [self afterburnerFactor];
    
    double last_range = success_factor;
    success_factor = range;
 
    if (range > desired_range || range == 0)
        [shipAI message:@"REACHED_SAFETY"];
    else
        desired_speed = max_available_speed;
 
    if (range > last_range) // improvement
    {
        frustration -= 0.25 * delta_t;
        if (frustration < 0.0)
            frustration = 0.0;
    }
    else
    {
        frustration += delta_t;
        if (frustration > 15.0)  // 15s of frustration
        {
            [self noteFrustration:@"BEHAVIOUR_FLEE_TARGET"];
            frustration = 0.0;
        }
    }
 
    [self trackPrimaryTarget:delta_t:YES];
 
    Entity *target = [self primaryTarget];
 
    if (missiles && [target isShip] && [(ShipEntity *)target primaryTarget] == self)
    {
        [self considerFiringMissile:delta_t];
    }
 
    if (([self hasCascadeMine]) && (range < 10000.0) && canBurn)
    {
        float   qbomb_chance = 0.01 * delta_t;
        if (randf() < qbomb_chance)
        {
            [self launchCascadeMine];
        }
    }
 
// thargoids won't normally be fleeing, but if they do, they can still shoot
    if ([forward_weapon_type isTurretLaser])
    {
        [self fireMainWeapon:range];
    }
 
    if (cloakAutomatic) [self activateCloakingDevice];
 
    // remember to look where you're going?
    if (accuracy >= COMBAT_AI_ISNT_AWFUL && [self hasProximityAlertIgnoringTarget:YES])
    {
        [self avoidCollision];
    }
 
}

References accuracy, activateCloakingDevice, afterburnerFactor, avoidCollision, cloakAutomatic, COMBAT_AI_ISNT_AWFUL, considerFiringMissile:, desired_range, desired_speed, fireMainWeapon:, forward_weapon_type, frustration, fuel, hasCascadeMine, hasFuelInjection, Entity::isShip, launchCascadeMine, maxFlightSpeed, AI::message:, MIN_FUEL, missiles, nil, noteFrustration:, noteLostTargetAndGoIdle, primaryTarget, randf(), rangeToPrimaryTarget, success_factor, and trackPrimaryTarget:delta_t:.

Referenced by processBehaviour:.

Here is the call graph for this function:

Here is the caller graph for this function:

behaviour_fly_from_destination:

- (void) behaviour_fly_from_destination:

(double)

delta_t

Definition at line 5955 of file ShipEntity.m.

                                       :(double) delta_t
{
    double distance = [self rangeToDestination];
    if (distance > desired_range)
    {
        // desired range achieved
        [shipAI message:@"DESIRED_RANGE_ACHIEVED"];
        [self doScriptEvent:OOJSID("shipAchievedDesiredRange")];
 
        behaviour = BEHAVIOUR_IDLE;
        frustration = 0.0;
        desired_speed = 0.0;
    }
 
    [self trackDestination:delta_t:YES];
    if ([self hasProximityAlertIgnoringTarget:YES])
    {
        [self avoidCollision];
    }
    
    
}

References avoidCollision, behaviour, desired_range, desired_speed, doScriptEvent:, frustration, AI::message:, rangeToDestination, and trackDestination:delta_t:.

Referenced by processBehaviour:.

Here is the call graph for this function:

Here is the caller graph for this function:

behaviour_fly_range_from_destination:

- (void) behaviour_fly_range_from_destination:

(double)

delta_t

Definition at line 5673 of file ShipEntity.m.

                                             :(double) delta_t
{
    double distance = [self rangeToDestination];
    if (distance < desired_range)
    {
        behaviour = BEHAVIOUR_FLY_FROM_DESTINATION;
        if (desired_speed < maxFlightSpeed) 
        {
            desired_speed = maxFlightSpeed;  // Not all AI define speed when flying away. Start with max speed to stay compatible with such AI's, but allow faster flight if it's (e.g.) used to flee from coordinates rather than entity
        }
    }
    else
    {
        behaviour = BEHAVIOUR_FLY_TO_DESTINATION;
    }
    if ([self hasProximityAlertIgnoringTarget:YES])
    {
        [self avoidCollision];
    }
    frustration = 0.0;
 
    
    
}

References avoidCollision, behaviour, desired_range, desired_speed, frustration, maxFlightSpeed, and rangeToDestination.

Referenced by processBehaviour:.

Here is the call graph for this function:

Here is the caller graph for this function:

behaviour_fly_thru_navpoints:

- (void) behaviour_fly_thru_navpoints:

(double)

delta_t

Definition at line 6067 of file ShipEntity.m.

                                     :(double) delta_t
{
    int navpoint_plus_index = (next_navpoint_index + 1) % number_of_navpoints;
    HPVector d1 = navpoints[next_navpoint_index];      // head for this one
    HPVector d2 = navpoints[navpoint_plus_index];  // but be facing this one
    
    HPVector rel = HPvector_between(d1, position);  // vector from d1 to position 
    HPVector ref = HPvector_between(d2, d1);        // vector from d2 to d1
    ref = HPvector_normal(ref);
    
    HPVector xp = make_HPvector(ref.y * rel.z - ref.z * rel.y, ref.z * rel.x - ref.x * rel.z, ref.x * rel.y - ref.y * rel.x);   
    
    GLfloat v0 = 0.0;
    
    GLfloat r0 = HPdot_product(rel, ref);   // proportion of rel in direction ref
    
    // if r0 is negative then we're the wrong side of things
    
    GLfloat r1 = HPmagnitude(xp);   // distance of position from line
    
    BOOL in_cone = (r0 > 0.5 * r1);
    
    if (!in_cone)   // are we in the approach cone ?
        r1 = 25.0 * flightSpeed; // aim a few km out!
    else
        r1 *= 2.0;
    
    GLfloat dist2 = HPmagnitude2(rel);
    
    if (dist2 < desired_range * desired_range)
    {
        // desired range achieved
        [self doScriptEvent:OOJSID("shipReachedNavPoint") andReactToAIMessage:@"NAVPOINT_REACHED"];
        if (navpoint_plus_index == 0)
        {
            [self doScriptEvent:OOJSID("shipReachedEndPoint") andReactToAIMessage:@"ENDPOINT_REACHED"];
            behaviour = BEHAVIOUR_IDLE;
        }
        next_navpoint_index = navpoint_plus_index;   // loop as required
    }
    else
    {
        double last_success_factor = success_factor;
        double last_dist2 = last_success_factor;
        success_factor = dist2;
 
        // set destination spline point from r1 and ref
        _destination = make_HPvector(d1.x + r1 * ref.x, d1.y + r1 * ref.y, d1.z + r1 * ref.z);
 
        // do the actual piloting!!
        //
        // aim to within 1m
        GLfloat temp = desired_range;
        if (in_cone)
            desired_range = 1.0;
        else
            desired_range = 100.0;
        v0 = [self trackDestination:delta_t: NO];
        desired_range = temp;
        
        if (dist2 < last_dist2) // improvement
        {
            frustration -= 0.25 * delta_t;
            if (frustration < 0.0)
                frustration = 0.0;
        }
        else
        {
            frustration += delta_t;
            if (frustration > 15.0)  // 15s of frustration
            {
                [self noteFrustration:@"BEHAVIOUR_FLY_THRU_NAVPOINTS"];
                frustration -= 15.0; //repeat after another 15s of frustration
            }
        }
    }
    
 
    
    GLfloat temp = desired_speed;
    desired_speed *= v0 * v0;
    
    desired_speed = temp;
}

References _destination, behaviour, desired_range, desired_speed, doScriptEvent:andReactToAIMessage:, flightSpeed, frustration, navpoints, next_navpoint_index, noteFrustration:, number_of_navpoints, Entity::position, success_factor, and trackDestination:delta_t:.

Referenced by processBehaviour:.

Here is the call graph for this function:

Here is the caller graph for this function:

behaviour_fly_to_destination:

- (void) behaviour_fly_to_destination:

(double)

delta_t

Definition at line 5850 of file ShipEntity.m.

                                     :(double) delta_t
{
    double distance = [self rangeToDestination];
    // double desiredRange = (dockingInstructions != nil) ? 1.2 * desired_range : desired_range; // stop a bit earlyer when docking.
    if (distance < desired_range) // + collision_radius)
    {
        // desired range achieved
        [shipAI message:@"DESIRED_RANGE_ACHIEVED"];
        [self doScriptEvent:OOJSID("shipAchievedDesiredRange")];
 
        if(!docking_match_rotation) // IDLE stops rotating while docking
        {
            behaviour = BEHAVIOUR_IDLE;
            desired_speed = 0.0;
        }
        frustration = 0.0;
    }
    else
    {
        double last_distance = success_factor;
        success_factor = distance;
 
        // do the actual piloting!!
        double confidenceFactor = [self trackDestination:delta_t: NO];
        if(confidenceFactor < 0.2) confidenceFactor = 0.2;  // don't allow small or negative values.
        
        /*  2009-07-19 Eric: Estimated Time of Arrival (eta) should also take the "angle to target" into account (confidenceFactor = cos(angle to target))
            and should not fuss about that last meter and use "distance + 1" instead of just "distance".
            trackDestination already did pitch regulation, use confidence here only for cutting down to high speeds.
            This should prevent ships crawling to their destination when they try to pull up close to their destination.
            
            To prevent ships circling around their target without reaching destination I added a limitation based on turnrate,
            speed and distance to target. Formula based on satelite orbit:
                    orbitspeed = turnrate (rad/sec) * radius (m)   or   flightSpeed = max_flight_pitch * 2 Pi * distance
            Speed must be significant lower when not flying in direction of target (low confidenceFactor) or it can never approach its destination 
            and the ships runs the risk flying in circles around the target. (exclude active escorts)
        */
        GLfloat eta = ((distance + 1) - desired_range) / (0.51 * flightSpeed * confidenceFactor);   // 2% safety margin assuming an average of half current speed
        GLfloat slowdownTime = (thrust > 0.0)? flightSpeed / (thrust) : 4.0;
        GLfloat minTurnSpeedFactor = 0.05 * max_flight_pitch * max_flight_roll;  // faster turning implies higher speeds
        if (dockingInstructions != nil)
        {
            minTurnSpeedFactor /= 10.0;
            if (minTurnSpeedFactor * maxFlightSpeed > 20.0)
            {
                minTurnSpeedFactor /= 10.0;
            }
        }
 
 
        if (((eta < slowdownTime)&&(flightSpeed > maxFlightSpeed * minTurnSpeedFactor)) || (flightSpeed > max_flight_pitch * 5 * confidenceFactor * distance))
        {
            desired_speed = flightSpeed * 0.50;   // cut speed by 50% to a minimum minTurnSpeedFactor of speed
        }
 
        /* Flight correction block to prevent one possible form of
         * crashes in late docking process */
        if (docking_match_rotation && confidenceFactor >= MAX_COS && dockingInstructions != nil && [dockingInstructions oo_intForKey:@"docking_stage"] >= 7)
        {
            // then at this point should be rotating to match the station
            StationEntity* station_for_docking = (StationEntity*)[self targetStation];
 
            if ((station_for_docking)&&(station_for_docking->isStation))
            {
                float rollMatch = dot_product([station_for_docking portUpVectorForShip:self],[self upVector]);
                if (rollMatch < MAX_COS && rollMatch > -MAX_COS)
                {
                    // not matching rotating - stop until corrected
                    desired_speed = 0.1;
                }
                else if (desired_speed <= 0.2)
                {
                    // had previously paused, so return to normal speed
                    desired_speed = [dockingInstructions oo_floatForKey:@"speed"];
                }
            }
        }
 
 
    
        if (distance < last_distance)   // improvement
        {
            frustration -= 0.25 * delta_t;
            if (frustration < 0.0)
                frustration = 0.0;
        }
        else
        {
            frustration += delta_t;
            if ((frustration > slowdownTime * 10.0 && slowdownTime > 0)||(frustration > 15.0))    // 10x slowdownTime or 15s of frustration
            {
                [self noteFrustration:@"BEHAVIOUR_FLY_TO_DESTINATION"];
                frustration -= slowdownTime * 5.0;   //repeat after another five units of frustration
            }
        }
    }
    if ([self hasProximityAlertIgnoringTarget:YES])
    {
        [self avoidCollision];
    }
    
    
}

References avoidCollision, behaviour, desired_range, desired_speed, docking_match_rotation, dockingInstructions, doScriptEvent:, flightSpeed, frustration, Entity::isStation, MAX_COS, max_flight_pitch, max_flight_roll, maxFlightSpeed, AI::message:, nil, noteFrustration:, rangeToDestination, success_factor, targetStation, thrust, trackDestination:delta_t:, and upVector.

Referenced by processBehaviour:.

Here is the call graph for this function:

Here is the caller graph for this function:

behaviour_fly_to_target_six:

- (void) behaviour_fly_to_target_six:

(double)

delta_t

Definition at line 5116 of file ShipEntity.m.

                                    :(double) delta_t
{
    BOOL    canBurn = [self hasFuelInjection] && (fuel > MIN_FUEL);
    float   max_available_speed = maxFlightSpeed;
    double  range = [self rangeToPrimaryTarget];
    if (canBurn) max_available_speed *= [self afterburnerFactor];
    
    // deal with collisions and lost targets
    if ([self proximityAlert] != nil)
    {
        if ([self proximityAlert] == [self primaryTarget])
        {
            behaviour = BEHAVIOUR_ATTACK_FLY_TO_TARGET; // this behaviour will handle proximity_alert.
            [self behaviour_attack_fly_from_target: delta_t]; // do it now.
        }
        else
        {
            [self avoidCollision];
        }
        return;
    }
    if (![self canStillTrackPrimaryTarget])
    {
        [self noteLostTargetAndGoIdle];
        return;
    }
 
    // control speed
    BOOL isUsingAfterburner = canBurn && (flightSpeed > maxFlightSpeed);
    BOOL closeQuickly = (canBurn && range > weaponRange);
    double  slow_down_range = weaponRange * COMBAT_WEAPON_RANGE_FACTOR * ((isUsingAfterburner)? 3.0 * [self afterburnerFactor] : 1.0);
    if (closeQuickly)
    {
        slow_down_range = weaponRange * COMBAT_OUT_RANGE_FACTOR;
    }
    double  back_off_range = weaponRange * COMBAT_OUT_RANGE_FACTOR * ((isUsingAfterburner)? 3.0 * [self afterburnerFactor] : 1.0);
    Entity* rawTarget = [self primaryTarget];
    if (![rawTarget isShip])
    {
        [self noteLostTargetAndGoIdle];
        return;
    }
    ShipEntity* target = (ShipEntity *)rawTarget;
    double target_speed = [target speed];
    double last_success_factor = success_factor;
    double distance = [self rangeToDestination];
    success_factor = distance;
        
    if (range < slow_down_range && (behaviour == BEHAVIOUR_ATTACK_FLY_TO_TARGET_SIX))
    {
        if (range < back_off_range)
        {
            desired_speed = fmax(0.9 * target_speed, 0.4 * maxFlightSpeed);
        } 
        else
        {
            desired_speed = fmax(target_speed * 1.2, maxFlightSpeed);
        }
        
        // avoid head-on collision
        if ((range < 0.5 * distance)&&(behaviour == BEHAVIOUR_ATTACK_FLY_TO_TARGET_SIX))
            behaviour = BEHAVIOUR_ATTACK_FLY_TO_TARGET_TWELVE;
    }
    else
    {
        if (range < back_off_range)
        {
            desired_speed = fmax(0.9 * target_speed, 0.8 * maxFlightSpeed);
        } 
        else 
        {
            desired_speed = max_available_speed; // use afterburner to approach
        }
    }
 
 
    // if within 0.75km of the target's six or twelve, or if target almost at standstill for 62.5% of non-thargoid ships (!),
    // then vector in attack. 
    if (distance < 750.0 || (target_speed < 0.2 && ![self isThargoid] && ([self universalID] & 14) > 4))
    {
        behaviour = BEHAVIOUR_ATTACK_FLY_TO_TARGET;
        frustration = 0.0;
        desired_speed = fmax(target_speed, 0.4 * maxFlightSpeed);   // within the weapon's range don't use afterburner
    }
 
    // target-six
    if (behaviour == BEHAVIOUR_ATTACK_FLY_TO_TARGET_SIX)
    {
        // head for a point weapon-range * 0.5 to the six of the target
        //
        _destination = [target distance_six:0.5 * weaponRange];
    }
    // target-twelve
    if (behaviour == BEHAVIOUR_ATTACK_FLY_TO_TARGET_TWELVE)
    {
        if ([forward_weapon_type isTurretLaser])
        {
            // head for a point near the target, avoiding common Galcop weapon mount locations
            // TODO: this should account for weapon ranges
            GLfloat offset = 1000.0;
            GLfloat spacing = 2000.0;
            if (accuracy > 0.0) 
            {
                offset = accuracy * 750.0;
                spacing = 2000.0 + (accuracy * 500.0);
            }
            if (entity_personality & 1)
            { // half at random
                offset = -offset;
            }
            _destination = [target distance_twelve:spacing withOffset:offset];
        }
        else 
        {
            // head for a point 1.25km above the target
            _destination = [target distance_twelve:1250 withOffset:0];
        }
    }
 
    pitching_over = NO; // in case it's set from elsewhere
    double confidenceFactor = [self trackDestination:delta_t :NO];
    
    if(success_factor > last_success_factor || confidenceFactor < 0.85) frustration += delta_t;
    else if(frustration > 0.0) frustration -= delta_t * 0.75;
 
    double aspect = [self approachAspectToPrimaryTarget];
    if(![forward_weapon_type isTurretLaser] && (frustration > 10 || aspect > 0.75))
    {
        behaviour = BEHAVIOUR_ATTACK_FLY_TO_TARGET;
    }
 
    // use weaponry
    if (missiles) [self considerFiringMissile:delta_t];
 
    if (cloakAutomatic) [self activateCloakingDevice];
    [self fireMainWeapon:range];
    
    
 
    if (weapon_temp > COMBAT_AI_WEAPON_TEMP_USABLE)
    {
        behaviour = BEHAVIOUR_ATTACK_TARGET;
    }
}

References _destination, accuracy, activateCloakingDevice, afterburnerFactor, approachAspectToPrimaryTarget, avoidCollision, behaviour, behaviour_attack_fly_from_target:, canStillTrackPrimaryTarget, cloakAutomatic, COMBAT_AI_WEAPON_TEMP_USABLE, COMBAT_OUT_RANGE_FACTOR, COMBAT_WEAPON_RANGE_FACTOR, considerFiringMissile:, desired_speed, entity_personality, fireMainWeapon:, flightSpeed, forward_weapon_type, frustration, fuel, hasFuelInjection, Entity::isShip, isThargoid, maxFlightSpeed, MIN_FUEL, missiles, nil, noteLostTargetAndGoIdle, pitching_over, primaryTarget, proximityAlert, rangeToDestination, rangeToPrimaryTarget, Entity::speed, success_factor, trackDestination:delta_t:, Entity::universalID, weapon_temp, and weaponRange.

Referenced by behaviour_close_to_broadside_range:, behaviour_close_with_target:, and processBehaviour:.

Here is the call graph for this function:

Here is the caller graph for this function:

behaviour_formation_form_up:

- (void) behaviour_formation_form_up:

(double)

delta_t

Definition at line 5797 of file ShipEntity.m.

                                    :(double) delta_t
{
    // destination for each escort is set in update() from owner.
    ShipEntity* leadShip = [self owner];
    double distance = [self rangeToDestination];
    double eta = (distance - desired_range) / flightSpeed;
    if(eta < 0) eta = 0;
    if ((eta < 5.0)&&(leadShip)&&(leadShip->isShip))
        desired_speed = [leadShip flightSpeed] * (1 + eta * 0.05);
    else
        desired_speed = maxFlightSpeed;
 
    double last_distance = success_factor;
    success_factor = distance;
 
    // do the actual piloting!!
    [self trackDestination:delta_t: NO];
 
    eta = eta / 0.51;   // 2% safety margin assuming an average of half current speed
    GLfloat slowdownTime = (thrust > 0.0)? flightSpeed / (thrust) : 4.0;
    GLfloat minTurnSpeedFactor = 0.05 * max_flight_pitch * max_flight_roll;  // faster turning implies higher speeds
 
    if ((eta < slowdownTime)&&(flightSpeed > maxFlightSpeed * minTurnSpeedFactor))
        desired_speed = flightSpeed * 0.50;   // cut speed by 50% to a minimum minTurnSpeedFactor of speed
        
    if (distance < last_distance)   // improvement
    {
        frustration -= 0.25 * delta_t;
        if (frustration < 0.0)
            frustration = 0.0;
    }
    else
    {
        frustration += delta_t;
        if (frustration > 15.0)
        {
            if (!leadShip) [self noteFrustration:@"BEHAVIOUR_FORMATION_FORM_UP"]; // escorts never reach their destination when following leader.
            else if (distance > 0.5 * scannerRange && !pitching_over) 
            {
                pitching_over = YES; // Force the ship in a 180 degree turn. Do it here to allow escorts to break out formation for some seconds.
            }
            frustration = 0;
        }
    }
    if ([self hasProximityAlertIgnoringTarget:YES])
    {
        [self avoidCollision];
    }
    
    
}

References avoidCollision, desired_range, desired_speed, flightSpeed, frustration, Entity::isShip, max_flight_pitch, max_flight_roll, maxFlightSpeed, noteFrustration:, Entity::owner, pitching_over, rangeToDestination, scannerRange, success_factor, thrust, and trackDestination:delta_t:.

Referenced by processBehaviour:.

Here is the call graph for this function:

Here is the caller graph for this function:

behaviour_idle:

- (void) behaviour_idle:

(double)

delta_t

Definition at line 4153 of file ShipEntity.m.

                       :(double) delta_t
{
    stick_yaw = 0.0;
    if ((!isStation)&&(scanClass != CLASS_BUOY))
    {
        stick_roll = 0.0;
    }
    else
    {
        stick_roll = flightRoll;
    }
    if (scanClass != CLASS_BUOY)
    {
        stick_pitch = 0.0;
    }
    else
    {
        stick_pitch = flightPitch;
    }
    [self applySticks:delta_t];
    
    
}

References applySticks:, flightPitch, flightRoll, Entity::isStation, scanClass, stick_pitch, stick_roll, and stick_yaw.

Referenced by processBehaviour:.

Here is the call graph for this function:

Here is the caller graph for this function:

behaviour_intercept_target:

- (void) behaviour_intercept_target:

(double)

delta_t

Definition at line 4287 of file ShipEntity.m.

                                   :(double) delta_t
{
    double  range = [self rangeToPrimaryTarget];
    if (behaviour == BEHAVIOUR_INTERCEPT_TARGET)
    {
        desired_speed = maxFlightSpeed;
        if (range < desired_range)
        {
            [shipAI reactToMessage:@"DESIRED_RANGE_ACHIEVED" context:@"BEHAVIOUR_INTERCEPT_TARGET"];
            [self doScriptEvent:OOJSID("shipAchievedDesiredRange")];
 
        }
        desired_speed = maxFlightSpeed * [self trackPrimaryTarget:delta_t:NO];
    }
    else
    {
        // = BEHAVIOUR_COLLECT_TARGET
        ShipEntity* target = [self primaryTarget];
// if somehow ended up in this state but target is not cargo, stop
// trying to scoop it
        if (!target || [target scanClass] != CLASS_CARGO || [target cargoType] == CARGO_NOT_CARGO)
        {
            [self noteLostTargetAndGoIdle];
            return;
        }
        double target_speed = [target speed];
        double eta = range / (flightSpeed - target_speed);
        double last_success_factor = success_factor;
        double last_distance = last_success_factor;
        double  distance = [self rangeToDestination];
        success_factor = distance;
        //
        double slowdownTime = 96.0 / (thrust*SHIP_THRUST_FACTOR);   // more thrust implies better slowing
        double minTurnSpeedFactor = 0.005 * max_flight_pitch * max_flight_roll;  // faster turning implies higher speeds
 
        if ((eta < slowdownTime)&&(flightSpeed > maxFlightSpeed * minTurnSpeedFactor))
            desired_speed = flightSpeed * 0.75;   // cut speed by 50% to a minimum minTurnSpeedFactor of speed
        else
            desired_speed = maxFlightSpeed;
 
        if (desired_speed < target_speed)
        {
            desired_speed += target_speed;
            if (target_speed > maxFlightSpeed)
            {
                [self noteLostTargetAndGoIdle];
                return;
            }
        }
        if (desired_speed > maxFlightSpeed)
        { // never use injectors for scooping
            desired_speed = maxFlightSpeed;
        }
 
        _destination = target->position;
        desired_range = 0.5 * target->collision_radius;
        [self trackDestination: delta_t : NO];
 
        //
        if (distance < last_distance)   // improvement
        {
            frustration -= delta_t;
            if (frustration < 0.0)
                frustration = 0.0;
        }
        else
        {
            frustration += delta_t * 0.9;
            if (frustration > 10.0)  // 10s of frustration
            {
                [self noteFrustration:@"BEHAVIOUR_INTERCEPT_TARGET"];
                frustration -= 5.0;  //repeat after another five seconds' frustration
            }
        }
    }
    if ([self hasProximityAlertIgnoringTarget:YES])
    {
        [self avoidCollision];
    }
    
    
}

References _destination, avoidCollision, behaviour, CARGO_NOT_CARGO, cargoType, Entity::collision_radius, desired_range, desired_speed, doScriptEvent:, flightSpeed, frustration, max_flight_pitch, max_flight_roll, maxFlightSpeed, noteFrustration:, noteLostTargetAndGoIdle, Entity::position, primaryTarget, rangeToDestination, rangeToPrimaryTarget, AI::reactToMessage:context:, scanClass, SHIP_THRUST_FACTOR, Entity::speed, success_factor, thrust, trackDestination:delta_t:, and trackPrimaryTarget:delta_t:.

Referenced by processBehaviour:.

Here is the call graph for this function:

Here is the caller graph for this function:

behaviour_land_on_planet:

- (void) behaviour_land_on_planet:

(double)

delta_t

Definition at line 5753 of file ShipEntity.m.

                                 :(double) delta_t
{
    double max_cos = MAX_COS2; // trackDestination returns the squared confidence in reverse mode.
    desired_speed = 0.0;
    
    OOPlanetEntity* planet = [UNIVERSE entityForUniversalID:planetForLanding];
    
    if (![planet isPlanet]) 
    {
        behaviour = BEHAVIOUR_IDLE;
        aiScriptWakeTime = 1; // reconsider JSAI
        [shipAI message:@"NO_PLANET_NEARBY"];
        return;
    }
          
    if (HPdistance(position, [planet position]) + [self collisionRadius] < [planet radius])
    {
        // we have landed. (completely disappeared inside planet)
        [self landOnPlanet:planet];
        return;
    }
 
    double confidenceFactor = [self trackDestination:delta_t:YES]; // turn away from destination
    
    if (confidenceFactor >= max_cos && flightSpeed == 0.0)
    {
        // We are now turned away from planet. Start landing by flying backward.
        thrust = 0.0; // stop forward acceleration.
        if (magnitude2(velocity) < MAX_LANDING_SPEED2)
        {
            [self adjustVelocity:vector_multiply_scalar([self forwardVector], -max_thrust * delta_t)];
        }
    }
    
    
    if ([self hasProximityAlertIgnoringTarget:YES])
    {
        [self avoidCollision];
    }
    
    
}

References adjustVelocity:, aiScriptWakeTime, avoidCollision, behaviour, Entity::collisionRadius, desired_speed, flightSpeed, forwardVector, Entity::isPlanet, landOnPlanet:, MAX_COS2, MAX_LANDING_SPEED2, AI::message:, Entity::position, thrust, trackDestination:delta_t:, and velocity.

Referenced by processBehaviour:.

Here is the call graph for this function:

Here is the caller graph for this function:

behaviour_running_defense:

- (void) behaviour_running_defense:

(double)

delta_t

Definition at line 5553 of file ShipEntity.m.

                                  :(double) delta_t
{
    if (![self canStillTrackPrimaryTarget])
    {
        [self noteLostTargetAndGoIdle];
        return;
    }
 
    double  range = [self rangeToPrimaryTarget];
    desired_speed = maxFlightSpeed; // not injectors
    jink = kZeroVector;
    if (range > weaponRange || range > 0.8 * scannerRange || range == 0)
    {
        behaviour = BEHAVIOUR_CLOSE_WITH_TARGET;
        if ([forward_weapon_type isTurretLaser]) 
        {
                behaviour = BEHAVIOUR_ATTACK_FLY_TO_TARGET_TWELVE;
        } 
        frustration = 0.0;
    }
    [self trackPrimaryTarget:delta_t:YES];
    if ([forward_weapon_type isTurretLaser]) 
    {
        // most Thargoids will only have the forward weapon
        [self fireMainWeapon:range];
    }
    else 
    {
        [self fireAftWeapon:range];
    }
    if (cloakAutomatic) [self activateCloakingDevice];
    if ([self hasProximityAlertIgnoringTarget:YES])
        [self avoidCollision];
 
    if (behaviour != BEHAVIOUR_CLOSE_WITH_TARGET && weapon_temp > COMBAT_AI_WEAPON_TEMP_USABLE)
    {
        behaviour = BEHAVIOUR_ATTACK_TARGET;
    }
 
    // remember to look where you're going?
    if (accuracy >= COMBAT_AI_ISNT_AWFUL && [self hasProximityAlertIgnoringTarget:YES])
    {
        [self avoidCollision];
    }
 
 
}

References accuracy, activateCloakingDevice, avoidCollision, behaviour, canStillTrackPrimaryTarget, cloakAutomatic, COMBAT_AI_ISNT_AWFUL, COMBAT_AI_WEAPON_TEMP_USABLE, desired_speed, fireAftWeapon:, fireMainWeapon:, forward_weapon_type, frustration, jink, kZeroVector, maxFlightSpeed, noteLostTargetAndGoIdle, rangeToPrimaryTarget, scannerRange, trackPrimaryTarget:delta_t:, weapon_temp, and weaponRange.

Referenced by processBehaviour:.

Here is the call graph for this function:

Here is the caller graph for this function:

behaviour_scripted_ai:

- (void) behaviour_scripted_ai:

(double)

delta_t

Definition at line 6153 of file ShipEntity.m.

                              :(double) delta_t
{
    
    JSContext   *context = OOJSAcquireContext();
    jsval       rval = JSVAL_VOID;
    jsval       deltaJS = JSVAL_VOID;
    NSDictionary *result = nil;
    
    BOOL OK = JS_NewNumberValue(context, delta_t, &deltaJS);
    if (OK)
    {
        OK = [[self script] callMethod:OOJSID("scriptedAI")
                             inContext:context
                         withArguments:&deltaJS
                                 count:1
                                result:&rval];
    }
    
    if (!OK)
    {
        OOLog(@"ai.error",@"Could not call scriptedAI in ship script of %@, reverting to idle",self);
        behaviour = BEHAVIOUR_IDLE;
        OOJSRelinquishContext(context);
        return;
    }
 
    if (!JSVAL_IS_OBJECT(rval))
    {
        OOLog(@"ai.error",@"Invalid return value of scriptedAI in ship script of %@, reverting to idle",self);
        behaviour = BEHAVIOUR_IDLE;
        OOJSRelinquishContext(context);
        return;
    }
 
    result = OOJSNativeObjectFromJSObject(context, JSVAL_TO_OBJECT(rval));
    OOJSRelinquishContext(context);
 
    // roll or roll factor
    if ([result objectForKey:@"stickRollFactor"] != nil)
    {
        stick_roll = [result oo_floatForKey:@"stickRollFactor"] * max_flight_roll;
    } 
    else 
    {
        stick_roll = [result oo_floatForKey:@"stickRoll"];
    }
    if (stick_roll > max_flight_roll) 
    {
        stick_roll = max_flight_roll;
    }
    else if (stick_roll < -max_flight_roll)
    {
        stick_roll = -max_flight_roll;
    }
 
    // pitch or pitch factor
    if ([result objectForKey:@"stickPitchFactor"] != nil)
    {
        stick_pitch = [result oo_floatForKey:@"stickPitchFactor"] * max_flight_pitch;
    } 
    else 
    {
        stick_pitch = [result oo_floatForKey:@"stickPitch"];
    }
    if (stick_pitch > max_flight_pitch) 
    {
        stick_pitch = max_flight_pitch;
    }
    else if (stick_pitch < -max_flight_pitch)
    {
        stick_pitch = -max_flight_pitch;
    }
 
    // yaw or yaw factor
    if ([result objectForKey:@"stickYawFactor"] != nil)
    {
        stick_yaw = [result oo_floatForKey:@"stickYawFactor"] * max_flight_yaw;
    } 
    else 
    {
        stick_yaw = [result oo_floatForKey:@"stickYaw"];
    }
    if (stick_yaw > max_flight_yaw) 
    {
        stick_yaw = max_flight_yaw;
    }
    else if (stick_yaw < -max_flight_yaw)
    {
        stick_yaw = -max_flight_yaw;
    }   
 
    // apply sticks to current flight profile
    [self applySticks:delta_t];
 
    // desired speed
    if ([result objectForKey:@"desiredSpeedFactor"] != nil)
    {
        desired_speed = [result oo_floatForKey:@"desiredSpeedFactor"] * maxFlightSpeed;
    }
    else
    {
        desired_speed = [result oo_floatForKey:@"desiredSpeed"];
    }
 
    if (desired_speed < 0.0)
    {
        desired_speed = 0.0;
    }
    // overspeed and injector use is handled by applyThrust
 
    if (behaviour == BEHAVIOUR_SCRIPTED_ATTACK_AI)
    {
        NSString* chosen_weapon = [result oo_stringForKey:@"chosenWeapon" defaultValue:@"FORWARD"];
        double  range = [self rangeToPrimaryTarget];
            
        if ([chosen_weapon isEqualToString:@"FORWARD"])
        {
            [self fireMainWeapon:range];
        }
        else if ([chosen_weapon isEqualToString:@"AFT"])
        {
            [self fireAftWeapon:range];
        }
        else if ([chosen_weapon isEqualToString:@"PORT"])
        {
            [self firePortWeapon:range];
        }
        else if ([chosen_weapon isEqualToString:@"STARBOARD"])
        {
            [self fireStarboardWeapon:range];
        }
    }
}

References applySticks:, behaviour, OOJSScript::callMethod:inContext:withArguments:count:result:, desired_speed, fireAftWeapon:, fireMainWeapon:, firePortWeapon:, fireStarboardWeapon:, max_flight_pitch, max_flight_roll, max_flight_yaw, maxFlightSpeed, nil, OOJSAcquireContext(), OOJSNativeObjectFromJSObject(), OOJSRelinquishContext(), OOLog, rangeToPrimaryTarget, script, stick_pitch, stick_roll, and stick_yaw.

Referenced by processBehaviour:.

Here is the call graph for this function:

Here is the caller graph for this function:

behaviour_stop_still:

- (void) behaviour_stop_still:

(double)

delta_t

Definition at line 4141 of file ShipEntity.m.

                             :(double) delta_t
{
    stick_roll = 0.0;
    stick_pitch = 0.0;
    stick_yaw = 0.0;
    [self applySticks:delta_t];
 
    
    
}

References applySticks:, stick_pitch, stick_roll, and stick_yaw.

Referenced by processBehaviour:.

Here is the call graph for this function:

Here is the caller graph for this function:

behaviour_track_as_turret:

- (void) behaviour_track_as_turret:

(double)

delta_t

Definition at line 6005 of file ShipEntity.m.

                                  :(double) delta_t
{
    double aim = -2.0;
    ShipEntity *turret_owner = (ShipEntity *)[self owner];
    ShipEntity *turret_target = (ShipEntity *)[turret_owner primaryTarget];
    if (turret_owner && turret_target && [turret_owner hasHostileTarget])
    {
        aim = [self ballTrackLeadingTarget:delta_t atTarget:turret_target];
        if (aim > -1.0) // potential target
        {
            HPVector p = HPvector_subtract([turret_target position], [turret_owner position]);
            double cr = [turret_owner collisionRadius];
            
            if (aim > .95)
            {
                [self fireTurretCannon:HPmagnitude(p) - cr];
            }
            return;
        }
    }
    
    // can't fire on primary target; track secondary targets instead
    NSEnumerator *targetEnum = [turret_owner defenseTargetEnumerator];
    Entity *target = nil;
    while ((target = [[targetEnum nextObject] weakRefUnderlyingObject]))
    {
        // defense targets cannot be tracked while cloaked
        if ([target scanClass] == CLASS_NO_DRAW || [(ShipEntity *)target isCloaked] || [target energy] <= 0.0)
        {
            [turret_owner removeDefenseTarget:target];
        }
        else 
        {
            double range = [turret_owner rangeToSecondaryTarget:target];
            if (range < weaponRange)
            {
                aim = [self ballTrackLeadingTarget:delta_t atTarget:target];
                if (aim > -1.0)
                { // tracking...
                    HPVector p = HPvector_subtract([target position], [turret_owner position]);
                    double cr = [turret_owner collisionRadius];
        
                    if (aim > .95)
                    { // fire!
                        [self fireTurretCannon:HPmagnitude(p) - cr];
                    }
                    return;
                }
                // else that target is out of range, try the next priority defense target
            }
            else if (range > scannerRange)
            {
                [turret_owner removeDefenseTarget:target];
            }
        }
    }
 
    // turrets now don't return to neutral facing if no suitable target
    // better for shooting at targets that are on edge of fire arc
}

References ballTrackLeadingTarget:atTarget:, Entity::collisionRadius, defenseTargetEnumerator, Entity::energy, fireTurretCannon:, hasHostileTarget, isCloaked, nil, Entity::owner, Entity::position, primaryTarget, rangeToSecondaryTarget:, removeDefenseTarget:, scanClass, scannerRange, and weaponRange.

Referenced by processBehaviour:.

Here is the call graph for this function:

Here is the caller graph for this function:

behaviour_track_target:

- (void) behaviour_track_target:

(double)

delta_t

Definition at line 4271 of file ShipEntity.m.

                               :(double) delta_t
{
    if ([self primaryTarget] == nil)
    {
        [self noteLostTargetAndGoIdle];
        return;
    }
    [self trackPrimaryTarget:delta_t:NO]; // applies sticks
    if ([self hasProximityAlertIgnoringTarget:YES])
    {
        [self avoidCollision];
    }
    
}

References avoidCollision, nil, noteLostTargetAndGoIdle, primaryTarget, and trackPrimaryTarget:delta_t:.

Referenced by processBehaviour:.

Here is the call graph for this function:

Here is the caller graph for this function:

behaviour_tractored:

- (void) behaviour_tractored:

(double)

delta_t

Definition at line 4186 of file ShipEntity.m.

                            :(double) delta_t
{
    desired_range = collision_radius * 2.0;
    ShipEntity* hauler = (ShipEntity*)[self owner];
    if ((hauler)&&([hauler isShip]))
    {
        _destination = [hauler absoluteTractorPosition];
        double  distance = [self rangeToDestination];
        if (distance < desired_range)
        {
            [self performTumble];
            [self setStatus:STATUS_IN_FLIGHT];
            [hauler scoopUp:self];
            return;
        }
        GLfloat tf = TRACTOR_FORCE / mass;
        // adjust for difference in velocity (spring rule)
        Vector dv = vector_between([self velocity], [hauler velocity]);
        GLfloat moment = delta_t * 0.25 * tf;
        velocity.x += moment * dv.x;
        velocity.y += moment * dv.y;
        velocity.z += moment * dv.z;
        // acceleration = force / mass
        // force proportional to distance (spring rule)
        HPVector dp = HPvector_between(position, _destination);
        moment = delta_t * 0.5 * tf;
        velocity.x += moment * dp.x;
        velocity.y += moment * dp.y;
        velocity.z += moment * dp.z;
        // force inversely proportional to distance
        GLfloat d2 = HPmagnitude2(dp);
        moment = (d2 > 0.0)? delta_t * 5.0 * tf / d2 : 0.0;
        if (d2 > 0.0)
        {
            velocity.x += moment * dp.x;
            velocity.y += moment * dp.y;
            velocity.z += moment * dp.z;
        }
        //
        if ([self status] == STATUS_BEING_SCOOPED)
        {
            BOOL lost_contact = (distance > hauler->collision_radius + collision_radius + 250.0f);  // 250m range for tractor beam
            if ([hauler isPlayer])
            {
                switch ([(PlayerEntity*)hauler dialFuelScoopStatus])
                {
                    case SCOOP_STATUS_NOT_INSTALLED:
                    case SCOOP_STATUS_FULL_HOLD:
                        lost_contact = YES; // don't draw
                        break;
                        
                    case SCOOP_STATUS_OKAY:
                    case SCOOP_STATUS_ACTIVE:
                        break;
                }
            }
            
            if (lost_contact)   // 250m range for tractor beam
            {
                // escaped tractor beam
                [self setStatus:STATUS_IN_FLIGHT];
                behaviour = BEHAVIOUR_IDLE;
                [self setThrust:[self maxThrust]]; // restore old thrust.
                frustration = 0.0;
                [self setOwner:self];
                [shipAI exitStateMachineWithMessage:nil];   // exit nullAI.plist
                return;
            }
            else if ([hauler isPlayer])
            {
                [(PlayerEntity*)hauler setScoopsActive];
            }
        }
    }
 
// being tractored; sticks ignored - CIM
    flightYaw = 0.0;
    
    desired_speed = 0.0;
    thrust = 25.0;    // used to damp velocity (must be less than hauler thrust)
    
    thrust = 0.0; // must reset thrust now
}

References _destination, absoluteTractorPosition, behaviour, Entity::collision_radius, desired_range, desired_speed, AI::exitStateMachineWithMessage:, flightYaw, frustration, Entity::isPlayer, Entity::isShip, Entity::mass, maxThrust, Entity::owner, performTumble, Entity::position, rangeToDestination, SCOOP_STATUS_ACTIVE, SCOOP_STATUS_FULL_HOLD, SCOOP_STATUS_NOT_INSTALLED, SCOOP_STATUS_OKAY, scoopUp:, setOwner:, PlayerEntity::setScoopsActive, setStatus:, setThrust:, Entity::status, thrust, TRACTOR_FORCE, and velocity.

Referenced by processBehaviour:.

Here is the call graph for this function:

Here is the caller graph for this function:

behaviour_tumble:

- (void) behaviour_tumble:

(double)

delta_t

Definition at line 4178 of file ShipEntity.m.

                         :(double) delta_t
{
    [self applySticks:delta_t];
    
    
}

References applySticks:.

Referenced by processBehaviour:.

Here is the call graph for this function:

Here is the caller graph for this function:

bounty

- (OOCreditsQuantity) bounty

Reimplemented in PlayerEntity.

References availableCargoSpace, cargo, cargoListForScripting, cargoQuantityOnBoard, cargoType, commodityAmount, commodityType, int(), isTemplateCargoPod, legalStatus, and maxAvailableCargoSpace.

Here is the call graph for this function:

broadcastAIMessage:

- (void) broadcastAIMessage:

(NSString *)

ai_message

Definition at line 14186 of file ShipEntity.m.

                           :(NSString *) ai_message
{
    NSString *expandedMessage = OOExpand(ai_message);
 
    [self checkScanner];
    unsigned i;
    for (i = 0; i < n_scanned_ships ; i++)
    {
        ShipEntity* ship = scanned_ships[i];
        [[ship getAI] message: expandedMessage];
    }
}

References checkScanner, getAI, AI::message:, n_scanned_ships, OOExpand, and scanned_ships.

Referenced by dumpCargoItem:.

Here is the call graph for this function:

Here is the caller graph for this function:

broadcastDistressMessage

- (void) broadcastDistressMessage

Provided by category ShipEntity(AI).

Definition at line 763 of file ShipEntityAI.m.

{
    /*-- Locates all the stations, bounty hunters and police ships in range and tells them that you are under attack --*/
    [self broadcastDistressMessageWithDumping:YES];
}   

broadcastDistressMessageWithDumping:

- (void) broadcastDistressMessageWithDumping:

(BOOL)

dumpCargo

Provided by category ShipEntity(AI).

Definition at line 769 of file ShipEntityAI.m.

                                            :(BOOL)dumpCargo
{
    [self checkScannerIgnoringUnpowered];
    DESTROY(_foundTarget);
    
    ShipEntity  *aggressor_ship = (ShipEntity*)[self primaryAggressor];
    if (aggressor_ship == nil)  return;
    
    // don't send too many distress messages at once, space them out semi-randomly
    if (messageTime > 2.0 * randf())  return;
    
    NSString    *distress_message = nil;
    BOOL        is_buoy = (scanClass == CLASS_BUOY);
    if (is_buoy)  distress_message = @"[buoy-distress-call]";
    else  distress_message = @"[distress-call]";
    
    unsigned i;
    for (i = 0; i < n_scanned_ships; i++)
    {
        ShipEntity* ship = scanned_ships[i];
 
    // dump cargo if energy is low
        if (dumpCargo && !is_buoy && [self primaryAggressor] == ship && energy < 0.375 * maxEnergy)
        {
            [self ejectCargo];
            [self performFlee];
        }
        
        // tell it! (only plist AIs send comms here; JS AIs are
        // expected to handle their own)
        if (ship->isPlayer && ![self hasNewAI])
        {
            [ship doScriptEvent:OOJSID("distressMessageReceived") withArgument:aggressor_ship andArgument:self];
 
            if (!is_buoy && [self primaryAggressor] == ship && energy < 0.375 * maxEnergy)
            {
                [self sendExpandedMessage:@"[beg-for-mercy]" toShip:ship];
            }
            else if ([self bounty] == 0)
            {
                // only send distress message to player if plausibly sending
                // one more generally
                [self sendExpandedMessage:distress_message toShip:ship];
            }
            
            // reset the thanked_ship_id
            DESTROY(_thankedShip);
        }
        else if ([self bounty] == 0 && [ship crew]) // Only clean ships can have their distress calls accepted
        {
            [ship doScriptEvent:OOJSID("distressMessageReceived") withArgument:aggressor_ship andArgument:self];
            
            // we only can send distressMessages to ships that are known to have a "ACCEPT_DISTRESS_CALL" reaction
            // in their AI, or they might react wrong on the added found_target.
 
            // ship must have a plist AI for this next bit. JS AIs
            // should already have done something sensible on
            // distressMessageReceived
            if (![self hasNewAI])
            {
                // FIXME: this test only works with core AIs
                if (ship->isStation || [ship hasPrimaryRole:@"police"] || [ship hasPrimaryRole:@"hunter"])
                {
                    [ship acceptDistressMessageFrom:self];
                }
            }
        }
    }
}

Referenced by ShipEntity(AI)::broadcastDistressMessage.

Here is the caller graph for this function:

broadcastEnergyBlastImminent

- (void) broadcastEnergyBlastImminent

Definition at line 9484 of file ShipEntity.m.

{
    // anyone further away than typical scanner range probably doesn't need to hear
    NSArray* targets = [UNIVERSE entitiesWithinRange:SCANNER_MAX_RANGE ofEntity:self];
    if ([targets count] > 0)
    {
        unsigned i;
        for (i = 0; i < [targets count]; i++)
        {
            Entity *e2 = [targets objectAtIndex:i];
            if ([e2 isShip]) 
            {
                ShipEntity *se = (ShipEntity *)e2;
                [se setFoundTarget:self];
                [se reactToAIMessage:@"CASCADE_WEAPON_DETECTED" context:@"nearby Q-mine"];
                [se doScriptEvent:OOJSID("cascadeWeaponDetected") withArgument:self];
            }
        }
    }
}

References broadcastEnergyBlastImminent, count, doScriptEvent:withArgument:, Entity::isShip, reactToAIMessage:context:, and setFoundTarget:.

Referenced by becomeEnergyBlast, broadcastEnergyBlastImminent, and maxFlightSpeed.

Here is the call graph for this function:

Here is the caller graph for this function:

broadcastHitByLaserFrom:

- (void) broadcastHitByLaserFrom:

(ShipEntity*)

aggressor_ship

Definition at line 14095 of file ShipEntity.m.

                                :(ShipEntity *) aggressor_ship
{
    /*-- If you're clean, locates all police and stations in range and tells them OFFENCE_COMMITTED --*/
    if (!UNIVERSE)  return;
    if ([self bounty])  return;
    if (!aggressor_ship)  return;
    
    if (    (scanClass == CLASS_NEUTRAL)||
            (scanClass == CLASS_STATION)||
            (scanClass == CLASS_BUOY)||
            (scanClass == CLASS_POLICE)||
            (scanClass == CLASS_MILITARY)||
            (scanClass == CLASS_PLAYER))   // only for active ships...
    {
        NSArray         *authorities = nil;
        NSEnumerator    *authEnum = nil;
        ShipEntity      *auth = nil;
        
        authorities = [UNIVERSE findShipsMatchingPredicate:AuthorityPredicate
                                                 parameter:self
                                                   inRange:-1
                                                  ofEntity:nil];
        authEnum = [authorities objectEnumerator];
        while ((auth = [authEnum nextObject]))
        {
            [auth setFoundTarget:aggressor_ship];
            [auth doScriptEvent:OOJSID("offenceCommittedNearby") withArgument:aggressor_ship andArgument:self];
            [auth reactToAIMessage:@"OFFENCE_COMMITTED" context:@"combat update"];
        }
    }
}

References bounty, doScriptEvent:withArgument:andArgument:, nil, reactToAIMessage:context:, scanClass, setFoundTarget:, and UNIVERSE.

Referenced by PlayerEntity::takeEnergyDamage:from:becauseOf:weaponIdentifier:, and takeEnergyDamage:from:becauseOf:weaponIdentifier:.

Here is the call graph for this function:

Here is the caller graph for this function:

broadcastMessage:withUnpilotedOverride:

- (void) broadcastMessage:		(NSString *)	message_text
withUnpilotedOverride:		(BOOL)	unpilotedOverride

Definition at line 14200 of file ShipEntity.m.

                         :(NSString *) message_text withUnpilotedOverride:(BOOL) unpilotedOverride
{
    NSString *expandedMessage = OOExpand(message_text); // consistent with broadcast message.
 
 
    if (!crew && !unpilotedOverride)
        return; // nobody to send the signal and no override for unpiloted craft is set
 
    [self checkScanner];
    unsigned i;
    for (i = 0; i < n_scanned_ships ; i++)
    {
        ShipEntity* ship = scanned_ships[i];
        if (![ship isPlayer]) [ship receiveCommsMessage:expandedMessage from:self];
    }
    
    PlayerEntity *player = PLAYER; // make sure that the player always receives a message when in range
    // SCANNER_MAX_RANGE2 because it's the player's scanner range
    // which is important
    if (HPdistance2(position, [player position]) < SCANNER_MAX_RANGE2)
    {
        [self setCommsMessageColor];
        [player receiveCommsMessage:expandedMessage from:self];
        messageTime = 6.0;
        [UNIVERSE resetCommsLogColor];
    }
}

References checkScanner, crew, Entity::isPlayer, messageTime, n_scanned_ships, OOExpand, PLAYER, Entity::position, PlayerEntity::receiveCommsMessage:from:, receiveCommsMessage:from:, scanned_ships, SCANNER_MAX_RANGE2, and setCommsMessageColor.

Referenced by commsMessage:withUnpilotedOverride:.

Here is the call graph for this function:

Here is the caller graph for this function:

broadcastThargoidDestroyed

- (void) broadcastThargoidDestroyed

Definition at line 14063 of file ShipEntity.m.

{
    [[UNIVERSE findShipsMatchingPredicate:HasRolePredicate
                               parameter:@"tharglet"
                                 inRange:SCANNER_MAX_RANGE
                                ofEntity:self]
            makeObjectsPerformSelector:@selector(sendAIMessage:) withObject:@"THARGOID_DESTROYED"];
}

References broadcastThargoidDestroyed.

Referenced by becomeExplosion, broadcastThargoidDestroyed, and dockingInstructions.

Here is the call graph for this function:

Here is the caller graph for this function:

calculateTargetPosition

- (HPVector) calculateTargetPosition

Definition at line 6299 of file ShipEntity.m.

{
    Entity *target = [self primaryTarget];
    if (target == nil)
    {
        return kZeroHPVector;
    }
    if (reactionTime <= 0.0)
    {
        return [target position];
    }
    double t = [UNIVERSE getTime] - trackingCurveTimes[1];
    return HPvector_add(HPvector_add(trackingCurveCoeffs[0], HPvector_multiply_scalar(trackingCurveCoeffs[1],t)), HPvector_multiply_scalar(trackingCurveCoeffs[2],t*t));
}

References calculateTargetPosition, kZeroHPVector, nil, Entity::position, primaryTarget, reactionTime, trackingCurveCoeffs, and trackingCurveTimes.

Referenced by calculateTargetPosition, onTarget:withWeapon:, reactionTime, trackPrimaryTarget:delta_t:, and trackSideTarget:delta_t:.

Here is the call graph for this function:

Here is the caller graph for this function:

calculateTrackingCurve

- (void) calculateTrackingCurve

Definition at line 6363 of file ShipEntity.m.

{
    if (reactionTime <= 0.0)
    {
        trackingCurveCoeffs[0] = trackingCurvePositions[0];
        trackingCurveCoeffs[1] = kZeroHPVector;
        trackingCurveCoeffs[2] = kZeroHPVector;
        return;
    }
    double  t1 = trackingCurveTimes[2] - trackingCurveTimes[1],
        t2 = trackingCurveTimes[3] - trackingCurveTimes[1];
    trackingCurveCoeffs[0] = trackingCurvePositions[1];
    trackingCurveCoeffs[1] = HPvector_add(HPvector_add(
        HPvector_multiply_scalar(trackingCurvePositions[1], -(t1+t2)/(t1*t2)),
        HPvector_multiply_scalar(trackingCurvePositions[2], -t2/(t1*(t1-t2)))),
        HPvector_multiply_scalar(trackingCurvePositions[3], t1/(t2*(t1-t2))));
    trackingCurveCoeffs[2] = HPvector_add(HPvector_add(
        HPvector_multiply_scalar(trackingCurvePositions[1], 1/(t1*t2)),
        HPvector_multiply_scalar(trackingCurvePositions[2], 1/(t1*(t1-t2)))),
        HPvector_multiply_scalar(trackingCurvePositions[3], -1/(t2*(t1-t2))));
    return;
}

References calculateTrackingCurve, kZeroHPVector, reactionTime, trackingCurveCoeffs, trackingCurvePositions, and trackingCurveTimes.

Referenced by calculateTrackingCurve, reactionTime, startTrackingCurve, and updateTrackingCurve.

Here is the call graph for this function:

Here is the caller graph for this function:

canAcceptEscort:

- (BOOL) canAcceptEscort:

(ShipEntity *)

potentialEscort

Definition at line 13688 of file ShipEntity.m.

                        :(ShipEntity *)potentialEscort
{
    if (dockingInstructions) // we are busy with docking.
    {
        return NO;
    }
    if (scanClass != [potentialEscort scanClass]) // this makes sure that wingman can only select police, thargons only thargoids.
    {
        return NO;
    }
    if ([self bounty] == 0 && [potentialEscort bounty] != 0) // clean mothers can only accept clean escorts
    {
        return NO;
    }
    if (![self isEscort]) // self is NOT wingman or escort or thargon
    {
        return [potentialEscort isEscort]; // is wingman or escort or thargon
    }
    return NO;
}

References bounty, dockingInstructions, isEscort, and scanClass.

Here is the call graph for this function:

canAddEquipment:inContext:

- (BOOL) canAddEquipment:		(NSString *)	equipmentKey
inContext:		(NSString *)	context

Reimplemented in PlayerEntity.

Definition at line 3225 of file ShipEntity.m.

                        :(NSString *)equipmentKey inContext:(NSString *)context
{
    if ([equipmentKey hasSuffix:@"_DAMAGED"])
    {
        equipmentKey = [equipmentKey substringToIndex:[equipmentKey length] - [@"_DAMAGED" length]];
    }
    
    NSString * lcEquipmentKey = [equipmentKey lowercaseString];
    if ([equipmentKey hasSuffix:@"MISSILE"]||[equipmentKey hasSuffix:@"MINE"]||([self isThargoid] && ([lcEquipmentKey hasPrefix:@"thargon"] || [lcEquipmentKey hasSuffix:@"thargon"])))
    {
        if (missiles >= max_missiles) return NO;
    }
    
    OOEquipmentType *eqType = [OOEquipmentType equipmentTypeWithIdentifier:equipmentKey];
    
    if (![eqType canCarryMultiple] && [self hasEquipmentItem:equipmentKey])  return NO;
    if (![self equipmentValidToAdd:equipmentKey inContext:context])  return NO;
    
    return YES;
}

References OOEquipmentType::equipmentTypeWithIdentifier:, isThargoid, max_missiles, and missiles.

Referenced by ShipCanAwardEquipment().

Here is the call graph for this function:

Here is the caller graph for this function:

canCollide

- (BOOL) canCollide

implementation

Reimplemented from Entity.

Reimplemented in PlayerEntity.

Definition at line 2071 of file ShipEntity.m.

{
    int status = [self status];
    if (status == STATUS_COCKPIT_DISPLAY || status == STATUS_DEAD || status == STATUS_BEING_SCOOPED)
    {   
        return NO;
    }
 
    if (isWreckage)
    {
        // wreckage won't collide
        return NO;
    }
    
    if (isMissile && [self shotTime] < 0.25) // not yet fused
    {
        return NO;
    }
    
    return YES;
}

References canCollide, isMissile, isWreckage, shotTime, and Entity::status.

Referenced by canCollide, and doOctreesCollide.

Here is the call graph for this function:

Here is the caller graph for this function:

canScoop:

- (BOOL) canScoop:

(ShipEntity *)

other

Reimplemented in PlayerEntity.

Definition at line 12861 of file ShipEntity.m.

                 :(ShipEntity*)other
{
    if (other == nil)                            return NO;
    if (![self hasCargoScoop])                     return NO;
    if ([cargo count] >= [self maxAvailableCargoSpace]) return NO;
    if (scanClass == CLASS_CARGO)              return NO;  // we have no power so we can't scoop
    if ([other scanClass] != CLASS_CARGO)      return NO;
    if ([other cargoType] == CARGO_NOT_CARGO)   return NO;
    
    if ([other isStation])                     return NO;
 
    HPVector  loc = HPvector_between(position, [other position]);
    
    if (dot_product(v_forward, HPVectorToVector(loc)) < 0.0f)      return NO;  // Must be in front of us
    if ([self isPlayer] && dot_product(v_up, HPVectorToVector(loc)) > 0.0f)  return NO;  // player has to scoop on underside, give more flexibility to NPCs
    
    return YES;
}

References cargo, CARGO_NOT_CARGO, cargoType, count, hasCargoScoop, Entity::isPlayer, Entity::isStation, maxAvailableCargoSpace, nil, Entity::position, scanClass, v_forward, and v_up.

Referenced by PlayerEntity::canScoop:.

Here is the call graph for this function:

Here is the caller graph for this function:

canStillTrackPrimaryTarget

- (BOOL) canStillTrackPrimaryTarget

Definition at line 10095 of file ShipEntity.m.

{
    Entity *target = (Entity *)[self primaryTargetWithoutValidityCheck];
    if (target == nil)
    {
        return NO;
    }
    if (![self isValidTarget:target])
    {
        return NO;
    }
    double range2 = HPmagnitude2(HPvector_subtract([target position], position));
    if (range2 > scannerRange * scannerRange * 1.5625) 
    {
        // 1.5625 = 1.25*1.25
        return NO;
    }
    // 1.81: can retain cloaked ships as a *primary* target now
/*  if ([target isShip] && [(ShipEntity*)target isCloaked])
    {
        return NO;
        } */
    return YES;
}

References canStillTrackPrimaryTarget, nil, Entity::position, primaryTargetWithoutValidityCheck, and scannerRange.

Referenced by behaviour_attack_break_off_target:, behaviour_attack_broadside:, behaviour_attack_broadside_target:leftside:, behaviour_attack_fly_to_target:, behaviour_attack_mining_target:, behaviour_attack_slow_dogfight:, behaviour_attack_sniper:, behaviour_close_to_broadside_range:, behaviour_close_with_target:, behaviour_fly_to_target_six:, behaviour_running_defense:, canStillTrackPrimaryTarget, maxFlightSpeed, trackPrimaryTarget:delta_t:, and trackSideTarget:delta_t:.

Here is the call graph for this function:

Here is the caller graph for this function:

cargo

- (NSMutableArray *) cargo

References cargoFlag, contractListForScripting, cruiseSpeed, desiredRange, desiredSpeed, equipmentListForScripting, missilesList, parcelListForScripting, passengerListForScripting, and showScoopMessage.

Here is the call graph for this function:

cargoFlag

- (OOCargoFlag) cargoFlag

Definition at line 8511 of file ShipEntity.m.

{
    return cargo_flag;
}

References cargo_flag, and cargoFlag.

Referenced by cargo, and cargoFlag.

Here is the call graph for this function:

Here is the caller graph for this function:

cargoListForScripting

- (NSArray *) cargoListForScripting

Reimplemented in PlayerEntity.

Definition at line 8411 of file ShipEntity.m.

{
    NSMutableArray      *list = [NSMutableArray array];
    
    OOCommodityType      good = nil;
    NSArray             *goods = [[UNIVERSE commodityMarket] goods];
    NSUInteger          i, j, commodityCount = [goods count];
    OOCargoQuantity      quantityInHold[commodityCount];
 
    for (i = 0; i < commodityCount; i++)
    {
        quantityInHold[i] = 0;
    }
    for (i = 0; i < [cargo count]; i++)
    {
        ShipEntity *container = [cargo objectAtIndex:i];
        j = [goods indexOfObject:[container commodityType]];
        quantityInHold[j] += [container commodityAmount];
    }
    
    for (i = 0; i < commodityCount; i++)
    {
        if (quantityInHold[i] > 0)
        {
            NSMutableDictionary *commodity = [NSMutableDictionary dictionaryWithCapacity:4];
            good = [goods objectAtIndex:i];
            // commodity, quantity - keep consistency between .manifest and .contracts
            [commodity setObject:good forKey:@"commodity"];
            [commodity setObject:[NSNumber numberWithUnsignedInt:quantityInHold[i]] forKey:@"quantity"];
            [commodity setObject:[[UNIVERSE commodityMarket] nameForGood:good] forKey:@"displayName"]; 
            [commodity setObject:DisplayStringForMassUnitForCommodity(good) forKey:@"unit"]; 
            [list addObject:commodity];
        }
    }
 
    return [[list copy] autorelease];   // return an immutable copy
}

References cargoListForScripting, commodityAmount, commodityType, and nil.

Referenced by bounty, cargoListForScripting, and ShipGetProperty().

Here is the call graph for this function:

Here is the caller graph for this function:

cargoQuantityOnBoard

- (OOCargoQuantity) cargoQuantityOnBoard

Reimplemented in PlayerEntity.

Definition at line 8388 of file ShipEntity.m.

{
    NSUInteger result = [[self cargo] count];
    NSAssert(result < UINT32_MAX, @"Cargo quantity out of bounds.");
    return (OOCargoQuantity)result;
}

References cargo, and cargoQuantityOnBoard.

Referenced by availableCargoSpace, bounty, and cargoQuantityOnBoard.

Here is the call graph for this function:

Here is the caller graph for this function:

cargoType

- (OOCargoType) cargoType

Definition at line 8397 of file ShipEntity.m.

{
    return cargo_type;
}

References cargo_type, and cargoType.

Referenced by behaviour_intercept_target:, bounty, canScoop:, cargoType, dumpItem:, and scoopUpProcess:processEvents:processMessages:.

Here is the call graph for this function:

Here is the caller graph for this function:

cascadeIfAppropriateWithDamageAmount:cascadeOwner:

- (BOOL) cascadeIfAppropriateWithDamageAmount:		(double)	amount
cascadeOwner:		(Entity *)	owner

Definition at line 13085 of file ShipEntity.m.

                                             :(double)amount cascadeOwner:(Entity *)owner
{
    BOOL cascade = NO;
    switch ([self scanClass])
    {
        case CLASS_WORMHOLE:
        case CLASS_ROCK:
        case CLASS_CARGO:
        case CLASS_VISUAL_EFFECT:
        case CLASS_BUOY:
            // does not normally cascade
            if ((fuel > MIN_FUEL) || isStation) 
            {
                //we have fuel onboard so we can still go pop, or we are a station which can
            }
            else break;
            
        case CLASS_STATION:
        case CLASS_MINE:
        case CLASS_PLAYER:
        case CLASS_POLICE:
        case CLASS_MILITARY:
        case CLASS_THARGOID:
        case CLASS_MISSILE:
        case CLASS_NOT_SET:
        case CLASS_NO_DRAW:
        case CLASS_NEUTRAL:
        case CLASS_TARGET:
            // ...start a chain reaction, if we're dying and have a non-trivial amount of energy.
            if (energy < amount && energy > 10 && [self countsAsKill])
            {
                cascade = YES;  // confirm we're cascading, then try to add our cascade to UNIVERSE.
                [UNIVERSE addEntity:[OOQuiriumCascadeEntity quiriumCascadeFromShip:self]];
            }
            break;
            //no default thanks, we want the compiler to tell us if we missed a case.
    }
    return cascade;
}

References countsAsKill, fuel, Entity::isStation, MIN_FUEL, OOQuiriumCascadeEntity::quiriumCascadeFromShip:, and scanClass.

Referenced by PlayerEntity::takeEnergyDamage:from:becauseOf:weaponIdentifier:, and takeEnergyDamage:from:becauseOf:weaponIdentifier:.

Here is the call graph for this function:

Here is the caller graph for this function:

checkAegis

- (void) checkAegis

implementation

Provided by category ShipEntity(PureAI).

Definition at line 1466 of file ShipEntityAI.m.

{
    switch (aegis_status)
    {
        case AEGIS_CLOSE_TO_MAIN_PLANET: 
            [shipAI message:@"AEGIS_CLOSE_TO_MAIN_PLANET"];
            // It's been a few years since 1.71 - it should be safe enough to comment out the line below for 1.77/1.78 -- Kaks 20120917
            //[shipAI message:@"AEGIS_CLOSE_TO_PLANET"];         // fires only for main planets, kept for compatibility with pre-1.72 AI plists.
            return;
        case AEGIS_CLOSE_TO_ANY_PLANET:
        {
            Entity<OOStellarBody> *nearest = [self findNearestStellarBody];
            
            if([nearest isSun])
            {
                [shipAI message:@"CLOSE_TO_SUN"];
            }
            else
            {
                [shipAI message:@"CLOSE_TO_PLANET"];
                if ([nearest planetType] == STELLAR_TYPE_MOON)
                {
                    [shipAI message:@"CLOSE_TO_MOON"];
                }
                else
                {
                    [shipAI message:@"CLOSE_TO_SECONDARY_PLANET"];
                }
            }
            return;
        }
        case AEGIS_IN_DOCKING_RANGE:
            [shipAI message:@"AEGIS_IN_DOCKING_RANGE"];
            return;
        case AEGIS_NONE:
            [shipAI message:@"AEGIS_NONE"];
            return;
    }
    
    NSLog(@"Aegis status for %@ has taken on invalid value %i. This is an internal error, please report it.", self, aegis_status);
    aegis_status = AEGIS_NONE;
    [shipAI message:@"AEGIS_NONE"];
}

checkCloseCollisionWith:

- (BOOL) checkCloseCollisionWith: (Entity *) other

implementation

Reimplemented from Entity.

Definition at line 2169 of file ShipEntity.m.

                                :(Entity *)other
{
    if (other == nil)  return NO;
    if ([collidingEntities containsObject:other])  return NO;  // we know about this already!
    
    ShipEntity *otherShip = nil;
    if ([other isShip])  otherShip = (ShipEntity *)other;
    
    if ([self canScoop:otherShip])  return YES; // quick test - could this improve scooping for small ships? I think so!
    
    if (otherShip != nil && trackCloseContacts)
    {
        // in update we check if close contacts have gone out of touch range (origin within our collision_radius)
        // here we check if something has come within that range
        HPVector            otherPos = [otherShip position];
        OOUniversalID  otherID = [otherShip universalID];
        NSString        *other_key = [NSString stringWithFormat:@"%d", otherID];
        
        if (![closeContactsInfo objectForKey:other_key] &&
            HPdistance2(position, otherPos) < collision_radius * collision_radius)
        {
            // calculate position with respect to our own position and orientation
            Vector  dpos = HPVectorToVector(HPvector_between(position, otherPos));
            Vector  rpos = make_vector(dot_product(dpos, v_right), dot_product(dpos, v_up), dot_product(dpos, v_forward));
            [closeContactsInfo setObject:[NSString stringWithFormat:@"%f %f %f", rpos.x, rpos.y, rpos.z] forKey: other_key];
            
            // send AI a message about the touch
            OOWeakReference *temp = _primaryTarget;
            _primaryTarget = [otherShip weakRetain];
            [self doScriptEvent:OOJSID("shipCloseContact") withArgument:otherShip andReactToAIMessage:@"CLOSE CONTACT"];
            _primaryTarget = temp;
        }
    }
    
    /* This does not appear to save a significant amount of time in
     * most situations. No significant change in frame rate with a
     * 350-segment planetary ring at 1400 collision candidates, even
     * on old hardware. There are perhaps situations in which it could
     * be a significant optimisation, but those are likely to also be
     * the situations where the effect of adding hundreds of extra
     * false-positive collisions leaves the player returning to a
     * mess... So, commented out: CIM 21 Jan 2014
    if (zero_distance > CLOSE_COLLISION_CHECK_MAX_RANGE2)   // don't work too hard on entities that are far from the player
    return YES; 
    */
    
    if (otherShip != nil)
    {
        // check hull octree versus other hull octree
        collider = doOctreesCollide(self, otherShip);
        return (collider != nil);
    }
    
    // default at this stage is to say YES they've collided!
    collider = other;
    return YES;
}

References _primaryTarget, closeContactsInfo, Entity::collider, Entity::collidingEntities, Entity::collision_radius, doOctreesCollide(), doScriptEvent:withArgument:andReactToAIMessage:, Entity::isShip, nil, Entity::position, trackCloseContacts, Entity::universalID, v_forward, v_right, v_up, and OOWeakRefObject::weakRetain.

Referenced by CollisionRegion::findCollisions.

Here is the call graph for this function:

Here is the caller graph for this function:

checkCourseToDestination

- (void) checkCourseToDestination

implementation

Provided by category ShipEntity(PureAI).

Definition at line 1447 of file ShipEntityAI.m.

{
    Entity *hazard = [UNIVERSE hazardOnRouteFromEntity: self toDistance: desired_range fromPoint: _destination];
    
    if (hazard == nil || ([hazard isShip] && HPdistance(position, [hazard position]) > scannerRange) || ([hazard isPlanet] && aegis_status == AEGIS_NONE)) 
        [shipAI message:@"COURSE_OK"]; // Avoid going into a waypoint.plist for far away objects, it cripples the main AI a bit in its funtionality.
    else
    {
        if ([hazard isShip] && (weapon_damage * 24.0 > [hazard energy]))
        {
            [shipAI reactToMessage:@"HAZARD_CAN_BE_DESTROYED" context:@"checkCourseToDestination"];
        }
        
        _destination = [UNIVERSE getSafeVectorFromEntity:self toDistance:desired_range fromPoint:_destination];
        [shipAI message:@"WAYPOINT_SET"];
    }
}

checkDistanceTravelled

- (void) checkDistanceTravelled

implementation

Provided by category ShipEntity(PureAI).

Definition at line 1777 of file ShipEntityAI.m.

{
    if (distanceTravelled > desired_range)
        [shipAI message:@"GONE_BEYOND_RANGE"];
}

checkEnergy

- (void) checkEnergy

implementation

Provided by category ShipEntity(PureAI).

Definition at line 1511 of file ShipEntityAI.m.

{
    if (energy == maxEnergy)
    {
        [shipAI message:@"ENERGY_FULL"];
        return;
    }
    if (energy >= maxEnergy * 0.75)
    {
        [shipAI message:@"ENERGY_HIGH"];
        return;
    }
    if (energy <= maxEnergy * 0.25)
    {
        [shipAI message:@"ENERGY_LOW"];
        return;
    }
    [shipAI message:@"ENERGY_MEDIUM"];
}

checkForAegis

- (OOAegisStatus) checkForAegis

Definition at line 7711 of file ShipEntity.m.

{
    Entity<OOStellarBody>   *nearest = [self findNearestStellarBody];
    BOOL                    sunGoneNova = [[UNIVERSE sun] goneNova];
    
    if (nearest == nil)
    {
        if (aegis_status != AEGIS_NONE)
        {
            // Planet disappeared!
            [self transitionToAegisNone];
        }
        return AEGIS_NONE;
    }
    // check planet
    float           cr = [nearest radius];
    float           cr2 = cr * cr;
    OOAegisStatus  result = AEGIS_NONE;
    float           d2 = HPmagnitude2(HPvector_subtract([nearest position], [self position]));
    // not scannerRange: aegis shouldn't depend on that
    float       sd2 = SCANNER_MAX_RANGE2 * 10.0f;
 
    // check if nearing a surface
    unsigned wasNearPlanetSurface = isNearPlanetSurface; // isNearPlanetSurface is a bit flag, not an actual BOOL
    isNearPlanetSurface = (d2 - cr2) < (250000.0f + 1000.0f * cr); //less than 500m from the surface: (a+b)*(a+b) = a*a+b*b +2*a*b
 
 
    if (EXPECT_NOT((wasNearPlanetSurface != isNearPlanetSurface) && !suppressAegisMessages))
    {
        if (isNearPlanetSurface)
        {
            [self doScriptEvent:OOJSID("shipApproachingPlanetSurface") withArgument:nearest];
            [shipAI reactToMessage:@"APPROACHING_SURFACE" context:@"flight update"];
        }
        else
        {
            [self doScriptEvent:OOJSID("shipLeavingPlanetSurface") withArgument:nearest];
            [shipAI reactToMessage:@"LEAVING_SURFACE" context:@"flight update"];
        }
    }
    
    // being close to the station takes precedence over planets
    StationEntity   *the_station = [UNIVERSE station];
    if (the_station)
    {
        sd2 = HPmagnitude2(HPvector_subtract([the_station position], [self position]));
    }
    // again, notional scanner range is intentional
    if (sd2 < SCANNER_MAX_RANGE2 * 4.0f) // double scanner range
    {
        result = AEGIS_IN_DOCKING_RANGE;
    }
    else if (EXPECT_NOT(isNearPlanetSurface || d2 < cr2 * 9.0f)) // to 3x radius of any planet/moon - or 500m of tiny ones,
    {
        result = AEGIS_CLOSE_TO_ANY_PLANET;
        if (EXPECT((OOPlanetEntity *)nearest == [UNIVERSE planet]))
        {
            result = AEGIS_CLOSE_TO_MAIN_PLANET;
        }
    }
    // need to do this check separately from above case to avoid oddity where
    // main planet and small moon are at just the wrong distance. - CIM
    if (result != AEGIS_CLOSE_TO_MAIN_PLANET && result != AEGIS_IN_DOCKING_RANGE && !sunGoneNova)
    {
        // are we also close to the main planet?
        OOPlanetEntity *mainPlanet = [UNIVERSE planet];
        d2 = HPmagnitude2(HPvector_subtract([mainPlanet position], [self position]));
        cr2 = [mainPlanet radius];
        cr2 *= cr2; 
        if (d2 < cr2 * 9.0f)
        {
            nearest = mainPlanet;
            result = AEGIS_CLOSE_TO_MAIN_PLANET;
        }
    }
 
 
    /*  Rewrote aegis stuff and tested it against redux.oxp that adds multiple planets and moons.
        Made sure AI scripts can differentiate between MAIN and NON-MAIN planets so they can decide
        if they can dock at the systemStation or just any station.
        Added sun detection so route2Patrol can turn before they heat up in the sun.
        -- Eric 2009-07-11
        
        More rewriting of the aegis stuff, it's now a bit faster and works properly when moving
        from one secondary planet/moon vicinity to another one.  -- Kaks 20120917
    */
    if (EXPECT(!suppressAegisMessages))
    {
        // script/AI messages on change in status
        if (EXPECT_NOT(aegis_status == AEGIS_IN_DOCKING_RANGE && result != aegis_status))
        {
            [self doScriptEvent:OOJSID("shipExitedStationAegis") withArgument:the_station];
            [shipAI message:@"AEGIS_LEAVING_DOCKING_RANGE"];
        }
        
        if (EXPECT_NOT(result == AEGIS_IN_DOCKING_RANGE && aegis_status != result))
        {
            [self doScriptEvent:OOJSID("shipEnteredStationAegis") withArgument:the_station];
            [shipAI message:@"AEGIS_IN_DOCKING_RANGE"];
            
            if([self lastAegisLock] == nil && !sunGoneNova) // With small main planets the station aegis can come before planet aegis
            {
                [self doScriptEvent:OOJSID("shipEnteredPlanetaryVicinity") withArgument:[UNIVERSE planet]];
                [self setLastAegisLock:[UNIVERSE planet]];
            }
        }
        else if (EXPECT_NOT(result == AEGIS_NONE && aegis_status != result))
        {
            if([self lastAegisLock] == nil && !sunGoneNova)
            {
                [self setLastAegisLock:[UNIVERSE planet]];  // in case of a first launch from a near-planet station.
            }
            [self transitionToAegisNone];
        }
        // approaching..
        else if (EXPECT_NOT((result == AEGIS_CLOSE_TO_ANY_PLANET || result == AEGIS_CLOSE_TO_MAIN_PLANET) && [self lastAegisLock] != nearest))
        {
            if(aegis_status != AEGIS_NONE && [self lastAegisLock] != nil) // we were close to another stellar body
            {
                [self doScriptEvent:OOJSID("shipExitedPlanetaryVicinity") withArgument:[self lastAegisLock]];
                [shipAI message:@"AWAY_FROM_PLANET"];   // fires for suns, planets and moons.
            }
            [self doScriptEvent:OOJSID("shipEnteredPlanetaryVicinity") withArgument:nearest];
            [self setLastAegisLock:nearest];
            
            if (EXPECT_NOT([nearest isSun]))
            {
                [shipAI message:@"CLOSE_TO_SUN"];
            }
            else
            {
                [shipAI message:@"CLOSE_TO_PLANET"];
                
                if (EXPECT(result == AEGIS_CLOSE_TO_MAIN_PLANET))
                {
                    // It's been years since 1.71 - it should be safe enough to comment out the line below for 1.77/1.78 -- Kaks 20120917
                    //[shipAI message:@"AEGIS_CLOSE_TO_PLANET"];        // fires only for main planets, kept for compatibility with pre-1.72 AI plists.
                    [shipAI message:@"AEGIS_CLOSE_TO_MAIN_PLANET"];  // fires only for main planet.
                }
                else if (EXPECT_NOT([nearest planetType] == STELLAR_TYPE_MOON))
                {
                    [shipAI message:@"CLOSE_TO_MOON"];
                }
                else
                {
                    [shipAI message:@"CLOSE_TO_SECONDARY_PLANET"];
                }
            }
        }
        
 
    }
    if (result == AEGIS_NONE)
    {
        [self setLastAegisLock:nil];
    }
 
    aegis_status = result;  // put this here
    return result;
}

References AEGIS_CLOSE_TO_ANY_PLANET, AEGIS_CLOSE_TO_MAIN_PLANET, AEGIS_IN_DOCKING_RANGE, AEGIS_NONE, aegis_status, checkForAegis, doScriptEvent:withArgument:, EXPECT, EXPECT_NOT, findNearestStellarBody, isNearPlanetSurface, Entity::isSun, lastAegisLock, AI::message:, nil, Entity::position, AI::reactToMessage:context:, SCANNER_MAX_RANGE2, setLastAegisLock:, STELLAR_TYPE_MOON, suppressAegisMessages, transitionToAegisNone, and UNIVERSE.

Referenced by checkForAegis, PlayerEntity::leaveDock:, reportAIMessages, PlayerEntity::setNextCompassMode, PlayerEntity::setPrevCompassMode, update:, and PlayerEntity::validateCompassTarget.

Here is the call graph for this function:

Here is the caller graph for this function:

checkForFullHold

- (void) checkForFullHold

implementation

Provided by category ShipEntity(PureAI).

Definition at line 1167 of file ShipEntityAI.m.

{
    if (!max_cargo)
    {
        [shipAI message:@"NO_CARGO_BAY"];
    }
    else if ([cargo count] >= [self maxAvailableCargoSpace])
    {
        [shipAI message:@"HOLD_FULL"];
    }
    else
    {
        [shipAI message:@"HOLD_NOT_FULL"];
    }
}

checkForMotherStation

- (void) checkForMotherStation

implementation

Provided by category ShipEntity(PureAI).

Definition at line 2066 of file ShipEntityAI.m.

{
    ShipEntity *motherStation = [[self group] leader];
    if ((!motherStation) || (!(motherStation->isStation)))
    {
        [shipAI message:@"NOTHING_FOUND"];
        return;
    }
    double found_d2 = scannerRange * scannerRange;
    HPVector v0 = motherStation->position;
    if (HPdistance2(v0,position) > found_d2)
    {
        [shipAI message:@"NOTHING_FOUND"];
        return;
    }
    [shipAI message:@"STATION_FOUND"];      
}

checkForNormalSpace

- (void) checkForNormalSpace

implementation

Provided by category ShipEntity(PureAI).

Definition at line 2481 of file ShipEntityAI.m.

{
    if ([UNIVERSE sun] && [UNIVERSE planet])
        [shipAI message:@"NORMAL_SPACE"];
    else
        [shipAI message:@"INTERSTELLAR_SPACE"];
}

checkFoundTarget

- (void) checkFoundTarget

implementation

Provided by category ShipEntity(OOAIPrivate).

Definition at line 2745 of file ShipEntityAI.m.

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

Referenced by ShipEntity(PureAI)::requestNewTarget, ShipEntity(AI)::scanForHostiles, ShipEntity(PureAI)::scanForLoot, ShipEntity(PureAI)::scanForNearestMerchantman, ShipEntity(OOAIPrivate)::scanForNearestShipWithPredicate:parameter:, ShipEntity(PureAI)::scanForNonThargoid, ShipEntity(PureAI)::scanForOffenders, and ShipEntity(PureAI)::scanForRocks.

Here is the caller graph for this function:

checkGroupOddsVersusTarget

- (void) checkGroupOddsVersusTarget

implementation

Provided by category ShipEntity(PureAI).

Definition at line 1859 of file ShipEntityAI.m.

{
    NSUInteger ownGroupCount = [[self group] count] + (ranrot_rand() & 3);           // add a random fudge factor
    NSUInteger targetGroupCount = [[[self primaryTarget] group] count] + (ranrot_rand() & 3);    // add a random fudge factor
    
    if (ownGroupCount == targetGroupCount)
    {
        [shipAI message:@"ODDS_LEVEL"];
    }
    else if (ownGroupCount > targetGroupCount)
    {
        [shipAI message:@"ODDS_GOOD"];
    }
    else
    {
        [shipAI message:@"ODDS_BAD"];
    }
}

checkHeatInsulation

- (void) checkHeatInsulation

implementation

Provided by category ShipEntity(PureAI).

Definition at line 1531 of file ShipEntityAI.m.

{
    float minInsulation = 1000 / [self maxFlightSpeed] + 1;
    
    if ([self heatInsulation] < minInsulation)
    {
        [shipAI message:@"INSULATION_POOR"];
        return;
    }
    [shipAI message:@"INSULATION_OK"];
}

checkOwnLegalStatus

- (void) checkOwnLegalStatus

implementation

Provided by category ShipEntity(PureAI).

Definition at line 1391 of file ShipEntityAI.m.

{
    if (scanClass == CLASS_THARGOID)
    {
        [shipAI message:@"SELF_THARGOID"];
        return;
    }
    int ls = [self legalStatus];
    if (ls > 50)
    {
        [shipAI message:@"SELF_FUGITIVE"];
        return;
    }
    if (ls > 20)
    {
        [shipAI message:@"SELF_OFFENDER"];
        return;
    }
    if (ls > 0)
    {
        [shipAI message:@"SELF_MINOR_OFFENDER"];
        return;
    }
    [shipAI message:@"SELF_CLEAN"];
}

checkScanner

- (void) checkScanner

Definition at line 9819 of file ShipEntity.m.

{
    Entity* scan;
    n_scanned_ships = 0;
    //
    scan = z_previous;    while ((scan)&&(scan->isShip == NO))  scan = scan->z_previous;  // skip non-ships
    GLfloat scannerRange2 = scannerRange * scannerRange;
    while ((scan)&&(scan->position.z > position.z - scannerRange)&&(n_scanned_ships < MAX_SCAN_NUMBER))
    {
        // can't scan cloaked ships
        if (scan->isShip && ![(ShipEntity*)scan isCloaked] && [self isValidTarget:scan])
        {
            distance2_scanned_ships[n_scanned_ships] = HPdistance2(position, scan->position);
            if (distance2_scanned_ships[n_scanned_ships] < scannerRange2)
                scanned_ships[n_scanned_ships++] = (ShipEntity*)scan;
        }
        scan = scan->z_previous;    while ((scan)&&(scan->isShip == NO))    scan = scan->z_previous;
    }
    //
    scan = z_next;    while ((scan)&&(scan->isShip == NO))    scan = scan->z_next;    // skip non-ships
    while ((scan)&&(scan->position.z < position.z + scannerRange)&&(n_scanned_ships < MAX_SCAN_NUMBER))
    {
        if (scan->isShip && ![(ShipEntity*)scan isCloaked] && [self isValidTarget:scan])
        {
            distance2_scanned_ships[n_scanned_ships] = HPdistance2(position, scan->position);
            if (distance2_scanned_ships[n_scanned_ships] < scannerRange2)
                scanned_ships[n_scanned_ships++] = (ShipEntity*)scan;
        }
        scan = scan->z_next;    while ((scan)&&(scan->isShip == NO))    scan = scan->z_next;    // skip non-ships
    }
    //
    scanned_ships[n_scanned_ships] = nil;   // terminate array
}

References checkScanner, distance2_scanned_ships, isCloaked, Entity::isShip, MAX_SCAN_NUMBER, n_scanned_ships, nil, Entity::position, scanned_ships, scannerRange, Entity::z_next, and Entity::z_previous.

Referenced by broadcastAIMessage:, broadcastMessage:withUnpilotedOverride:, checkScanner, ShipEntity(PureAI)::findNewDefenseTarget, maxFlightSpeed, ShipEntity(PureAI)::requestNewTarget, ShipEntity(AI)::scanForHostiles, ShipEntity(PureAI)::scanForLoot, ShipEntity(OOAIPrivate)::scanForNearestShipWithPredicate:parameter:, ShipEntity(PureAI)::scanForNonThargoid, ShipEntity(PureAI)::scanForOffenders, ShipEntity(PureAI)::scanForRandomLoot, and ShipEntity(PureAI)::scanForRocks.

Here is the call graph for this function:

Here is the caller graph for this function:

checkScannerIgnoringUnpowered

- (void) checkScannerIgnoringUnpowered

Definition at line 9854 of file ShipEntity.m.

{
    Entity* scan;
    n_scanned_ships = 0;
    //
    GLfloat scannerRange2 = scannerRange * scannerRange;
    scan = z_previous;    
    while ((scan)&&((scan->isShip == NO)||(scan->scanClass==CLASS_ROCK)||(scan->scanClass==CLASS_CARGO)))   
    {
        scan = scan->z_previous;  // skip non-ships
    }
    while ((scan)&&(scan->position.z > position.z - scannerRange)&&(n_scanned_ships < MAX_SCAN_NUMBER))
    {
        if (scan->isShip && ![(ShipEntity*)scan isCloaked])
        {
            distance2_scanned_ships[n_scanned_ships] = HPdistance2(position, scan->position);
            if (distance2_scanned_ships[n_scanned_ships] < scannerRange2)
                scanned_ships[n_scanned_ships++] = (ShipEntity*)scan;
        }
        scan = scan->z_previous;
        while ((scan)&&((scan->isShip == NO)||(scan->scanClass==CLASS_ROCK)||(scan->scanClass==CLASS_CARGO)))   
        {
            scan = scan->z_previous;  // skip non-ships
        }
    }
    //
    scan = z_next;    
    while ((scan)&&((scan->isShip == NO)||(scan->scanClass==CLASS_ROCK)||(scan->scanClass==CLASS_CARGO)))   
    {
        scan = scan->z_next;  // skip non-ships
    }
 
    while ((scan)&&(scan->position.z < position.z + scannerRange)&&(n_scanned_ships < MAX_SCAN_NUMBER))
    {
        if (scan->isShip && ![(ShipEntity*)scan isCloaked])
        {
            distance2_scanned_ships[n_scanned_ships] = HPdistance2(position, scan->position);
            if (distance2_scanned_ships[n_scanned_ships] < scannerRange2)
                scanned_ships[n_scanned_ships++] = (ShipEntity*)scan;
        }
        scan = scan->z_next;
        while ((scan)&&((scan->isShip == NO)||(scan->scanClass==CLASS_ROCK)||(scan->scanClass==CLASS_CARGO)))   
        {
            scan = scan->z_next;  // skip non-ships
        }
    }
    //
    scanned_ships[n_scanned_ships] = nil;   // terminate array
}

References checkScannerIgnoringUnpowered, distance2_scanned_ships, isCloaked, Entity::isShip, MAX_SCAN_NUMBER, n_scanned_ships, nil, Entity::position, Entity::scanClass, scanned_ships, scannerRange, Entity::z_next, and Entity::z_previous.

Referenced by ShipEntity(AI)::broadcastDistressMessageWithDumping:, checkScannerIgnoringUnpowered, dumpCargoItem:, ShipEntity(PureAI)::fightOrFleeMissile, getTractoredBy:, maxFlightSpeed, ShipEntity(PureAI)::scanForFormationLeader, ShipEntity(PureAI)::scanForNearestMerchantman, ShipEntity(PureAI)::scanForRandomMerchantman, and scoopUpProcess:processEvents:processMessages:.

Here is the call graph for this function:

Here is the caller graph for this function:

checkShipsInVicinityForWitchJumpExit

- (int) checkShipsInVicinityForWitchJumpExit

Definition at line 14343 of file ShipEntity.m.

{
    // checks if there are any large masses close by
    // since we want to place the space station at least 10km away
    // the formula we'll use is K x m / d2 < 1.0
    // (m = mass, d2 = distance squared)
    // coriolis station is mass 455,223,200
    // 10km is 10,000m,
    // 10km squared is 100,000,000
    // therefore K is 0.22 (approx)
 
    int result = NO_TARGET;
 
    GLfloat k = 0.1;
 
    int         ent_count =     UNIVERSE->n_entities;
    Entity**    uni_entities =  UNIVERSE->sortedEntities;   // grab the public sorted list
    ShipEntity* my_entities[ent_count];
    int i;
 
    int ship_count = 0;
    for (i = 0; i < ent_count; i++)
        if ((uni_entities[i]->isShip)&&(uni_entities[i] != self))
            my_entities[ship_count++] = (ShipEntity*)[uni_entities[i] retain];      //  retained
    //
    for (i = 0; (i < ship_count)&&(result == NO_TARGET) ; i++)
    {
        ShipEntity* ship = my_entities[i];
        HPVector delta = HPvector_between(position, ship->position);
        GLfloat d2 = HPmagnitude2(delta);
        if (![ship isPlayer] || ![PLAYER isDocked])
        { // player doesn't block if docked
            if ((k * [ship mass] > d2)&&(d2 < SCANNER_MAX_RANGE2))    // if you go off (typical) scanner from a blocker - it ceases to block
                result = [ship universalID];
        }
    }
    for (i = 0; i < ship_count; i++)
        [my_entities[i] release];   //      released
 
    return result;
}

References checkShipsInVicinityForWitchJumpExit, int(), Entity::isPlayer, Entity::isShip, Entity::mass, NO_TARGET, PLAYER, Entity::position, SCANNER_MAX_RANGE2, Entity::universalID, and UNIVERSE.

Referenced by checkShipsInVicinityForWitchJumpExit, ShipEntity(OOAIPrivate)::performHyperSpaceExitReplace:toSystem:, sunGlareFilter, and PlayerEntity::witchJumpChecklist:.

Here is the call graph for this function:

Here is the caller graph for this function:

checkTargetLegalStatus

- (void) checkTargetLegalStatus

implementation

Provided by category ShipEntity(PureAI).

Definition at line 1360 of file ShipEntityAI.m.

{
    ShipEntity  *other_ship = [self primaryTarget];
    if (!other_ship)
    {
        [shipAI message:@"NO_TARGET"];
        return;
    }
    else
    {
        int ls = [other_ship legalStatus];
        if (ls > 50)
        {
            [shipAI message:@"TARGET_FUGITIVE"];
            return;
        }
        if (ls > 20)
        {
            [shipAI message:@"TARGET_OFFENDER"];
            return;
        }
        if (ls > 0)
        {
            [shipAI message:@"TARGET_MINOR_OFFENDER"];
            return;
        }
        [shipAI message:@"TARGET_CLEAN"];
    }
}

clearSubEntities

- (void) clearSubEntities

Definition at line 1155 of file ShipEntity.m.

{
    [subEntities makeObjectsPerformSelector:@selector(setOwner:) withObject:nil];   // Ensure backlinks are broken
    [subEntities release];
    subEntities = nil;
    
    // reset size & mass!
    collision_radius = [self findCollisionRadius];
    _profileRadius = collision_radius;
    float density = [[self shipInfoDictionary] oo_floatForKey:@"density" defaultValue:1.0f];
    if (octree)  mass = (GLfloat)(density * 20.0f * [octree volume]);
}

References _profileRadius, clearSubEntities, Entity::collision_radius, OOEntityWithDrawable::findCollisionRadius, Entity::mass, nil, octree, shipInfoDictionary, subEntities, and volume.

Referenced by becomeExplosion, becomeLargeExplosion:, clearSubEntities, dealloc, PlayerEntity(Contracts)::newShipCommonSetup:yardInfo:baseInfo:, PlayerEntity::setUpAndConfirmOK:saveGame:, ShipRestoreSubEntities(), subEntities, and PlayerEntity(OOPrivate)::tryBuyingItem:.

Here is the call graph for this function:

Here is the caller graph for this function:

collectBountyFor:

- (void) collectBountyFor:

(ShipEntity *)

other

Reimplemented in PlayerEntity.

Definition at line 9687 of file ShipEntity.m.

                         :(ShipEntity *)other
{
    if ([other isPolice])   // oops, we shot a copper!
    {
        [self markAsOffender:64 withReason:kOOLegalStatusReasonAttackedPolice];
    }
}

References isPolice, and markAsOffender:withReason:.

Referenced by noteTargetDestroyed:.

Here is the call graph for this function:

Here is the caller graph for this function:

collideWithShip:

- (BOOL) collideWithShip:

(ShipEntity *)

other

Reimplemented in StationEntity.

Definition at line 12676 of file ShipEntity.m.

                        :(ShipEntity *)other
{
    HPVector  hploc;
    Vector loc;
    double  dam1, dam2;
    
    if (!other)
        return NO;
    
    ShipEntity* otherParent = [other parentEntity];
    BOOL otherIsStation = other == [UNIVERSE station];
    // calculate line of centers using centres
    hploc = HPvector_normal_or_zbasis(HPvector_subtract([other absolutePositionForSubentity], position));
    loc = HPVectorToVector(hploc);
 
    
    if ([self canScoop:other])
    {
        [self scoopIn:other];
        return NO;
    }
    if ([other canScoop:self])
    {
        [other scoopIn:self];
        return NO;
    }
    if (universalID == NO_TARGET)
        return NO;
    if (other->universalID == NO_TARGET)
        return NO;
 
    // find velocity along line of centers
    //
    // momentum = mass x velocity
    // ke = mass x velocity x velocity
    //
    GLfloat m1 = mass;          // mass of self
    GLfloat m2 = [other mass];  // mass of other
 
    // starting velocities:
    Vector  v, vel1b =  [self velocity];
    
    if (otherParent != nil)
    {
        // Subentity
        /*  TODO: if the subentity is rotating (subentityRotationalVelocity is
            not 1 0 0 0) we should calculate the tangential velocity from the
            other's position relative to our absolute position and add that in.
        */
        v = [otherParent velocity];
    }
    else
    {
        v = [other velocity];
    }
 
    v = vector_subtract(vel1b, v);
    
    GLfloat v2b = dot_product(v, loc);          // velocity of other along loc before collision
    
    GLfloat v1a = sqrt(v2b * v2b * m2 / m1);    // velocity of self along loc after elastic collision
    if (v2b < 0.0f) v1a = -v1a;                 // in same direction as v2b
    
    // are they moving apart at over 1m/s already?
    if (v2b < 0.0f)
    {
        if (v2b < -1.0f)  return NO;
        else
        {
            position = HPvector_subtract(position, hploc);  // adjust self position
            v = kZeroVector; // go for the 1m/s solution
        }
    }
 
    // convert change in velocity into damage energy (KE)
    dam1 = m2 * v2b * v2b / 50000000;
    dam2 = m1 * v2b * v2b / 50000000;
    
    // calculate adjustments to velocity after collision
    Vector vel1a = vector_multiply_scalar(loc, -v1a);
    Vector vel2a = vector_multiply_scalar(loc, v2b);
 
    if (magnitude2(v) <= 0.1)   // virtually no relative velocity - we must provide at least 1m/s to avoid conjoined objects
    {
        vel1a = vector_multiply_scalar(loc, -1);
        vel2a = loc;
    }
 
    // apply change in velocity
    if (otherParent != nil)
    {
        [otherParent adjustVelocity:vel2a];   // move the otherParent not the subentity
    }
    else
    {
        [other adjustVelocity:vel2a];
    }
    
    [self adjustVelocity:vel1a];
    
    BOOL selfDestroyed = (dam1 > energy);
    BOOL otherDestroyed = (dam2 > [other energy]) && !otherIsStation;
    
    if (dam1 > 0.05)
    {
        [self takeScrapeDamage: dam1 from:other];
        if (selfDestroyed)  // inelastic! - take xplosion velocity damage instead
        {
            vel2a = vector_multiply_scalar(vel2a, -1);
            [other adjustVelocity:vel2a];
        }
    }
    
    if (dam2 > 0.05)
    {
        if (otherParent != nil && ![otherParent isFrangible])
        {
            [otherParent takeScrapeDamage: dam2 from:self];
        }
        else
        {
            [other  takeScrapeDamage: dam2 from:self];
        }
        
        if (otherDestroyed) // inelastic! - take explosion velocity damage instead
        {
            vel1a = vector_multiply_scalar(vel1a, -1);
            [self adjustVelocity:vel1a];
        }
    }
    
    if (!selfDestroyed && !otherDestroyed)
    {
        float t = 10.0 * [UNIVERSE getTimeDelta];   // 10 ticks
        
        HPVector pos1a = HPvector_add([self position], vectorToHPVector(vector_multiply_scalar(loc, t * v1a)));
        [self setPosition:pos1a];
        
        if (!otherIsStation)
        {
            HPVector pos2a = HPvector_add([other position], vectorToHPVector(vector_multiply_scalar(loc, t * v2b)));
            [other setPosition:pos2a];
        }
    }
    
    // remove self from other's collision list
    [[other collisionArray] removeObject:self];
    
    [self doScriptEvent:OOJSID("shipCollided") withArgument:other andReactToAIMessage:@"COLLISION"];
    [other doScriptEvent:OOJSID("shipCollided") withArgument:self andReactToAIMessage:@"COLLISION"];
    
    return YES;
}

References Entity::absolutePositionForSubentity, adjustVelocity:, Entity::collisionArray, doScriptEvent:withArgument:andReactToAIMessage:, Entity::energy, isFrangible, kZeroVector, Entity::mass, nil, NO_TARGET, Entity::parentEntity, Entity::position, scoopIn:, Entity::setPosition:, takeScrapeDamage:from:, Entity::universalID, velocity, and Entity::velocity.

Referenced by StationEntity::collideWithShip:, and manageCollisions.

Here is the call graph for this function:

Here is the caller graph for this function:

collisionExceptedFor:

- (BOOL) collisionExceptedFor:

(ShipEntity *)

ship

Definition at line 11148 of file ShipEntity.m.

                             :(ShipEntity *)ship
{
    if (_collisionExceptions == nil)
    {
        return NO;
    }
    return [_collisionExceptions containsObject:ship];
}

References _collisionExceptions, OOWeakSet::containsObject:, and nil.

Here is the call graph for this function:

collisionExceptions

- (NSArray *) collisionExceptions

Definition at line 11118 of file ShipEntity.m.

{
    if (_collisionExceptions == nil)
    {
        return [NSArray array];
    }
    return [_collisionExceptions allObjects];
}

References _collisionExceptions, OOWeakSet::allObjects, collisionExceptions, and nil.

Referenced by collisionExceptions, isMissile, and ShipGetProperty().

Here is the call graph for this function:

Here is the caller graph for this function:

commodityAmount

- (OOCargoQuantity) commodityAmount

Definition at line 8362 of file ShipEntity.m.

{
    return commodity_amount;
}

References commodity_amount, and commodityAmount.

Referenced by bounty, PlayerEntity::cargoListForScripting, cargoListForScripting, PlayerEntity::cargoQuantityForType:, PlayerEntity::collectBountyFor:, commodityAmount, PlayerEntity::setGuiToMarketInfoScreen, PlayerEntity::setGuiToMarketScreen, PlayerEntity::unloadAllCargoPodsForType:toManifest:, and PlayerEntity::unloadCargoPodsForType:amount:.

Here is the call graph for this function:

Here is the caller graph for this function:

commodityType

- (OOCommodityType) commodityType

Definition at line 8356 of file ShipEntity.m.

{
    return commodity_type;
}

References commodity_type, and commodityType.

Referenced by bounty, PlayerEntity::cargoListForScripting, cargoListForScripting, Universe::cargoPodFromTemplate:, PlayerEntity::cargoQuantityForType:, commodityType, dumpCargo, dumpCargoItem:, removeCargo:amount:, PlayerEntity::rotateCargo, scoopUpProcess:processEvents:processMessages:, PlayerEntity::setGuiToMarketInfoScreen, PlayerEntity::setGuiToMarketScreen, ShipGetProperty(), PlayerEntity::takeInternalDamage, PlayerEntity::unloadAllCargoPodsForType:toManifest:, PlayerEntity::unloadCargoPodsForType:amount:, and OOTrumble::updateTrumble:.

Here is the call graph for this function:

Here is the caller graph for this function:

commsMessage:

- (void) commsMessage: (NSString *) valueString

implementation

Reimplemented in PlayerEntity.

Provided by category ShipEntity(PureAI).

Definition at line 1665 of file ShipEntityAI.m.

                     :(NSString *)valueString
{
    [self commsMessage:valueString withUnpilotedOverride:NO];
}

commsMessage:withUnpilotedOverride:

- (void) commsMessage:		(NSString *)	valueString
withUnpilotedOverride:		(BOOL)	unpilotedOverride

Definition at line 14247 of file ShipEntity.m.

                     :(NSString *)valueString withUnpilotedOverride:(BOOL)unpilotedOverride
{
    Random_Seed very_random_seed;
    very_random_seed.a = rand() & 255;
    very_random_seed.b = rand() & 255;
    very_random_seed.c = rand() & 255;
    very_random_seed.d = rand() & 255;
    very_random_seed.e = rand() & 255;
    very_random_seed.f = rand() & 255;
    seed_RNG_only_for_planet_description(very_random_seed);
    
    [self broadcastMessage:valueString withUnpilotedOverride:unpilotedOverride];
}

References Random_Seed::a, Random_Seed::b, broadcastMessage:withUnpilotedOverride:, Random_Seed::c, Random_Seed::d, Random_Seed::e, Random_Seed::f, and seed_RNG_only_for_planet_description().

Referenced by ShipEntity(PureAI)::commsMessage:, ShipEntity(PureAI)::commsMessageByUnpiloted:, and ShipCommsMessage().

Here is the call graph for this function:

Here is the caller graph for this function:

commsMessageByUnpiloted:

- (void) commsMessageByUnpiloted: (NSString *) valueString

implementation

Reimplemented in PlayerEntity.

Provided by category ShipEntity(PureAI).

Definition at line 1671 of file ShipEntityAI.m.

                                :(NSString *)valueString
{
    [self commsMessage:valueString withUnpilotedOverride:YES];
}

compareBeaconCodeWith:

- (NSComparisonResult) compareBeaconCodeWith: (Entity<OOBeaconEntity> *) other

implementation

Reimplemented from <OOBeaconEntity>.

Definition at line 9696 of file ShipEntity.m.

                                            :(Entity<OOBeaconEntity> *) other
{
    return [[self beaconCode] compare:[other beaconCode] options: NSCaseInsensitiveSearch];
}

References beaconCode.

Here is the call graph for this function:

ComparePlanetsBySurfaceDistance

- (NSComparisonResult) ComparePlanetsBySurfaceDistance (id) i1 (id) i2 (void *) context

implementation

Definition at line 7619 of file ShipEntity.m.

{
    HPVector p = [(ShipEntity*) context position];
    OOPlanetEntity* e1 = i1;
    OOPlanetEntity* e2 = i2;
    
    float p1 = SurfaceDistanceSqaredV(p, e1);
    float p2 = SurfaceDistanceSqaredV(p, e2);
    
    if (p1 < p2) return NSOrderedAscending;
    if (p1 > p2) return NSOrderedDescending;
    
    return NSOrderedSame;
}

References Entity::position, and SurfaceDistanceSqaredV.

Here is the call graph for this function:

considerFiringMissile:

- (void) considerFiringMissile:

(double)

delta_t

Definition at line 12132 of file ShipEntity.m.

                              :(double)delta_t
{
    int missile_chance = 0;
    int rhs = 3.2 / delta_t;
    if (rhs) missile_chance = 1 + (ranrot_rand() % rhs);
 
    double hurt_factor = 16 * pow(energy/maxEnergy, 4.0);
    if (missiles > missile_chance * hurt_factor)
    {
        [self fireMissile];
    }
}

References Entity::energy, fireMissile, Entity::maxEnergy, missiles, and ranrot_rand.

Referenced by behaviour_attack_broadside_target:leftside:, behaviour_attack_fly_from_target:, behaviour_attack_fly_to_target:, behaviour_attack_slow_dogfight:, behaviour_attack_sniper:, behaviour_flee_target:, and behaviour_fly_to_target_six:.

Here is the call graph for this function:

Here is the caller graph for this function:

contractListForScripting

- (NSArray *) contractListForScripting

Reimplemented in PlayerEntity.

Definition at line 3322 of file ShipEntity.m.

{
    return [NSArray array];
}

References contractListForScripting.

Referenced by cargo, contractListForScripting, and ShipGetProperty().

Here is the call graph for this function:

Here is the caller graph for this function:

coordinates

- (HPVector) coordinates

References abandonShip, abortDocking, activateCloakingDevice, approachAspectToPrimaryTarget, currentAimTolerance, deactivateCloakingDevice, deployEscorts, destination, dockEscorts, dockingInstructions, dumpCargo, enterWitchspace, exhaustEmissiveColor, fireDirectLaserDefensiveShot, fireECM, fireMissile, int(), isMissileFlagSet, landOnPlanet, laserColor, launchCascadeMine, launchEscapeCapsule, leaveWitchspace, lightsActive, manageCollisions, missedShots, missileLaunchPosition, missileLoadTime, noticeECM, rangeToPrimaryTarget, resetShotTime, setTargetToNearestFriendlyStation, setTargetToNearestStation, setTargetToSystemStation, shotTime, switchLightsOff, switchLightsOn, and witchspaceLeavingEffects.

Here is the call graph for this function:

coordinatesForEscortPosition:

- (HPVector) coordinatesForEscortPosition: (unsigned) idx

implementation

Provided by category ShipEntity(Private).

Definition at line 13821 of file ShipEntity.m.

                                         :(unsigned)idx
{
    /*
        This function causes problems with Thargoids: their missiles (aka Thargons) are automatically
        added to the escorts group, and when a mother ship dies all thargons will attach themselves
        as escorts to the surviving battleships. This can lead to huge escort groups.
        TODO: better handling of Thargoid groups:
            - put thargons (& all other thargon missiles) in their own non-escort group perhaps?
    */
    
    // The _escortPositions array is always MAX_ESCORTS long.
    // Kludge: return the same last escort position if we have escorts above MAX_ESCORTS...
    idx = MIN(idx, (unsigned)(MAX_ESCORTS - 1));
    
    return HPvector_add(self->position, vectorToHPVector(quaternion_rotate_vector([self normalOrientation], _escortPositions[idx])));
}

References MAX_ESCORTS, MIN, quaternion_rotate_vector(), and self.

Referenced by setUpEscorts, ShipEntity(Private)::setUpMixedEscorts, and update:.

Here is the call graph for this function:

Here is the caller graph for this function:

countEquipmentItem:

- (NSUInteger) countEquipmentItem:

(NSString *)

eqkey

Definition at line 3092 of file ShipEntity.m.

                                 :(NSString *)eqkey
{
    NSString *eq = nil;
    NSUInteger count = 0;
    foreach (eq, _equipment)
    {
        if ([eqkey isEqualToString:eq])
        {
            ++count;
        }
    }
    return count;
}

References _equipment, count, and nil.

Referenced by PlayerEntity::commanderDataDictionary, PlayerEntity::equipmentList, equipmentListForScripting, and ShipEquipmentStatus().

Here is the caller graph for this function:

countsAsKill

- (BOOL) countsAsKill

Definition at line 1685 of file ShipEntity.m.

{
    return [[self shipInfoDictionary] oo_boolForKey:@"counts_as_kill" defaultValue:YES];
}

References countsAsKill, and shipInfoDictionary.

Referenced by cascadeIfAppropriateWithDamageAmount:cascadeOwner:, PlayerEntity::collectBountyFor:, countsAsKill, and findBoundingBoxRelativeToPosition:InVectors:i:j:.

Here is the call graph for this function:

Here is the caller graph for this function:

crew

- (NSArray *) crew

References crewForScripting, and fuel.

Here is the call graph for this function:

crewForScripting

- (NSArray *) crewForScripting

Definition at line 7978 of file ShipEntity.m.

{
    if (crew == nil)
    {
        return nil;
    }
    OOCharacter *crewMember = nil;
    NSMutableArray *result = [NSMutableArray arrayWithCapacity:4];
    foreach (crewMember, crew)
    {
        NSDictionary *crewDict = [crewMember infoForScripting];
        [result addObject:crewDict];
    }
    return result;
}

References crew, crewForScripting, OOCharacter::infoForScripting, and nil.

Referenced by crew, crewForScripting, and ShipGetProperty().

Here is the call graph for this function:

Here is the caller graph for this function:

cruiseSpeed

- (double) cruiseSpeed

References flightRoll, and thrustVector.

Here is the call graph for this function:

currentAimTolerance

- (GLfloat) currentAimTolerance

Definition at line 11285 of file ShipEntity.m.

{
    GLfloat basic_aim = aim_tolerance;
    GLfloat best_cos = 0.99999; // ~45m in 10km (track won't go better than 40)
    if (accuracy >= COMBAT_AI_ISNT_AWFUL)
    { 
        // better general targeting
        best_cos = 0.999999; // ~14m in 10km (track won't go better than 10)
        // if missing, aim better!
        basic_aim /= 1.0 + ((GLfloat)[self missedShots] / 4.0);
    }
    if (accuracy >= COMBAT_AI_TRACKS_CLOSER)
    { 
        // deadly shots
        best_cos = 0.9999999; // ~4m in 10km (track won't go better than 4)
        // and start with extremely good aim circle
        basic_aim /= 5.0;
    }
    if (currentWeaponFacing == WEAPON_FACING_AFT && accuracy < COMBAT_AI_ISNT_AWFUL)
    { // bad shots with aft lasers
        basic_aim *= 1.3;
    }
    else if (currentWeaponFacing == WEAPON_FACING_PORT || currentWeaponFacing == WEAPON_FACING_STARBOARD)
    { // everyone a bit worse with side lasers
        if (accuracy < COMBAT_AI_ISNT_AWFUL) 
        { // especially these
            basic_aim *= 1.3 + randf();
        }
        else
        {
            basic_aim *= 1.3;
        }
    }
    // only apply glare if ship is not shadowed
    if (isSunlit) {
        OOSunEntity *sun = [UNIVERSE sun];
        if (sun)
        {
            GLfloat sunGlareAngularSize = atan([sun radius]/HPdistance([self position], [sun position])) * SUN_GLARE_MULT_FACTOR + (SUN_GLARE_ADD_FACTOR);
            GLfloat glareLevel = [self lookingAtSunWithThresholdAngleCos:cos(sunGlareAngularSize)] * (1.0f - [self sunGlareFilter]);
            if (glareLevel > 0.1f)
            {
                // looking towards sun can seriously mess up aim (glareLevel 0..1)
                basic_aim *= (1.0 + glareLevel*3.0);
//              OOLog(@"aim.debug",@"Sun glare affecting aim: %f for %@",glareLevel,self);
                if (glareLevel > 0.5f)
                {
                    // strong glare makes precise targeting impossible
                    best_cos = 0.99999;
                }
            }
        }
    }
 
 
    GLfloat max_cos = sqrt(1-(basic_aim * basic_aim / 100000000.0));
 
    if (max_cos < best_cos)
    {
        return max_cos;
    }
    return best_cos;
}

References accuracy, aim_tolerance, COMBAT_AI_ISNT_AWFUL, COMBAT_AI_TRACKS_CLOSER, currentAimTolerance, currentWeaponFacing, Entity::isSunlit, lookingAtSunWithThresholdAngleCos:, missedShots, Entity::position, randf(), sunGlareFilter, WEAPON_FACING_AFT, WEAPON_FACING_PORT, and WEAPON_FACING_STARBOARD.

Referenced by coordinates, currentAimTolerance, onTarget:withWeapon:, trackPrimaryTarget:delta_t:, and trackSideTarget:delta_t:.

Here is the call graph for this function:

Here is the caller graph for this function:

currentWeaponFacing

- (OOWeaponFacing) currentWeaponFacing

References scannerRange.

damage

- (int) damage

Definition at line 8833 of file ShipEntity.m.

{
    return (int)(100 - (100 * energy / maxEnergy));
}

References damage, Entity::energy, int(), and Entity::maxEnergy.

Referenced by damage, dealEnergyDamage:atRange:withBias:, dealEnergyDamageWithinDesiredRange, maxFlightSpeed, and OOExhaustPlumeEntity::update:.

Here is the call graph for this function:

Here is the caller graph for this function:

deactivateCloakingDevice

- (void) deactivateCloakingDevice

Reimplemented in PlayerEntity.

Definition at line 12375 of file ShipEntity.m.

{
    if ([self hasCloakingDevice] && cloaking_device_active)
    {
        cloaking_device_active = NO;
        [self doScriptEvent:OOJSID("shipCloakDeactivated")];
    }
}

References cloaking_device_active, deactivateCloakingDevice, doScriptEvent:, and hasCloakingDevice.

Referenced by coordinates, PlayerEntity::deactivateCloakingDevice, deactivateCloakingDevice, fireMissileWithIdentifier:andTarget:, fireWeapon:direction:range:, launchCascadeMine, setCloaked:, and update:.

Here is the call graph for this function:

Here is the caller graph for this function:

dealEnergyDamage:atRange:withBias:

- (void) dealEnergyDamage:		(GLfloat)	baseDamage
atRange:		(GLfloat)	range
withBias:		(GLfloat)	velocityBias

Definition at line 8839 of file ShipEntity.m.

                         :(GLfloat) baseDamage atRange:(GLfloat) range withBias:(GLfloat) velocityBias
{
    // this is limited to the player's scanner range
    GLfloat maxRange = fmin(range * sqrt(baseDamage), SCANNER_MAX_RANGE);
    
    OOLog(@"missile.damage.calc", @"Range: %f | Damage: %f | MaxRange: %f",range,baseDamage,maxRange);
 
    NSArray *targets = [UNIVERSE entitiesWithinRange:maxRange ofEntity:self];
    if ([targets count] > 0)
    {
        unsigned i;
        for (i = 0; i < [targets count]; i++)
        {
            Entity *e2 = [targets objectAtIndex:i];
            Vector p2 = [self vectorTo:e2];
            double ecr = [e2 collisionRadius];
            double d = (magnitude(p2) - ecr) / range;
            // base damage within defined range, inverse-square falloff outside
            double localDamage = baseDamage;
            OOLog(@"missile.damage.calc", @"Base damage: %f",baseDamage);
            if (velocityBias > 0)
            {
                Vector v2 = vector_subtract([self velocity], [e2 velocity]);
                double vSign = dot_product(vector_normal([self velocity]), vector_normal(p2));
                // vSign should always be positive for the missile's actual target
        // but might be negative for other nearby ships which are
        // actually moving further away from the missile
//              double vMag = vSign > 0.0 ? magnitude(v2) : -magnitude(v2);
                double vMag = vSign * magnitude(v2);
                if (vMag > 1000.0) {
                    vMag = 1000.0; 
// cap effective closing speed to 1.0LM or injector-collisions can still do
// ridiculous damage
                }
 
                localDamage += vMag * velocityBias;
                OOLog(@"missile.damage.calc",@"Velocity magnitude + sign: %f , %f",magnitude(v2),vSign);
                OOLog(@"missile.damage.calc",@"Velocity magnitude factor: %f",vMag);
                OOLog(@"missile.damage.calc",@"Velocity corrected damage: %f",localDamage);
            }
            double damage = (d > 1) ? localDamage / (d * d) : localDamage;
            OOLog(@"missile.damage.calc",@"%f at range %f (d=%f)",damage,magnitude(p2)-ecr,d);
            if (damage > 0.0)
            {
                if ([self owner])
                {
                    [e2 takeEnergyDamage:damage from:self becauseOf:[self owner] weaponIdentifier:[self primaryRole]];
                } 
                else
                {
                    [e2 takeEnergyDamage:damage from:self becauseOf:self weaponIdentifier:[self primaryRole]];
                }
            }
        }
    }
    
    /* the actual damage can't go more than S_M_R, so cap the range
     * for exploding purposes so that the visual appearance isn't
     * larger than that */
    if (range > SCANNER_MAX_RANGE / 4.0)
    {
        range = SCANNER_MAX_RANGE / 4.0;
    }
    // and a visual sign of the explosion
    // "fireball" explosion effect
    NSDictionary *explosion = [UNIVERSE explosionSetting:@"oolite-default-ship-explosion"];
    [UNIVERSE addEntity:[OOExplosionCloudEntity explosionCloudFromEntity:self withSize:range*3.0 andSettings:explosion]];
 
}

References Entity::collisionRadius, count, damage, OOExplosionCloudEntity::explosionCloudFromEntity:withSize:andSettings:, OOLog, Entity::owner, primaryRole, SCANNER_MAX_RANGE, Entity::takeEnergyDamage:from:becauseOf:weaponIdentifier:, Entity::vectorTo:, and velocity.

Referenced by ShipDealEnergyDamage().

Here is the call graph for this function:

Here is the caller graph for this function:

dealEnergyDamageWithinDesiredRange

- (void) dealEnergyDamageWithinDesiredRange

Definition at line 8912 of file ShipEntity.m.

{
    OOStandardsDeprecated([NSString stringWithFormat:@"dealEnergyDamageWithinDesiredRange is deprecated for %@",self]);
    // not over scannerRange
    NSArray* targets = [UNIVERSE entitiesWithinRange:(desired_range < SCANNER_MAX_RANGE ? desired_range : SCANNER_MAX_RANGE) ofEntity:self];
    if ([targets count] > 0)
    {
        unsigned i;
        for (i = 0; i < [targets count]; i++)
        {
            Entity *e2 = [targets objectAtIndex:i];
            Vector p2 = [self vectorTo:e2];
            double ecr = [e2 collisionRadius];
            double d = (magnitude(p2) - ecr) * 2.6; // 2.6 is a correction constant to stay in limits of the old code.
            double damage = (d > 0) ? weapon_damage * desired_range / (d * d) : weapon_damage;
            [e2 takeEnergyDamage:damage from:self becauseOf:[self owner] weaponIdentifier:[self primaryRole]];
        }
    }
}

References Entity::collisionRadius, count, damage, dealEnergyDamageWithinDesiredRange, desired_range, OOStandardsDeprecated(), Entity::owner, primaryRole, Entity::takeEnergyDamage:from:becauseOf:weaponIdentifier:, Entity::vectorTo:, and weapon_damage.

Referenced by dealEnergyDamageWithinDesiredRange, and maxFlightSpeed.

Here is the call graph for this function:

Here is the caller graph for this function:

dealloc

- (void) dealloc

implementation

Reimplemented from OOEntityWithDrawable.

Reimplemented in DockEntity, PlayerEntity, and StationEntity.

Definition at line 1073 of file ShipEntity.m.

{
    /*  NOTE: we guarantee that entityDestroyed is sent immediately after the
        JS ship becomes invalid (as a result of dropping the weakref), i.e.
        with no intervening script activity.
        It has to be after the invalidation so that scripts can't directly or
        indirectly cause the ship to become strong-referenced. (Actually, we
        could handle that situation by breaking out of dealloc, but that's a
        nasty abuse of framework semantics and would require special-casing in
        subclasses.)
        -- Ahruman 2011-02-27
    */
    [weakSelf weakRefDrop];
    weakSelf = nil;
    ShipScriptEventNoCx(self, "entityDestroyed");
    
    [self setTrackCloseContacts:NO];    // deallocs tracking dictionary
    [[self parentEntity] subEntityReallyDied:self]; // Will do nothing if we're not really a subentity
    [self clearSubEntities];
    
    DESTROY(_shipKey);
    DESTROY(shipinfoDictionary);
    DESTROY(shipAI);
    DESTROY(cargo);
    DESTROY(name);
    DESTROY(shipUniqueName);
    DESTROY(shipClassName);
    DESTROY(displayName);
    DESTROY(scan_description);
    DESTROY(roleSet);
    DESTROY(primaryRole);
    DESTROY(laser_color);
    DESTROY(default_laser_color);
    DESTROY(exhaust_emissive_color);
    DESTROY(scanner_display_color1);
    DESTROY(scanner_display_color2);
    DESTROY(scanner_display_color_hostile1);
    DESTROY(scanner_display_color_hostile2);
    DESTROY(script);
    DESTROY(aiScript);
    DESTROY(previousCondition);
    DESTROY(dockingInstructions);
    DESTROY(crew);
    DESTROY(lastRadioMessage);
    DESTROY(octree);
    DESTROY(_defenseTargets);
    DESTROY(_collisionExceptions);
 
    DESTROY(forwardWeaponOffset);
    DESTROY(aftWeaponOffset);
    DESTROY(portWeaponOffset);
    DESTROY(starboardWeaponOffset);
    
    DESTROY(commodity_type);
 
    [self setSubEntityTakingDamage:nil];
    [self removeAllEquipment];
    
    [_group removeShip:self];
    DESTROY(_group);
    [_escortGroup removeShip:self];
    DESTROY(_escortGroup);
    
    DESTROY(_lastAegisLock);
    
    DESTROY(_beaconCode);
    DESTROY(_beaconLabel);
    DESTROY(_beaconDrawable);
    
    DESTROY(explosionType);
 
    [super dealloc];
}

References _beaconCode, _beaconDrawable, _beaconLabel, _collisionExceptions, _defenseTargets, _escortGroup, _group, _lastAegisLock, _shipKey, aftWeaponOffset, aiScript, cargo, clearSubEntities, commodity_type, crew, OOEntityWithDrawable::dealloc, dealloc, default_laser_color, DESTROY, displayName, dockingInstructions, exhaust_emissive_color, explosionType, forwardWeaponOffset, laser_color, lastRadioMessage, name, nil, octree, Entity::parentEntity, portWeaponOffset, previousCondition, primaryRole, removeAllEquipment, OOShipGroup::removeShip:, roleSet, scan_description, scanner_display_color1, scanner_display_color2, scanner_display_color_hostile1, scanner_display_color_hostile2, script, setSubEntityTakingDamage:, setTrackCloseContacts:, shipAI, shipClassName, shipinfoDictionary, ShipScriptEventNoCx, shipUniqueName, starboardWeaponOffset, subEntityReallyDied:, OOWeakReference::weakRefDrop, and OOWeakRefObject::weakSelf.

Referenced by DockEntity::dealloc, PlayerEntity::dealloc, dealloc, and StationEntity::dealloc.

Here is the call graph for this function:

Here is the caller graph for this function:

dealMomentumWithinDesiredRange:

- (void) dealMomentumWithinDesiredRange:

(double)

amount

Definition at line 8933 of file ShipEntity.m.

                                       :(double)amount
{
    NSArray* targets = [UNIVERSE entitiesWithinRange:desired_range ofEntity:self];
    if ([targets count] > 0)
    {
        unsigned i;
        for (i = 0; i < [targets count]; i++)
        {
            ShipEntity *e2 = (ShipEntity*)[targets objectAtIndex:i];
            if ([e2 isShip] && [e2 isInSpace])
            {
                Vector p2 = [self vectorTo:e2];
                double ecr = [e2 collisionRadius];
                double d2 = magnitude2(p2) - ecr * ecr;
                // limit momentum transfer to relatively sensible levels
                if (d2 < 0.1)
                {
                    d2 = 0.1;
                }
                double moment = amount*desired_range/d2;
                [e2 addImpactMoment:vector_normal(p2) fraction:moment];
            }
        }
    }
}

References addImpactMoment:fraction:, Entity::collisionRadius, count, desired_range, Entity::isInSpace, Entity::isShip, and Entity::vectorTo:.

Referenced by becomeExplosion.

Here is the call graph for this function:

Here is the caller graph for this function:

debugDumpPendingMessages

- (void) debugDumpPendingMessages

implementation

Provided by category ShipEntity(PureAI).

Definition at line 890 of file ShipEntityAI.m.

{
    [shipAI debugDumpPendingMessages];
}

debugInspectorModules

- (NSArray *) debugInspectorModules

implementation

Reimplemented from Entity.

Provided by category ShipEntity(OOShipDebugInspectorModule).

Definition at line 158 of file OOShipDebugInspectorModule.m.

{
    return [[super debugInspectorModules] arrayByAddingInspectorModuleOfClass:[OOShipDebugInspectorModule class]
                                                                    forObject:(id)self];
}

decrease_flight_pitch:

- (void) decrease_flight_pitch:

(double)

delta

Definition at line 8675 of file ShipEntity.m.

                              :(double) delta
{
    flightPitch -= delta;
    if (flightPitch > max_flight_pitch)
        flightPitch = max_flight_pitch;
    else if (flightPitch < -max_flight_pitch)
        flightPitch = -max_flight_pitch;
}

References flightPitch, and max_flight_pitch.

Referenced by PlayerShipSetProperty(), PlayerEntity(OOControlsPrivate)::pollFlightArrowKeyControls:, and PlayerEntity(OOControlsPrivate)::pollGuiArrowKeyControls:.

Here is the caller graph for this function:

decrease_flight_roll:

- (void) decrease_flight_roll:

(double)

delta

Definition at line 8655 of file ShipEntity.m.

                             :(double) delta
{
    flightRoll -= delta;
    if (flightRoll > max_flight_roll)
        flightRoll = max_flight_roll;
    else if (flightRoll < -max_flight_roll)
        flightRoll = -max_flight_roll;
}

References flightRoll, and max_flight_roll.

Referenced by PlayerShipSetProperty(), PlayerEntity(OOControlsPrivate)::pollFlightArrowKeyControls:, and PlayerEntity(OOControlsPrivate)::pollGuiArrowKeyControls:.

Here is the caller graph for this function:

decrease_flight_speed:

- (void) decrease_flight_speed:

(double)

delta

Definition at line 8626 of file ShipEntity.m.

                              :(double) delta
{
    double factor = 1.0;
    if (flightSpeed > maxFlightSpeed) 
    {
        factor = MIN_HYPERSPEED_FACTOR;
    }
 
    if (flightSpeed > factor * delta)
    {
        flightSpeed -= factor * delta;
    }
    else
    {
        flightSpeed = 0;
    }
}

References flightSpeed, maxFlightSpeed, and MIN_HYPERSPEED_FACTOR.

Referenced by applyThrust:.

Here is the caller graph for this function:

decrease_flight_yaw:

- (void) decrease_flight_yaw:

(double)

delta

Definition at line 8695 of file ShipEntity.m.

                            :(double) delta
{
    flightYaw -= delta;
    if (flightYaw > max_flight_yaw)
        flightYaw = max_flight_yaw;
    else if (flightYaw < -max_flight_yaw)
        flightYaw = -max_flight_yaw;
}

References flightYaw, and max_flight_yaw.

Referenced by PlayerShipSetProperty(), PlayerEntity(OOControlsPrivate)::pollFlightArrowKeyControls:, and PlayerEntity(OOControlsPrivate)::pollGuiArrowKeyControls:.

Here is the caller graph for this function:

defenseTargetCount

- (NSUInteger) defenseTargetCount

Definition at line 11159 of file ShipEntity.m.

{
    return [_defenseTargets count];
}

References OOWeakSet::count, and defenseTargetCount.

Referenced by addDefenseTarget:, defenseTargetCount, isMissile, and ShipGetProperty().

Here is the call graph for this function:

Here is the caller graph for this function:

defenseTargetEnumerator

- (NSEnumerator *) defenseTargetEnumerator

Definition at line 11171 of file ShipEntity.m.

{
    return [_defenseTargets objectEnumerator];
}

References defenseTargetEnumerator, and OOWeakSet::objectEnumerator.

Referenced by behaviour_track_as_turret:, defenseTargetEnumerator, fireDirectLaserDefensiveShot, isMissile, and ShipGetProperty().

Here is the call graph for this function:

Here is the caller graph for this function:

deployEscorts

- (void) deployEscorts

Definition at line 13840 of file ShipEntity.m.

{
    NSEnumerator    *escortEnum = nil;
    ShipEntity      *escort = nil;
    ShipEntity      *target = nil;
    NSMutableSet    *idleEscorts = nil;
    unsigned        deployCount;
    
    if ([self primaryTarget] == nil || _escortGroup == nil)  return;
    
    OOShipGroup *escortGroup = [self escortGroup];
    NSUInteger escortCount = [escortGroup count] - 1;  // escorts minus leader.
    if (escortCount == 0)  return;
    
    if ([self group] == nil)  [self setGroup:escortGroup];
    
    if ([self primaryTarget] == [self lastEscortTarget])
    {
        // already deployed escorts onto this target!
        return;
    }
    
    [self setLastEscortTarget:[self primaryTarget]];
    
    // Find idle escorts
    idleEscorts = [NSMutableSet set];
    for (escortEnum = [self escortEnumerator]; (escort = [escortEnum nextObject]); )
    {
        if (![[[escort getAI] name] isEqualToString:@"interceptAI.plist"] && ![escort hasNewAI])
        {
            [idleEscorts addObject:escort];
        }
        else if ([escort hasNewAI])
        {
            // JS-based escorts get a help request
            [escort doScriptEvent:OOJSID("helpRequestReceived") withArgument:self andArgument:[self primaryTarget]];
        }
    }
    
    escortCount = [idleEscorts count];
    if (escortCount == 0)  return;
    
    deployCount = ranrot_rand() % escortCount + 1;
    
    // Deploy deployCount idle escorts.
    target = [self primaryTarget];
    for (escortEnum = [idleEscorts objectEnumerator]; (escort = [escortEnum nextObject]); )
    {
        [escort addTarget:target];
        [escort setAITo:@"interceptAI.plist"];
        [escort doScriptEvent:OOJSID("escortAttack") withArgument:target];
        
        if (--deployCount == 0)  break;
    }
    
    [self updateEscortFormation];
}

References _escortGroup, addTarget:, OOShipGroup::count, deployEscorts, doScriptEvent:withArgument:, doScriptEvent:withArgument:andArgument:, escortCount, escortEnumerator, escortGroup, getAI, group, hasNewAI, lastEscortTarget, name, nil, primaryTarget, ranrot_rand, setAITo:, setGroup:, setLastEscortTarget:, and updateEscortFormation.

Referenced by coordinates, deployEscorts, ShipEntity(PureAI)::fightOrFleeHostiles, and ShipDeployEscorts().

Here is the call graph for this function:

Here is the caller graph for this function:

descriptionComponents

- (NSString *) descriptionComponents

implementation

Reimplemented from Entity.

Reimplemented in StationEntity.

Definition at line 1181 of file ShipEntity.m.

{
    if (![self isSubEntity])
    {
        return [NSString stringWithFormat:@"\"%@\" %@", [self name], [super descriptionComponents]];
    }
    else
    {
        // ID, scanClass and status are of no interest for subentities.
        NSString *subtype = nil;
        if ([self behaviour] == BEHAVIOUR_TRACK_AS_TURRET)  subtype = @"(turret)";
        else  subtype = @"(subentity)";
        
        return [NSString stringWithFormat:@"\"%@\" position: %@ %@", [self name], HPVectorDescription([self position]), subtype];
    }
}

References behaviour, Entity::descriptionComponents, descriptionComponents, Entity::isSubEntity, name, nil, and Entity::position.

Referenced by descriptionComponents, and StationEntity::descriptionComponents.

Here is the call graph for this function:

Here is the caller graph for this function:

descriptionForObjDump

- (NSString *) descriptionForObjDump

implementation

Reimplemented from Entity.

Definition at line 14841 of file ShipEntity.m.

{
    NSString *desc = [super descriptionForObjDump];
    desc = [NSString stringWithFormat:@"%@ mass %g", desc, [self mass]];
    if (![self isPlayer])
    {
        desc = [NSString stringWithFormat:@"%@ AI: %@", desc, [[self getAI] shortDescriptionComponents]];
    }
    return desc;
}

References Entity::descriptionForObjDump, descriptionForObjDump, getAI, Entity::isPlayer, Entity::mass, and AI::shortDescriptionComponents.

Referenced by descriptionForObjDump.

Here is the call graph for this function:

Here is the caller graph for this function:

deserializeShipSubEntitiesFrom:

- (void) deserializeShipSubEntitiesFrom:

(NSString *)

string

Definition at line 833 of file ShipEntity.m.

                                       :(NSString *)string
{
    NSArray             *subEnts = [[self shipSubEntityEnumerator] allObjects];
    NSInteger           i,idx, start = [subEnts count] - 1;
    NSInteger           strMaxIdx = [string length] - 1;
        
    ShipEntity          *se = nil;
    
    for (i = start; i >= 0; i--)
    {
        se = (ShipEntity *)[subEnts objectAtIndex:i];
        idx = [se subIdx]; // should be identical to i, but better safe than sorry...
        if (idx <= strMaxIdx && [[string substringWithRange:NSMakeRange(idx, 1)] isEqualToString:@"0"])
        {
            [se setSuppressExplosion:NO];
            [se setEnergy:1];
            [se takeEnergyDamage:500000000.0 from:nil becauseOf:nil weaponIdentifier:@""];
        }
    }
}

References nil, Entity::setEnergy:, setSuppressExplosion:, shipSubEntityEnumerator, subIdx, and takeEnergyDamage:from:becauseOf:weaponIdentifier:.

Referenced by PlayerEntity::setCommanderDataFromDictionary:, and PlayerEntity::showShipModelWithKey:shipData:personality:factorX:factorY:factorZ:inContext:.

Here is the call graph for this function:

Here is the caller graph for this function:

desiredRange

- (double) desiredRange

Definition at line 8596 of file ShipEntity.m.

{
    return desired_range;
}

References desired_range, and desiredRange.

Referenced by cargo, and desiredRange.

Here is the call graph for this function:

Here is the caller graph for this function:

desiredSpeed

- (double) desiredSpeed

Definition at line 8590 of file ShipEntity.m.

{
    return desired_speed;
}

References desired_speed, and desiredSpeed.

Referenced by cargo, and desiredSpeed.

Here is the call graph for this function:

Here is the caller graph for this function:

destination

- (HPVector) destination

Definition at line 10260 of file ShipEntity.m.

{
    return _destination;
}

References _destination, and destination.

Referenced by coordinates, destination, PlayerEntity::enterWormhole:, and Universe::update:.

Here is the call graph for this function:

Here is the caller graph for this function:

destinationSystem

- (OOSystemID) destinationSystem

Definition at line 7911 of file ShipEntity.m.

{
    return destination_system;
}

References destination_system, and destinationSystem.

Referenced by destinationSystem, and reportAIMessages.

Here is the call graph for this function:

Here is the caller graph for this function:

disengageAutopilot

- (void) disengageAutopilot

implementation

Reimplemented in PlayerEntity.

Provided by category ShipEntity(PureAI).

Definition at line 1641 of file ShipEntityAI.m.

{
    OOLogERR(@"ai.invalid.notPlayer", @"Error in %@:%@, AI method endAutoPilot is only applicable to the player.", [shipAI name], [shipAI state]);
}

Referenced by removeEquipmentItem:.

Here is the caller graph for this function:

displayName

- (NSString *) displayName

References roleSet, scanDescription, and scanDescriptionForScripting.

Here is the call graph for this function:

distance_six:

- (HPVector) distance_six:

(GLfloat)

dist

Definition at line 10275 of file ShipEntity.m.

                         : (GLfloat) dist
{
    HPVector six = position;
    six.x -= dist * v_forward.x;  six.y -= dist * v_forward.y;  six.z -= dist * v_forward.z;
    return six;
}

References Entity::position, and v_forward.

distance_twelve:withOffset:

- (HPVector) distance_twelve:		(GLfloat)	dist
withOffset:		(GLfloat)	offset

Definition at line 10283 of file ShipEntity.m.

                            : (GLfloat) dist withOffset:(GLfloat)offset
{
    HPVector twelve = position;
    twelve.x += dist * v_up.x; twelve.y += dist * v_up.y; twelve.z += dist * v_up.z;
    twelve.x += offset * v_right.x;   twelve.y += offset * v_right.y;   twelve.z += offset * v_right.z;
    return twelve;
}

References Entity::position, v_right, and v_up.

dockEscorts

- (void) dockEscorts

Definition at line 13900 of file ShipEntity.m.

{
    if (![self hasEscorts])  return;
    
    OOShipGroup         *escortGroup = [self escortGroup];
    NSEnumerator        *escortEnum = nil;
    ShipEntity          *escort = nil;
    ShipEntity          *target = [self primaryTarget];
    unsigned            i = 0;
    // Note: works on escortArray rather than escortEnumerator because escorts may be mutated.
    for (escortEnum = [[self escortArray] objectEnumerator]; (escort = [escortEnum nextObject]); )
    {
        float       delay = i++ * 3.0 + 1.5;        // send them off at three second intervals
        AI          *ai = [escort getAI];
        
        // act individually now!
        if ([escort group] == escortGroup)  [escort setGroup:nil];
        if ([escort owner] == self)  [escort setOwner:escort];
        if(target && [target isStation]) [escort setTargetStation:target];
        // JSAI: handles own delay
        if (![escort hasNewAI])
        {
            [escort setAITo:@"dockingAI.plist"];
            [ai setState:@"ABORT" afterDelay:delay + 0.25];
        }
        [escort doScriptEvent:OOJSID("escortDock") withArgument:[NSNumber numberWithFloat:delay]];
    }
    
    // We now have no escorts.
    [_escortGroup release];
    _escortGroup = nil;
}

References _escortGroup, dockEscorts, doScriptEvent:withArgument:, escortArray, escortGroup, getAI, group, hasEscorts, hasNewAI, Entity::isStation, nil, Entity::owner, primaryTarget, setAITo:, setGroup:, setOwner:, AI::setState:afterDelay:, and setTargetStation:.

Referenced by coordinates, dockEscorts, and ShipDockEscorts().

Here is the call graph for this function:

Here is the caller graph for this function:

dockingInstructions

- (NSDictionary *) dockingInstructions

References broadcastThargoidDestroyed, and sunGlareFilter.

Here is the call graph for this function:

doesHitLine:v0:

- (GLfloat) doesHitLine:		(HPVector)
v0:		(HPVector)	v1

Definition at line 1442 of file ShipEntity.m.

                       :(HPVector)v0 :(HPVector)v1
{
    Vector u0 = HPVectorToVector(HPvector_between(position, v0));   // relative to origin of model / octree
    Vector u1 = HPVectorToVector(HPvector_between(position, v1));
    Vector w0 = make_vector(dot_product(u0, v_right), dot_product(u0, v_up), dot_product(u0, v_forward));   // in ijk vectors
    Vector w1 = make_vector(dot_product(u1, v_right), dot_product(u1, v_up), dot_product(u1, v_forward));
    return [octree isHitByLine:w0 :w1];
}

References Entity::position, v_forward, v_right, and v_up.

doesHitLine:v0:v1:

- (GLfloat) doesHitLine:		(HPVector)
v0:		(HPVector)
v1:		(ShipEntity**)	hitEntity

Reimplemented in PlayerEntity.

Definition at line 1452 of file ShipEntity.m.

                       :(HPVector)v0 :(HPVector)v1 :(ShipEntity **)hitEntity
{
    if (hitEntity)
        hitEntity[0] = (ShipEntity*)nil;
    Vector u0 = HPVectorToVector(HPvector_between(position, v0));   // relative to origin of model / octree
    Vector u1 = HPVectorToVector(HPvector_between(position, v1));
    Vector w0 = make_vector(dot_product(u0, v_right), dot_product(u0, v_up), dot_product(u0, v_forward));   // in ijk vectors
    Vector w1 = make_vector(dot_product(u1, v_right), dot_product(u1, v_up), dot_product(u1, v_forward));
    GLfloat hit_distance = [octree isHitByLine:w0 :w1];
    if (hit_distance)
    {
        if (hitEntity)
            hitEntity[0] = self;
    }
    
    NSEnumerator    *subEnum = nil;
    ShipEntity      *se = nil;
    for (subEnum = [self shipSubEntityEnumerator]; (se = [subEnum nextObject]); )
    {
        HPVector p0 = [se absolutePositionForSubentity];
        Triangle ijk = [se absoluteIJKForSubentity];
        u0 = HPVectorToVector(HPvector_between(p0, v0));
        u1 = HPVectorToVector(HPvector_between(p0, v1));
        w0 = resolveVectorInIJK(u0, ijk);
        w1 = resolveVectorInIJK(u1, ijk);
        
        GLfloat hitSub = [se->octree isHitByLine:w0 :w1];
        if (hitSub && (hit_distance == 0 || hit_distance > hitSub))
        {   
            hit_distance = hitSub;
            if (hitEntity)
            {
                *hitEntity = se;
            }
        }
    }
    
    return hit_distance;
}

References absoluteIJKForSubentity, Entity::absolutePositionForSubentity, nil, Entity::position, shipSubEntityEnumerator, v_forward, v_right, and v_up.

Here is the call graph for this function:

doesHitLine:v0:withPosition:andIJK:i:j:

- (GLfloat) doesHitLine:		(HPVector)
v0:		(HPVector)	v1
withPosition:		(HPVector)	o
andIJK:		(Vector)
i:		(Vector)
j:		(Vector)	k

Definition at line 1493 of file ShipEntity.m.

                      :(HPVector)v0 :(HPVector)v1 withPosition:(HPVector)o andIJK:(Vector)i :(Vector)j :(Vector)k
{
    Vector u0 = HPVectorToVector(HPvector_between(o, v0));  // relative to origin of model / octree
    Vector u1 = HPVectorToVector(HPvector_between(o, v1));
    Vector w0 = make_vector(dot_product(u0, i), dot_product(u0, j), dot_product(u0, k));    // in ijk vectors
    Vector w1 = make_vector(dot_product(u1, j), dot_product(u1, j), dot_product(u1, k));
    return [octree isHitByLine:w0 :w1];
}

doNothing

- (void) doNothing

implementation

Definition at line 14834 of file ShipEntity.m.

{
    
}

References doNothing.

Referenced by doNothing.

Here is the call graph for this function:

Here is the caller graph for this function:

doOctreesCollide

- (ShipEntity *) doOctreesCollide (ShipEntity *) prime (ShipEntity *) other

implementation

Definition at line 2093 of file ShipEntity.m.

{
    // octree check
    Octree      *prime_octree = prime->octree;
    Octree      *other_octree = other->octree;
    
    HPVector        prime_position = [prime absolutePositionForSubentity];
    Triangle    prime_ijk = [prime absoluteIJKForSubentity];
    HPVector        other_position = [other absolutePositionForSubentity];
    Triangle    other_ijk = [other absoluteIJKForSubentity];
 
    Vector      relative_position_of_other = resolveVectorInIJK(HPVectorToVector(HPvector_between(prime_position, other_position)), prime_ijk);
    Triangle    relative_ijk_of_other;
    relative_ijk_of_other.v[0] = resolveVectorInIJK(other_ijk.v[0], prime_ijk);
    relative_ijk_of_other.v[1] = resolveVectorInIJK(other_ijk.v[1], prime_ijk);
    relative_ijk_of_other.v[2] = resolveVectorInIJK(other_ijk.v[2], prime_ijk);
    
    // check hull octree against other hull octree
    if ([prime_octree isHitByOctree:other_octree
                         withOrigin:relative_position_of_other
                             andIJK:relative_ijk_of_other])
    {
        return other;
    }
    
    // check prime subentities against the other's hull
    NSArray *prime_subs = prime->subEntities;
    if (prime_subs)
    {
        NSUInteger i, n_subs = [prime_subs count];
        for (i = 0; i < n_subs; i++)
        {
            Entity* se = [prime_subs objectAtIndex:i];
            if ([se isShip] && [se canCollide] && doOctreesCollide((ShipEntity*)se, other))
                return other;
        }
    }
 
    // check prime hull against the other's subentities
    NSArray *other_subs = other->subEntities;
    if (other_subs)
    {
        NSUInteger i, n_subs = [other_subs count];
        for (i = 0; i < n_subs; i++)
        {
            Entity* se = [other_subs objectAtIndex:i];
            if ([se isShip] && [se canCollide] && doOctreesCollide(prime, (ShipEntity*)se))
                return (ShipEntity*)se;
        }
    }
    
    // check prime subenties against the other's subentities
    if ((prime_subs)&&(other_subs))
    {
        NSUInteger i, n_osubs = [other_subs count];
        for (i = 0; i < n_osubs; i++)
        {
            Entity* oe = [other_subs objectAtIndex:i];
            if ([oe isShip] && [oe canCollide])
            {
                NSUInteger j, n_psubs = [prime_subs count];
                for (j = 0; j <  n_psubs; j++)
                {
                    Entity* pe = [prime_subs objectAtIndex:j];
                    if ([pe isShip] && [pe canCollide] && doOctreesCollide((ShipEntity*)pe, (ShipEntity*)oe))
                        return (ShipEntity*)oe;
                }
            }
        }
    }
 
    // fall through => no collision
    return nil;
}

References absoluteIJKForSubentity, Entity::absolutePositionForSubentity, canCollide, doOctreesCollide(), isHitByOctree(), Entity::isShip, nil, octree, and subEntities.

Here is the call graph for this function:

doScriptEvent:

- (void) doScriptEvent:

(jsid)

message

Definition at line 14631 of file ShipEntity.m.

                      :(jsid)message
{
    JSContext *context = OOJSAcquireContext();
    [self doScriptEvent:message inContext:context withArguments:NULL count:0];
    OOJSRelinquishContext(context);
}

References doScriptEvent:inContext:withArguments:count:, OOJSAcquireContext(), and OOJSRelinquishContext().

Referenced by DockEntity::abortAllDockings, StationEntity::abortAllDockings, StationEntity::abortDockingForShip:, StationEntity::acceptDockingClearanceRequestFrom:, activateCloakingDevice, Universe::allShipsDoScriptEvent:andReactToAIMessage:, StationEntity::autoDockShipsOnApproach, behaviour_face_destination:, behaviour_fly_from_destination:, behaviour_fly_to_destination:, behaviour_intercept_target:, PlayerEntity::cancelDockingRequest:, PlayerEntity(Controls)::cancelWitchspaceCountdown, deactivateCloakingDevice, PlayerEntity::disengageAutopilot, WormholeEntity::disgorgeShips, PlayerEntity::doBookkeeping:, doScriptEvent:andReactToAIMessage:, PlayerEntity::interpretAIMessage:, PlayerEntity::performDockingRequest:, PlayerEntity(OOControlsPrivate)::pollGuiArrowKeyControls:, DockEntity::pruneAndCountShipsOnApproach, StationEntity::sanityCheckShipsOnApproach, ShipEntity(PureAI)::sendScriptMessage:, WormholeEntity::suckInShip:, update:, and StationEntity::update:.

Here is the call graph for this function:

Here is the caller graph for this function:

doScriptEvent:andReactToAIMessage:

- (void) doScriptEvent:		(jsid)	scriptEvent
andReactToAIMessage:		(NSString *)	aiMessage

Definition at line 14729 of file ShipEntity.m.

                      :(jsid)scriptEvent andReactToAIMessage:(NSString *)aiMessage
{
    [self doScriptEvent:scriptEvent];
    [self reactToAIMessage:aiMessage context:nil];
}

References doScriptEvent:, and reactToAIMessage:context:.

Referenced by behaviour_fly_thru_navpoints:, WormholeEntity::disgorgeShips, takeEnergyDamage:from:becauseOf:weaponIdentifier:, takeHeatDamage:, and takeScrapeDamage:from:.

Here is the call graph for this function:

Here is the caller graph for this function:

doScriptEvent:inContext:withArguments:count:

- (void) doScriptEvent:		(jsid)	message
inContext:		(JSContext *)	context
withArguments:		(jsval *)	argv
count:		(uintN)	argc

Reimplemented in PlayerEntity.

Definition at line 14709 of file ShipEntity.m.

                      :(jsid)message inContext:(JSContext *)context withArguments:(jsval *)argv count:(uintN)argc
{
    // This method is a bottleneck so that PlayerEntity can override at one point.
    [script callMethod:message inContext:context withArguments:argv count:argc result:NULL];
    [aiScript callMethod:message inContext:context withArguments:argv count:argc result:NULL];
}

References OOJSScript::callMethod:inContext:withArguments:count:result:.

Referenced by doScriptEvent:, PlayerEntity::doScriptEvent:inContext:withArguments:count:, doScriptEvent:withArgument:, doScriptEvent:withArgument:andArgument:, doScriptEvent:withArguments:, and doScriptEvent:withArguments:count:.

Here is the call graph for this function:

Here is the caller graph for this function:

doScriptEvent:withArgument:

- (void) doScriptEvent:		(jsid)	message
withArgument:		(id)	argument

Definition at line 14639 of file ShipEntity.m.

                      :(jsid)message withArgument:(id)argument
{
    JSContext *context = OOJSAcquireContext();
    
    jsval value = OOJSValueFromNativeObject(context, argument);
    [self doScriptEvent:message inContext:context withArguments:&value count:1];
    
    OOJSRelinquishContext(context);
}

References doScriptEvent:inContext:withArguments:count:, OOJSAcquireContext(), OOJSRelinquishContext(), and OOJSValueFromNativeObject().

Referenced by acceptAsEscort:, StationEntity::acceptDockingClearanceRequestFrom:, addEquipmentItem:withValidation:inContext:, addTarget:, broadcastEnergyBlastImminent, Universe::carryPlayerOn:inWormhole:, checkForAegis, deployEscorts, PlayerEntity::docked, dockEscorts, StationEntity::dockingInstructionsForShip:, doScriptEvent:withArgument:andReactToAIMessage:, dumpItem:, PlayerEntity::engageAutopilotToStation:, PlayerEntity::enterDock:, enterDock:, ShipEntity(PureAI)::fightOrFleeMissile, fireMissileWithIdentifier:andTarget:, fireSubentityLaserShot:, PlayerEntity::launchEscapeCapsule, PlayerEntity::launchMine:, DockEntity::launchShip:, PlayerEntity::leaveWitchspace, StationEntity::noteDockedShip:, ShipEntity(Private)::noteFrustration:, noteLostTarget, noteTargetDestroyed:, PlayerEntity::performDockingRequest:, ShipEntity(OOAIPrivate)::performHyperSpaceExitReplace:toSystem:, PlayerEntity(OOPrivate)::performLaunchingUpdates:, PlayerEntity(OOPrivate)::performWitchspaceExitUpdates:, PlayerReplaceShip(), PlayerShipSetProperty(), PlayerEntity(OOControlsPrivate)::pollFlightControls:, PlayerEntity(OOControlsPrivate)::pollGuiArrowKeyControls:, removeEquipmentItem:, PlayerEntity(Contracts)::replaceShipWithNamedShip:, respondToAttackFrom:becauseOf:, scoopUpProcess:processEvents:processMessages:, ShipEntity(PureAI)::sendScriptMessage:, PlayerEntity(ScriptMethods)::setMissionChoice:keyPress:withEvent:, ShipEntity(PureAI)::setTargetToPrimaryAggressor, ShipEntity(Private)::setUpOneEscort:inGroup:withRole:atPosition:andCount:, Universe::setUpUniverseFromStation, ShipAwardEquipment(), DockEntity::shipIsInDockingCorridor:, ShipRemove(), ShipSetEquipmentStatus(), ShipEntity(AI)::suggestEscortTo:, PlayerEntity::takeEnergyDamage:from:becauseOf:weaponIdentifier:, PlayerEntity::takeInternalDamage, transitionToAegisNone, PlayerEntity(OOPrivate)::tryBuyingItem:, update:, PlayerEntity(OOPrivate)::updateClocks:, ShipEntity(AI)::wormholeEscorts, and ShipEntity(PureAI)::wormholeGroup.

Here is the call graph for this function:

Here is the caller graph for this function:

doScriptEvent:withArgument:andArgument:

- (void) doScriptEvent:		(jsid)	message
withArgument:		(id)	argument1
andArgument:		(id)	argument2

Definition at line 14650 of file ShipEntity.m.

                      :(jsid)message
          withArgument:(id)argument1
           andArgument:(id)argument2
{
    JSContext *context = OOJSAcquireContext();
    
    jsval argv[2] = { OOJSValueFromNativeObject(context, argument1), OOJSValueFromNativeObject(context, argument2) };
    [self doScriptEvent:message inContext:context withArguments:argv count:2];
    
    OOJSRelinquishContext(context);
}

References doScriptEvent:inContext:withArguments:count:, OOJSAcquireContext(), OOJSRelinquishContext(), and OOJSValueFromNativeObject().

Referenced by ShipEntity(AI)::broadcastDistressMessageWithDumping:, broadcastHitByLaserFrom:, deployEscorts, dumpCargoItem:, fireMissileWithIdentifier:andTarget:, ShipEntity(AI)::groupAttackTarget, launchEscapeCapsule, PlayerReplaceShip(), PlayerEntity(OOControlsPrivate)::pollGuiArrowKeyControls:, and receiveCommsMessage:from:.

Here is the call graph for this function:

Here is the caller graph for this function:

doScriptEvent:withArgument:andReactToAIMessage:

- (void) doScriptEvent:		(jsid)	scriptEvent
withArgument:		(id)	argument
andReactToAIMessage:		(NSString *)	aiMessage

Definition at line 14736 of file ShipEntity.m.

                      :(jsid)scriptEvent withArgument:(id)argument andReactToAIMessage:(NSString *)aiMessage
{
    [self doScriptEvent:scriptEvent withArgument:argument];
    [self reactToAIMessage:aiMessage context:nil];
}

References doScriptEvent:withArgument:, and reactToAIMessage:context:.

Referenced by checkCloseCollisionWith:, collideWithShip:, landOnPlanet:, DockEntity::launchShip:, respondToAttackFrom:becauseOf:, and update:.

Here is the call graph for this function:

Here is the caller graph for this function:

doScriptEvent:withArguments:

- (void) doScriptEvent:		(jsid)	message
withArguments:		(NSArray *)	arguments

Definition at line 14663 of file ShipEntity.m.

                      :(jsid)message withArguments:(NSArray *)arguments
{
    JSContext               *context = OOJSAcquireContext();
    uintN                   i, argc;
    jsval                   *argv = NULL;
    
    // Convert arguments to JS values and make them temporarily un-garbage-collectable.
    argc = (uintN)[arguments count];
    if (argc != 0)
    {
        argv = malloc(sizeof *argv * argc);
        if (argv != NULL)
        {
            for (i = 0; i != argc; ++i)
            {
                argv[i] = [[arguments objectAtIndex:i] oo_jsValueInContext:context];
                OOJSAddGCValueRoot(context, &argv[i], "event parameter");
            }
        }
        else  argc = 0;
    }
    
    [self doScriptEvent:message inContext:context withArguments:argv count:argc];
    
    // Re-garbage-collectibalize the arguments and free the array.
    if (argv != NULL)
    {
        for (i = 0; i != argc; ++i)
        {
            JS_RemoveValueRoot(context, &argv[i]);
        }
        free(argv);
    }
    
    OOJSRelinquishContext(context);
}

References count, doScriptEvent:inContext:withArguments:count:, OOJSAcquireContext(), OOJSAddGCValueRoot, and OOJSRelinquishContext().

Referenced by PlayerEntity(Contracts)::addParcel:start:destination:eta:fee:premium:risk:, PlayerEntity(Contracts)::addPassenger:start:destination:eta:fee:advance:risk:, PlayerEntity(Contracts)::awardContract:commodity:start:destination:eta:fee:premium:, PlayerEntity(Controls)::beginWitchspaceCountdown:, PlayerEntity::buySelectedItem, PlayerEntity(Contracts)::buySelectedShip, PlayerEntity(Contracts)::checkPassengerContracts, PlayerEntity(OOControlsPrivate)::pollFlightControls:, PlayerEntity(Contracts)::processEscapePods, PlayerEntity::tryBuyingCommodity:all:, PlayerEntity::trySellingCommodity:all:, and PlayerEntity::validateCompassTarget.

Here is the call graph for this function:

Here is the caller graph for this function:

doScriptEvent:withArguments:count:

- (void) doScriptEvent:		(jsid)	message
withArguments:		(jsval *)	argv
count:		(uintN)	argc

Definition at line 14701 of file ShipEntity.m.

                      :(jsid)message withArguments:(jsval *)argv count:(uintN)argc
{
    JSContext *context = OOJSAcquireContext();
    [self doScriptEvent:message inContext:context withArguments:argv count:argc];
    OOJSRelinquishContext(context);
}

References doScriptEvent:inContext:withArguments:count:, OOJSAcquireContext(), and OOJSRelinquishContext().

Here is the call graph for this function:

drawDebugStuff

- (void) drawDebugStuff

implementation

Provided by category ShipEntity(Private).

Definition at line 6427 of file ShipEntity.m.

{
    // HPVect: imprecise here - needs camera relative
    if (0 && reportAIMessages)
    {
        OODebugDrawPoint(HPVectorToVector(_destination), [OOColor blueColor]);
        OODebugDrawColoredLine(HPVectorToVector([self position]), HPVectorToVector(_destination), [OOColor colorWithWhite:0.15 alpha:1.0]);
        
        Entity *pTarget = [self primaryTarget];
        if (pTarget != nil)
        {
            OODebugDrawPoint(HPVectorToVector([pTarget position]), [OOColor redColor]);
            OODebugDrawColoredLine(HPVectorToVector([self position]), HPVectorToVector([pTarget position]), [OOColor colorWithRed:0.2 green:0.0 blue:0.0 alpha:1.0]);
        }
        
        Entity *sTarget = [self targetStation];
        if (sTarget != pTarget && [sTarget isStation])
        {
            OODebugDrawPoint(HPVectorToVector([sTarget position]), [OOColor cyanColor]);
        }
        
        Entity *fTarget = [self foundTarget];
        if (fTarget != nil && fTarget != pTarget && fTarget != sTarget)
        {
            OODebugDrawPoint(HPVectorToVector([fTarget position]), [OOColor magentaColor]);
        }
    }
}

References ShipEntity(Private)::drawDebugStuff, foundTarget, nil, OODebugDrawColoredLine(), OODebugDrawPoint(), primaryTarget, and targetStation.

Referenced by ShipEntity(Private)::drawDebugStuff, and drawImmediate:translucent:.

Here is the call graph for this function:

Here is the caller graph for this function:

drawImmediate:translucent:

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

implementation

Reimplemented from OOEntityWithDrawable.

Reimplemented in DockEntity, and PlayerEntity.

Definition at line 6386 of file ShipEntity.m.

                      :(bool)immediate translucent:(bool)translucent
{
    if ((no_draw_distance < cam_zero_distance) ||  // Done redundantly to skip subentities
        (cloaking_device_active && randf() > 0.10))
    {
        // Don't draw.
        return;
    }
    
    // Draw self.
    [super drawImmediate:immediate translucent:translucent];
    
#ifndef NDEBUG
    // Draw bounding boxes if we have to before going for the subentities.
    // TODO: the translucent flag here makes very little sense. Something's wrong with the matrices.
    if (translucent)  [self drawDebugStuff];
    else if (gDebugFlags & DEBUG_BOUNDING_BOXES && ![self isSubEntity])
    {
        OODebugDrawBoundingBox([self boundingBox]);
        OODebugDrawColoredBoundingBox(totalBoundingBox, [OOColor purpleColor]);
    }
#endif
    
    // Draw subentities.
    if (!immediate) // TODO: is this relevant any longer?
    {
        // save time by not copying the subentity array if it's empty - CIM
        if ([self subEntityCount] > 0) 
        { 
            Entity<OOSubEntity> *subEntity = nil;
            foreach (subEntity, [self subEntities])
            {
                NSAssert3([subEntity owner] == self, @"Subentity ownership broke - %@ should be owned by %@ but is owned by %@.", subEntity, self, [subEntity owner]);
                [subEntity drawSubEntityImmediate:immediate translucent:translucent];
            }
        }
    }
}

References Entity::boundingBox, Entity::cam_zero_distance, cloaking_device_active, DEBUG_BOUNDING_BOXES, drawDebugStuff, OOEntityWithDrawable::drawImmediate:translucent:, Entity::drawSubEntityImmediate:translucent:, gDebugFlags, Entity::isSubEntity, nil, Entity::no_draw_distance, OODebugDrawBoundingBox(), OODebugDrawColoredBoundingBox(), Entity::owner, randf(), subEntities, subEntityCount, and totalBoundingBox.

Referenced by DockEntity::drawImmediate:translucent:, PlayerEntity::drawImmediate:translucent:, and drawSubEntityImmediate:translucent:.

Here is the call graph for this function:

Here is the caller graph for this function:

drawSubEntityImmediate:translucent:

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

implementation

Reimplemented from Entity.

Definition at line 6458 of file ShipEntity.m.

                               :(bool)immediate translucent:(bool)translucent
{
    OOVerifyOpenGLState();
    
    if (cam_zero_distance > no_draw_distance) // this test provides an opportunity to do simple LoD culling
    {
        return; // TOO FAR AWAY
    }
    OOGLPushModelView();
    
    // HPVect: need to make camera-relative
    OOGLTranslateModelView(HPVectorToVector(position));
    OOGLMultModelView(rotMatrix);
    [self drawImmediate:immediate translucent:translucent];
    
#ifndef NDEBUG
    if (gDebugFlags & DEBUG_BOUNDING_BOXES)
    {
        OODebugDrawBoundingBox([self boundingBox]);
    }
#endif
    
    OOGLPopModelView();
    
    OOVerifyOpenGLState();   
}

References Entity::boundingBox, Entity::cam_zero_distance, DEBUG_BOUNDING_BOXES, drawImmediate:translucent:, gDebugFlags, Entity::no_draw_distance, OODebugDrawBoundingBox(), OOGLMultModelView(), OOGLPopModelView(), OOGLPushModelView(), OOGLTranslateModelView(), OOVerifyOpenGLState, Entity::position, and Entity::rotMatrix.

Here is the call graph for this function:

dropMessages:

- (void) dropMessages: (NSString *) messageString

implementation

Provided by category ShipEntity(PureAI).

Definition at line 875 of file ShipEntityAI.m.

                     :(NSString *)messageString
{
    NSArray             *messages = nil;
    NSEnumerator        *messageEnum = nil;
    NSString            *message = nil;
    NSCharacterSet      *whiteSpace = [NSCharacterSet whitespaceCharacterSet];
    
    messages = [messageString componentsSeparatedByString:@","];
    for (messageEnum = [messages objectEnumerator]; (message = [messageEnum nextObject]); )
    {
        [shipAI dropMessage:[message stringByTrimmingCharactersInSet:whiteSpace]];
    }
}

dumpCargo

- (OOCommodityType) dumpCargo

Reimplemented in PlayerEntity.

Definition at line 12487 of file ShipEntity.m.

{
    ShipEntity *jetto = [self dumpCargoItem:nil];
    if (jetto != nil)
    {
        return [jetto commodityType];
    }
    else
    {
        return nil;
    }
}

References commodityType, dumpCargo, dumpCargoItem:, and nil.

Referenced by coordinates, PlayerEntity::dumpCargo, dumpCargo, and ShipEntity(PureAI)::ejectCargo.

Here is the call graph for this function:

Here is the caller graph for this function:

dumpCargoItem:

- (ShipEntity *) dumpCargoItem:

(OOCommodityType)

preferred

Definition at line 12501 of file ShipEntity.m.

                              :(OOCommodityType)preferred
{
    ShipEntity              *jetto = nil;
    NSUInteger               i = 0;
    
    if (([cargo count] > 0)&&([UNIVERSE getTime] - cargo_dump_time > 0.5))  // space them 0.5s or 10m apart
    {
        if (preferred == nil)
        {
            jetto = [[[cargo objectAtIndex:0] retain] autorelease];
        }
        else
        {
            BOOL found = NO;
            for (i=0;i<[cargo count];i++)
            {
                if ([[[cargo objectAtIndex:i] commodityType] isEqualToString:preferred])
                {
                    jetto = [[[cargo objectAtIndex:i] retain] autorelease];
                    found = YES;
                    break;
                }
            }
            if (found == NO)
            {
                // dump anything
                jetto = [[[cargo objectAtIndex:0] retain] autorelease];
                i = 0;
            }
        }
        if (jetto != nil)
        {
            [self dumpItem:jetto];  // CLASS_CARGO, STATUS_IN_FLIGHT, AI state GLOBAL
            [cargo removeObjectAtIndex:i];
            [self broadcastAIMessage:@"CARGO_DUMPED"]; // goes only to 16 nearby ships in range, but that should be enough.
            unsigned i;
            // only send script event to powered entities
            [self checkScannerIgnoringUnpowered];
            for (i = 0; i < n_scanned_ships ; i++)
            {
                ShipEntity* other = scanned_ships[i];
                [other doScriptEvent:OOJSID("cargoDumpedNearby") withArgument:jetto andArgument:self];
                
            }
        }
    }
    
    return jetto;
}

References broadcastAIMessage:, cargo, cargo_dump_time, checkScannerIgnoringUnpowered, commodityType, count, doScriptEvent:withArgument:andArgument:, dumpItem:, n_scanned_ships, nil, scanned_ships, and UNIVERSE.

Referenced by dumpCargo.

Here is the call graph for this function:

Here is the caller graph for this function:

dumpItem:

- (OOCargoType) dumpItem:

(ShipEntity*)

jetto

Definition at line 12552 of file ShipEntity.m.

                        : (ShipEntity*) cargoObj
{
    if (!cargoObj)
        return 0;
 
    ShipEntity* jetto = [UNIVERSE reifyCargoPod:cargoObj];
 
    int     result = [jetto cargoType];
    AI      *jettoAI = nil;
    Vector  start;
    
    // players get to see their old ship sailing forth, while NPCs run away more efficiently!
    // cargo is ejected at higher speed from any ship
    double  eject_speed = EXPECT_NOT([jetto crew] && [jetto isPlayer]) ? 20.0 : 100.0;
    double  eject_reaction = -eject_speed * [jetto mass] / [self mass];
    double  jcr = jetto->collision_radius;
    
    Quaternion  jetto_orientation = kIdentityQuaternion;
    Vector  vel, v_eject, v_eject_normal;
    HPVector  rpos = [self absolutePositionForSubentity];
    double jetto_roll = 0;
    double jetto_pitch = 0;
    
    // default launching position
    start.x = 0.0;                      // in the middle
    start.y = 0.0;                      //
    start.z = boundingBox.min.z - jcr;   // 1m behind of bounding box
    
    // custom launching position
    start = [shipinfoDictionary oo_vectorForKey:@"aft_eject_position" defaultValue:start];
    
    v_eject = vector_normal(start);
    
    // check if start is within bounding box...
    while ( (start.x > boundingBox.min.x - jcr)&&(start.x < boundingBox.max.x + jcr)&&
            (start.y > boundingBox.min.y - jcr)&&(start.y < boundingBox.max.y + jcr)&&
            (start.z > boundingBox.min.z - jcr)&&(start.z < boundingBox.max.z + jcr))
    {
        start = vector_add(start, vector_multiply_scalar(v_eject, jcr));
    }
    
    v_eject = quaternion_rotate_vector([self normalOrientation], start);
    rpos = HPvector_add(rpos, vectorToHPVector(v_eject));
    v_eject = vector_normal(v_eject);
    v_eject_normal = v_eject;
    
    v_eject.x += (randf() - randf())/eject_speed;
    v_eject.y += (randf() - randf())/eject_speed;
    v_eject.z += (randf() - randf())/eject_speed;
    
    vel = vector_add(vector_multiply_scalar(v_forward, flightSpeed), vector_multiply_scalar(v_eject, eject_speed));
    velocity = vector_add(velocity, vector_multiply_scalar(v_eject, eject_reaction));
    
    [jetto setPosition:rpos];
    if ([jetto crew]) // jetto has a crew, so assume it is an escape pod.
    {
        // orient the pod away from the ship to avoid colliding with it.
        jetto_orientation = quaternion_rotation_between(v_eject_normal, kBasisZVector);
    }
    else
    {
        // It is true cargo, let it tumble.
        jetto_roll =    ((ranrot_rand() % 1024) - 512.0)/1024.0;  //  -0.5 to +0.5
        jetto_pitch =   ((ranrot_rand() % 1024) - 512.0)/1024.0;  //  -0.5 to +0.5
        quaternion_set_random(&jetto_orientation);
    }
    
    [jetto setOrientation:jetto_orientation];
    [jetto setRoll:jetto_roll];
    [jetto setPitch:jetto_pitch];
    [jetto setVelocity:vel];
    [jetto setScanClass: CLASS_CARGO];
    [jetto setTemperature:[self randomEjectaTemperature]];
    [UNIVERSE addEntity:jetto]; // STATUS_IN_FLIGHT, AI state GLOBAL
    
    jettoAI = [jetto getAI];
    if ([jettoAI hasSuspendedStateMachines]) // check if this was previous scooped cargo.
    {
        [jetto setThrust:[jetto maxThrust]]; // restore old thrust.
        [jetto setOwner:jetto];
        [jettoAI exitStateMachineWithMessage:nil]; // exit nullAI.
    }
    [jetto doScriptEvent:OOJSID("shipWasDumped") withArgument:self];
    [self doScriptEvent:OOJSID("shipDumpedCargo") withArgument:jetto];
    
    cargo_dump_time = [UNIVERSE getTime];
    return result;
}

References Entity::absolutePositionForSubentity, Entity::boundingBox, cargo_dump_time, cargoType, Entity::collision_radius, crew, doScriptEvent:withArgument:, AI::exitStateMachineWithMessage:, EXPECT_NOT, flightSpeed, getAI, Entity::isPlayer, kBasisZVector, kIdentityQuaternion, Entity::mass, maxThrust, nil, Entity::normalOrientation, quaternion_rotate_vector(), quaternion_rotation_between(), quaternion_set_random(), randf(), randomEjectaTemperature, ranrot_rand, Entity::setOrientation:, setOwner:, setPitch:, Entity::setPosition:, setRoll:, Entity::setScanClass:, setTemperature:, setThrust:, Entity::setVelocity:, v_forward, and velocity.

Referenced by dumpCargoItem:, ShipEntity(ScriptMethods)::ejectShipOfRole:, ShipEntity(ScriptMethods)::ejectShipOfType:, PlayerEntity::launchMine:, and ShipEntity(Private)::launchPodWithCrew:.

Here is the call graph for this function:

Here is the caller graph for this function:

dumpSelfState

- (void) dumpSelfState

implementation

Reimplemented from Entity.

Reimplemented in PlayerEntity, and StationEntity.

Definition at line 14501 of file ShipEntity.m.

{
    NSMutableArray      *flags = nil;
    NSString            *flagsString = nil;
    
    [super dumpSelfState];
    
    OOLog(@"dumpState.shipEntity", @"Type: %@", [self shipDataKey]);
    OOLog(@"dumpState.shipEntity", @"Name: %@", name);
    OOLog(@"dumpState.shipEntity", @"Display Name: %@", [self displayName]);
    OOLog(@"dumpState.shipEntity", @"Roles: %@", [self roleSet]);
    OOLog(@"dumpState.shipEntity", @"Primary role: %@", primaryRole);
    OOLog(@"dumpState.shipEntity", @"Script: %@", script);
    OOLog(@"dumpState.shipEntity", @"Subentity count: %lu", [self subEntityCount]);
    OOLog(@"dumpState.shipEntity", @"Behaviour: %@", OOStringFromBehaviour(behaviour));
    id target = [self primaryTarget];
    if (target == nil)  target = @"<none>";
    OOLog(@"dumpState.shipEntity", @"Target: %@", target);
    OOLog(@"dumpState.shipEntity", @"Destination: %@", HPVectorDescription(_destination));
    OOLog(@"dumpState.shipEntity", @"Other destination: %@", HPVectorDescription(coordinates));
    OOLog(@"dumpState.shipEntity", @"Waypoint count: %u", number_of_navpoints);
    OOLog(@"dumpState.shipEntity", @"Desired speed: %g", desired_speed);
    OOLog(@"dumpState.shipEntity", @"Thrust: %g", thrust);
    if ([self escortCount] != 0)  OOLog(@"dumpState.shipEntity", @"Escort count: %u", [self escortCount]);
    OOLog(@"dumpState.shipEntity", @"Fuel: %i", fuel);
    OOLog(@"dumpState.shipEntity", @"Fuel accumulator: %g", fuel_accumulator);
    OOLog(@"dumpState.shipEntity", @"Missile count: %u", missiles);
    
    if (shipAI != nil && OOLogWillDisplayMessagesInClass(@"dumpState.shipEntity.ai"))
    {
        OOLog(@"dumpState.shipEntity.ai", @"%@", @"AI:");
        OOLogPushIndent();
        OOLogIndent();
        @try
        {
            [shipAI dumpState];
        }
        @catch (id exception) {}
        OOLogPopIndent();
    }
    OOLog(@"dumpState.shipEntity", @"Accuracy: %g", accuracy);
    OOLog(@"dumpState.shipEntity", @"Jink position: %@", VectorDescription(jink));
    OOLog(@"dumpState.shipEntity", @"Frustration: %g", frustration);
    OOLog(@"dumpState.shipEntity", @"Success factor: %g", success_factor);
    OOLog(@"dumpState.shipEntity", @"Shots fired: %u", shot_counter);
    OOLog(@"dumpState.shipEntity", @"Time since shot: %g", [self shotTime]);
    OOLog(@"dumpState.shipEntity", @"Spawn time: %g (%g seconds ago)", [self spawnTime], [self timeElapsedSinceSpawn]);
    if ([self isBeacon])
    {
        OOLog(@"dumpState.shipEntity", @"Beacon code: %@", [self beaconCode]);
    }
    OOLog(@"dumpState.shipEntity", @"Hull temperature: %g", ship_temperature);
    OOLog(@"dumpState.shipEntity", @"Heat insulation: %g", [self heatInsulation]);
    
    flags = [NSMutableArray array];
    #define ADD_FLAG_IF_SET(x)      if (x) { [flags addObject:@#x]; }
    ADD_FLAG_IF_SET(military_jammer_active);
    ADD_FLAG_IF_SET(docking_match_rotation);
    ADD_FLAG_IF_SET(pitching_over);
    ADD_FLAG_IF_SET(reportAIMessages);
    ADD_FLAG_IF_SET(being_mined);
    ADD_FLAG_IF_SET(being_fined);
    ADD_FLAG_IF_SET(isHulk);
    ADD_FLAG_IF_SET(trackCloseContacts);
    ADD_FLAG_IF_SET(isNearPlanetSurface);
    ADD_FLAG_IF_SET(isFrangible);
    ADD_FLAG_IF_SET(cloaking_device_active);
    ADD_FLAG_IF_SET(canFragment);
    ADD_FLAG_IF_SET([self proximityAlert] != nil);
    flagsString = [flags count] ? [flags componentsJoinedByString:@", "] : (NSString *)@"none";
    OOLog(@"dumpState.shipEntity", @"Flags: %@", flagsString);
}

References _destination, accuracy, ADD_FLAG_IF_SET, beaconCode, behaviour, being_fined, being_mined, canFragment, cloaking_device_active, coordinates, desired_speed, displayName, docking_match_rotation, Entity::dumpSelfState, dumpSelfState, AI::dumpState, escortCount, frustration, fuel, fuel_accumulator, heatInsulation, isBeacon, isFrangible, isHulk, isNearPlanetSurface, jink, military_jammer_active, missiles, name, nil, number_of_navpoints, OOLog, OOLogIndent(), OOLogPopIndent(), OOLogPushIndent(), OOLogWillDisplayMessagesInClass(), OOStringFromBehaviour(), pitching_over, primaryRole, primaryTarget, proximityAlert, reportAIMessages, roleSet, script, ship_temperature, shipAI, shipDataKey, shot_counter, shotTime, Entity::spawnTime, subEntityCount, success_factor, thrust, Entity::timeElapsedSinceSpawn, and trackCloseContacts.

Referenced by PlayerEntity::dumpSelfState, dumpSelfState, and StationEntity::dumpSelfState.

Here is the call graph for this function:

Here is the caller graph for this function:

ejectCargo

- (void) ejectCargo

implementation

Provided by category ShipEntity(PureAI).

Definition at line 1677 of file ShipEntityAI.m.

{
    OOCargoQuantity i, cargo_to_go = 0.1 * [self maxAvailableCargoSpace];
    while (cargo_to_go > 15)
    {
        cargo_to_go = ranrot_rand() % cargo_to_go;
    }
    [self dumpCargo];
    for (i = 1; i < cargo_to_go; i++)
    {
        [self performSelector:@selector(dumpCargo) withObject:nil afterDelay:0.75 * i]; // drop 3 canisters per 2 seconds
    }
}

Referenced by ShipEntity(AI)::broadcastDistressMessageWithDumping:.

Here is the caller graph for this function:

ejectShipOfRole:

- (ShipEntity *) ejectShipOfRole:

(NSString *)

role

Provided by category ShipEntity(ScriptMethods).

Definition at line 50 of file ShipEntityScriptMethods.m.

                                :(NSString *)role
{
    ShipEntity      *item = nil;
    
    if (role != nil)
    {
        item = [[UNIVERSE newShipWithRole:role] autorelease];
        if (item != nil)  [self dumpItem:item];
    }
    
    return item;
}

ejectShipOfType:

- (ShipEntity *) ejectShipOfType:

(NSString *)

shipKey

Provided by category ShipEntity(ScriptMethods).

Definition at line 36 of file ShipEntityScriptMethods.m.

                                :(NSString *)shipKey
{
    ShipEntity      *item = nil;
    
    if (shipKey != nil)
    {
        item = [[UNIVERSE newShipWithName:shipKey] autorelease];
        if (item != nil)  [self dumpItem:item];
    }
    
    return item;
}

Referenced by PlayerEntity(Scripting)::ejectItem:.

Here is the caller graph for this function:

energyRechargeRate

- (float) energyRechargeRate

Definition at line 7502 of file ShipEntity.m.

{
    return energy_recharge_rate;
}

References energy_recharge_rate, and energyRechargeRate.

Referenced by PlayerEntity::doBookkeeping:, energyRechargeRate, OOShipLibraryGenerator(), and weaponRange.

Here is the call graph for this function:

Here is the caller graph for this function:

enterDock:

- (void) enterDock:

(StationEntity *)

station

Reimplemented in PlayerEntity.

Definition at line 13458 of file ShipEntity.m.

                  :(StationEntity *)station
{
    // throw these away now we're docked...
    if (dockingInstructions != nil)
    {
        [dockingInstructions autorelease];
        dockingInstructions = nil;
    }
    
    [self doScriptEvent:OOJSID("shipWillDockWithStation") withArgument:station];
    [self doScriptEvent:OOJSID("shipDockedWithStation") withArgument:station];
    [shipAI message:@"DOCKED"];
    [station noteDockedShip:self];
    [UNIVERSE removeEntity:self];
}

References dockingInstructions, doScriptEvent:withArgument:, AI::message:, nil, and StationEntity::noteDockedShip:.

Referenced by DockEntity(OOPrivate)::pullInShipIfPermitted:, and StationEntity(OOPrivate)::pullInShipIfPermitted:.

Here is the call graph for this function:

Here is the caller graph for this function:

enterPlayerWormhole

- (void) enterPlayerWormhole

Provided by category ShipEntity(AI).

Definition at line 634 of file ShipEntityAI.m.

{
    [self enterWormhole:[PLAYER wormhole] replacing:NO];
}

enterTargetWormhole

- (void) enterTargetWormhole

Provided by category ShipEntity(AI).

Definition at line 639 of file ShipEntityAI.m.

{
    WormholeEntity *whole = nil;
    ShipEntity      *targEnt = [self primaryTarget];
    double found_d2 = scannerRange * scannerRange;
    
    if (targEnt && (HPdistance2(position, [targEnt position]) < found_d2))
    {
        if ([targEnt isWormhole])
            whole = (WormholeEntity *)targEnt;
        else if ([targEnt isPlayer])
            whole = [PLAYER wormhole];
    }
 
    if (!whole)
    {
        // locate nearest wormhole
        int             ent_count =     UNIVERSE->n_entities;
        Entity**        uni_entities =  UNIVERSE->sortedEntities;   // grab the public sorted list
        WormholeEntity* wormholes[ent_count];
        int i;
        int wh_count = 0;
        for (i = 0; i < ent_count; i++)
            if (uni_entities[i]->isWormhole)
                wormholes[wh_count++] = [(WormholeEntity *)uni_entities[i] retain];
        //
        //double found_d2 = scannerRange * scannerRange;
        for (i = 0; i < wh_count ; i++)
        {
            WormholeEntity *wh = wormholes[i];
            double d2 = HPdistance2(position, wh->position);
            if (d2 < found_d2)
            {
                whole = wh;
                found_d2 = d2;
            }
            [wh release];
        }
    }
    
    [self enterWormhole:whole replacing:NO];
}

Referenced by Universe::forceWitchspaceEntries.

Here is the caller graph for this function:

enterWitchspace

- (void) enterWitchspace

Reimplemented in PlayerEntity.

Definition at line 13524 of file ShipEntity.m.

{
    [UNIVERSE addWitchspaceJumpEffectForShip:self];
    [shipAI message:@"ENTERED_WITCHSPACE"];
    
    if (![[UNIVERSE sun] willGoNova])
    {
        // if the sun's not going nova, add a new ship like this one leaving.
        [UNIVERSE witchspaceShipWithPrimaryRole:[self primaryRole]];
    }
    
    [UNIVERSE removeEntity:self];
}

References enterWitchspace, AI::message:, primaryRole, and UNIVERSE.

Referenced by coordinates, and enterWitchspace.

Here is the call graph for this function:

Here is the caller graph for this function:

enterWormhole:

- (void) enterWormhole:

(WormholeEntity *)

w_hole

Reimplemented in PlayerEntity.

Definition at line 13485 of file ShipEntity.m.

                      :(WormholeEntity *) w_hole
{
    [self enterWormhole:w_hole replacing:YES];
}

References enterWormhole:replacing:.

Referenced by manageCollisions.

Here is the call graph for this function:

Here is the caller graph for this function:

enterWormhole:replacing:

- (void) enterWormhole:		(WormholeEntity *)	w_hole
replacing:		(BOOL)	replacing

Definition at line 13491 of file ShipEntity.m.

                      :(WormholeEntity *) w_hole replacing:(BOOL)replacing
{
    if (w_hole == nil)  return;
    if ([self status] == STATUS_ENTERING_WITCHSPACE)
    {
        return; // has already entered a different wormhole
    }
    // Replacement ships now handled by system repopulator
 
    // MKW 2011.02.27 - Moved here from ShipEntityAI so escorts reliably follow
    //                  mother in all wormhole cases, not just when the ship
    //                  creates the wormhole.
    [self addTarget:w_hole];
    [self setFoundTarget:w_hole];
    [shipAI reactToMessage:@"WITCHSPACE OKAY" context:@"performHyperSpaceExit"];    // must be a reaction, the ship is about to disappear
    
    // CIM 2012.07.22 above only covers those cases where ship expected to leave
    if ([[self escortArray] count] > 1)
    {
        // so wormhole escorts anyway if it leaves unexpectedly.
        [self wormholeEscorts];
    }
 
    if ([self scriptedMisjump])
    {
        [self setScriptedMisjump:NO];
        [w_hole setMisjumpWithRange:[self scriptedMisjumpRange]];
        [self setScriptedMisjumpRange:0.5];
    }
    [w_hole suckInShip: self];    // removes ship from universe
}

References addTarget:, count, escortArray, nil, AI::reactToMessage:context:, scriptedMisjump, scriptedMisjumpRange, setFoundTarget:, WormholeEntity::setMisjumpWithRange:, setScriptedMisjump:, setScriptedMisjumpRange:, Entity::status, WormholeEntity::suckInShip:, and wormholeEscorts.

Referenced by ShipEntity(AI)::enterPlayerWormhole, ShipEntity(AI)::enterTargetWormhole, enterWormhole:, manageCollisions, and ShipEntity(OOAIPrivate)::performHyperSpaceExitReplace:toSystem:.

Here is the call graph for this function:

Here is the caller graph for this function:

entityForShaderProperties

- (Entity *) entityForShaderProperties

Definition at line 14601 of file ShipEntity.m.

{
    return [self rootShipEntity];
}

References entityForShaderProperties, and Entity::rootShipEntity.

Referenced by entityForShaderProperties, and scriptInfo.

Here is the call graph for this function:

Here is the caller graph for this function:

entityPersonality

- (GLfloat) entityPersonality

Definition at line 9766 of file ShipEntity.m.

{
    return entity_personality / (float)ENTITY_PERSONALITY_MAX;
}

References entity_personality, ENTITY_PERSONALITY_MAX, and entityPersonality.

Referenced by entityPersonality, and maxFlightSpeed.

Here is the call graph for this function:

Here is the caller graph for this function:

entityPersonalityInt

- (GLint) entityPersonalityInt

Definition at line 9772 of file ShipEntity.m.

{
    return entity_personality;
}

References entity_personality, and entityPersonalityInt.

Referenced by DockEntity(OOPrivate)::addShipToShipsOnApproach:, entityPersonalityInt, maxFlightSpeed, PlayerEntity::setGuiToStatusScreen, and setUpOneStandardSubentity:asTurret:.

Here is the call graph for this function:

Here is the caller graph for this function:

equipmentCount

- (NSUInteger) equipmentCount

Definition at line 3636 of file ShipEntity.m.

{
    return [_equipment count];
}

References equipmentCount.

Referenced by equipmentCount, and isFrangible.

Here is the call graph for this function:

Here is the caller graph for this function:

equipmentEnumerator

- (NSEnumerator *) equipmentEnumerator

Definition at line 3630 of file ShipEntity.m.

{
    return [_equipment objectEnumerator];
}

References equipmentEnumerator.

Referenced by PlayerEntity::commanderDataDictionary, equipmentEnumerator, isFrangible, ShipEntity(LoadRestore)::savedShipDictionaryWithContext:, and PlayerEntity::takeInternalDamage.

Here is the call graph for this function:

Here is the caller graph for this function:

equipmentItemProviding:

- (NSString *) equipmentItemProviding:

(NSString *)

equipmentType

Definition at line 3159 of file ShipEntity.m.

                                     :(NSString *)equipmentType
{
    NSString *key = nil;
    foreach (key, _equipment) {
        if ([key isEqualToString:equipmentType])
        {
            // equipment always provides itself
            return [[key copy] autorelease];
        }
        else
        {
            OOEquipmentType *et = [OOEquipmentType equipmentTypeWithIdentifier:key];
            if (et != nil && [et provides:equipmentType])
            {
                return [[key copy] autorelease];
            }
        }
    }
    return nil;
}

References _equipment, OOEquipmentType::equipmentTypeWithIdentifier:, and nil.

Referenced by abandonShip, PlayerEntity::enterGalacticWitchspace, and PlayerEntity::launchEscapeCapsule.

Here is the call graph for this function:

Here is the caller graph for this function:

equipmentListForScripting

- (NSArray *) equipmentListForScripting

Definition at line 3351 of file ShipEntity.m.

{
    NSArray             *eqTypes = [OOEquipmentType allEquipmentTypes];
    NSMutableArray      *quip = [NSMutableArray arrayWithCapacity:[eqTypes count]];
    NSEnumerator        *eqTypeEnum = nil;
    OOEquipmentType     *eqType = nil;
    BOOL                isDamaged;
    
    for (eqTypeEnum = [eqTypes objectEnumerator]; (eqType = [eqTypeEnum nextObject]); )
    {
        // Equipment list,  consistent with the rest of the API - Kaks
        if ([eqType canCarryMultiple])
        {
            NSString *damagedIdentifier = [[eqType identifier] stringByAppendingString:@"_DAMAGED"];
            NSUInteger i, count = 0;
            count += [self countEquipmentItem:[eqType identifier]];
            count += [self countEquipmentItem:damagedIdentifier];
            for (i=0;i<count;i++)
            {
                [quip addObject:eqType];    
            }
        }
        else
        {
            isDamaged = [self hasEquipmentItem:[[eqType identifier] stringByAppendingString:@"_DAMAGED"]];
            if ([self hasEquipmentItem:[eqType identifier]] || isDamaged)
            {
                [quip addObject:eqType];
            }
        }
    }
    
    // Passengers - not supported yet for NPCs, but it's here for genericity.
    if ([self passengerCapacity] > 0)
    {
        eqType = [OOEquipmentType equipmentTypeWithIdentifier:@"EQ_PASSENGER_BERTH"];
        //[quip addObject:[self eqDictionaryWithType:eqType isDamaged:NO]];
        [quip addObject:eqType];
    }
    
    return [[quip copy] autorelease];
}

References OOEquipmentType::allEquipmentTypes, count, countEquipmentItem:, equipmentListForScripting, OOEquipmentType::equipmentTypeWithIdentifier:, hasEquipmentItem:, OOEquipmentType::identifier, nil, and passengerCapacity.

Referenced by cargo, equipmentListForScripting, and ShipGetProperty().

Here is the call graph for this function:

Here is the caller graph for this function:

equipmentValidToAdd:inContext:

- (BOOL) equipmentValidToAdd:		(NSString *)	equipmentKey
inContext:		(NSString *)	context

Definition at line 3395 of file ShipEntity.m.

                            :(NSString *)equipmentKey inContext:(NSString *)context
{
    return [self equipmentValidToAdd:equipmentKey whileLoading:NO inContext:context];
}

References equipmentValidToAdd:whileLoading:inContext:.

Here is the call graph for this function:

equipmentValidToAdd:whileLoading:inContext:

- (BOOL) equipmentValidToAdd:		(NSString *)	equipmentKey
whileLoading:		(BOOL)	loading
inContext:		(NSString *)	context

Definition at line 3401 of file ShipEntity.m.

                            :(NSString *)equipmentKey whileLoading:(BOOL)loading inContext:(NSString *)context
{
    OOEquipmentType         *eqType = nil;
    BOOL                    validationForDamagedEquipment = NO;
    
    if ([equipmentKey hasSuffix:@"_DAMAGED"])
    {
        equipmentKey = [equipmentKey substringToIndex:[equipmentKey length] - [@"_DAMAGED" length]];
    }
    
    eqType = [OOEquipmentType equipmentTypeWithIdentifier:equipmentKey];
    if (eqType == nil)  return NO;
    
    // need to know if we are trying to add a Repair version of the equipment. In some cases
    // (e.g. available cargo space required), it makes sense to deny installation of equipment
    // if the condition is not satisfied, but it doesn't make sense to deny repair when the
    // equipment is already installed. For now, we are checking only the cargo space condition,
    // but other conditions might need to be revised too. - Nikos, 20151115
    if ([self hasEquipmentItem:[eqType damagedIdentifier]])
    {
        validationForDamagedEquipment = YES;
    }
    
    // not all conditions make sence checking while loading a game with already purchaged equipment.
    // while loading, we mainly need to catch changes when the installed oxps set has changed since saving. 
    if ([eqType requiresEmptyPylon] && [self missileCount] >= [self missileCapacity] && !loading)  return NO;
    if ([eqType  requiresMountedPylon] && [self missileCount] == 0 && !loading)  return NO;
    if ([self availableCargoSpace] < [eqType requiredCargoSpace] && !validationForDamagedEquipment && !loading)  return NO;
    if ([eqType requiresEquipment] != nil && ![self hasAllEquipment:[eqType requiresEquipment] includeWeapons:YES whileLoading:loading])  return NO;
    if ([eqType requiresAnyEquipment] != nil && ![self hasEquipmentItem:[eqType requiresAnyEquipment] includeWeapons:YES whileLoading:loading])  return NO;
    if ([eqType incompatibleEquipment] != nil && [self hasEquipmentItem:[eqType incompatibleEquipment] includeWeapons:YES whileLoading:loading])  return NO;
    if ([eqType requiresCleanLegalRecord] && [self legalStatus] != 0 && !loading)  return NO;
    if ([eqType requiresNonCleanLegalRecord] && [self legalStatus] == 0 && !loading)  return NO;
    if ([eqType requiresFreePassengerBerth] && [self passengerCount] >= [self passengerCapacity])  return NO;
    if ([eqType requiresFullFuel] && [self fuel] < [self fuelCapacity] && !loading)  return NO;
    if ([eqType requiresNonFullFuel] && [self fuel] >= [self fuelCapacity] && !loading)  return NO;
 
    if (!loading)
    {
        NSString *condition_script = [eqType conditionScript];
        if (condition_script != nil)
        {
            OOJSScript *condScript = [UNIVERSE getConditionScript:condition_script];
            if (condScript != nil) // should always be non-nil, but just in case
            {
                JSContext           *JScontext = OOJSAcquireContext();
                BOOL OK;
                JSBool allow_addition = false;
                jsval result;
                jsval args[] = { OOJSValueFromNativeObject(JScontext, equipmentKey) , OOJSValueFromNativeObject(JScontext, self) , OOJSValueFromNativeObject(JScontext, context)};
                
                OK = [condScript callMethod:OOJSID("allowAwardEquipment")
                                            inContext:JScontext
                                    withArguments:args count:sizeof args / sizeof *args
                                                 result:&result];
 
                if (OK) OK = JS_ValueToBoolean(JScontext, result, &allow_addition);
                
                OOJSRelinquishContext(JScontext);
 
                if (OK && !allow_addition)
                {
                    /* if the script exists, the function exists, the function
                     * returns a bool, and that bool is false, block
                     * addition. Otherwise allow it as default */
                    return NO;
                }
            }
        }
    }
 
    if ([self isPlayer])
    {
        if (![eqType isAvailableToPlayer])  return NO;
        if (![eqType isAvailableToAll])  
        {
            // find options that agree with this ship. Only player ships have these options.
            OOShipRegistry      *registry = [OOShipRegistry sharedRegistry];
            NSDictionary        *shipyardInfo = [registry shipyardInfoForKey:[self shipDataKey]];
            NSMutableSet        *options = [NSMutableSet setWithArray:[shipyardInfo oo_arrayForKey:KEY_OPTIONAL_EQUIPMENT]];
            [options addObjectsFromArray:[[shipyardInfo oo_dictionaryForKey:KEY_STANDARD_EQUIPMENT] oo_arrayForKey:KEY_EQUIPMENT_EXTRAS]];
            if (![options containsObject:equipmentKey])  return NO;
        }
    }
    else
    {
        if (![eqType isAvailableToNPCs])  return NO;
    }
    
    return YES;
}

References availableCargoSpace, OOJSScript::callMethod:inContext:withArguments:count:result:, OOEquipmentType::conditionScript, OOEquipmentType::equipmentTypeWithIdentifier:, fuel, fuelCapacity, Entity::isPlayer, legalStatus, missileCapacity, missileCount, nil, OOJSAcquireContext(), OOJSRelinquishContext(), OOJSValueFromNativeObject(), passengerCapacity, passengerCount, OOShipRegistry::sharedRegistry, shipDataKey, and OOShipRegistry::shipyardInfoForKey:.

Referenced by equipmentValidToAdd:inContext:.

Here is the call graph for this function:

Here is the caller graph for this function:

escortArray

- (NSArray *) escortArray

Definition at line 6990 of file ShipEntity.m.

{
    if (_escortGroup == nil)  return [NSArray array];
    return [[self escortEnumerator] allObjects];
}

References _escortGroup, escortArray, escortEnumerator, and nil.

Referenced by abandonShip, dockEscorts, enterWormhole:replacing:, escortArray, messageTime, and update:.

Here is the call graph for this function:

Here is the caller graph for this function:

escortCheckMother

- (void) escortCheckMother

implementation

Provided by category ShipEntity(PureAI).

Definition at line 1840 of file ShipEntityAI.m.

{
    ShipEntity   *mother = [self owner];
    
    if ([mother acceptAsEscort:self])
    {
        [self setOwner:mother];
        [self setGroup:[mother escortGroup]];
        [shipAI message:@"ESCORTING"];
    }
    else
    {
        [self setOwner:self];
        if ([self group] == [mother escortGroup])  [self setGroup:nil];
        [shipAI message:@"NOT_ESCORTING"];
    }
}

escortCount

- (uint8_t) escortCount

Definition at line 6997 of file ShipEntity.m.

{
    if (_escortGroup == nil)  return 0;
    return [_escortGroup count] - 1;
}

References _escortGroup, OOShipGroup::count, escortCount, and nil.

Referenced by acceptAsEscort:, deployEscorts, dumpSelfState, escortCount, and messageTime.

Here is the call graph for this function:

Here is the caller graph for this function:

escortEnumerator

- (NSEnumerator *) escortEnumerator

Definition at line 6983 of file ShipEntity.m.

{
    if (_escortGroup == nil)  return [[NSArray array] objectEnumerator];
    return [[_escortGroup mutationSafeEnumerator] ooExcludingObject:self];
}

References _escortGroup, escortEnumerator, OOShipGroup::mutationSafeEnumerator, and nil.

Referenced by deployEscorts, escortArray, escortEnumerator, and messageTime.

Here is the call graph for this function:

Here is the caller graph for this function:

escortGroup

- (OOShipGroup *) escortGroup

Definition at line 6932 of file ShipEntity.m.

{
    if (_escortGroup == nil)
    {
        _escortGroup = [[OOShipGroup alloc] initWithName:@"escort group"];
        [_escortGroup setLeader:self];
    }
    
    return _escortGroup;
}

References _escortGroup, escortGroup, nil, and OOShipGroup::setLeader:.

Referenced by abandonShip, acceptAsEscort:, deployEscorts, dockEscorts, ShipEntity(PureAI)::escortCheckMother, escortGroup, fireMissileWithIdentifier:andTarget:, StationEntity::launchIndependentShip:, messageTime, setUpEscorts, ShipEntity(Private)::setUpMixedEscorts, ShipGetProperty(), ShipEntity(AI)::suggestEscortTo:, and update:.

Here is the call graph for this function:

Here is the caller graph for this function:

evasiveAction:

- (void) evasiveAction:

(double)

delta_t

Definition at line 10442 of file ShipEntity.m.

                      :(double) delta_t
{
    stick_roll = flightRoll;    //desired roll and pitch
    stick_pitch = flightPitch;
 
    ShipEntity* target = [self primaryTarget];
    if (!target)   // leave now!
    {
        [self noteLostTargetAndGoIdle]; // NOTE: was AI message: rather than reactToMessage:
        return;
    }
 
    double agreement = dot_product(v_right,target->v_right);
    if (agreement > -0.3 && agreement < 0.3)
    {
        stick_roll = 0.0;
    }
    else
    {
        if (stick_roll >= 0.0) {
            stick_roll = max_flight_roll;
        } else {
            stick_roll = -max_flight_roll;
        }
    }
    if (stick_pitch >= 0.0) {
        stick_pitch = max_flight_pitch;
    } else {
        stick_pitch = -max_flight_pitch;
    }
    
  [self applySticks:delta_t];
}

References applySticks:, flightPitch, flightRoll, max_flight_pitch, max_flight_roll, noteLostTargetAndGoIdle, primaryTarget, stick_pitch, stick_roll, and v_right.

Referenced by behaviour_attack_break_off_target:, and behaviour_evasive_action:.

Here is the call graph for this function:

Here is the caller graph for this function:

exhaustEmissiveColor

- (OOColor *) exhaustEmissiveColor

Definition at line 11723 of file ShipEntity.m.

{
    return [[exhaust_emissive_color retain] autorelease];
}

References exhaustEmissiveColor.

Referenced by coordinates, exhaustEmissiveColor, ShipGetProperty(), and OOExhaustPlumeEntity::update:.

Here is the call graph for this function:

Here is the caller graph for this function:

exhaustEnumerator

- (NSEnumerator *) exhaustEnumerator

Definition at line 1349 of file ShipEntity.m.

{
    return [[self subEntities] objectEnumeratorFilteredWithSelector:@selector(isExhaust)];
}

References exhaustEnumerator, and subEntities.

Referenced by exhaustEnumerator, frustumRadius, resetExhaustPlumes, ShipGetProperty(), and subEntities.

Here is the call graph for this function:

Here is the caller graph for this function:

exitAIWithMessage:

- (void) exitAIWithMessage: (NSString *) message

implementation

Provided by category ShipEntity(PureAI).

Definition at line 1418 of file ShipEntityAI.m.

                          :(NSString *)message
{
    if ([message length] == 0)  message = @"RESTARTED";
    [shipAI exitStateMachineWithMessage:message];
}

explodeSelf

- (void) explodeSelf

implementation

Provided by category ShipEntity(PureAI).

Definition at line 2644 of file ShipEntityAI.m.

{
    [self getDestroyedBy:nil damageType:kOODamageTypeEnergy];
}

extraCargo

- (NSUInteger) extraCargo

Definition at line 3941 of file ShipEntity.m.

{
    return extra_cargo;
}

References extra_cargo, and extraCargo.

Referenced by extraCargo, and isFrangible.

Here is the call graph for this function:

Here is the caller graph for this function:

fightOrFleeHostiles

- (void) fightOrFleeHostiles

implementation

Provided by category ShipEntity(PureAI).

Definition at line 1784 of file ShipEntityAI.m.

{
    [self addDefenseTarget:[self foundTarget]];
    
    if ([self hasEscorts])
    {
        Entity *leTarget = [self lastEscortTarget];
        if (leTarget != nil)
        {
            [self setFoundTarget:leTarget];
            [shipAI message:@"FLEEING"];
            return;
        }
        
        [self setPrimaryAggressor:[self foundTarget]];
        [self addTarget:[self foundTarget]];
        [self deployEscorts];
        [shipAI message:@"DEPLOYING_ESCORTS"];
        [shipAI message:@"FLEEING"];
        return;
    }
    
    // consider launching a missile
    if (missiles > 2)   // keep a reserve
    {
        if (randf() < 0.50)
        {
            [self setPrimaryAggressor:[self foundTarget]];
            [self addTarget:[self foundTarget]];
            [self fireMissile];
            [shipAI message:@"FLEEING"];
            return;
        }
    }
    
    // consider fighting
    if (energy > maxEnergy * 0.80)
    {
        [self setPrimaryAggressor:[self foundTarget]];
        //[self performAttack];
        [shipAI message:@"FIGHTING"];
        return;
    }
    
    [shipAI message:@"FLEEING"];
}

fightOrFleeMissile

- (void) fightOrFleeMissile

implementation

Provided by category ShipEntity(PureAI).

Definition at line 1231 of file ShipEntityAI.m.

{
    // find an incoming missile...
    //
    ShipEntity          *missile =  nil;
    unsigned            i;
    NSEnumerator        *escortEnum = nil;
    ShipEntity          *escort = nil;
    ShipEntity          *target = nil;
    
    [self checkScannerIgnoringUnpowered];
    for (i = 0; (i < n_scanned_ships)&&(missile == nil); i++)
    {
        ShipEntity *thing = scanned_ships[i];
        if (thing->scanClass == CLASS_MISSILE)
        {
            target = [thing primaryTarget];
            
            if (target == self)
            {
                missile = thing;
            }
            else
            {
                for (escortEnum = [self escortEnumerator]; (escort = [escortEnum nextObject]); )
                {
                    if (target == escort)
                    {
                        missile = thing;
                    }
                }
            }
        }
    }
    
    if (missile == nil)  return;
    
    [self addTarget:missile];
    [self addDefenseTarget:missile];
    
    // Notify own ship script that we are being attacked.   
    ShipEntity *hunter = [missile owner];
    [self doScriptEvent:OOJSID("shipBeingAttacked") withArgument:hunter];
    [hunter doScriptEvent:OOJSID("shipAttackedOther") withArgument:self];
    
    if ([self isPolice])
    {
        // Notify other police in group of attacker.
        // Note: prior to 1.73 this was done only if we had ECM.
        NSEnumerator    *policeEnum = nil;
        ShipEntity      *police = nil;
        
        for (policeEnum = [[self group] mutationSafeEnumerator]; (police = [policeEnum nextObject]); )
        {
            [police setFoundTarget:hunter];
            [police setPrimaryAggressor:hunter];
        }
    }
    
    // if I'm a copper and you're not, then mark the other as an offender!
    if ([self isPolice] && ![hunter isPolice])  [hunter markAsOffender:64 withReason:kOOLegalStatusReasonAttackedPolice];
 
    if ([self hasECM])
    {
        // use the ECM and battle on
        
        [self setPrimaryAggressor:hunter];  // lets get them now for that!
        [self setFoundTarget:hunter];
        
        [self fireECM];
        return;
    }
    
    // RUN AWAY !!
    desired_range = 10000;
    [self performFlee];
    [shipAI message:@"FLEEING"];
}

findBoundingBoxRelativeTo:InVectors:_i:_j:

- (BoundingBox) findBoundingBoxRelativeTo: (Entity *) other InVectors: (Vector) _i: (Vector) _j: (Vector) _k

implementation

Definition at line 14313 of file ShipEntity.m.

                                         :(Entity *)other InVectors:(Vector) _i :(Vector) _j :(Vector) _k
{
    HPVector  opv = other ? other->position : position;
    return [self findBoundingBoxRelativeToPosition:opv InVectors:_i :_j :_k];
}

References findBoundingBoxRelativeToPosition:InVectors:_i:_j:, and Entity::position.

Here is the call graph for this function:

findBoundingBoxRelativeToPosition:InVectors:_i:_j:

- (BoundingBox) findBoundingBoxRelativeToPosition: (HPVector) opv InVectors: (Vector) _i: (Vector) _j: (Vector) _k

implementation

Definition at line 1420 of file ShipEntity.m.

                                                :(HPVector)opv InVectors:(Vector) _i :(Vector) _j :(Vector) _k
{
    // HPVect: check that this conversion doesn't lose needed precision
    return [[self mesh] findBoundingBoxRelativeToPosition:HPVectorToVector(opv)
                                                    basis:_i :_j :_k
                                         selfPosition:HPVectorToVector(position)
                                                selfBasis:v_right :v_up :v_forward];
}

References mesh.

Referenced by findBoundingBoxRelativeTo:InVectors:_i:_j:.

Here is the call graph for this function:

Here is the caller graph for this function:

findBoundingBoxRelativeToPosition:InVectors:i:j:

- (BoundingBox) findBoundingBoxRelativeToPosition:		(HPVector)	opv
InVectors:		(Vector)
i:		(Vector)
j:		(Vector)	k

References absoluteTractorPosition, aftWeaponOffset, countsAsKill, frustumRadius, isBoulder, isMinable, setUpEscorts, setUpSubEntities, shipDataKey, shipDataKeyAutoRole, shipInfoDictionary, and updateEscortFormation.

Referenced by positionOffsetForShipInRotationToAlignment.

Here is the call graph for this function:

Here is the caller graph for this function:

findNearestPlanet

- (OOPlanetEntity *) findNearestPlanet

Definition at line 7635 of file ShipEntity.m.

{
    /*
        Performance note: this method is called every frame by every ship, and
        has a significant profiler presence.
        -- Ahruman 2012-09-13
    */
    OOPlanetEntity *planet = nil, *bestPlanet = nil;
    float bestRange = INFINITY;
    HPVector myPosition = [self position];
    
    // valgrind complains about this line here. Might be compiler/GNUstep bug? 
    // should we go back to a traditional enumerator? - CIM
    // similar complaints about the other foreach() in this file
    foreach (planet, [UNIVERSE planets])
    {
        // Ignore miniature planets.
        if ([planet planetType] == STELLAR_TYPE_MINIATURE)  continue;
        
        float range = SurfaceDistanceSqaredV(myPosition, planet);
        if (range < bestRange)
        {
            bestPlanet = planet;
            bestRange = range;
        }
    }
    
    return bestPlanet;
}

References findNearestPlanet, nil, Entity::position, STELLAR_TYPE_MINIATURE, SurfaceDistanceSqaredV, and UNIVERSE.

Referenced by findNearestPlanet, findNearestStellarBody, ShipEntity(PureAI)::landOnPlanet, ShipEntity(AI)::performLandOnPlanet, reportAIMessages, and ShipEntity(PureAI)::setTakeOffFromPlanet.

Here is the call graph for this function:

Here is the caller graph for this function:

findNearestPlanetExcludingMoons

- (OOPlanetEntity *) findNearestPlanetExcludingMoons

Definition at line 7684 of file ShipEntity.m.

{
    OOPlanetEntity      *result = nil;
    OOPlanetEntity      *planet = nil;
    NSArray             *bodies = nil;
    NSArray             *planets = nil;
    unsigned            i;
    
    bodies = [UNIVERSE planets];
    planets = [NSMutableArray arrayWithCapacity:[bodies count]];
 
    for (i=0; i < [bodies count]; i++)
    {
        planet = [bodies objectAtIndex:i];
        if([planet planetType] == STELLAR_TYPE_NORMAL_PLANET)
                    planets = [planets arrayByAddingObject:planet];
    }
    
    if ([planets count] == 0)  return nil;
    
    planets = [planets sortedArrayUsingFunction:ComparePlanetsBySurfaceDistance context:self];
    result = [planets objectAtIndex:0];
        
    return result;
}

References count, findNearestPlanetExcludingMoons, nil, and STELLAR_TYPE_NORMAL_PLANET.

Referenced by findNearestPlanetExcludingMoons, reportAIMessages, and ShipEntity(PureAI)::setCourseToPlanet.

Here is the call graph for this function:

Here is the caller graph for this function:

findNearestStellarBody

- (Entity< OOStellarBody > *) findNearestStellarBody

Definition at line 7666 of file ShipEntity.m.

{
    Entity<OOStellarBody> *match = [self findNearestPlanet];
    OOSunEntity *sun = [UNIVERSE sun];
    
    if (sun != nil)
    {
        if (match == nil ||
            SurfaceDistanceSqared(self, sun) < SurfaceDistanceSqared(self, match))
        {
            match = sun;
        }
    }
    
    return match;
}

References findNearestPlanet, findNearestStellarBody, nil, and SurfaceDistanceSqared.

Referenced by ShipEntity(PureAI)::checkAegis, checkForAegis, PlayerEntity::dialAltitude, findNearestStellarBody, and reportAIMessages.

Here is the call graph for this function:

Here is the caller graph for this function:

findNewDefenseTarget

- (void) findNewDefenseTarget

implementation

Provided by category ShipEntity(PureAI).

Definition at line 1544 of file ShipEntityAI.m.

{
    [self checkScanner];
    unsigned i;
    for (i = 0; i < n_scanned_ships ; i++)
    {
        ShipEntity *ship = scanned_ships[i];
        if (![ship isCloaked] && (([ship primaryTarget] == self && [ship hasHostileTarget]) || [ship isMine] || ([ship isThargoid] != [self isThargoid])))
        {
            if (![self isDefenseTarget:ship])
            {
                [self addDefenseTarget:ship];
                return;
            }
        }
    }
}

findSubentityBoundingBox

- (BoundingBox) findSubentityBoundingBox

Definition at line 2228 of file ShipEntity.m.

{
    return [[self mesh] findSubentityBoundingBoxWithPosition:HPVectorToVector(position) rotMatrix:rotMatrix];
}

References findSubentityBoundingBox, OOMesh::findSubentityBoundingBoxWithPosition:rotMatrix:, and mesh.

Referenced by PlayerEntity::doBookkeeping:, findSubentityBoundingBox, maxFlightSpeed, setUpOneStandardSubentity:asTurret:, and update:.

Here is the call graph for this function:

Here is the caller graph for this function:

fireAftWeapon:

- (BOOL) fireAftWeapon:

(double)

range

Definition at line 11602 of file ShipEntity.m.

                      :(double)range
{
    // set the values from aft_weapon_type.
    currentWeaponFacing = WEAPON_FACING_AFT;
    [self setWeaponDataFromType:aft_weapon_type];
    
    return [self fireWeapon:aft_weapon_type direction:WEAPON_FACING_AFT range:range];
}

References currentWeaponFacing, fireWeapon:direction:range:, setWeaponDataFromType:, and WEAPON_FACING_AFT.

Referenced by behaviour_running_defense:, and behaviour_scripted_ai:.

Here is the call graph for this function:

Here is the caller graph for this function:

fireDirectLaserDefensiveShot

- (BOOL) fireDirectLaserDefensiveShot

Definition at line 11827 of file ShipEntity.m.

{
    NSEnumerator *targetEnum = [self defenseTargetEnumerator];
    Entity *target = nil;
    while ((target = [[targetEnum nextObject] weakRefUnderlyingObject]))
    {
        // can't fire defensively at cloaked ships
        if ([target scanClass] == CLASS_NO_DRAW || [(ShipEntity *)target isCloaked] || [target energy] <= 0.0)
        {
            [self removeDefenseTarget:target];
        }
        else 
        {
            double range = [self rangeToSecondaryTarget:target];
            if (range < weaponRange)
            {
                return [self fireDirectLaserShotAt:target];
            }
            else if (range > scannerRange)
            {
                [self removeDefenseTarget:target];
            }
        }
    }
    return NO;
}

References defenseTargetEnumerator, Entity::energy, fireDirectLaserDefensiveShot, fireDirectLaserShotAt:, isCloaked, nil, rangeToSecondaryTarget:, removeDefenseTarget:, scanClass, scannerRange, and weaponRange.

Referenced by coordinates, fireDirectLaserDefensiveShot, and fireDirectLaserShot:.

Here is the call graph for this function:

Here is the caller graph for this function:

fireDirectLaserShot:

- (BOOL) fireDirectLaserShot:

(double)

range

Definition at line 11817 of file ShipEntity.m.

                            :(double)range
{
    Entity          *my_target = [self primaryTarget];
    if (my_target == nil)  return [self fireDirectLaserDefensiveShot];
    if (range > randf() * weaponRange * (accuracy+5.5))  return [self fireDirectLaserDefensiveShot];
    if (range > weaponRange)  return [self fireDirectLaserDefensiveShot];
    return [self fireDirectLaserShotAt:my_target];
}

References accuracy, fireDirectLaserDefensiveShot, fireDirectLaserShotAt:, nil, primaryTarget, randf(), and weaponRange.

Referenced by fireWeapon:direction:range:.

Here is the call graph for this function:

Here is the caller graph for this function:

fireDirectLaserShotAt:

- (BOOL) fireDirectLaserShotAt:

(Entity *)

my_target

Definition at line 11855 of file ShipEntity.m.

                              :(Entity *)my_target
{
    GLfloat         hit_at_range;
    double          range_limit2 = weaponRange*weaponRange;
    Vector          r_pos;
    
    r_pos = vector_normal_or_zbasis([self vectorTo:my_target]);
 
    Quaternion      q_laser = quaternion_rotation_between(r_pos, kBasisZVector);
 
    GLfloat acc_factor = (10.0 - accuracy) * 0.001;
 
    q_laser.x += acc_factor * (randf() - 0.5); // randomise aim a little (+/- 0.005 at accuracy 0, never miss at accuracy 10)
    q_laser.y += acc_factor * (randf() - 0.5);
    q_laser.z += acc_factor * (randf() - 0.5);
    quaternion_normalize(&q_laser);
 
    Quaternion q_save = orientation; // save rotation
    orientation = q_laser;           // face in direction of laser
    // weapon offset for thargoid lasers is always zero
    ShipEntity *victim = [UNIVERSE firstShipHitByLaserFromShip:self inDirection:WEAPON_FACING_FORWARD offset:kZeroVector gettingRangeFound:&hit_at_range];
    [self setShipHitByLaser:victim];
    orientation = q_save;            // restore rotation
 
    Vector  vel = vector_multiply_scalar(v_forward, flightSpeed);
    
    // do special effects laser line
    OOLaserShotEntity *shot = [OOLaserShotEntity laserFromShip:self direction:WEAPON_FACING_FORWARD offset:kZeroVector];
    [shot setColor:laser_color];
    [shot setScanClass: CLASS_NO_DRAW];
    [shot setPosition: position];
    [shot setOrientation: q_laser];
    [shot setVelocity: vel];
    
    if (victim != nil)
    {
        ShipEntity *subent = [victim subEntityTakingDamage];
        if (subent != nil && [victim isFrangible])
        {
            // do 1% bleed-through damage...
            [victim takeEnergyDamage: 0.01 * weapon_damage from:self becauseOf:self weaponIdentifier:[[self weaponTypeForFacing:WEAPON_FACING_FORWARD strict:YES] identifier]];
            victim = subent;
        }
 
        if (hit_at_range * hit_at_range < range_limit2)
        {
            [victim takeEnergyDamage:weapon_damage from:self becauseOf:self weaponIdentifier:[[self weaponTypeForFacing:WEAPON_FACING_FORWARD strict:YES] identifier]];    // a very palpable hit
 
            [shot setRange:hit_at_range];
            Vector vd = vector_forward_from_quaternion([shot orientation]);
            HPVector flash_pos = HPvector_add([shot position], vectorToHPVector(vector_multiply_scalar(vd, hit_at_range)));
            [UNIVERSE addLaserHitEffectsAt:flash_pos against:victim damage:weapon_damage color:laser_color];
        }
    }
    
    [UNIVERSE addEntity:shot];
    
    [self resetShotTime];
    
    return YES;
}

References accuracy, flightSpeed, OOEquipmentType::identifier, isFrangible, kBasisZVector, OOLaserShotEntity::laserFromShip:direction:offset:, nil, Entity::orientation, Entity::position, quaternion_rotation_between(), randf(), resetShotTime, OOLightParticleEntity::setColor:, Entity::setOrientation:, Entity::setPosition:, Entity::setScanClass:, setShipHitByLaser:, Entity::setVelocity:, subEntityTakingDamage, takeEnergyDamage:from:becauseOf:weaponIdentifier:, v_forward, vector_forward_from_quaternion(), weaponRange, and weaponTypeForFacing:strict:.

Referenced by fireDirectLaserDefensiveShot, and fireDirectLaserShot:.

Here is the call graph for this function:

Here is the caller graph for this function:

fireECM

- (BOOL) fireECM

Reimplemented in PlayerEntity.

Definition at line 12354 of file ShipEntity.m.

{
    if (![self hasECM])  return NO;
    
    OOECMBlastEntity *ecmDevice = [[OOECMBlastEntity alloc] initFromShip:self];
    [UNIVERSE addEntity:ecmDevice];
    [ecmDevice release];
    return YES;
}

References fireECM, and hasECM.

Referenced by coordinates, ShipEntity(PureAI)::fightOrFleeMissile, fireECM, and ShipFireECM().

Here is the call graph for this function:

Here is the caller graph for this function:

fireLaserShotInDirection:weaponIdentifier:

- (BOOL) fireLaserShotInDirection:		(OOWeaponFacing)	direction
weaponIdentifier:		(NSString *)	weaponIdentifier

Definition at line 11944 of file ShipEntity.m.

                                 :(OOWeaponFacing)direction weaponIdentifier:(NSString *)weaponIdentifier
{
    double          range_limit2 = weaponRange * weaponRange;
    GLfloat         hit_at_range;
    NSUInteger      i, barrels;
    Vector          vel = vector_multiply_scalar(v_forward, flightSpeed);
    NSArray         *laserPortOffsets = [self laserPortOffset:direction];
    OOLaserShotEntity *shot = nil;
 
    barrels = [laserPortOffsets count];
    NSMutableArray *shotEntities = [NSMutableArray arrayWithCapacity:barrels];
 
    
    GLfloat         effective_damage = weapon_damage;
    if (barrels > 1 && !_multiplyWeapons)
    {
        // then divide the shot power between the shots
        effective_damage /= (GLfloat)barrels;
    }
    
    for (i=0;i<barrels;i++)
    {
        Vector          laserPortOffset = [laserPortOffsets oo_vectorAtIndex:i];
    
        last_shot_time = [UNIVERSE getTime];
 
        ShipEntity *victim = [UNIVERSE firstShipHitByLaserFromShip:self inDirection:direction offset:laserPortOffset gettingRangeFound:&hit_at_range];
        [self setShipHitByLaser:victim];
    
        shot = [OOLaserShotEntity laserFromShip:self direction:direction offset:laserPortOffset];
        if ([self isPlayer])
        {
            [shotEntities addObject:shot];
        }
    
        [shot setColor:laser_color];
        [shot setScanClass: CLASS_NO_DRAW];
        [shot setVelocity: vel];
    
        if (victim != nil)
        {
            [self adjustMissedShots:-1];
            if ([self isPlayer])
            {
                [PLAYER addRoleForAggression:victim];
            }
        
            /*  CRASH in [victim->sub_entities containsObject:subent] here (1.69, OS X/x86).
                Analysis: Crash is in _freedHandler called from CFEqual, indicating either a dead
                object in victim->sub_entities or dead victim->subentity_taking_damage. I suspect
                the latter. Probable solution: dying subentities must cause parent to clean up
                properly. This was probably obscured by the entity recycling scheme in the past.
                Fix: made subentity_taking_damage a weak reference accessed via a method.
                -- Ahruman 20070706, 20080304
            */
            ShipEntity *subent = [victim subEntityTakingDamage];
            if (subent != nil && [victim isFrangible])
            {
                // do 1% bleed-through damage...
                [victim takeEnergyDamage: 0.01 * effective_damage from:self becauseOf:self weaponIdentifier:weaponIdentifier];
                victim = subent;
            }
        
            if (hit_at_range * hit_at_range < range_limit2)
            {
                [victim takeEnergyDamage:effective_damage from:self becauseOf:self weaponIdentifier:weaponIdentifier]; // a very palpable hit
 
                [shot setRange:hit_at_range];
                Vector vd = vector_forward_from_quaternion([shot orientation]);
                HPVector flash_pos = HPvector_add([shot position], vectorToHPVector(vector_multiply_scalar(vd, hit_at_range)));
                [UNIVERSE addLaserHitEffectsAt:flash_pos against:victim damage:effective_damage color:laser_color];
            }
        }
        else
        {
            [self adjustMissedShots:+1];
 
            // shot missed
            if (![self isCloaked])
            {
                victim = [self primaryTarget];
                if ([victim isShip]) // it might not be - fixes crash bug
                {
 
                    /* player currently gets a bit of an advantage here if
                     * they ambush without having their target actually
                     * targeted. Though in those circumstances they
                     * shouldn't be missing their first shot anyway. */
                    if (dot_product(vector_forward_from_quaternion([shot orientation]),vector_normal([self vectorTo:victim])) > 0.995)
                    {
                        /* plausibly aimed at target. Allows reaction
                         * before attacker actually hits. But we need to
                         * be able to distinguish in AI from ATTACKED so
                         * that ships in combat aren't bothered by
                         * amateurs. So should only respond to
                         * ATTACKER_MISSED if not already fighting */
                        if ([self isPlayer])
                        {
                            [PLAYER addRoleForAggression:victim];
                        }
                        [victim setPrimaryAggressor:self];
                        [victim setFoundTarget:self];
                        [victim reactToAIMessage:@"ATTACKER_MISSED" context:@"attacker narrowly misses"];
                        [victim doScriptEvent:OOJSID("shipBeingAttackedUnsuccessfully") withArgument:self];
                    }
                }
            }
        }
    
        [UNIVERSE addEntity:shot];
 
    }
    
    if ([self isPlayer])
    {
        [(PlayerEntity *)self setLastShot:shotEntities];
    }
    
    [self resetShotTime];
 
    return YES;
}

References _multiplyWeapons, adjustMissedShots:, flightSpeed, isCloaked, isFrangible, Entity::isPlayer, Entity::isShip, OOLaserShotEntity::laserFromShip:direction:offset:, laserPortOffset:, last_shot_time, nil, Entity::orientation, Entity::position, primaryTarget, resetShotTime, OOLightParticleEntity::setColor:, Entity::setScanClass:, setShipHitByLaser:, Entity::setVelocity:, subEntityTakingDamage, takeEnergyDamage:from:becauseOf:weaponIdentifier:, v_forward, vector_forward_from_quaternion(), weapon_damage, and weaponRange.

Referenced by PlayerEntity::fireMainWeapon, and fireWeapon:direction:range:.

Here is the call graph for this function:

Here is the caller graph for this function:

fireMainWeapon:

- (BOOL) fireMainWeapon:

(double)

range

Definition at line 11556 of file ShipEntity.m.

                       :(double)range
{
    // set the values from forward_weapon_type.
    // OXPs can override the default front laser energy damage.
    currentWeaponFacing = WEAPON_FACING_FORWARD;
    [self setWeaponDataFromType:forward_weapon_type];
 
//  weapon damage override no longer effective
//  weapon_damage = weapon_damage_override;
    
    BOOL result = [self fireWeapon:forward_weapon_type direction:WEAPON_FACING_FORWARD range:range];
    if (isWeaponNone(forward_weapon_type))
    {
        // need to check subentities to avoid AI oddities
        // will already have fired them by now, though
        NSEnumerator    *subEnum = [self shipSubEntityEnumerator];
        ShipEntity      *se = nil;
        OOWeaponType            weapon_type = nil;
        BOOL hasTurrets = NO;
        while (isWeaponNone(weapon_type) && (se = [subEnum nextObject]))
        {
            weapon_type = se->forward_weapon_type;
            weapon_temp = se->forward_weapon_temp;
            if (se->behaviour == BEHAVIOUR_TRACK_AS_TURRET)
            {
                hasTurrets = YES;
            }
        }
        if (isWeaponNone(weapon_type) && hasTurrets)
        { /* no forward weapon but has turrets, so set up range calculations accordingly
             note: this was hard-coded to 10000.0, although turrets have a notably 
             shorter range. We are using a multiplier of 1.667 in order to not change
             something that already works, but probably it would be best to use
             TURRET_SHOT_RANGE * COMBAT_WEAPON_RANGE_FACTOR here
          */
             weaponRange = TURRET_SHOT_RANGE * 1.667;
        }
        else
        {
            [self setWeaponDataFromType:weapon_type];
        }
    }
    return result;
}

References behaviour, currentWeaponFacing, fireWeapon:direction:range:, forward_weapon_temp, forward_weapon_type, isWeaponNone(), nil, setWeaponDataFromType:, shipSubEntityEnumerator, TURRET_SHOT_RANGE, WEAPON_FACING_FORWARD, weapon_temp, and weaponRange.

Referenced by behaviour_attack_fly_to_target:, behaviour_attack_mining_target:, behaviour_attack_sniper:, behaviour_evasive_action:, behaviour_flee_target:, behaviour_fly_to_target_six:, behaviour_running_defense:, and behaviour_scripted_ai:.

Here is the call graph for this function:

Here is the caller graph for this function:

fireMissile

- (ShipEntity *) fireMissile

Reimplemented in PlayerEntity.

Definition at line 12172 of file ShipEntity.m.

{
    return [self fireMissileWithIdentifier:nil andTarget:[self primaryTarget]];
}

References fireMissile, fireMissileWithIdentifier:andTarget:, and primaryTarget.

Referenced by considerFiringMissile:, coordinates, ShipEntity(PureAI)::fightOrFleeHostiles, fireMissile, and ShipFireMissile().

Here is the call graph for this function:

Here is the caller graph for this function:

fireMissileWithIdentifier:andTarget:

- (ShipEntity *) fireMissileWithIdentifier:		(NSString *)	identifier
andTarget:		(Entity *)	target

Definition at line 12178 of file ShipEntity.m.

                                          :(NSString *) identifier andTarget:(Entity *) target
{
    // both players and NPCs!
    //
    ShipEntity      *missile = nil;
    ShipEntity      *target_ship = nil;
    
    Vector          vel;
    Vector          start, v_eject;
    
    if ([UNIVERSE getTime] < missile_launch_time) return nil;
 
    start = [self missileLaunchPosition];
    
    double  throw_speed = 250.0f;
    
    if  ((missiles <= 0)||(target == nil)||([target scanClass] == CLASS_NO_DRAW))   // no missile lock!
        return nil;
    
    if ([target isShip])
    {
        target_ship = (ShipEntity*)target;
        if ([target_ship isCloaked])
        {
            return nil;
        }
        // missile fire requires being in scanner range
        if (HPmagnitude2(HPvector_subtract([target_ship position], position)) > scannerRange * scannerRange)
        {
            return nil;
        }
        if (![self hasMilitaryScannerFilter] && [target_ship isJammingScanning]) 
        {
            return nil;
        }
    }
    
    unsigned i;
    if (identifier == nil)
    {
        // use a random missile from the list
        i = floor(randf()*(double)missiles);
        identifier = [missile_list[i] identifier];
        missile = [UNIVERSE newShipWithRole:identifier];
        if (EXPECT_NOT(missile == nil))    // invalid missile role.
        {
            // remove that invalid missile role from the missiles list.
            while ( ++i < missiles ) missile_list[i - 1] = missile_list[i];
            missiles--;
        }
    }
    else
        missile = [UNIVERSE newShipWithRole:identifier];
    
    if (EXPECT_NOT(missile == nil))    return nil;
    
    // By definition, the player will always have the specified missile.
    // What if the NPC didn't actually have the specified missile to begin with?
    if (!isPlayer && ![self removeExternalStore:[OOEquipmentType equipmentTypeWithIdentifier:identifier]])
    {
        [missile release];
        return nil;
    }
    
    double mcr = missile->collision_radius;
    v_eject = vector_normal(start);
    vel = kZeroVector;   // starting velocity
    
    // check if start is within bounding box...
    while ( (start.x > boundingBox.min.x - mcr)&&(start.x < boundingBox.max.x + mcr)&&
            (start.y > boundingBox.min.y - mcr)&&(start.y < boundingBox.max.y + mcr)&&
            (start.z > boundingBox.min.z - mcr)&&(start.z < boundingBox.max.z + mcr) )
    {
        start = vector_add(start, vector_multiply_scalar(v_eject, mcr));
    }
    
    vel = vector_add(vel, vector_multiply_scalar(v_forward, flightSpeed + throw_speed));
    
    Quaternion q1 = [self normalOrientation];
    HPVector origin = HPvector_add(position, vectorToHPVector(quaternion_rotate_vector(q1, start)));
    
    if (isPlayer) [missile setScanClass: CLASS_MISSILE];
    
// special cases
    
    //We don't want real missiles in a group. Missiles could become escorts when the group is also used as escortGroup.
    if ([missile scanClass] == CLASS_THARGOID) 
    {
        if([self group] == nil) [self setGroup:[OOShipGroup groupWithName:@"thargoid group"]];
        
        ShipEntity  *thisGroupLeader = [_group leader];
        
        if ([thisGroupLeader escortGroup] != _group) // avoid adding tharons to escort groups
        {
            [missile setGroup:[self group]];
        }
    }
    
    // is this a submunition?
    if (![self isMissileFlagSet])  [missile setOwner:self];
    else  [missile setOwner:[self owner]];
 
// end special cases
 
    [missile setPosition:origin];
    [missile addTarget:target];    
    [missile setOrientation:q1];
    [missile setIsMissileFlag:YES];
    [missile setVelocity:vel];
    [missile setSpeed:150.0f];
    [missile setDistanceTravelled:0.0f];
    [missile resetShotTime];
    missile_launch_time = [UNIVERSE getTime] + missile_load_time; // set minimum launchtime for the next missile.
    
    [UNIVERSE addEntity:missile];   // STATUS_IN_FLIGHT, AI state GLOBAL
    [missile release]; //release
    
    // missile lives on after UNIVERSE addEntity
    if ([missile isMissile] && [target isShip])
    {
        [self doScriptEvent:OOJSID("shipFiredMissile") withArgument:missile andArgument:target_ship];
        [target_ship setPrimaryAggressor:self];
        [target_ship doScriptEvent:OOJSID("shipAttackedWithMissile") withArgument:missile andArgument:self];
        [target_ship reactToAIMessage:@"INCOMING_MISSILE" context:@"someone's shooting at me!"];
        if (cloaking_device_active && cloakPassive)
        {
            // parity between player &NPCs, only deactivate cloak for missiles
            [self deactivateCloakingDevice];
        }
    }
    else
    {
        [self doScriptEvent:OOJSID("shipReleasedEquipment") withArgument:missile];
    }
    
    return missile;
}

References _group, addTarget:, Entity::boundingBox, cloaking_device_active, cloakPassive, Entity::collision_radius, deactivateCloakingDevice, doScriptEvent:withArgument:, doScriptEvent:withArgument:andArgument:, escortGroup, EXPECT_NOT, flightSpeed, group, OOShipGroup::groupWithName:, hasMilitaryScannerFilter, OOEquipmentType::identifier, isCloaked, isJammingScanning, isMissile, isMissileFlagSet, Entity::isPlayer, Entity::isShip, kZeroVector, OOShipGroup::leader, missile_launch_time, missile_list, missile_load_time, missileLaunchPosition, missiles, nil, Entity::normalOrientation, Entity::owner, Entity::position, quaternion_rotate_vector(), randf(), reactToAIMessage:context:, resetShotTime, scanClass, scannerRange, Entity::setDistanceTravelled:, setGroup:, setIsMissileFlag:, Entity::setOrientation:, setOwner:, Entity::setPosition:, setPrimaryAggressor:, Entity::setScanClass:, setSpeed:, Entity::setVelocity:, UNIVERSE, and v_forward.

Referenced by PlayerEntity::fireMissile, fireMissile, and ShipFireMissile().

Here is the call graph for this function:

Here is the caller graph for this function:

firePortWeapon:

- (BOOL) firePortWeapon:

(double)

range

Definition at line 11612 of file ShipEntity.m.

                       :(double)range
{
    // set the values from port_weapon_type.
    currentWeaponFacing = WEAPON_FACING_PORT;
    [self setWeaponDataFromType:port_weapon_type];
    
    return [self fireWeapon:port_weapon_type direction:WEAPON_FACING_PORT range:range];
}

References currentWeaponFacing, fireWeapon:direction:range:, setWeaponDataFromType:, and WEAPON_FACING_PORT.

Referenced by behaviour_attack_broadside_target:leftside:, and behaviour_scripted_ai:.

Here is the call graph for this function:

Here is the caller graph for this function:

fireStarboardWeapon:

- (BOOL) fireStarboardWeapon:

(double)

range

Definition at line 11622 of file ShipEntity.m.

                            :(double)range
{
    // set the values from starboard_weapon_type.
    currentWeaponFacing = WEAPON_FACING_STARBOARD;
    [self setWeaponDataFromType:starboard_weapon_type];
    
    return [self fireWeapon:starboard_weapon_type direction:WEAPON_FACING_STARBOARD range:range];
}

References currentWeaponFacing, fireWeapon:direction:range:, setWeaponDataFromType:, and WEAPON_FACING_STARBOARD.

Referenced by behaviour_attack_broadside_target:leftside:, and behaviour_scripted_ai:.

Here is the call graph for this function:

Here is the caller graph for this function:

fireSubentityLaserShot:

- (BOOL) fireSubentityLaserShot:

(double)

range

Definition at line 11729 of file ShipEntity.m.

                               :(double)range
{
    [self setShipHitByLaser:nil];
    
    if (isWeaponNone(forward_weapon_type))  return NO;
    [self setWeaponDataFromType:forward_weapon_type];
    
    ShipEntity *parent = [self owner];
    NSAssert([parent isShipWithSubEntityShip:self], @"-fireSubentityLaserShot: called on ship which is not a subentity.");
 
    // subentity lasers still draw power from the main entity
    if ([parent energy] <= weapon_energy_use) return NO;
    if ([self shotTime] < weapon_recharge_rate)  return NO;
    if (forward_weapon_temp > WEAPON_COOLING_CUTOUT * NPC_MAX_WEAPON_TEMP)  return NO;
    if (range > weaponRange)  return NO;
 
    forward_weapon_temp += weapon_shot_temperature;
    [parent setEnergy:([parent energy] - weapon_energy_use)];
 
    GLfloat hitAtRange = weaponRange;
    OOWeaponFacing direction = WEAPON_FACING_FORWARD;
    ShipEntity *victim = [UNIVERSE firstShipHitByLaserFromShip:self inDirection:direction offset:kZeroVector gettingRangeFound:&hitAtRange];
    [self setShipHitByLaser:victim];
    
    OOLaserShotEntity *shot = [OOLaserShotEntity laserFromShip:self direction:direction offset:kZeroVector];
    [shot setColor:laser_color];
    [shot setScanClass:CLASS_NO_DRAW];
    
    if (victim != nil)
    {
        [self adjustMissedShots:-1];
        
        if ([self isPlayer])
        {
            [PLAYER addRoleForAggression:victim];
        }
 
        ShipEntity *subent = [victim subEntityTakingDamage];
        if (subent != nil && [victim isFrangible])
        {
            // do 1% bleed-through damage...
            [victim takeEnergyDamage:0.01 * weapon_damage from:self becauseOf:parent weaponIdentifier:[[self weaponTypeForFacing:WEAPON_FACING_FORWARD strict:YES] identifier]];
            victim = subent;
        }
        
        if (hitAtRange < weaponRange)
        {
            [victim takeEnergyDamage:weapon_damage from:self becauseOf:parent weaponIdentifier:[[self weaponTypeForFacing:WEAPON_FACING_FORWARD strict:YES] identifier]];  // a very palpable hit
            
            [shot setRange:hitAtRange];
            Vector vd = vector_forward_from_quaternion([shot orientation]);
            HPVector flash_pos = HPvector_add([shot position], vectorToHPVector(vector_multiply_scalar(vd, hitAtRange)));
            [UNIVERSE addLaserHitEffectsAt:flash_pos against:victim damage:weapon_damage color:laser_color];
        }
    }
    else
    {
        [self adjustMissedShots:+1];
 
        // see ATTACKER_MISSED section of main entity laser routine
        if (![parent isCloaked])
        {
            victim = [parent primaryTarget];
            
            Vector shotDirection = vector_forward_from_quaternion([shot orientation]);
            Vector victimDirection = vector_normal(HPVectorToVector(HPvector_subtract([victim position], [parent position])));
            if (dot_product(shotDirection, victimDirection) > 0.995)    // Within 84.26 degrees
            {
                if ([self isPlayer])
                {
                    [PLAYER addRoleForAggression:victim];
                }
                [victim setPrimaryAggressor:parent];
                [victim setFoundTarget:parent];
                [victim reactToAIMessage:@"ATTACKER_MISSED" context:@"attacker narrowly misses"];
                [victim doScriptEvent:OOJSID("shipBeingAttackedUnsuccessfully") withArgument:parent];
 
            }
        }
    }
    
    [UNIVERSE addEntity:shot];
    [self resetShotTime];
    
    return YES;
}

References adjustMissedShots:, doScriptEvent:withArgument:, Entity::energy, forward_weapon_temp, forward_weapon_type, OOEquipmentType::identifier, isCloaked, isFrangible, Entity::isPlayer, isWeaponNone(), OOLaserShotEntity::laserFromShip:direction:offset:, nil, NPC_MAX_WEAPON_TEMP, Entity::orientation, Entity::owner, Entity::position, primaryTarget, reactToAIMessage:context:, resetShotTime, OOLightParticleEntity::setColor:, Entity::setEnergy:, setFoundTarget:, setPrimaryAggressor:, Entity::setScanClass:, setShipHitByLaser:, setWeaponDataFromType:, shotTime, subEntityTakingDamage, takeEnergyDamage:from:becauseOf:weaponIdentifier:, vector_forward_from_quaternion(), WEAPON_COOLING_CUTOUT, weapon_energy_use, WEAPON_FACING_FORWARD, weapon_recharge_rate, weapon_shot_temperature, weaponRange, and weaponTypeForFacing:strict:.

Here is the call graph for this function:

fireTurretCannon:

- (BOOL) fireTurretCannon:

(double)

range

Definition at line 11644 of file ShipEntity.m.

                         :(double) range
{
    if ([self shotTime] < weapon_recharge_rate)
        return NO;
    if (range > weaponRange * 1.01) // 1% more than max range - open up just slightly early
        return NO;
    ShipEntity *root = [self rootShipEntity];
    if ([root isPlayer] && ![PLAYER weaponsOnline])
        return NO;
 
    if ([root isCloaked] && [root cloakPassive])
    {
        // can't fire turrets while cloaked
        return NO;
    }
 
    Vector      vel;    
    HPVector        origin = [self position];
 
    Entity      *last = nil;
    Entity      *father = [self parentEntity];
    OOMatrix    r_mat;
 
    vel = vector_forward_from_quaternion(orientation);     // Facing
    // adjust velocity and position vectors to absolute coordinates
    while ((father)&&(father != last) && (father != NO_TARGET))
    {
        r_mat = [father drawRotationMatrix];
        origin = HPvector_add(OOHPVectorMultiplyMatrix(origin, r_mat), [father position]);
        vel = OOVectorMultiplyMatrix(vel, r_mat);
        last = father;
        if (![last isSubEntity]) break;
        father = [father owner];
    }
    
    origin = HPvector_add(origin, vectorToHPVector(vector_multiply_scalar(vel, collision_radius + 0.5)));   // Start just outside collision sphere
    vel = vector_multiply_scalar(vel, TURRET_SHOT_SPEED);  // Shot velocity
    
    OOPlasmaShotEntity *shot = [[OOPlasmaShotEntity alloc] initWithPosition:origin
                                                                   velocity:vel
                                                                     energy:weapon_damage
                                                                   duration:weaponRange/TURRET_SHOT_SPEED
                                                                      color:laser_color];
    
    [shot autorelease];
    [UNIVERSE addEntity:shot];
    [shot setOwner:[self rootShipEntity]];  // has to be done AFTER adding shot to the UNIVERSE
    
    [self resetShotTime];
    return YES;
}

References cloakPassive, Entity::collision_radius, Entity::drawRotationMatrix, isCloaked, Entity::isPlayer, Entity::isSubEntity, nil, NO_TARGET, OOHPVectorMultiplyMatrix(), OOVectorMultiplyMatrix(), Entity::orientation, Entity::owner, Entity::parentEntity, PLAYER, Entity::position, resetShotTime, Entity::rootShipEntity, Entity::setOwner:, shotTime, TURRET_SHOT_SPEED, vector_forward_from_quaternion(), weapon_recharge_rate, and weaponRange.

Referenced by behaviour_track_as_turret:.

Here is the call graph for this function:

Here is the caller graph for this function:

fireWeapon:direction:range:

- (BOOL) fireWeapon: (OOWeaponType) weapon_type direction: (OOWeaponFacing) direction range: (double) range

implementation

Definition at line 11450 of file ShipEntity.m.

                   :(OOWeaponType)weapon_type direction:(OOWeaponFacing)direction range:(double)range
{
    weapon_temp = 0.0;
    switch (direction)
    {
        case WEAPON_FACING_FORWARD:
            weapon_temp = forward_weapon_temp;
            break;
            
        case WEAPON_FACING_AFT:
            weapon_temp = aft_weapon_temp;
            break;
            
        case WEAPON_FACING_PORT:
            weapon_temp = port_weapon_temp;
            break;
            
        case WEAPON_FACING_STARBOARD:
            weapon_temp = starboard_weapon_temp;
            break;
            
        case WEAPON_FACING_NONE:
            break;
    }
    if (weapon_temp / NPC_MAX_WEAPON_TEMP >= WEAPON_COOLING_CUTOUT) return NO;
 
    NSUInteger multiplier = 1;
    if (_multiplyWeapons)
    {
        // multiple fitted
        multiplier = [[self laserPortOffset:direction] count];
    }
 
    if (energy <= weapon_energy_use * multiplier) return NO;
    if ([self shotTime] < weapon_recharge_rate)  return NO;
    if (![weapon_type isTurretLaser])
    { // thargoid laser may just pick secondary target in this case
        if (range > randf() * weaponRange * (accuracy+7.5))  return NO;
        if (range > weaponRange)  return NO;
    }
    if (![self onTarget:direction withWeapon:weapon_type])  return NO;
    
    BOOL fired = NO;
    if (!isWeaponNone(weapon_type))
    {
        if ([weapon_type isTurretLaser])
        {
            [self fireDirectLaserShot:range];
            fired = YES;
        }
        else
        {
            [self fireLaserShotInDirection:direction weaponIdentifier:[weapon_type identifier]];
            fired = YES;
        }
    }
 
    if (fired)
    {
        energy -= weapon_energy_use * multiplier;
        switch (direction)
        {
            case WEAPON_FACING_FORWARD:
                forward_weapon_temp += weapon_shot_temperature * multiplier;
                break;
                
            case WEAPON_FACING_AFT:
                aft_weapon_temp += weapon_shot_temperature * multiplier;
                break;
                
            case WEAPON_FACING_PORT:
                port_weapon_temp += weapon_shot_temperature * multiplier;
                break;
                
            case WEAPON_FACING_STARBOARD:
                starboard_weapon_temp += weapon_shot_temperature * multiplier;
                break;
                
            case WEAPON_FACING_NONE:
                break;
        }
    }
    
    if (direction == WEAPON_FACING_FORWARD)
    {
        //can we fire lasers from our subentities?
        NSEnumerator    *subEnum = nil;
        ShipEntity      *se = nil;
        for (subEnum = [self shipSubEntityEnumerator]; (se = [subEnum nextObject]); )
        {
            if ([se fireSubentityLaserShot:range])
            {
                fired = YES;
            }
        }
    }
    
    if (fired && cloaking_device_active && cloakPassive)
    {
        [self deactivateCloakingDevice];
    }
    
    return fired;
}

References _multiplyWeapons, accuracy, aft_weapon_temp, cloaking_device_active, cloakPassive, deactivateCloakingDevice, Entity::energy, fireDirectLaserShot:, fireLaserShotInDirection:weaponIdentifier:, forward_weapon_temp, OOEquipmentType::identifier, isWeaponNone(), laserPortOffset:, nil, NPC_MAX_WEAPON_TEMP, port_weapon_temp, randf(), shipSubEntityEnumerator, shotTime, starboard_weapon_temp, WEAPON_COOLING_CUTOUT, weapon_energy_use, WEAPON_FACING_AFT, WEAPON_FACING_FORWARD, WEAPON_FACING_NONE, WEAPON_FACING_PORT, WEAPON_FACING_STARBOARD, weapon_recharge_rate, weapon_shot_temperature, weapon_temp, and weaponRange.

Referenced by fireAftWeapon:, fireMainWeapon:, firePortWeapon:, and fireStarboardWeapon:.

Here is the call graph for this function:

Here is the caller graph for this function:

flasherEnumerator

- (NSEnumerator *) flasherEnumerator

Definition at line 1343 of file ShipEntity.m.

{
    return [[self subEntities] objectEnumeratorFilteredWithSelector:@selector(isFlasher)];
}

References flasherEnumerator, and subEntities.

Referenced by flasherEnumerator, ShipGetProperty(), subEntities, switchLightsOff, and switchLightsOn.

Here is the call graph for this function:

Here is the caller graph for this function:

flightPitch

- (GLfloat) flightPitch

References flightYaw.

flightRoll

- (GLfloat) flightRoll

References flightPitch.

flightSpeed

- (GLfloat) flightSpeed

References maxFlightPitch, and maxFlightSpeed.

Here is the call graph for this function:

flightYaw

- (GLfloat) flightYaw

References flightSpeed.

forceAegisCheck

- (void) forceAegisCheck

Definition at line 7873 of file ShipEntity.m.

{
    _nextAegisCheck = -1.0f;
}

References _nextAegisCheck, and forceAegisCheck.

Referenced by EntitySetProperty(), forceAegisCheck, and reportAIMessages.

Here is the call graph for this function:

Here is the caller graph for this function:

forwardVector

- (Vector) forwardVector

Definition at line 1271 of file ShipEntity.m.

{
    return v_forward;
}

References forwardVector, and v_forward.

Referenced by behaviour_land_on_planet:, forwardVector, PlayerEntity::leaveWitchspace, missileTrackPrimaryTarget:, ShipEntity(PureAI)::setPlanetPatrolCoordinates, DockEntity::shipIsInDockingCorridor:, totalBoundingBox, and OOExhaustPlumeEntity::update:.

Here is the call graph for this function:

Here is the caller graph for this function:

forwardWeaponOffset

- (NSArray *) forwardWeaponOffset

References portWeaponOffset.

foundTarget

- (Entity *) foundTarget

Definition at line 9918 of file ShipEntity.m.

{
    Entity *result = [_foundTarget weakRefUnderlyingObject];
    if (result == nil || ![self isValidTarget:result])
    {
        DESTROY(_foundTarget);
        return nil;
    }
    return result;
}

References _foundTarget, DESTROY, foundTarget, nil, and OOWeakReference::weakRefUnderlyingObject.

Referenced by ShipEntity(OOAIPrivate)::acceptDistressMessageFrom:, ShipEntity(PureAI)::addFoundTargetAsDefenseTarget, PlayerEntity::doBookkeeping:, ShipEntity(Private)::drawDebugStuff, ShipEntity(PureAI)::fightOrFleeHostiles, foundTarget, maxFlightSpeed, ShipEntity(PureAI)::setTargetToFoundTarget, ShipGetProperty(), PlayerEntity(Scripting)::targetNearestHostile, and PlayerEntity(Scripting)::targetNearestIncomingMissile.

Here is the call graph for this function:

Here is the caller graph for this function:

frustration

- (double) frustration

References accuracy.

frustumRadius

- (GLfloat) frustumRadius

Reimplemented from Entity.

Definition at line 890 of file ShipEntity.m.

{
    OOScalar exhaust_length = 0;
    NSEnumerator *exEnum = nil;
    OOExhaustPlumeEntity *exEnt = nil;
    for (exEnum = [self exhaustEnumerator]; (exEnt = [exEnum nextObject]); )
    {
        if ([exEnt findCollisionRadius] > exhaust_length)
        {
            exhaust_length = [exEnt findCollisionRadius];
        }
    }
    return _profileRadius + exhaust_length;
}

References _profileRadius, exhaustEnumerator, OOEntityWithDrawable::findCollisionRadius, OOExhaustPlumeEntity::findCollisionRadius, frustumRadius, and nil.

Referenced by OOEntityWithDrawable::drawImmediate:translucent:, findBoundingBoxRelativeToPosition:InVectors:i:j:, and frustumRadius.

Here is the call graph for this function:

Here is the caller graph for this function:

fuel

- (OOFuelQuantity) fuel

References bounty, fuelCapacity, and fuelChargeRate.

Here is the call graph for this function:

fuelCapacity

- (OOFuelQuantity) fuelCapacity

Definition at line 8118 of file ShipEntity.m.

{
    // FIXME: shipdata.plist can allow greater fuel quantities (without extending hyperspace range). Need some consistency here.
    return PLAYER_MAX_FUEL;
}

References fuelCapacity, and PLAYER_MAX_FUEL.

Referenced by PlayerEntity(Scripting)::awardEquipment:, PlayerEntity::dialFuel, PlayerEntity::doBookkeeping:, equipmentValidToAdd:whileLoading:inContext:, fuel, fuelCapacity, PlayerEntity(Contracts)::newShipCommonSetup:yardInfo:baseInfo:, PlayerEntity(Scripting)::sendAllShipsAway, setFuel:, PlayerEntity(OOPrivate)::tryBuyingItem:, and update:.

Here is the call graph for this function:

Here is the caller graph for this function:

fuelChargeRate

- (GLfloat) fuelChargeRate

Reimplemented in PlayerEntity.

Definition at line 8125 of file ShipEntity.m.

{
    GLfloat     rate = 1.0; // Standard (& strict play) charge rate.
    
#if MASS_DEPENDENT_FUEL_PRICES
    
    if (EXPECT(PLAYER != nil && mass> 0 && mass != [PLAYER baseMass]))
    {
        rate = calcFuelChargeRate(mass);
    }
 
    OOLog(@"fuelPrices", @"\"%@\" fuel charge rate: %.2f (mass ratio: %.2f/%.2f)", [self shipDataKey], rate, mass, [PLAYER baseMass]);
#endif
    
    return rate;
}

References EXPECT, fuelChargeRate, Entity::mass, nil, OOLog, PLAYER, and shipDataKey.

Referenced by fuel, PlayerEntity::fuelChargeRate, fuelChargeRate, and update:.

Here is the call graph for this function:

Here is the caller graph for this function:

generateMissileEquipmentTypeFrom:

- (OOEquipmentType *) generateMissileEquipmentTypeFrom: (NSString *) role

implementation

Provided by category ShipEntity(Private).

Definition at line 3328 of file ShipEntity.m.

                                                      :(NSString *)role
{
    /*  The generated missile equipment type provides for backward compatibility with pre-1.74 OXPs  missile_roles
        and follows this template:
        
        //NPC equipment, incompatible with player ship. Not buyable because of its TL.
        (
            100, 100000, "Missile",
            "EQ_X_MISSILE",
            "Unidentified missile type.",
            {
                is_external_store = true;
            }
        )
    */
    NSArray  *itemInfo = [NSArray arrayWithObjects:@"100", @"100000", @"Missile", role, @"Unidentified missile type.",
                            [NSDictionary dictionaryWithObjectsAndKeys: @"true", @"is_external_store", nil], nil];
    
    [OOEquipmentType addEquipmentWithInfo:itemInfo];
    return [OOEquipmentType equipmentTypeWithIdentifier:role];
}

References OOEquipmentType::addEquipmentWithInfo:, and OOEquipmentType::equipmentTypeWithIdentifier:.

Referenced by verifiedMissileTypeFromRole:.

Here is the call graph for this function:

Here is the caller graph for this function:

getAI

- (AI *) getAI

Definition at line 8014 of file ShipEntity.m.

{
    return shipAI;
}

References getAI, and shipAI.

Referenced by Universe::addEntity:, Universe::allShipsDoScriptEvent:andReactToAIMessage:, broadcastAIMessage:, deployEscorts, descriptionForObjDump, dockEscorts, DockEntity::dockingInstructionsForShip:, dumpItem:, getAI, hasNewAI, OOShipDebugInspectorModule::inspectAI:, DockEntity::launchShip:, PlayerEntity(Scripting)::messageShipAIs:, releaseCargoPodsDebris, PlayerEntity::resetAutopilotAI, ShipEntity(PureAI)::safeScriptActionOnTarget:, ShipEntity(LoadRestore)::savedShipDictionaryWithContext:, ShipEntity(PureAI)::scanForNearestShipMatchingPredicate:, ShipEntity(PureAI)::scriptActionOnTarget:, PlayerEntity(Scripting)::sendAllShipsAway, ShipEntity(AI)::setAITo:, ShipEntity(PureAI)::setStateTo:, ShipEntity(PureAI)::setTargetToPrimaryAggressor, ShipEntity(Private)::setUpOneEscort:inGroup:withRole:atPosition:andCount:, ShipExitAI(), ShipGetProperty(), ShipSetProperty(), WormholeEntity::suckInShip:, ShipEntity(AI)::switchAITo:, OOShipDebugInspectorModule::update, StationEntity::update:, and Universe::update:.

Here is the call graph for this function:

Here is the caller graph for this function:

getDemoStartTime

- (OOTimeAbsolute) getDemoStartTime

implementation

Definition at line 14625 of file ShipEntity.m.

{
    return demoStartTime;
}

References demoStartTime, and getDemoStartTime.

Referenced by getDemoStartTime.

Here is the call graph for this function:

Here is the caller graph for this function:

getDestroyedBy:damageType:

- (void) getDestroyedBy:		(Entity *)	whom
damageType:		(OOShipDamageType)	type

Reimplemented in PlayerEntity.

Definition at line 9035 of file ShipEntity.m.

                       :(Entity *)whom damageType:(OOShipDamageType)type
{
    [self noteKilledBy:whom damageType:type];
    [self abortDocking];
    [self becomeExplosion];
}

References abortDocking, becomeExplosion, and noteKilledBy:damageType:.

Referenced by ShipEntity(PureAI)::explodeSelf, takeEnergyDamage:from:becauseOf:weaponIdentifier:, takeHeatDamage:, and takeScrapeDamage:from:.

Here is the call graph for this function:

Here is the caller graph for this function:

getJSClass:andPrototype:

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

implementation

Reimplemented from Entity.

Reimplemented in DockEntity, and StationEntity.

Provided by category ShipEntity(OOJavaScriptExtensions).

Definition at line 121 of file EntityOOJavaScriptExtensions.m.

                   :(JSClass **)outClass andPrototype:(JSObject **)outPrototype
{
    *outClass = JSShipClass();
    *outPrototype = JSShipPrototype();
}

getTractoredBy:

- (void) getTractoredBy:

(ShipEntity *)

other

Definition at line 12881 of file ShipEntity.m.

                       :(ShipEntity *)other
{
    if([self status] == STATUS_BEING_SCOOPED) return; // both cargo and ship call this. Act only once.
    desired_speed = 0.0;
    [self setAITo:@"nullAI.plist"]; // prevent AI from changing status or behaviour.
    behaviour = BEHAVIOUR_TRACTORED;
    [self setStatus:STATUS_BEING_SCOOPED];
    [self addTarget:other];
    [self setOwner:other];
    // should we make this an all rather than first 16? - CIM
    // made it ignore other cargopods and similar at least. - CIM 28/7/2013
    [self checkScannerIgnoringUnpowered]; 
    unsigned i;
    ShipEntity *scooper;
    for (i = 0; i < n_scanned_ships ; i++)
    {
        scooper = (ShipEntity *)scanned_ships[i];
        // 'Dibs!' - Stops other ships from trying to scoop/shoot this cargo.
        if (other != scooper && (id) self == [scooper primaryTarget])
        {
            [scooper noteLostTarget];
        }
    }
}

References addTarget:, behaviour, checkScannerIgnoringUnpowered, desired_speed, n_scanned_ships, noteLostTarget, primaryTarget, scanned_ships, setAITo:, setOwner:, setStatus:, and Entity::status.

Here is the call graph for this function:

getWeaponOffsetFrom:withKey:inMode:

- (NSArray *) getWeaponOffsetFrom:		(NSDictionary *)	dict
withKey:		(NSString *)	key
inMode:		(NSString *)	mode

Definition at line 2001 of file ShipEntity.m.

                                 :(NSDictionary *)dict withKey:(NSString *)key inMode:(NSString *)mode
{
    Vector offset;
    if ([mode isEqualToString:@"single"])
    {
        offset = vector_multiply_scalar([dict oo_vectorForKey:key defaultValue:kZeroVector],_scaleFactor);
        return [NSArray arrayWithObject:MAKE_VECTOR_ARRAY(offset)];
    }
    else
    {
        NSArray *offsets = [dict oo_arrayForKey:key defaultValue:nil];
        if (offsets == nil) {
            offset = kZeroVector;
            return [NSArray arrayWithObject:MAKE_VECTOR_ARRAY(offset)];
        }
        NSMutableArray *output = [NSMutableArray arrayWithCapacity:[offsets count]];
        NSUInteger i;
        for (i=0;i<[offsets count];i++) {
            offset = vector_multiply_scalar([offsets oo_vectorAtIndex:i defaultValue:kZeroVector],_scaleFactor);
            [output addObject:MAKE_VECTOR_ARRAY(offset)];
        }
        return [NSArray arrayWithArray:output];
    }
}

References _scaleFactor, kZeroVector, and nil.

getWitchspaceEntryCoordinates

- (void) getWitchspaceEntryCoordinates

implementation

Provided by category ShipEntity(PureAI).

Definition at line 1187 of file ShipEntityAI.m.

{
    /*- calculates coordinates from the nearest station it can find, or just fly 10s forward -*/
    if (!UNIVERSE)
    {
        Vector  vr = vector_multiply_scalar(v_forward, maxFlightSpeed * 10.0);  // 10 second flying away
        coordinates = HPvector_add(position, vectorToHPVector(vr));
        return;
    }
    //
    // find the nearest station...
    //
    // we don't use "checkScanner" because we must rely on finding a present station.
    //
    StationEntity   *station =  nil;
    station = [UNIVERSE nearestShipMatchingPredicate:IsStationPredicate
                                           parameter:nil
                                    relativeToEntity:self];
    
    if (station && HPdistance2([station position], position) < SCANNER_MAX_RANGE2) // there is a station in range.
    {
        Vector  vr = vector_multiply_scalar([station rightVector], 10000);  // 10km from station
        coordinates = HPvector_add([station position], vectorToHPVector(vr));
    }
    else
    {
        Vector  vr = vector_multiply_scalar(v_forward, maxFlightSpeed * 10.0);  // 10 second flying away
        coordinates = HPvector_add(position, vectorToHPVector(vr));
    }
}

group

- (OOShipGroup *) group

Definition at line 6908 of file ShipEntity.m.

{
    return _group;
}

References _group, and group.

Referenced by abandonShip, acceptAsEscort:, ShipEntity(PureAI)::checkForMotherStation, ShipEntity(PureAI)::checkGroupOddsVersusTarget, deployEscorts, dockEscorts, fireMissileWithIdentifier:andTarget:, group, OOShipDebugInspectorModule::inspectGroup:, isFriendlyTo:, StationEntity::launchDefenseShip, StationEntity::launchIndependentShip:, messageTime, ShipEntity(PureAI)::patrolReportIn, ShipEntity(PureAI)::requestNewTarget, respondToAttackFrom:becauseOf:, ShipEntity(PureAI)::scanForOffenders, setEscortGroup:, setGroup:, ShipEntity(PureAI)::setPlanetPatrolCoordinates, setTargetToNearestStationIncludingHostiles:, setUpEscorts, StationEntity::setUpShipFromDictionary:, ShipGetProperty(), ShipGroupAddShip(), WormholeEntity::suckInShip:, SystemAddShipsOrGroup(), SystemAddShipsOrGroupToRoute(), takeEnergyDamage:from:becauseOf:weaponIdentifier:, StationEntity::takeEnergyDamage:from:becauseOf:weaponIdentifier:, ShipEntity(PureAI)::thargonCheckMother, and OOShipDebugInspectorModule::update.

Here is the call graph for this function:

Here is the caller graph for this function:

groupAttackTarget

- (void) groupAttackTarget

Provided by category ShipEntity(AI).

Definition at line 339 of file ShipEntityAI.m.

{
    NSEnumerator        *shipEnum = nil;
    ShipEntity          *target = nil, *ship = nil;
 
    target = [self primaryTarget];
    
    if (target == nil) return;
    
    if ([self group] == nil)        // ship is alone!
    {
        [self setFoundTarget:target];
        [shipAI reactToMessage:@"GROUP_ATTACK_TARGET" context:@"groupAttackTarget"];
        [self doScriptEvent:OOJSID("helpRequestReceived") withArgument:self andArgument:target];
        return;
    }
    
    for (shipEnum = [[self group] mutationSafeEnumerator]; (ship = [shipEnum nextObject]); )
    {
        [ship setFoundTarget:target];
        [ship reactToAIMessage:@"GROUP_ATTACK_TARGET" context:@"groupAttackTarget"];
        [ship doScriptEvent:OOJSID("helpRequestReceived") withArgument:self andArgument:target];
 
        if ([ship escortGroup] != [ship group] && [[ship escortGroup] count] > 1) // Ship has a seperate escort group.
        {
            ShipEntity      *escort = nil;
            NSEnumerator    *shipEnum = nil;
            NSArray         *escortMembers = [[ship escortGroup] memberArrayExcludingLeader];
            for (shipEnum = [escortMembers objectEnumerator]; (escort = [shipEnum nextObject]); )
            {
                [escort setFoundTarget:target];
                [escort reactToAIMessage:@"GROUP_ATTACK_TARGET" context:@"groupAttackTarget"];
                [escort doScriptEvent:OOJSID("helpRequestReceived") withArgument:self andArgument:target];
            }
        }
    }
}

hasAllEquipment:

- (BOOL) hasAllEquipment:

(id)

equipmentKeys

Definition at line 3201 of file ShipEntity.m.

                        :(id)equipmentKeys
{
    return [self hasAllEquipment:equipmentKeys includeWeapons:NO whileLoading:NO];
}

References hasAllEquipment:includeWeapons:whileLoading:.

Here is the call graph for this function:

hasAllEquipment:includeWeapons:whileLoading:

- (BOOL) hasAllEquipment:		(id)	equipmentKeys
includeWeapons:		(BOOL)	includeWeapons
whileLoading:		(BOOL)	loading

Definition at line 3181 of file ShipEntity.m.

                        :(id)equipmentKeys includeWeapons:(BOOL)includeWeapons whileLoading:(BOOL)loading
{
    NSEnumerator                *keyEnum = nil;
    id                          key = nil;
    
    if (_equipment == nil)  return NO;
    
    // Make sure it's an array or set, using a single-object set if it's a string.
    if ([equipmentKeys isKindOfClass:[NSString class]])  equipmentKeys = [NSArray arrayWithObject:equipmentKeys];
    else if (![equipmentKeys isKindOfClass:[NSArray class]] && ![equipmentKeys isKindOfClass:[NSSet class]])  return NO;
    
    for (keyEnum = [equipmentKeys objectEnumerator]; (key = [keyEnum nextObject]); )
    {
        if (![self hasOneEquipmentItem:key includeWeapons:includeWeapons whileLoading:loading])  return NO;
    }
    
    return YES;
}

References _equipment, and nil.

Referenced by hasAllEquipment:.

Here is the caller graph for this function:

hasAutoAI

- (BOOL) hasAutoAI

Definition at line 8020 of file ShipEntity.m.

{
    return  [[self shipInfoDictionary] oo_fuzzyBooleanForKey:@"auto_ai" defaultValue:YES];
}

References hasAutoAI, and shipInfoDictionary.

Referenced by hasAutoAI.

Here is the call graph for this function:

Here is the caller graph for this function:

hasAutoCloak

- (BOOL) hasAutoCloak

Definition at line 6689 of file ShipEntity.m.

{
    return cloakAutomatic;
}

References cloakAutomatic, and hasAutoCloak.

Referenced by hasAutoCloak, and reactionTime.

Here is the call graph for this function:

Here is the caller graph for this function:

hasAutoWeapons

- (BOOL) hasAutoWeapons

Definition at line 8032 of file ShipEntity.m.

{
    return  [[self shipInfoDictionary] oo_fuzzyBooleanForKey:@"auto_weapons" defaultValue:NO];
}

References hasAutoWeapons, and shipInfoDictionary.

Referenced by hasAutoWeapons, selectMissile, and starboardWeaponOffset.

Here is the call graph for this function:

Here is the caller graph for this function:

hasCargoScoop

- (BOOL) hasCargoScoop

Definition at line 3961 of file ShipEntity.m.

{
    return [self hasEquipmentItemProviding:@"EQ_CARGO_SCOOPS"];
}

References hasCargoScoop, and hasEquipmentItemProviding:.

Referenced by canScoop:, hasCargoScoop, and isFrangible.

Here is the call graph for this function:

Here is the caller graph for this function:

hasCascadeMine

- (BOOL) hasCascadeMine

Definition at line 4033 of file ShipEntity.m.

{
    /* TODO: this could be providing since theoretically OXP
     * deployable mines could also do cascade effects, but there are
     * probably better ways to manage OXP pylon AI */
    return [self hasEquipmentItem:@"EQ_QC_MINE" includeWeapons:YES whileLoading:NO];
}

References hasCascadeMine, and hasEquipmentItem:includeWeapons:whileLoading:.

Referenced by behaviour_flee_target:, hasCascadeMine, isFrangible, and launchCascadeMine.

Here is the call graph for this function:

Here is the caller graph for this function:

hasCloakingDevice

- (BOOL) hasCloakingDevice

Definition at line 3973 of file ShipEntity.m.

{
    /* TODO: Checks above stop this being 'providing'. */
    return [self hasEquipmentItem:@"EQ_CLOAKING_DEVICE"];
}

References hasCloakingDevice, and hasEquipmentItem:.

Referenced by PlayerEntity::activateCloakingDevice, activateCloakingDevice, PlayerEntity::deactivateCloakingDevice, deactivateCloakingDevice, PlayerEntity::doBookkeeping:, hasCloakingDevice, isFrangible, and update:.

Here is the call graph for this function:

Here is the caller graph for this function:

hasDockingComputer

- (BOOL) hasDockingComputer

Definition at line 4048 of file ShipEntity.m.

{
    return [self hasEquipmentItemProviding:@"EQ_DOCK_COMP"];
}

References hasDockingComputer, and hasEquipmentItemProviding:.

Referenced by hasDockingComputer, isFrangible, and removeEquipmentItem:.

Here is the call graph for this function:

Here is the caller graph for this function:

hasECM

- (BOOL) hasECM

Definition at line 3967 of file ShipEntity.m.

{
    return [self hasEquipmentItemProviding:@"EQ_ECM"];
}

References hasECM, and hasEquipmentItemProviding:.

Referenced by fireECM, hasECM, and isFrangible.

Here is the call graph for this function:

Here is the caller graph for this function:

hasEquipmentItem:

- (BOOL) hasEquipmentItem:

(id)

equipmentKeys

Definition at line 3129 of file ShipEntity.m.

                         :(id)equipmentKeys
{
    return [self hasEquipmentItem:equipmentKeys includeWeapons:NO whileLoading:NO];
}

References hasEquipmentItem:includeWeapons:whileLoading:.

Referenced by PlayerEntity::buySelectedItem, equipmentListForScripting, hasCloakingDevice, hasExpandedCargoBay, hasMilitaryShieldEnhancer, hasShieldBooster, ShipAwardEquipment(), ShipSetEquipmentStatus(), and PlayerEntity(Scripting)::testForEquipment:.

Here is the call graph for this function:

Here is the caller graph for this function:

hasEquipmentItem:includeWeapons:whileLoading:

- (BOOL) hasEquipmentItem:		(id)	equipmentKeys
includeWeapons:		(BOOL)	includeWeapons
whileLoading:		(BOOL)	loading

Definition at line 3107 of file ShipEntity.m.

                         :(id)equipmentKeys includeWeapons:(BOOL)includeWeapons whileLoading:(BOOL)loading
{
    // this method is also used internally to find out if an equipped item is undamaged.
    if ([equipmentKeys isKindOfClass:[NSString class]])
    {
        return [self hasOneEquipmentItem:equipmentKeys includeWeapons:includeWeapons whileLoading:loading];
    }
    else
    {
        NSParameterAssert([equipmentKeys isKindOfClass:[NSArray class]] || [equipmentKeys isKindOfClass:[NSSet class]]);
        
        id key = nil;
        foreach (key, equipmentKeys)
        {
            if ([self hasOneEquipmentItem:key includeWeapons:includeWeapons whileLoading:loading])  return YES;
        }
    }
    
    return NO;
}

References hasOneEquipmentItem:includeWeapons:whileLoading:, and nil.

Referenced by hasCascadeMine, and hasEquipmentItem:.

Here is the call graph for this function:

Here is the caller graph for this function:

hasEquipmentItemProviding:

- (BOOL) hasEquipmentItemProviding:

(NSString *)

equipmentType

Definition at line 3137 of file ShipEntity.m.

                                  :(NSString *)equipmentType
{
    NSString *key = nil;
    foreach (key, _equipment) {
        if ([key isEqualToString:equipmentType])
        {
            // equipment always provides itself
            return YES;
        }
        else
        {
            OOEquipmentType *et = [OOEquipmentType equipmentTypeWithIdentifier:key];
            if (et != nil && [et provides:equipmentType])
            {
                return YES;
            }
        }
    }
    return NO;
}

References _equipment, OOEquipmentType::equipmentTypeWithIdentifier:, and nil.

Referenced by hasCargoScoop, hasDockingComputer, hasECM, hasEscapePod, hasFuelInjection, hasFuelScoop, hasGalacticHyperdrive, hasHeatShield, hasMilitaryJammer, hasMilitaryScannerFilter, hasScoop, and ProxyPlayerEntity::initWithKey:definition:.

Here is the call graph for this function:

Here is the caller graph for this function:

hasEscapePod

- (BOOL) hasEscapePod

Definition at line 4042 of file ShipEntity.m.

{
    return [self hasEquipmentItemProviding:@"EQ_ESCAPE_POD"];
}

References hasEquipmentItemProviding:, and hasEscapePod.

Referenced by abandonShip, hasEscapePod, isFrangible, and takeEnergyDamage:from:becauseOf:weaponIdentifier:.

Here is the call graph for this function:

Here is the caller graph for this function:

hasEscorts

- (BOOL) hasEscorts

Definition at line 6976 of file ShipEntity.m.

{
    if (_escortGroup == nil)  return NO;
    return [_escortGroup count] > 1;    // If only one member, it's self.
}

References _escortGroup, OOShipGroup::count, hasEscorts, and nil.

Referenced by abandonShip, dockEscorts, hasEscorts, DockEntity::launchShip:, messageTime, and update:.

Here is the call graph for this function:

Here is the caller graph for this function:

hasExpandedCargoBay

- (BOOL) hasExpandedCargoBay

Definition at line 4000 of file ShipEntity.m.

{
    /* Not 'providing' - controlled through scripts */
    return [self hasEquipmentItem:@"EQ_CARGO_BAY"];
}

References hasEquipmentItem:, and hasExpandedCargoBay.

Referenced by hasExpandedCargoBay, isFrangible, and PlayerEntity::setCommanderDataFromDictionary:.

Here is the call graph for this function:

Here is the caller graph for this function:

hasFuelInjection

- (BOOL) hasFuelInjection

Definition at line 4027 of file ShipEntity.m.

{
    return [self hasEquipmentItemProviding:@"EQ_FUEL_INJECTION"];
}

References hasEquipmentItemProviding:, and hasFuelInjection.

Referenced by applyThrust:, behaviour_attack_break_off_target:, behaviour_attack_broadside:, behaviour_attack_broadside_target:leftside:, behaviour_attack_fly_from_target:, behaviour_attack_fly_to_target:, behaviour_attack_sniper:, behaviour_evasive_action:, behaviour_flee_target:, behaviour_fly_to_target_six:, hasFuelInjection, increase_flight_speed:, isFrangible, and WormholeEntity::suckInShip:.

Here is the call graph for this function:

Here is the caller graph for this function:

hasFuelScoop

- (BOOL) hasFuelScoop

Definition at line 3954 of file ShipEntity.m.

{
    return [self hasEquipmentItemProviding:@"EQ_FUEL_SCOOPS"];
}

References hasEquipmentItemProviding:, and hasFuelScoop.

Referenced by PlayerEntity::doBookkeeping:, hasFuelScoop, isFrangible, and update:.

Here is the call graph for this function:

Here is the caller graph for this function:

hasGalacticHyperdrive

- (BOOL) hasGalacticHyperdrive

Definition at line 4054 of file ShipEntity.m.

{
    return [self hasEquipmentItemProviding:@"EQ_GAL_DRIVE"];
}

References hasEquipmentItemProviding:, and hasGalacticHyperdrive.

Referenced by hasGalacticHyperdrive, and isFrangible.

Here is the call graph for this function:

Here is the caller graph for this function:

hasHeatShield

- (BOOL) hasHeatShield

Definition at line 4021 of file ShipEntity.m.

{
    return [self hasEquipmentItemProviding:@"EQ_HEAT_SHIELD"];
}

References hasEquipmentItemProviding:, and hasHeatShield.

Referenced by hasHeatShield, isFrangible, and setUpShipFromDictionary:.

Here is the call graph for this function:

Here is the caller graph for this function:

hasHostileTarget

- (BOOL) hasHostileTarget

Reimplemented in PlayerEntity, and StationEntity.

Definition at line 7445 of file ShipEntity.m.

{
    Entity *t = [self primaryTarget];
    if (t == nil || ![t isShip])
    {
        return NO;
    }
    if ([self isMissile])
    {
        return YES; // missiles are always fired against a hostile target
    }
    if ((behaviour == BEHAVIOUR_AVOID_COLLISION)&&(previousCondition))
    {
        int old_behaviour = [previousCondition oo_intForKey:@"behaviour"];
        return IsBehaviourHostile(old_behaviour);
    }
    return IsBehaviourHostile(behaviour);
}

References behaviour, hasHostileTarget, IsBehaviourHostile, isMissile, Entity::isShip, nil, previousCondition, and primaryTarget.

Referenced by alertCondition, behaviour_track_as_turret:, HeadUpDisplay(Private)::drawScanner:, hasHostileTarget, StationEntity::hasHostileTarget, HeadUpDisplay::hudDrawReticleOnTarget, IsHostileAgainstTargetPredicate(), isHostileTo:, isMissile, noteTakingDamage:from:type:, realAlertCondition, and PlayerEntity(OOPrivate)::updateAlertConditionForNearbyEntities.

Here is the call graph for this function:

Here is the caller graph for this function:

hasHyperspaceMotor

- (BOOL) hasHyperspaceMotor

Definition at line 3207 of file ShipEntity.m.

{
    return hyperspaceMotorSpinTime >= 0;
}

References hasHyperspaceMotor, and hyperspaceMotorSpinTime.

Referenced by hasHyperspaceMotor, isFrangible, and PlayerEntity::setGuiToStatusScreen.

Here is the call graph for this function:

Here is the caller graph for this function:

hasMilitaryJammer

- (BOOL) hasMilitaryJammer

Definition at line 3990 of file ShipEntity.m.

{
#if USEMASC
    return [self hasEquipmentItemProviding:@"EQ_MILITARY_JAMMER"];
#else
    return NO;
#endif
}

References hasEquipmentItemProviding:, and hasMilitaryJammer.

Referenced by PlayerEntity::doBookkeeping:, hasMilitaryJammer, isFrangible, isJammingScanning, and update:.

Here is the call graph for this function:

Here is the caller graph for this function:

hasMilitaryScannerFilter

- (BOOL) hasMilitaryScannerFilter

Definition at line 3980 of file ShipEntity.m.

{
#if USEMASC
    return [self hasEquipmentItemProviding:@"EQ_MILITARY_SCANNER_FILTER"];
#else
    return NO;
#endif
}

References hasEquipmentItemProviding:, and hasMilitaryScannerFilter.

Referenced by fireMissileWithIdentifier:andTarget:, hasMilitaryScannerFilter, identFromShip:, isFrangible, PlayerEntity::isValidTarget:, and scannerDisplayColorForShip:otherShip:isHostile:flash:scannerDisplayColor1:scannerDisplayColor2:scannerDisplayColorH1:.

Here is the call graph for this function:

Here is the caller graph for this function:

hasMilitaryShieldEnhancer

- (BOOL) hasMilitaryShieldEnhancer

Definition at line 4014 of file ShipEntity.m.

{
    /* Not 'providing' - controlled through scripts */
    return [self hasEquipmentItem:@"EQ_NAVAL_SHIELD_BOOSTER"];
}

References hasEquipmentItem:, and hasMilitaryShieldEnhancer.

Referenced by hasMilitaryShieldEnhancer, isFrangible, shieldBoostFactor, and shieldRechargeRate.

Here is the call graph for this function:

Here is the caller graph for this function:

hasNewAI

- (BOOL) hasNewAI

Definition at line 8026 of file ShipEntity.m.

{
    return [[[self getAI] name] isEqualToString:@"nullAI.plist"];
}

References getAI, hasNewAI, and AI::name.

Referenced by deployEscorts, dockEscorts, hasNewAI, respondToAttackFrom:becauseOf:, takeEnergyDamage:from:becauseOf:weaponIdentifier:, StationEntity::takeEnergyDamage:from:becauseOf:weaponIdentifier:, and StationEntity::update:.

Here is the call graph for this function:

Here is the caller graph for this function:

hasOneEquipmentItem:includeMissiles:whileLoading:

- (BOOL) hasOneEquipmentItem:		(NSString *)	itemKey
includeMissiles:		(BOOL)	includeMissiles
whileLoading:		(BOOL)	loading

Definition at line 3046 of file ShipEntity.m.

                            :(NSString *)itemKey includeMissiles:(BOOL)includeMissiles whileLoading:(BOOL)loading
{
    if ([_equipment containsObject:itemKey])  return YES;
    
    if (loading) 
    {
        NSString *damaged = [itemKey stringByAppendingString:@"_DAMAGED"];
        if ([_equipment containsObject:damaged])  return YES;
    }
 
    if (includeMissiles && missiles > 0)
    {
        unsigned i;
        if ([itemKey isEqualToString:@"thargon"]) itemKey = @"EQ_THARGON";
        for (i = 0; i < missiles; i++)
        {
            if (missile_list[i] != nil && [[missile_list[i] identifier] isEqualTo:itemKey])  return YES;
        }
    }
    
    return NO;
}

References _equipment, missile_list, missiles, and nil.

Referenced by ShipRemoveEquipment().

Here is the caller graph for this function:

hasOneEquipmentItem:includeWeapons:whileLoading:

- (BOOL) hasOneEquipmentItem:		(NSString *)	itemKey
includeWeapons:		(BOOL)	includeMissiles
whileLoading:		(BOOL)	loading

Definition at line 3022 of file ShipEntity.m.

                            :(NSString *)itemKey includeWeapons:(BOOL)includeWeapons whileLoading:(BOOL)loading
{
    if ([self hasOneEquipmentItem:itemKey includeMissiles:includeWeapons whileLoading:loading])  return YES;
 
    if (loading) 
    {
        NSString *damaged = [itemKey stringByAppendingString:@"_DAMAGED"];
        if ([_equipment containsObject:damaged])  return YES;
    }
 
    if (includeWeapons)
    {
        // Check for primary weapon
        OOWeaponType weaponType = OOWeaponTypeFromEquipmentIdentifierStrict(itemKey);
        if (!isWeaponNone(weaponType))
        {
            if ([self hasPrimaryWeapon:weaponType])  return YES;
        }
    }
    
    return NO;
}

References _equipment, isWeaponNone(), and OOWeaponTypeFromEquipmentIdentifierStrict().

Referenced by hasEquipmentItem:includeWeapons:whileLoading:.

Here is the call graph for this function:

Here is the caller graph for this function:

hasPrimaryRole:

- (BOOL) hasPrimaryRole:

(NSString *)

role

Definition at line 7327 of file ShipEntity.m.

                      :(NSString *)role
{
    return [[self primaryRole] isEqual:role];
}

References primaryRole.

Referenced by HasPrimaryRolePredicate().

Here is the caller graph for this function:

hasPrimaryWeapon:

- (BOOL) hasPrimaryWeapon:

(OOWeaponType)

weaponType

Reimplemented in PlayerEntity.

Definition at line 3070 of file ShipEntity.m.

                         :(OOWeaponType)weaponType
{
    NSEnumerator                *subEntEnum = nil;
    ShipEntity                  *subEntity = nil;
    
    if ([[forward_weapon_type identifier] isEqualToString:[weaponType identifier]] ||
        [[aft_weapon_type identifier] isEqualToString:[weaponType identifier]] ||
        [[port_weapon_type identifier] isEqualToString:[weaponType identifier]] ||
        [[starboard_weapon_type identifier] isEqualToString:[weaponType identifier]])
    {
        return YES;
    }
 
    for (subEntEnum = [self shipSubEntityEnumerator]; (subEntity = [subEntEnum nextObject]); )
    {
        if ([subEntity hasPrimaryWeapon:weaponType])  return YES;
    }
    
    return NO;
}

References aft_weapon_type, forward_weapon_type, nil, port_weapon_type, shipSubEntityEnumerator, and starboard_weapon_type.

Referenced by PlayerEntity::hasPrimaryWeapon:.

Here is the call graph for this function:

Here is the caller graph for this function:

hasProximityAlertIgnoringTarget:

- (BOOL) hasProximityAlertIgnoringTarget:

(BOOL)

ignore_target

Definition at line 11273 of file ShipEntity.m.

                                        :(BOOL)ignore_target
{
    if (([self proximityAlert] != nil)&&(!ignore_target || ([self proximityAlert] != [self primaryTarget])))
    {
        return YES;
    }
    return NO;
}

References nil, primaryTarget, and proximityAlert.

Here is the call graph for this function:

hasRole:

- (BOOL) hasRole:

(NSString *)

role

Definition at line 7253 of file ShipEntity.m.

                :(NSString *)role
{
    return [roleSet hasRole:role] || [role isEqual:primaryRole] || [role isEqual:[self shipDataKeyAutoRole]];
}

References OORoleSet::hasRole:, and shipDataKeyAutoRole.

Referenced by HasRolePredicate().

Here is the call graph for this function:

Here is the caller graph for this function:

hasScoop

- (BOOL) hasScoop

Definition at line 3948 of file ShipEntity.m.

{
    return [self hasEquipmentItemProviding:@"EQ_FUEL_SCOOPS"] || [self hasEquipmentItemProviding:@"EQ_CARGO_SCOOPS"];
}

References hasEquipmentItemProviding:, and hasScoop.

Referenced by PlayerEntity::dialFuelScoopStatus, hasScoop, ProxyPlayerEntity::initWithKey:definition:, and isFrangible.

Here is the call graph for this function:

Here is the caller graph for this function:

hasShieldBooster

- (BOOL) hasShieldBooster

Definition at line 4007 of file ShipEntity.m.

{
    /* Not 'providing' - controlled through scripts */
    return [self hasEquipmentItem:@"EQ_SHIELD_BOOSTER"];
}

References hasEquipmentItem:, and hasShieldBooster.

Referenced by hasShieldBooster, isFrangible, and shieldBoostFactor.

Here is the call graph for this function:

Here is the caller graph for this function:

hasSubEntity:

- (BOOL) hasSubEntity:

(Entity<OOSubEntity> *)

sub

Definition at line 1325 of file ShipEntity.m.

                     :(Entity<OOSubEntity> *)sub
{
    return [subEntities containsObject:sub];
}

heatInsulation

- (GLfloat) heatInsulation

Definition at line 8821 of file ShipEntity.m.

{
    return _heatInsulation;
}

References _heatInsulation, and heatInsulation.

Referenced by PlayerEntity::doBookkeeping:, dumpSelfState, heatInsulation, StationEntity::launchDefenseShip, StationEntity::launchMiner, StationEntity::launchPatrol, StationEntity::launchPirateShip, StationEntity::launchPolice, StationEntity::launchScavenger, maxFlightSpeed, ShipEntity(Private)::setUpOneEscort:inGroup:withRole:atPosition:andCount:, PlayerEntity::takeEnergyDamage:from:becauseOf:weaponIdentifier:, takeEnergyDamage:from:becauseOf:weaponIdentifier:, and update:.

Here is the call graph for this function:

Here is the caller graph for this function:

homeSystem

- (OOSystemID) homeSystem

Definition at line 7905 of file ShipEntity.m.

{
    return home_system;
}

References home_system, and homeSystem.

Referenced by homeSystem, reportAIMessages, and setSingleCrewWithRole:.

Here is the call graph for this function:

Here is the caller graph for this function:

hullHeatLevel

- (GLfloat) hullHeatLevel

Definition at line 9759 of file ShipEntity.m.

{
    GLfloat result = (GLfloat)ship_temperature / (GLfloat)SHIP_MAX_CABIN_TEMP;
    return OOClamp_0_1_f(result);
}

References hullHeatLevel, SHIP_MAX_CABIN_TEMP, and ship_temperature.

Referenced by hullHeatLevel, maxFlightSpeed, OOShipDebugInspectorModule::update, PlayerEntity(OOPrivate)::updateAlertConditionForNearbyEntities, and OOTrumble::updateTrumble:.

Here is the call graph for this function:

Here is the caller graph for this function:

hyperspaceSpinTime

- (float) hyperspaceSpinTime

Definition at line 3213 of file ShipEntity.m.

{
    return hyperspaceMotorSpinTime;
}

References hyperspaceMotorSpinTime, and hyperspaceSpinTime.

Referenced by hyperspaceSpinTime, and isFrangible.

Here is the call graph for this function:

Here is the caller graph for this function:

identFromShip:

- (NSString *) identFromShip:

(ShipEntity*)

otherShip

Definition at line 7243 of file ShipEntity.m.

                            :(ShipEntity*) otherShip
{
    if ([self isJammingScanning] && ![otherShip hasMilitaryScannerFilter])
    {
        return DESC(@"unknown-target");
    }
    return [self displayName];
}

References DESC, displayName, hasMilitaryScannerFilter, and isJammingScanning.

Referenced by PlayerEntity::dialTargetName, and sendExpandedMessage:toShip:.

Here is the call graph for this function:

Here is the caller graph for this function:

increase_flight_pitch:

- (void) increase_flight_pitch:

(double)

delta

Definition at line 8665 of file ShipEntity.m.

                              :(double) delta
{
    flightPitch += delta;
    if (flightPitch > max_flight_pitch)
        flightPitch = max_flight_pitch;
    else if (flightPitch < -max_flight_pitch)
        flightPitch = -max_flight_pitch;
}

References flightPitch, and max_flight_pitch.

Referenced by PlayerEntity(OOControlsPrivate)::pollFlightArrowKeyControls:, and PlayerEntity(OOControlsPrivate)::pollGuiArrowKeyControls:.

Here is the caller graph for this function:

increase_flight_roll:

- (void) increase_flight_roll:

(double)

delta

Definition at line 8645 of file ShipEntity.m.

                             :(double) delta
{
    flightRoll += delta;
    if (flightRoll > max_flight_roll)
        flightRoll = max_flight_roll;
    else if (flightRoll < -max_flight_roll)
        flightRoll = -max_flight_roll;
}

References flightRoll, and max_flight_roll.

Referenced by PlayerEntity(OOControlsPrivate)::pollFlightArrowKeyControls:, and PlayerEntity(OOControlsPrivate)::pollGuiArrowKeyControls:.

Here is the caller graph for this function:

increase_flight_speed:

- (void) increase_flight_speed:

(double)

delta

Definition at line 8614 of file ShipEntity.m.

                              :(double) delta
{
    double factor = 1.0;
    if (desired_speed > maxFlightSpeed && [self hasFuelInjection] && fuel > MIN_FUEL) factor = [self afterburnerFactor];
 
    if (flightSpeed < maxFlightSpeed * factor)
        flightSpeed += delta * factor;
    else
        flightSpeed = maxFlightSpeed * factor;
}

References afterburnerFactor, desired_speed, flightSpeed, fuel, hasFuelInjection, maxFlightSpeed, and MIN_FUEL.

Referenced by applyThrust:.

Here is the call graph for this function:

Here is the caller graph for this function:

increase_flight_yaw:

- (void) increase_flight_yaw:

(double)

delta

Definition at line 8685 of file ShipEntity.m.

                            :(double) delta
{
    flightYaw += delta;
    if (flightYaw > max_flight_yaw)
        flightYaw = max_flight_yaw;
    else if (flightYaw < -max_flight_yaw)
        flightYaw = -max_flight_yaw;
}

References flightYaw, and max_flight_yaw.

Referenced by PlayerEntity(OOControlsPrivate)::pollFlightArrowKeyControls:, and PlayerEntity(OOControlsPrivate)::pollGuiArrowKeyControls:.

Here is the caller graph for this function:

init

- (id) init

implementation

Reimplemented from Entity.

Reimplemented in PlayerEntity.

Definition at line 175 of file ShipEntity.m.

{
    /*  -init used to set up a bunch of defaults that were different from
        those in -reinit and -setUpShipFromDictionary:. However, it seems that
        no ships are ever used which are not -setUpShipFromDictionary: (which
        is as it should be), so these different defaults were meaningless.
    */
    return [self initWithKey:@"" definition:nil];
}

References init, and initWithKey:definition:.

Referenced by init.

Here is the call graph for this function:

Here is the caller graph for this function:

initBypassForPlayer

- (id) initBypassForPlayer

implementation

Provided by category ShipEntity(Hax).

Definition at line 186 of file ShipEntity.m.

{
    return [super init];
}

References Entity::init, and ShipEntity(Hax)::initBypassForPlayer.

Referenced by PlayerEntity::init, and ShipEntity(Hax)::initBypassForPlayer.

Here is the call graph for this function:

Here is the caller graph for this function:

initWithKey:definition:

- (id) initWithKey:		(NSString *)	key
definition:		(NSDictionary *)	dict

Reimplemented in DockEntity, ProxyPlayerEntity, and StationEntity.

Definition at line 193 of file ShipEntity.m.

                 :(NSString *)key definition:(NSDictionary *)dict
{
    OOJS_PROFILE_ENTER
    
    NSParameterAssert(dict != nil);
    
    self = [super init];
    if (self == nil)  return nil;
    
    _shipKey = [key retain];
    
    isShip = YES;
    entity_personality = Ranrot() & ENTITY_PERSONALITY_MAX;
    [self setStatus:STATUS_IN_FLIGHT];
    
    zero_distance = SCANNER_MAX_RANGE2 * 2.0;
    weapon_recharge_rate = 6.0;
    shot_time = INITIAL_SHOT_TIME;
    ship_temperature = SHIP_MIN_CABIN_TEMP;
    weapon_temp              = 0.0f;
    currentWeaponFacing      = WEAPON_FACING_FORWARD;
    forward_weapon_temp      = 0.0f;
    aft_weapon_temp          = 0.0f;
    port_weapon_temp        = 0.0f;
    starboard_weapon_temp  = 0.0f;
 
    _nextAegisCheck = -0.1f;
    aiScriptWakeTime = 0;
    
    if (![self setUpShipFromDictionary:dict])
    {
        [self release];
        self = nil;
    }
    
    // Problem observed in testing -- Ahruman
    if (self != nil && !isfinite(maxFlightSpeed))
    {
        OOLog(@"ship.sanityCheck.failed", @"Ship %@ %@ infinite top speed, clamped to 300.", self, @"generated with");
        maxFlightSpeed = 300;
    }
    return self;
    
    OOJS_PROFILE_EXIT
}

References _nextAegisCheck, _shipKey, aft_weapon_temp, aiScriptWakeTime, currentWeaponFacing, entity_personality, ENTITY_PERSONALITY_MAX, forward_weapon_temp, Entity::init, INITIAL_SHOT_TIME, Entity::isShip, maxFlightSpeed, nil, OOJS_PROFILE_ENTER, OOJS_PROFILE_EXIT, OOLog, port_weapon_temp, Ranrot(), SCANNER_MAX_RANGE2, setStatus:, SHIP_MIN_CABIN_TEMP, ship_temperature, shot_time, starboard_weapon_temp, WEAPON_FACING_FORWARD, weapon_recharge_rate, weapon_temp, and Entity::zero_distance.

Referenced by init, DockEntity::initWithKey:definition:, ProxyPlayerEntity::initWithKey:definition:, and StationEntity::initWithKey:definition:.

Here is the call graph for this function:

Here is the caller graph for this function:

inspBecomeTarget

- (void) inspBecomeTarget

implementation

Provided by category ShipEntity(OOEntityInspectorExtensions).

Definition at line 202 of file OOEntityInspectorExtensions.m.

{
    if ([self inspCanBecomeTarget])  [[PlayerEntity sharedPlayer] addTarget:self];
}

inspCanBecomeTarget

- (BOOL) inspCanBecomeTarget

implementation

Reimplemented in PlayerEntity.

Provided by category ShipEntity(OOEntityInspectorExtensions).

Definition at line 196 of file OOEntityInspectorExtensions.m.

{
    return ![self isSubEntity];
}

inspDescription

- (NSString *) inspDescription

implementation

Reimplemented from Entity.

Reimplemented in PlayerEntity.

Provided by category ShipEntity(OOEntityInspectorExtensions).

Definition at line 184 of file OOEntityInspectorExtensions.m.

{
    return [NSString stringWithFormat:@"%@ ID %u", [self displayName], [self universalID]];
}

Referenced by OOShipGroupDebugInspectorModule::update.

Here is the caller graph for this function:

inspHasSecondaryIdentityLine

- (BOOL) inspHasSecondaryIdentityLine

implementation

Provided by category ShipEntity(OOEntityInspectorExtensions).

Definition at line 172 of file OOEntityInspectorExtensions.m.

{
    return YES;
}

inspSecondaryIdentityLine

- (NSString *) inspSecondaryIdentityLine

implementation

Reimplemented in PlayerEntity.

Provided by category ShipEntity(OOEntityInspectorExtensions).

Definition at line 178 of file OOEntityInspectorExtensions.m.

{
    return [self displayName];
}

inspTargetLine

- (NSString *) inspTargetLine

implementation

Reimplemented from Entity.

Provided by category ShipEntity(OOEntityInspectorExtensions).

Definition at line 190 of file OOEntityInspectorExtensions.m.

{
    return [[self primaryTarget] inspDescription];
}

Referenced by OOShipDebugInspectorModule::update.

Here is the caller graph for this function:

interpretAIMessage:

- (void) interpretAIMessage:

(NSString *)

message

Reimplemented in PlayerEntity.

Definition at line 14283 of file ShipEntity.m.

                           :(NSString *)ms
{
    if ([ms hasPrefix:AIMS_AGGRESSOR_SWITCHED_TARGET])
    {
        // if I'm under attack send a thank-you message to the rescuer
        //
        NSArray* tokens = ScanTokensFromString(ms);
        int switcher_id = [(NSString*)[tokens objectAtIndex:1] intValue]; // Attacker that switched targets.
        Entity* switcher = [UNIVERSE entityForUniversalID:switcher_id];
        int rescuer_id = [(NSString*)[tokens objectAtIndex:2] intValue]; // New primary target of attacker. 
        Entity* rescuer = [UNIVERSE entityForUniversalID:rescuer_id];
        if ((switcher == [self primaryAggressor])&&(switcher == [self primaryTarget])&&(switcher)&&(rescuer)&&(rescuer->isShip)&&([self thankedShip] != rescuer)&&(scanClass != CLASS_THARGOID))
        {
            ShipEntity* rescueShip = (ShipEntity*)rescuer;
//          ShipEntity* switchingShip = (ShipEntity*)switcher;
            if (scanClass == CLASS_POLICE)
            {
                [self sendExpandedMessage:@"[police-thanks-for-assist]" toShip:rescueShip];
                [rescueShip setBounty:[rescueShip bounty] * 0.80 withReason:kOOLegalStatusReasonAssistingPolice];  // lower bounty by 20%
            }
            else
            {
                [self sendExpandedMessage:@"[thanks-for-assist]" toShip:rescueShip];
            }
            [self setThankedShip:rescuer];
        }
    }
}

References AIMS_AGGRESSOR_SWITCHED_TARGET, bounty, Entity::isShip, primaryAggressor, primaryTarget, scanClass, ScanTokensFromString(), sendExpandedMessage:toShip:, setBounty:withReason:, setThankedShip:, and thankedShip.

Here is the call graph for this function:

isBeacon

- (BOOL) isBeacon

implementation

Reimplemented from <OOBeaconEntity>.

Definition at line 1595 of file ShipEntity.m.

{
    return [self beaconCode] != nil;
}

References beaconCode, isBeacon, and nil.

Referenced by dumpSelfState, and isBeacon.

Here is the call graph for this function:

Here is the caller graph for this function:

IsBehaviourHostile

+ (static BOOL) IsBehaviourHostile (OOBehaviour) behaviour

implementation

Definition at line 7411 of file ShipEntity.m.

{
    switch (behaviour)
    {
        case BEHAVIOUR_ATTACK_TARGET:
        case BEHAVIOUR_ATTACK_FLY_TO_TARGET:
        case BEHAVIOUR_ATTACK_FLY_FROM_TARGET:
        case BEHAVIOUR_RUNNING_DEFENSE:
        case BEHAVIOUR_FLEE_TARGET:
        case BEHAVIOUR_ATTACK_BREAK_OFF_TARGET:
        case BEHAVIOUR_ATTACK_SLOW_DOGFIGHT:
        case BEHAVIOUR_EVASIVE_ACTION:
        case BEHAVIOUR_FLEE_EVASIVE_ACTION:
        case BEHAVIOUR_ATTACK_FLY_TO_TARGET_SIX:
    //  case BEHAVIOUR_ATTACK_MINING_TARGET:
        case BEHAVIOUR_ATTACK_FLY_TO_TARGET_TWELVE:
        case BEHAVIOUR_ATTACK_BROADSIDE:
        case BEHAVIOUR_ATTACK_BROADSIDE_LEFT:
        case BEHAVIOUR_ATTACK_BROADSIDE_RIGHT:
      case BEHAVIOUR_CLOSE_TO_BROADSIDE_RANGE:
        case BEHAVIOUR_CLOSE_WITH_TARGET:
      case BEHAVIOUR_ATTACK_SNIPER:
        case BEHAVIOUR_SCRIPTED_ATTACK_AI:
            return YES;
            
        default:
            return NO;
    }
    
    return 100 < behaviour && behaviour < 120;
}

References behaviour.

Referenced by hasHostileTarget.

Here is the caller graph for this function:

isBoulder

- (BOOL) isBoulder

Definition at line 1666 of file ShipEntity.m.

{
    return [roleSet hasRole:kBoulderRole];
}

References OORoleSet::hasRole:, and isBoulder.

Referenced by becomeExplosion, findBoundingBoxRelativeToPosition:InVectors:i:j:, isBoulder, and isMinable.

Here is the call graph for this function:

Here is the caller graph for this function:

isCloaked

- (BOOL) isCloaked

Definition at line 6670 of file ShipEntity.m.

{
    return cloaking_device_active;
}

References cloaking_device_active, and isCloaked.

Referenced by behaviour_track_as_turret:, PlayerEntity(OOPrivate)::checkEntityForMassLock:withScanClass:, checkScanner, checkScannerIgnoringUnpowered, PlayerEntity::collectBountyFor:, fireDirectLaserDefensiveShot, fireLaserShotInDirection:weaponIdentifier:, fireMissileWithIdentifier:andTarget:, fireSubentityLaserShot:, fireTurretCannon:, isCloaked, PlayerEntity::isValidTarget:, PlayerEntity::markAsOffender:withReason:, markAsOffender:withReason:, PlayerEntity::moveTargetMemoryBy:, reactionTime, removeEquipmentItem:, takeEnergyDamage:from:becauseOf:weaponIdentifier:, and updateTrackingCurve.

Here is the call graph for this function:

Here is the caller graph for this function:

isDefenseTarget:

- (BOOL) isDefenseTarget:

(Entity *)

target

Definition at line 11218 of file ShipEntity.m.

                        :(Entity *)target
{
    return [_defenseTargets containsObject:target];
}

References OOWeakSet::containsObject:.

Here is the call graph for this function:

isDemoShip

- (BOOL) isDemoShip

isEscort

- (BOOL) isEscort

Definition at line 7375 of file ShipEntity.m.

{
    return [UNIVERSE role:[self primaryRole] isInCategory:@"oolite-escort"];
}

References isEscort, and primaryRole.

Referenced by canAcceptEscort:, isEscort, isMissile, setUpEscorts, and takeEnergyDamage:from:becauseOf:weaponIdentifier:.

Here is the call graph for this function:

Here is the caller graph for this function:

isExplicitlyUnpiloted

- (BOOL) isExplicitlyUnpiloted

Definition at line 7399 of file ShipEntity.m.

{
    return _explicitlyUnpiloted;
}

References _explicitlyUnpiloted, and isExplicitlyUnpiloted.

Referenced by PlayerEntity::addRoleForAggression:, isExplicitlyUnpiloted, isMissile, isUnpiloted, StationEntity::isUnpiloted, and setCrew:.

Here is the call graph for this function:

Here is the caller graph for this function:

isFrangible

- (BOOL) isFrangible

References afterburnerFactor, afterburnerRate, equipmentCount, equipmentEnumerator, extraCargo, hasCargoScoop, hasCascadeMine, hasCloakingDevice, hasDockingComputer, hasECM, hasEscapePod, hasExpandedCargoBay, hasFuelInjection, hasFuelScoop, hasGalacticHyperdrive, hasHeatShield, hasHyperspaceMotor, hasMilitaryJammer, hasMilitaryScannerFilter, hasMilitaryShieldEnhancer, hasScoop, hasShieldBooster, hyperspaceSpinTime, maxAftShieldLevel, maxForwardShieldLevel, maxHyperspaceDistance, maxThrust, missileCapacity, missileCount, parcelCount, passengerCapacity, passengerCount, removeAllEquipment, removeMissiles, selectMissile, shieldBoostFactor, shieldRechargeRate, suppressFlightNotifications, thrust, and weaponFacings.

Here is the call graph for this function:

isFriendlyTo:

- (BOOL) isFriendlyTo:

(ShipEntity *)

otherShip

Definition at line 10157 of file ShipEntity.m.

                     :(ShipEntity *)otherShip
{
    BOOL isFriendly = NO;
    OOShipGroup *myGroup = [self group];
    OOShipGroup *otherGroup = [otherShip group];
    
    if ((otherShip == self) ||
        ([self isPolice] && [otherShip isPolice]) ||
        ([self isThargoid] && [otherShip isThargoid]) ||
        (myGroup != nil && otherGroup != nil && (myGroup == otherGroup || [otherGroup leader] == self)) ||
        ([self scanClass] == CLASS_MILITARY && [otherShip scanClass] == CLASS_MILITARY))
    {
        isFriendly = YES;
    }
    
    return isFriendly;
}

References group, isPolice, isThargoid, nil, and scanClass.

Here is the call graph for this function:

isHostileTo:

- (BOOL) isHostileTo:

(Entity *)

entity

Definition at line 7465 of file ShipEntity.m.

                    :(Entity *)entity
{
    return ([self hasHostileTarget] && [self primaryTarget] == entity);
}

References hasHostileTarget, and primaryTarget.

Referenced by Universe::IsFriendlyStationPredicate.

Here is the call graph for this function:

Here is the caller graph for this function:

isHulk

- (BOOL) isHulk

References script.

isJammingScanning

- (BOOL) isJammingScanning

implementation

Reimplemented from <OOBeaconEntity>.

Definition at line 6701 of file ShipEntity.m.

{
    return ([self hasMilitaryJammer] && military_jammer_active);
}

References hasMilitaryJammer, isJammingScanning, and military_jammer_active.

Referenced by fireMissileWithIdentifier:andTarget:, identFromShip:, isJammingScanning, PlayerEntity::isValidTarget:, scannerDisplayColorForShip:otherShip:isHostile:flash:scannerDisplayColor1:scannerDisplayColor2:scannerDisplayColorH1:, PlayerEntity::setNextCompassMode, and PlayerEntity::setPrevCompassMode.

Here is the call graph for this function:

Here is the caller graph for this function:

isMinable

- (BOOL) isMinable

Definition at line 1672 of file ShipEntity.m.

{
    if ([self hasRole:@"asteroid"] || [self isBoulder])
    {
        if (!noRocks)
        {
            return YES;
        }
    }
    return NO;
}

References isBoulder, isMinable, and noRocks.

Referenced by findBoundingBoxRelativeToPosition:InVectors:i:j:, and isMinable.

Here is the call graph for this function:

Here is the caller graph for this function:

isMine

- (BOOL) isMine

Definition at line 7363 of file ShipEntity.m.

{
    return [[self primaryRole] hasSuffix:@"MINE"];
}

References isMine, and primaryRole.

Referenced by PlayerEntity::fireMissile, isMine, isMissile, and isWeapon.

Here is the call graph for this function:

Here is the caller graph for this function:

isMining

- (BOOL) isMining

Reimplemented in PlayerEntity.

Definition at line 14277 of file ShipEntity.m.

{
    return ((behaviour == BEHAVIOUR_ATTACK_MINING_TARGET)&&([forward_weapon_type isMiningLaser]));
}

References behaviour, forward_weapon_type, and isMining.

Referenced by isMining, sunGlareFilter, and takeEnergyDamage:from:becauseOf:weaponIdentifier:.

Here is the call graph for this function:

Here is the caller graph for this function:

isMissile

- (BOOL) isMissile

References alertCondition, allDefenseTargets, collisionExceptions, defenseTargetCount, defenseTargetEnumerator, hasHostileTarget, isEscort, isExplicitlyUnpiloted, isMine, isPirateVictim, isShuttle, isTurret, isUnpiloted, isWeapon, realAlertCondition, removeAllDefenseTargets, validateDefenseTargets, and weaponRange.

Here is the call graph for this function:

isMissileFlagSet

- (BOOL) isMissileFlagSet

Definition at line 12317 of file ShipEntity.m.

{
    return isMissile; // were we created using fireMissile? (for tracking submunitions and preventing collisions at launch)
}

References isMissile, and isMissileFlagSet.

Referenced by coordinates, fireMissileWithIdentifier:andTarget:, and isMissileFlagSet.

Here is the call graph for this function:

Here is the caller graph for this function:

isPirate

- (BOOL) isPirate

Definition at line 7351 of file ShipEntity.m.

{
    return [UNIVERSE role:[self primaryRole] isInCategory:@"oolite-pirate"];
}

References isPirate, and primaryRole.

Referenced by isPirate, primaryRole, and takeEnergyDamage:from:becauseOf:weaponIdentifier:.

Here is the call graph for this function:

Here is the caller graph for this function:

isPirateVictim

- (BOOL) isPirateVictim

Definition at line 7393 of file ShipEntity.m.

{
    return [UNIVERSE roleIsPirateVictim:[self primaryRole]];
}

References isPirateVictim, and primaryRole.

Referenced by PlayerEntity::addRoleForAggression:, isMissile, and isPirateVictim.

Here is the call graph for this function:

Here is the caller graph for this function:

isPolice

- (BOOL) isPolice

Definition at line 7333 of file ShipEntity.m.

{
    //bounty hunters have a police role, but are not police, so we must test by scan class, not by role
    return [self scanClass] == CLASS_POLICE;
}

References isPolice, and scanClass.

Referenced by PlayerEntity::collectBountyFor:, collectBountyFor:, isFriendlyTo:, isPolice, StationEntity::launchDefenseShip, markAsOffender:withReason:, primaryRole, respondToAttackFrom:becauseOf:, setUpEscorts, and takeEnergyDamage:from:becauseOf:weaponIdentifier:.

Here is the call graph for this function:

Here is the caller graph for this function:

isShipWithSubEntityShip:

- (BOOL) isShipWithSubEntityShip: (Entity *) other

implementation

Reimplemented from Entity.

Provided by category ShipEntity(SubEntityRelationship).

Definition at line 14874 of file ShipEntity.m.

                                :(Entity *)other
{
    assert ([self isShip]);
    
    if (![other isShip])  return NO;
    if (![other isSubEntity])  return NO;
    if ([other owner] != self)  return NO;
    
#ifndef NDEBUG
    // Sanity check; this should always be true.
    if (![self hasSubEntity:(ShipEntity *)other])
    {
        OOLogERR(@"ship.subentity.sanityCheck.failed", @"%@ thinks it's a subentity of %@, but the supposed parent does not agree. %@", [other shortDescription], [self shortDescription], @"This is an internal error, please report it.");
        [other setOwner:nil];
        return NO;
    }
#endif
    
    return YES;
}

isShuttle

- (BOOL) isShuttle

Definition at line 7381 of file ShipEntity.m.

{
    return [UNIVERSE role:[self primaryRole] isInCategory:@"oolite-shuttle"];
}

References isShuttle, and primaryRole.

Referenced by isMissile, isShuttle, and landOnPlanet:.

Here is the call graph for this function:

Here is the caller graph for this function:

isTemplateCargoPod

- (BOOL) isTemplateCargoPod

Definition at line 1017 of file ShipEntity.m.

{
    return [[self primaryRole] isEqualToString:@"oolite-template-cargopod"];
}

References isTemplateCargoPod, and primaryRole.

Referenced by bounty, and isTemplateCargoPod.

Here is the call graph for this function:

Here is the caller graph for this function:

isThargoid

- (BOOL) isThargoid

Definition at line 7339 of file ShipEntity.m.

{
    return [self scanClass] == CLASS_THARGOID;
}

References isThargoid, and scanClass.

Referenced by addEquipmentItem:withValidation:inContext:, becomeExplosion, behaviour_fly_to_target_six:, canAddEquipment:inContext:, isFriendlyTo:, isThargoid, primaryRole, removeEquipmentItem:, selectMissile, and setUpEscorts.

Here is the call graph for this function:

Here is the caller graph for this function:

isTrader

- (BOOL) isTrader

Definition at line 7345 of file ShipEntity.m.

{
    return [UNIVERSE role:[self primaryRole] isInCategory:@"oolite-trader"];
}

References isTrader, and primaryRole.

Referenced by isTrader, primaryRole, and takeEnergyDamage:from:becauseOf:weaponIdentifier:.

Here is the call graph for this function:

Here is the caller graph for this function:

isTurret

- (BOOL) isTurret

Definition at line 7387 of file ShipEntity.m.

{
    return behaviour == BEHAVIOUR_TRACK_AS_TURRET;
}

References behaviour, and isTurret.

Referenced by isMissile, isTurret, and turretCount.

Here is the call graph for this function:

Here is the caller graph for this function:

isUnpiloted

- (BOOL) isUnpiloted

Reimplemented in StationEntity.

Definition at line 7405 of file ShipEntity.m.

{
    return [self isExplicitlyUnpiloted] || [self isHulk] || [self scanClass] == CLASS_ROCK || [self scanClass] == CLASS_CARGO;
}

References isExplicitlyUnpiloted, isHulk, isUnpiloted, and scanClass.

Referenced by isMissile, isUnpiloted, and setSingleCrewWithRole:.

Here is the call graph for this function:

Here is the caller graph for this function:

isValidTarget:

- (BOOL) isValidTarget:

(Entity *)

target

Reimplemented in PlayerEntity.

Definition at line 10034 of file ShipEntity.m.

                      :(Entity *)target
{
    if (target == nil) 
    {
        return NO;
    }
    if ([target isShip])
    {
        OOEntityStatus tstatus = [target status];
        if (tstatus == STATUS_ENTERING_WITCHSPACE || tstatus == STATUS_IN_HOLD || tstatus == STATUS_DOCKED || tstatus == STATUS_DEAD)
        // 2013-01-13, Eric: added STATUS_DEAD because I keep seeing ships locked on dead ships in attack mode.
        {
            return NO;
        }
        return YES;
    }
    if ([target isWormhole] && [target scanClass] != CLASS_NO_DRAW)
    {
        return YES;
    }
    return NO;
}

References Entity::isShip, Entity::isWormhole, nil, scanClass, and Entity::status.

Referenced by noteLostTarget.

Here is the call graph for this function:

Here is the caller graph for this function:

isVisible

- (BOOL) isVisible

implementation

Reimplemented from Entity.

Definition at line 1589 of file ShipEntity.m.

{
    return cam_zero_distance <= no_draw_distance;
}

References Entity::cam_zero_distance, isVisible, and Entity::no_draw_distance.

Referenced by becomeExplosion, PlayerEntity::equipmentList, isVisible, and PlayerEntity::lookingAtSunWithThresholdAngleCos:.

Here is the call graph for this function:

Here is the caller graph for this function:

isVisibleToScripts

- (BOOL) isVisibleToScripts

implementation

Reimplemented from Entity.

Provided by category ShipEntity(OOJavaScriptExtensions).

Definition at line 115 of file EntityOOJavaScriptExtensions.m.

{
    return YES;
}

isWeapon

- (BOOL) isWeapon

Definition at line 7369 of file ShipEntity.m.

{
    return [self isMissile] || [self isMine];
}

References isMine, isMissile, and isWeapon.

Referenced by isMissile, and isWeapon.

Here is the call graph for this function:

Here is the caller graph for this function:

landOnPlanet

- (void) landOnPlanet

implementation

Provided by category ShipEntity(PureAI).

Definition at line 1353 of file ShipEntityAI.m.

{
    // Selects the nearest planet it can find.
    [self landOnPlanet:[self findNearestPlanet]];
}

Referenced by coordinates, and landOnPlanet:.

Here is the caller graph for this function:

landOnPlanet:

- (void) landOnPlanet:

(OOPlanetEntity *)

planet

Definition at line 14027 of file ShipEntity.m.

                     :(OOPlanetEntity *)planet
{
    if (planet && [self isShuttle])
    {
        [planet welcomeShuttle:self];
    }
    [self doScriptEvent:OOJSID("shipLandedOnPlanet") withArgument:planet andReactToAIMessage:@"LANDED_ON_PLANET"];
    
#ifndef NDEBUG
    if ([self reportAIMessages])
    {
        OOLog(@"planet.collide.shuttleLanded", @"DEBUG: %@ landed on planet %@", self, planet);
    }
#endif
    
    [UNIVERSE removeEntity:self];
}

References doScriptEvent:withArgument:andReactToAIMessage:, isShuttle, landOnPlanet, OOLog, and reportAIMessages.

Referenced by behaviour_land_on_planet:, and ShipEntity(PureAI)::landOnPlanet.

Here is the call graph for this function:

Here is the caller graph for this function:

laserColor

- (OOColor *) laserColor

Definition at line 11717 of file ShipEntity.m.

{
    return [[laser_color retain] autorelease];
}

References laserColor.

Referenced by coordinates, and laserColor.

Here is the call graph for this function:

Here is the caller graph for this function:

laserHeatLevel

- (GLfloat) laserHeatLevel

Reimplemented in PlayerEntity.

Definition at line 9710 of file ShipEntity.m.

{
    GLfloat result = weapon_temp / NPC_MAX_WEAPON_TEMP;
    return OOClamp_0_1_f(result);
}

References laserHeatLevel, NPC_MAX_WEAPON_TEMP, and weapon_temp.

Referenced by laserHeatLevel, maxFlightSpeed, and OOShipDebugInspectorModule::update.

Here is the call graph for this function:

Here is the caller graph for this function:

laserHeatLevelAft

- (GLfloat) laserHeatLevelAft

Reimplemented in PlayerEntity.

Definition at line 9717 of file ShipEntity.m.

{
    GLfloat result = aft_weapon_temp / NPC_MAX_WEAPON_TEMP;
    return OOClamp_0_1_f(result);
}

References aft_weapon_temp, laserHeatLevelAft, and NPC_MAX_WEAPON_TEMP.

Referenced by laserHeatLevelAft, and maxFlightSpeed.

Here is the call graph for this function:

Here is the caller graph for this function:

laserHeatLevelForward

- (GLfloat) laserHeatLevelForward

Reimplemented in PlayerEntity.

Definition at line 9724 of file ShipEntity.m.

{
    GLfloat result = forward_weapon_temp / NPC_MAX_WEAPON_TEMP;
    if (isWeaponNone(forward_weapon_type)) 
    { // must check subents
        OOWeaponType forward_weapon_real_type = nil;
        NSEnumerator    *subEnum = [self shipSubEntityEnumerator];
        ShipEntity      *se = nil;
        while (isWeaponNone(forward_weapon_real_type) && (se = [subEnum nextObject]))
        {
            if (!isWeaponNone(se->forward_weapon_type))
            {
                forward_weapon_real_type = se->forward_weapon_type;
                result = se->forward_weapon_temp / NPC_MAX_WEAPON_TEMP;
            }
        }
    }
    return OOClamp_0_1_f(result);
}

References forward_weapon_temp, forward_weapon_type, isWeaponNone(), laserHeatLevelForward, nil, NPC_MAX_WEAPON_TEMP, and shipSubEntityEnumerator.

Referenced by laserHeatLevelForward, and maxFlightSpeed.

Here is the call graph for this function:

Here is the caller graph for this function:

laserHeatLevelPort

- (GLfloat) laserHeatLevelPort

Reimplemented in PlayerEntity.

Definition at line 9745 of file ShipEntity.m.

{
    GLfloat result = port_weapon_temp / NPC_MAX_WEAPON_TEMP;
    return OOClamp_0_1_f(result);
}

References laserHeatLevelPort, NPC_MAX_WEAPON_TEMP, and port_weapon_temp.

Referenced by laserHeatLevelPort, and maxFlightSpeed.

Here is the call graph for this function:

Here is the caller graph for this function:

laserHeatLevelStarboard

- (GLfloat) laserHeatLevelStarboard

Reimplemented in PlayerEntity.

Definition at line 9752 of file ShipEntity.m.

{
    GLfloat result = starboard_weapon_temp / NPC_MAX_WEAPON_TEMP;
    return OOClamp_0_1_f(result);
}

References laserHeatLevelStarboard, NPC_MAX_WEAPON_TEMP, and starboard_weapon_temp.

Referenced by laserHeatLevelStarboard, and maxFlightSpeed.

Here is the call graph for this function:

Here is the caller graph for this function:

laserPortOffset:

- (NSArray *) laserPortOffset:

(OOWeaponFacing)

direction

Definition at line 11918 of file ShipEntity.m.

                             :(OOWeaponFacing)direction
{
    NSArray *laserPortOffset = nil;
    switch (direction)
    {
        case WEAPON_FACING_FORWARD:
        case WEAPON_FACING_NONE:
            laserPortOffset = forwardWeaponOffset;
            break;
            
        case WEAPON_FACING_AFT:
            laserPortOffset = aftWeaponOffset;
            break;
            
        case WEAPON_FACING_PORT:
            laserPortOffset = portWeaponOffset;
            break;
            
        case WEAPON_FACING_STARBOARD:
            laserPortOffset = starboardWeaponOffset;
            break;
    }
    return laserPortOffset;
}

References aftWeaponOffset, forwardWeaponOffset, nil, portWeaponOffset, starboardWeaponOffset, WEAPON_FACING_AFT, WEAPON_FACING_FORWARD, WEAPON_FACING_NONE, WEAPON_FACING_PORT, and WEAPON_FACING_STARBOARD.

Referenced by PlayerEntity::currentLaserOffset, fireLaserShotInDirection:weaponIdentifier:, PlayerEntity::fireMainWeapon, and fireWeapon:direction:range:.

Here is the caller graph for this function:

lastAegisLock

- (Entity< OOStellarBody > *) lastAegisLock

implementation

Provided by category ShipEntity(Private).

Definition at line 7885 of file ShipEntity.m.

{
    Entity<OOStellarBody> *stellar = [_lastAegisLock weakRefUnderlyingObject];
    if (stellar == nil)
    {
        [_lastAegisLock release];
        _lastAegisLock = nil;
    }
    
    return stellar;
}

References ShipEntity(Private)::lastAegisLock, and nil.

Referenced by checkForAegis, ShipEntity(Private)::lastAegisLock, and transitionToAegisNone.

Here is the call graph for this function:

Here is the caller graph for this function:

lastEscortTarget

- (Entity *) lastEscortTarget

Definition at line 9956 of file ShipEntity.m.

{
    Entity *result = [_lastEscortTarget weakRefUnderlyingObject];
    if (result == nil || ![self isValidTarget:result])
    {
        DESTROY(_lastEscortTarget);
        return nil;
    }
    return result;
}

References _lastEscortTarget, DESTROY, lastEscortTarget, nil, and OOWeakReference::weakRefUnderlyingObject.

Referenced by deployEscorts, ShipEntity(PureAI)::fightOrFleeHostiles, lastEscortTarget, and maxFlightSpeed.

Here is the call graph for this function:

Here is the caller graph for this function:

launchCascadeMine

- (BOOL) launchCascadeMine

Definition at line 12385 of file ShipEntity.m.

{
    if (![self hasCascadeMine])  return NO;
    [self setSpeed: maxFlightSpeed + 300];
    ShipEntity* bomb = [UNIVERSE newShipWithRole:@"energy-bomb"];
    if (bomb == nil)  return NO;
    
    [self removeEquipmentItem:@"EQ_QC_MINE"];
    
    double  start = collision_radius + bomb->collision_radius;
    Quaternion  random_direction;
    Vector  vel;
    HPVector  rpos;
    double random_roll =    randf() - 0.5;  //  -0.5 to +0.5
    double random_pitch =   randf() - 0.5;  //  -0.5 to +0.5
    quaternion_set_random(&random_direction);
    
    rpos = HPvector_subtract([self position], vectorToHPVector(vector_multiply_scalar(v_forward, start)));
    
    double  eject_speed = -800.0;
    vel = vector_multiply_scalar(v_forward, [self flightSpeed] + eject_speed);
    eject_speed *= 0.5 * (randf() - 0.5);   //  -0.25x .. +0.25x
    vel = vector_add(vel, vector_multiply_scalar(v_up, eject_speed));
    eject_speed *= 0.5 * (randf() - 0.5);   //  -0.0625x .. +0.0625x
    vel = vector_add(vel, vector_multiply_scalar(v_right, eject_speed));
    
    [bomb setPosition:rpos];
    [bomb setOrientation:random_direction];
    [bomb setRoll:random_roll];
    [bomb setPitch:random_pitch];
    [bomb setVelocity:vel];
    [bomb setScanClass:CLASS_MINE];
    [bomb setEnergy:5.0];  // 5 second countdown
    [bomb setBehaviour:BEHAVIOUR_ENERGY_BOMB_COUNTDOWN];
    [bomb setOwner:self];
    [UNIVERSE addEntity:bomb];  // STATUS_IN_FLIGHT, AI state GLOBAL
    [bomb release];
    
    if (cloaking_device_active && cloakPassive)
    {
        [self deactivateCloakingDevice];
    }
    
    if (self != PLAYER)   // get the heck out of here
    {
        [self addTarget:bomb];
        [self setBehaviour:BEHAVIOUR_FLEE_TARGET];
        frustration = 0.0;
    }
    return YES;
}

References addTarget:, cloaking_device_active, cloakPassive, Entity::collision_radius, deactivateCloakingDevice, flightSpeed, frustration, hasCascadeMine, launchCascadeMine, nil, PLAYER, Entity::position, quaternion_set_random(), randf(), removeEquipmentItem:, setBehaviour:, Entity::setEnergy:, Entity::setOrientation:, setOwner:, setPitch:, Entity::setPosition:, setRoll:, Entity::setScanClass:, setSpeed:, Entity::setVelocity:, v_forward, v_right, and v_up.

Referenced by behaviour_flee_target:, coordinates, and launchCascadeMine.

Here is the call graph for this function:

Here is the caller graph for this function:

launchEscapeCapsule

- (ShipEntity *) launchEscapeCapsule

Reimplemented in PlayerEntity.

Definition at line 12438 of file ShipEntity.m.

{
    ShipEntity      *result = nil;
    ShipEntity          *mainPod = nil;
    unsigned            n_pods, i;
    NSMutableArray      *passengers = nil;
    
    /*
        CHANGE: both player & NPCs can now launch escape pods in interstellar
        space. -- Kaks 20101113
    */
    
    // check number of pods aboard -- require at least one.
    n_pods = [shipinfoDictionary oo_unsignedIntForKey:@"has_escape_pod"];
    if (n_pods > 65) n_pods = 65; // maximum of 64 passengers.
    if (n_pods > 1) passengers = [NSMutableArray arrayWithCapacity:n_pods-1];
    
    if (crew)   // transfer crew
    {
        // make sure crew inherit any legalStatus
        for (i = 0; i < [crew count]; i++)
        {
            OOCharacter *ch = (OOCharacter*)[crew objectAtIndex:i];
            [ch setLegalStatus: [self legalStatus] | [ch legalStatus]];
        }
        mainPod = [self launchPodWithCrew:crew];
        if (mainPod)
        {
            result = mainPod;
            [self setCrew:nil];
            [self setHulk:YES]; // we are without crew now.
        }
    }
    
    // launch other pods (passengers)
    for (i = 1; i < n_pods; i++)
    {
        ShipEntity  *passenger = nil;
        passenger = [self launchPodWithCrew:[NSArray arrayWithObject:[OOCharacter randomCharacterWithRole:@"passenger" andOriginalSystem:gen_rnd_number()]]];
        [passengers addObject:passenger];
    }
    
    if (mainPod) [self doScriptEvent:OOJSID("shipLaunchedEscapePod") withArgument:mainPod andArgument:passengers];
    
    return result;
}

References crew, doScriptEvent:withArgument:andArgument:, launchEscapeCapsule, launchPodWithCrew:, OOCharacter::legalStatus, legalStatus, nil, OOCharacter::randomCharacterWithRole:andOriginalSystem:, setCrew:, setHulk:, and OOCharacter::setLegalStatus:.

Referenced by abandonShip, coordinates, and launchEscapeCapsule.

Here is the call graph for this function:

Here is the caller graph for this function:

launchPatrol

- (BOOL) launchPatrol

implementation

Reimplemented in StationEntity.

Provided by category ShipEntity(OOAIStationStubs).

Definition at line 2941 of file ShipEntityAI.m.

{
    OOLog(@"ai.invalid.notAStation", @"Attempt to use station AI method \"%s\" on non-station %@.", "launchPatrol", self);
    return NO;
}

launchPodWithCrew:

- (ShipEntity *) launchPodWithCrew: (NSArray *) podCrew

implementation

Provided by category ShipEntity(Private).

Definition at line 2277 of file ShipEntity.m.

                                  :(NSArray *)podCrew
{
    ShipEntity *pod = nil;
    
    pod = [UNIVERSE newShipWithRole:[shipinfoDictionary oo_stringForKey:@"escape_pod_role"]];   // or nil
    if (!pod)
    {
        //  _role not defined? it might have _model defined;
        pod = [UNIVERSE newShipWithRole:[shipinfoDictionary oo_stringForKey:@"escape_pod_model" defaultValue:@"escape-capsule"]];
        if (!pod)
        {
            pod = [UNIVERSE newShipWithRole:@"escape-capsule"];
            OOLog(@"shipEntity.noEscapePod", @"Ship %@ has no correct escape_pod_role defined. Now using default capsule.", self);
        }
    }
    
    if (pod)
    {
        [pod setOwner:self];
        [pod setTemperature:[self randomEjectaTemperatureWithMaxFactor:0.9]];
        [pod setCommodity:@"slaves" andAmount:1];
        [pod setCrew:podCrew];
        [pod switchAITo:@"oolite-shuttleAI.js"];
        [self dumpItem:pod];    // CLASS_CARGO, STATUS_IN_FLIGHT, AI state GLOBAL
        [pod release]; //release
    }
    
    return pod;
}

References dumpItem:, nil, OOLog, randomEjectaTemperatureWithMaxFactor:, setCommodity:andAmount:, setCrew:, setOwner:, setTemperature:, and switchAITo:.

Referenced by launchEscapeCapsule.

Here is the call graph for this function:

Here is the caller graph for this function:

leaveDock:

- (void) leaveDock:

(StationEntity *)

station

Reimplemented in PlayerEntity.

Definition at line 13475 of file ShipEntity.m.

                  :(StationEntity *)station
{
    // This code is never used. Currently npc ships are only launched from the stations launch queue.
    if (station == nil)  return;
    
    [station launchShip:self];
 
}

References StationEntity::launchShip:, and nil.

Here is the call graph for this function:

leaveWitchspace

- (void) leaveWitchspace

Reimplemented in PlayerEntity.

Definition at line 13539 of file ShipEntity.m.

{
    Quaternion  q1;
    quaternion_set_random(&q1);
    Vector      v1 = vector_forward_from_quaternion(q1);
    double      d1 = 0.0;
    
    GLfloat min_d1 = [UNIVERSE safeWitchspaceExitDistance];
 
    while (fabs(d1) < min_d1)
    {
        // not scannerRange - has no effect on witchspace exit
        d1 = SCANNER_MAX_RANGE * (randf() - randf());
    }
    
    HPVector exitposition = [UNIVERSE getWitchspaceExitPosition];
    exitposition.x += v1.x * d1; // randomise exit position
    exitposition.y += v1.y * d1;
    exitposition.z += v1.z * d1;
    [self setPosition:exitposition];
    [self witchspaceLeavingEffects];
}

References leaveWitchspace, quaternion_set_random(), randf(), SCANNER_MAX_RANGE, Entity::setPosition:, vector_forward_from_quaternion(), and witchspaceLeavingEffects.

Referenced by coordinates, leaveWitchspace, and Universe::witchspaceShipWithPrimaryRole:.

Here is the call graph for this function:

Here is the caller graph for this function:

legalStatus

- (int) legalStatus

Definition at line 8312 of file ShipEntity.m.

{
    if (scanClass == CLASS_THARGOID)
        return 5 * collision_radius;
    if (scanClass == CLASS_ROCK)
        return 0;
    return (int)[self bounty];
}

References bounty, Entity::collision_radius, int(), legalStatus, and scanClass.

Referenced by bounty, ShipEntity(PureAI)::checkOwnLegalStatus, ShipEntity(PureAI)::checkTargetLegalStatus, StationEntity::dockingInstructionsForShip:, equipmentValidToAdd:whileLoading:inContext:, launchEscapeCapsule, legalStatus, markForFines, scanDescription, ShipEntity(PureAI)::scanForOffenders, and scoopUpProcess:processEvents:processMessages:.

Here is the call graph for this function:

Here is the caller graph for this function:

lightsActive

- (BOOL) lightsActive

Definition at line 13669 of file ShipEntity.m.

{
    return _lightsActive;
}

References _lightsActive, and lightsActive.

Referenced by coordinates, and lightsActive.

Here is the call graph for this function:

Here is the caller graph for this function:

lookingAtSunWithThresholdAngleCos:

- (GLfloat) lookingAtSunWithThresholdAngleCos:

(GLfloat)

thresholdAngleCos

Reimplemented in PlayerEntity.

Definition at line 11351 of file ShipEntity.m.

                                             :(GLfloat) thresholdAngleCos
{
    OOSunEntity *sun = [UNIVERSE sun];
    GLfloat measuredCos = 999.0f, measuredCosAbs;
    GLfloat sunBrightness = 0.0f;
    Vector relativePosition, unitRelativePosition;
    
    if (EXPECT_NOT(!sun))  return 0.0f;
    
    relativePosition = HPVectorToVector(HPvector_subtract([self position], [sun position]));
    unitRelativePosition = vector_normal_or_zbasis(relativePosition);
    switch (currentWeaponFacing)
    {
        case WEAPON_FACING_FORWARD:
            measuredCos = -dot_product(unitRelativePosition, v_forward);
            break;
        case WEAPON_FACING_AFT:
            measuredCos = +dot_product(unitRelativePosition, v_forward);
            break;
        case WEAPON_FACING_PORT:
            measuredCos = +dot_product(unitRelativePosition, v_right);
            break;
        case WEAPON_FACING_STARBOARD:
            measuredCos = -dot_product(unitRelativePosition, v_right);
            break;
        default:
            break;
    }
    measuredCosAbs = fabs(measuredCos);
    if (thresholdAngleCos <= measuredCosAbs && measuredCosAbs <= 1.0f)  // angle from viewpoint to sun <= desired threshold
    {
        sunBrightness =  (measuredCos - thresholdAngleCos) / (1.0f - thresholdAngleCos);
        if (sunBrightness < 0.0f)  sunBrightness = 0.0f;
    }
    return sunBrightness * sunBrightness * sunBrightness;
}

References currentWeaponFacing, EXPECT_NOT, Entity::position, Entity::relativePosition, v_forward, v_right, WEAPON_FACING_AFT, WEAPON_FACING_FORWARD, WEAPON_FACING_PORT, and WEAPON_FACING_STARBOARD.

Referenced by currentAimTolerance.

Here is the call graph for this function:

Here is the caller graph for this function:

manageCollisions

- (void) manageCollisions

Definition at line 12642 of file ShipEntity.m.

{
    // deal with collisions
    //
    Entity*     ent;
    ShipEntity* other_ship;
    
    while ([collidingEntities count] > 0)
    {
        // EMMSTRAN: investigate if doing this backwards would be more efficient. (Not entirely obvious, NSArray is kinda funky.) -- Ahruman 2011-02-12
        ent = [[[collidingEntities objectAtIndex:0] retain] autorelease];
        [collidingEntities removeObjectAtIndex:0];
        if (ent)
        {
            if ([ent isShip])
            {
                other_ship = (ShipEntity *)ent;
                [self collideWithShip:other_ship];
            }
            else if ([ent isStellarObject])
            {
                [self getDestroyedBy:ent damageType:[ent isSun] ? kOODamageTypeHitASun : kOODamageTypeHitAPlanet];
                if (self == PLAYER)  [self retain];
            }
            else if ([ent isWormhole])
            {
                if( [self isPlayer] ) [self enterWormhole:(WormholeEntity*)ent];
                else [self enterWormhole:(WormholeEntity*)ent replacing:NO];
            }
        }
    }
}

References collideWithShip:, Entity::collidingEntities, count, enterWormhole:, enterWormhole:replacing:, Entity::isPlayer, Entity::isShip, Entity::isStellarObject, Entity::isSun, Entity::isWormhole, manageCollisions, and PLAYER.

Referenced by coordinates, manageCollisions, PlayerEntity::update:, and update:.

Here is the call graph for this function:

Here is the caller graph for this function:

markAsOffender:

- (void) markAsOffender:

(int)

offence_value

Reimplemented in PlayerEntity.

Definition at line 13591 of file ShipEntity.m.

                       :(int)offence_value
{
    [self markAsOffender:offence_value withReason:kOOLegalStatusReasonUnknown];
}

References markAsOffender:withReason:.

Here is the call graph for this function:

markAsOffender:withReason:

- (void) markAsOffender:		(int)	offence_value
withReason:		(OOLegalStatusReason)	reason

Reimplemented in PlayerEntity.

Definition at line 13597 of file ShipEntity.m.

                       :(int)offence_value withReason:(OOLegalStatusReason)reason
{
    if (![self isPolice] && ![self isCloaked] && self != [UNIVERSE station])
    {
        if ([self isSubEntity]) 
        {
            [[self parentEntity] markAsOffender:offence_value withReason:reason];
        }
        else
        {
            if ((scanClass == CLASS_THARGOID || scanClass == CLASS_STATION) && reason != kOOLegalStatusReasonSetup && reason != kOOLegalStatusReasonByScript)
            {
                return; // no non-scripted bounties for thargoids and stations
            }
 
            JSContext *context = OOJSAcquireContext();
    
            jsval amountVal = JSVAL_VOID;
            JS_NewNumberValue(context, (bounty | offence_value)-bounty, &amountVal);
 
            bounty |= offence_value; // can't set the new bounty until the size of the change is known
 
            jsval reasonVal = OOJSValueFromLegalStatusReason(context, reason);
        
            ShipScriptEvent(context, self, "shipBountyChanged", amountVal, reasonVal);
        
            OOJSRelinquishContext(context);
        
        }
    }
}

References bounty, isCloaked, isPolice, Entity::isSubEntity, markAsOffender:withReason:, OOJSAcquireContext(), OOJSRelinquishContext(), OOJSValueFromLegalStatusReason(), Entity::parentEntity, scanClass, ShipScriptEvent, and UNIVERSE.

Referenced by StationEntity(OOAIPrivate)::acceptDistressMessageFrom:, collectBountyFor:, ShipEntity(PureAI)::fightOrFleeMissile, markAsOffender:, markAsOffender:withReason:, ShipEntity(PureAI)::markTargetForOffence:, ShipEntity(Private)::setUpOneEscort:inGroup:withRole:atPosition:andCount:, ShipEntity(AI)::suggestEscortTo:, takeEnergyDamage:from:becauseOf:weaponIdentifier:, and StationEntity::takeEnergyDamage:from:becauseOf:weaponIdentifier:.

Here is the call graph for this function:

Here is the caller graph for this function:

markedForFines

- (BOOL) markedForFines

Definition at line 14262 of file ShipEntity.m.

{
    return being_fined;
}

References being_fined, and markedForFines.

Referenced by markedForFines, and sunGlareFilter.

Here is the call graph for this function:

Here is the caller graph for this function:

markForFines

- (BOOL) markForFines

Definition at line 14268 of file ShipEntity.m.

{
    if (being_fined)
        return NO;  // can't mark twice
    being_fined = ([self legalStatus] > 0);
    return being_fined;
}

References being_fined, legalStatus, and markForFines.

Referenced by PlayerEntity(OOControlsPrivate)::handleAutopilotOn:, markForFines, ShipMarkTargetForFines(), and sunGlareFilter.

Here is the call graph for this function:

Here is the caller graph for this function:

markTargetForFines

- (void) markTargetForFines

implementation

Provided by category ShipEntity(PureAI).

Definition at line 2097 of file ShipEntityAI.m.

{
    ShipEntity *ship = [self primaryTarget];
    if ((ship == nil) || ([ship status] == STATUS_DEAD) || ([ship status] == STATUS_DOCKED))
    {
        [self noteLostTarget];
        return;
    }
    if ([ship markForFines])  [shipAI message:@"TARGET_MARKED"];
}

markTargetForOffence:

- (void) markTargetForOffence: (NSString *) valueString

implementation

Provided by category ShipEntity(PureAI).

Definition at line 2109 of file ShipEntityAI.m.

                             :(NSString *)valueString
{
    if ((isStation)||(scanClass == CLASS_POLICE))
    {
        ShipEntity *ship = [self primaryTarget];
        if ((ship == nil) || ([ship status] == STATUS_DEAD) || ([ship status] == STATUS_DOCKED))
        {
            [self noteLostTarget];
            return;
        }
        NSString *finalValue = OOExpand(valueString);   // expand values
        [ship markAsOffender:[finalValue intValue] withReason:kOOLegalStatusReasonSeenByPolice];
    }
}

maxAftShieldLevel

- (float) maxAftShieldLevel

Reimplemented in PlayerEntity.

Definition at line 4078 of file ShipEntity.m.

{
    return BASELINE_SHIELD_LEVEL * [self shieldBoostFactor];
}

References BASELINE_SHIELD_LEVEL, maxAftShieldLevel, and shieldBoostFactor.

Referenced by isFrangible, and maxAftShieldLevel.

Here is the call graph for this function:

Here is the caller graph for this function:

maxAvailableCargoSpace

- (OOCargoQuantity) maxAvailableCargoSpace

Definition at line 8368 of file ShipEntity.m.

{
    return max_cargo - equipment_weight;
}

References equipment_weight, max_cargo, and maxAvailableCargoSpace.

Referenced by addCargo:, availableCargoSpace, bounty, canScoop:, PlayerEntity::cargoQuantityOnBoard, PlayerEntity::changePassengerBerths:, PlayerEntity::dialFuelScoopStatus, ShipEntity(PureAI)::ejectCargo, PlayerEntity::enterWitchspace, PlayerEntity::loadCargoPodsForType:amount:, maxAvailableCargoSpace, OOShipLibraryCargo(), scoopUpProcess:processEvents:processMessages:, setCargoFlag:, PlayerEntity::setCommanderDataFromDictionary:, PlayerEntity(Contracts)::setGuiToDockingReportScreen, PlayerEntity(Contracts)::setGuiToManifestScreen, PlayerEntity::setGuiToMarketScreen, ShipSetProperty(), PlayerEntity(OOPrivate)::showMarketCashAndLoadLine, PlayerEntity::takeInternalDamage, and PlayerEntity::tryBuyingCommodity:all:.

Here is the call graph for this function:

Here is the caller graph for this function:

maxEscortCount

- (uint8_t) maxEscortCount

Definition at line 7016 of file ShipEntity.m.

{
    return _maxEscortCount;
}

References _maxEscortCount, and maxEscortCount.

Referenced by maxEscortCount, and messageTime.

Here is the call graph for this function:

Here is the caller graph for this function:

maxFlightPitch

- (GLfloat) maxFlightPitch

Definition at line 8729 of file ShipEntity.m.

{
    return max_flight_pitch;
}

References max_flight_pitch, and maxFlightPitch.

Referenced by flightSpeed, maxFlightPitch, and OOShipLibraryTurnRate().

Here is the call graph for this function:

Here is the caller graph for this function:

maxFlightRoll

- (GLfloat) maxFlightRoll

Definition at line 8741 of file ShipEntity.m.

{
    return max_flight_roll;
}

References max_flight_roll, and maxFlightRoll.

Referenced by maxFlightRoll, maxFlightSpeed, and OOShipLibraryTurnRate().

Here is the call graph for this function:

Here is the caller graph for this function:

maxFlightSpeed

- (GLfloat) maxFlightSpeed

References absoluteIJKForSubentity, becomeEnergyBlast, becomeExplosion, behaviour, broadcastEnergyBlastImminent, canStillTrackPrimaryTarget, checkScanner, checkScannerIgnoringUnpowered, damage, dealEnergyDamageWithinDesiredRange, entityPersonality, entityPersonalityInt, findSubentityBoundingBox, foundTarget, heatInsulation, hullHeatLevel, int(), laserHeatLevel, laserHeatLevelAft, laserHeatLevelForward, laserHeatLevelPort, laserHeatLevelStarboard, lastEscortTarget, maxFlightRoll, maxFlightYaw, noteLostTarget, noteLostTargetAndGoIdle, numberOfScannedShips, positionOffsetForShipInRotationToAlignment, primaryAggressor, primaryTarget, primaryTargetWithoutValidityCheck, proximityAlert, randomEjectaTemperature, rememberedShip, resetExhaustPlumes, scannedShips, shipHitByLaser, showDamage, speedFactor, targetStation, temperature, thankedShip, and weaponRecoveryTime.

Here is the call graph for this function:

maxFlightYaw

- (GLfloat) maxFlightYaw

Definition at line 8747 of file ShipEntity.m.

{
    return max_flight_yaw;
}

References max_flight_yaw, and maxFlightYaw.

Referenced by maxFlightSpeed, and maxFlightYaw.

Here is the call graph for this function:

Here is the caller graph for this function:

maxForwardShieldLevel

- (float) maxForwardShieldLevel

Reimplemented in PlayerEntity.

Definition at line 4072 of file ShipEntity.m.

{
    return BASELINE_SHIELD_LEVEL * [self shieldBoostFactor];
}

References BASELINE_SHIELD_LEVEL, maxForwardShieldLevel, and shieldBoostFactor.

Referenced by isFrangible, and maxForwardShieldLevel.

Here is the call graph for this function:

Here is the caller graph for this function:

maxHyperspaceDistance

- (double) maxHyperspaceDistance

Definition at line 4090 of file ShipEntity.m.

{
    return MAX_JUMP_RANGE;
}

References MAX_JUMP_RANGE, and maxHyperspaceDistance.

Referenced by isFrangible, maxHyperspaceDistance, and PlayerEntity::witchJumpChecklist:.

Here is the call graph for this function:

Here is the caller graph for this function:

maxShipSubEntities

- (NSUInteger) maxShipSubEntities

Definition at line 792 of file ShipEntity.m.

{
    return _maxShipSubIdx;
}

References _maxShipSubIdx, and maxShipSubEntities.

Referenced by PlayerEntity::canAddEquipment:inContext:, maxShipSubEntities, PlayerEntity(Contracts)::missingSubEntitiesAdjustment, serializeShipSubEntities, and subEntities.

Here is the call graph for this function:

Here is the caller graph for this function:

maxThrust

- (float) maxThrust

Definition at line 4119 of file ShipEntity.m.

{
    return max_thrust;
}

References max_thrust, and maxThrust.

Referenced by behaviour_tractored:, dumpItem:, isFrangible, maxThrust, releaseCargoPodsDebris, and ShipSetProperty().

Here is the call graph for this function:

Here is the caller graph for this function:

mesh

- (OOMesh *) mesh

Definition at line 1248 of file ShipEntity.m.

{
    return (OOMesh *)[self drawable];
}

References OOEntityWithDrawable::drawable, and mesh.

Referenced by accuracy, PlayerEntity::doBookkeeping:, findBoundingBoxRelativeToPosition:InVectors:_i:_j:, findSubentityBoundingBox, PlayerEntity::launchEscapeCapsule, mesh, setEntityPersonalityInt:, setMesh:, PlayerEntity::setUpTrumbles, and ShipSetMaterialsInternal().

Here is the call graph for this function:

Here is the caller graph for this function:

messageMother:

- (void) messageMother: (NSString *) msgString

implementation

Provided by category ShipEntity(PureAI).

Definition at line 1917 of file ShipEntityAI.m.

                      :(NSString *)msgString
{
    ShipEntity *mother = [self owner];
    if (mother != nil && mother != self)
    {
        NSString *context = nil;
#ifndef NDEBUG
        context = [NSString stringWithFormat:@"%@ messageMother", [self shortDescription]];
#endif
        [mother reactToAIMessage:msgString context:context];
    }
}

messageSelf:

- (void) messageSelf: (NSString *) msgString

implementation

Provided by category ShipEntity(PureAI).

Definition at line 1931 of file ShipEntityAI.m.

                    :(NSString *)msgString
{
    [self sendAIMessage:msgString];
}

messageTime

- (double) messageTime

References escortArray, escortCount, escortEnumerator, escortGroup, group, hasEscorts, maxEscortCount, name, pendingEscortCount, stationGroup, and turretCount.

Here is the call graph for this function:

missedShots

- (int) missedShots

Definition at line 12085 of file ShipEntity.m.

{
    if ([self isSubEntity])
    {
        return [[self owner] missedShots];
    }
    else
    {
        return _missed_shots;
    }
}

References _missed_shots, int(), Entity::isSubEntity, missedShots, and Entity::owner.

Referenced by coordinates, currentAimTolerance, missedShots, and trackPrimaryTarget:delta_t:.

Here is the call graph for this function:

Here is the caller graph for this function:

missileCapacity

- (NSUInteger) missileCapacity

Definition at line 3935 of file ShipEntity.m.

{
    return max_missiles;
}

References max_missiles, and missileCapacity.

Referenced by equipmentValidToAdd:whileLoading:inContext:, isFrangible, missileCapacity, PlayerEntity::mountMissileWithRole:, and OOShipLibraryWeapons().

Here is the call graph for this function:

Here is the caller graph for this function:

missileCount

- (NSUInteger) missileCount

Definition at line 3929 of file ShipEntity.m.

{
    return missiles;
}

References missileCount, and missiles.

Referenced by equipmentValidToAdd:whileLoading:inContext:, isFrangible, missileCount, PlayerEntity::mountMissileWithRole:, and PlayerEntity::setCommanderDataFromDictionary:.

Here is the call graph for this function:

Here is the caller graph for this function:

missileLaunchPosition

- (Vector) missileLaunchPosition

Definition at line 12146 of file ShipEntity.m.

{
    Vector start;
    // default launching position
    start.x = 0.0f;                     // in the middle
    start.y = boundingBox.min.y - 4.0f;  // 4m below bounding box
    start.z = boundingBox.max.z + 1.0f;  // 1m ahead of bounding box
    
    // custom launching position
    start = [shipinfoDictionary oo_vectorForKey:@"missile_launch_position" defaultValue:start];
    if (EXPECT_NOT(_scaleFactor != 1.0))
    {
        start = vector_multiply_scalar(start,_scaleFactor);
    }
    
    if (start.x == 0.0f && start.y == 0.0f && start.z <= 0.0f) // The kZeroVector as start is illegal also.
    {
        OOLog(@"ship.missileLaunch.invalidPosition", @"***** ERROR: The missile_launch_position defines a position %@ behind the %@. In future versions such missiles may explode on launch because they have to travel through the ship.", VectorDescription(start), self);
        start.x = 0.0f;
        start.y = boundingBox.min.y - 4.0f;
        start.z = boundingBox.max.z + 1.0f;
    }
    return start;
}

References _scaleFactor, Entity::boundingBox, EXPECT_NOT, missileLaunchPosition, and OOLog.

Referenced by coordinates, PlayerEntity::fireMissile, fireMissileWithIdentifier:andTarget:, and missileLaunchPosition.

Here is the call graph for this function:

Here is the caller graph for this function:

missileLoadTime

- (OOTimeDelta) missileLoadTime

Definition at line 12329 of file ShipEntity.m.

{
    return missile_load_time;
}

References missile_load_time, and missileLoadTime.

Referenced by coordinates, and missileLoadTime.

Here is the call graph for this function:

Here is the caller graph for this function:

missilesList

- (NSArray *) missilesList

Reimplemented in PlayerEntity.

Definition at line 3302 of file ShipEntity.m.

{
    // if missile_list is empty, avoid exception and return empty NSArray instead
    return missile_list[0] != nil ?  [NSArray arrayWithObjects:missile_list count:missiles] :
                                    [NSArray array];
}

References missile_list, missilesList, and nil.

Referenced by cargo, PlayerEntity::missilesList, missilesList, and ShipGetProperty().

Here is the call graph for this function:

Here is the caller graph for this function:

missileTrackPrimaryTarget:

- (double) missileTrackPrimaryTarget:

(double)

delta_t

Definition at line 10830 of file ShipEntity.m.

                                    :(double) delta_t
{
    Vector  relPos;
    GLfloat  d_forward, d_up, d_right;
    ShipEntity  *target = [self primaryTarget];
    BOOL    inPursuit = YES;
 
    if (!target || ![target isShip])   // leave now!
        return 0.0;
 
    double  damping = 0.5 * delta_t;
 
    stick_roll = 0.0; //desired roll and pitch
    stick_pitch = 0.0;
    stick_yaw = 0.0;
 
    relPos = [self vectorTo:target];
    
    // Adjust missile course by taking into account target's velocity and missile
    // accuracy. Modification on original code contributed by Cmdr James.
 
    float missileSpeed = (float)[self speed];
 
    // Avoid getting ourselves in a divide by zero situation by setting a missileSpeed
    // low threshold. Arbitrarily chosen 0.01, since it seems to work quite well.
    // Missile accuracy is already clamped within the 0.0 to 10.0 range at initialization,
    // but doing these calculations every frame when accuracy equals 0.0 just wastes cycles.
    if (missileSpeed > 0.01f && accuracy > 0.0f)
    {
        inPursuit = (dot_product([target forwardVector], v_forward) > 0.0f);
        if (inPursuit)
        {
            Vector leading = [target velocity]; 
            float lead = magnitude(relPos) / missileSpeed; 
            
            // Adjust where we are going to take into account target's velocity.
            // Use accuracy value to determine how well missile will track target.
            relPos.x += (lead * leading.x * (accuracy / 10.0f)); 
            relPos.y += (lead * leading.y * (accuracy / 10.0f)); 
            relPos.z += (lead * leading.z * (accuracy / 10.0f));
        }
    }
 
    if (!vector_equal(relPos, kZeroVector))  relPos = vector_normal(relPos);
    else  relPos.z = 1.0;
 
    d_right     =   dot_product(relPos, v_right);        // = cosine of angle between angle to target and v_right
    d_up        =   dot_product(relPos, v_up);      // = cosine of angle between angle to target and v_up
    d_forward   =   dot_product(relPos, v_forward);    // = cosine of angle between angle to target and v_forward
 
    // begin rule-of-thumb manoeuvres
 
    stick_roll = 0.0;
 
    if (pitching_over)
        pitching_over = (stick_pitch != 0.0);
 
    if ((d_forward < -pitch_tolerance) && (!pitching_over))
    {
        pitching_over = YES;
        if (d_up >= 0)
            stick_pitch = -max_flight_pitch;
        if (d_up < 0)
            stick_pitch = max_flight_pitch;
    }
 
    if (pitching_over)
    {
        pitching_over = (d_forward < 0.5);
    }
    else
    {
        stick_pitch = -max_flight_pitch * d_up;
        stick_roll = -max_flight_roll * d_right;
    }
 
    // end rule-of-thumb manoeuvres
 
    // apply damping
    if (flightRoll < 0)
        flightRoll += (flightRoll < -damping) ? damping : -flightRoll;
    if (flightRoll > 0)
        flightRoll -= (flightRoll > damping) ? damping : flightRoll;
    if (flightPitch < 0)
        flightPitch += (flightPitch < -damping) ? damping : -flightPitch;
    if (flightPitch > 0)
        flightPitch -= (flightPitch > damping) ? damping : flightPitch;
 
    
    [self applySticks:delta_t];
 
    //
    //  return target confidence 0.0 .. 1.0
    //
    if (d_forward < 0.0)
        return 0.0;
    return d_forward;
}

References accuracy, applySticks:, flightPitch, flightRoll, forwardVector, Entity::isShip, kZeroVector, max_flight_pitch, max_flight_roll, pitch_tolerance, pitching_over, primaryTarget, Entity::speed, stick_pitch, stick_roll, stick_yaw, v_forward, v_right, v_up, Entity::vectorTo:, and Entity::velocity.

Referenced by trackPrimaryTarget:delta_t:, and trackSideTarget:delta_t:.

Here is the call graph for this function:

Here is the caller graph for this function:

name

- (NSString *) name

References shipUniqueName.

nextBeacon

- (Entity< OOBeaconEntity > *) nextBeacon

implementation

Reimplemented from <OOBeaconEntity>.

Definition at line 1631 of file ShipEntity.m.

{
    return [_nextBeacon weakRefUnderlyingObject];
}

References nextBeacon, and OOWeakReference::weakRefUnderlyingObject.

Referenced by nextBeacon, setNextBeacon:, PlayerEntity::setNextCompassMode, PlayerEntity::setPrevCompassMode, and PlayerEntity::validateCompassTarget.

Here is the call graph for this function:

Here is the caller graph for this function:

noteFrustration:

- (void) noteFrustration: (NSString *) context

implementation

Provided by category ShipEntity(Private).

Definition at line 2953 of file ShipEntity.m.

                       :(NSString *)context
{
    [shipAI reactToMessage:@"FRUSTRATED" context:context];
    [self doScriptEvent:OOJSID("shipAIFrustrated") withArgument:context];
}

References doScriptEvent:withArgument:.

Referenced by behaviour_attack_broadside_target:leftside:, behaviour_attack_fly_to_target:, behaviour_attack_sniper:, behaviour_face_destination:, behaviour_flee_target:, behaviour_fly_thru_navpoints:, behaviour_fly_to_destination:, behaviour_formation_form_up:, and behaviour_intercept_target:.

Here is the call graph for this function:

Here is the caller graph for this function:

noteKilledBy:damageType:

- (void) noteKilledBy:		(Entity *)	whom
damageType:		(OOShipDamageType)	type

Definition at line 9010 of file ShipEntity.m.

                     :(Entity *)whom damageType:(OOShipDamageType)type
{
    if ([self status] == STATUS_DEAD)  return;
    
    [PLAYER setScriptTarget:self];
    
    JSContext *context = OOJSAcquireContext();
    
    jsval whomVal = OOJSValueFromNativeObject(context, whom);
    jsval typeVal = OOJSValueFromShipDamageType(context, type);
    OOEntityStatus originalStatus = [self status];
    [self setStatus:STATUS_DEAD];
    
    ShipScriptEvent(context, self, "shipDied", whomVal, typeVal);
    if ([whom isShip])
    {
        jsval selfVal = OOJSValueFromNativeObject(context, self);
        ShipScriptEvent(context, (ShipEntity *)whom, "shipKilledOther", selfVal, typeVal);
    }
    
    [self setStatus:originalStatus];
    OOJSRelinquishContext(context);
}

References Entity::isShip, OOJSAcquireContext(), OOJSRelinquishContext(), OOJSValueFromNativeObject(), OOJSValueFromShipDamageType(), setStatus:, ShipScriptEvent, and Entity::status.

Referenced by becomeEnergyBlast, PlayerEntity::getDestroyedBy:damageType:, and getDestroyedBy:damageType:.

Here is the call graph for this function:

Here is the caller graph for this function:

noteLostTarget

- (void) noteLostTarget

Definition at line 10192 of file ShipEntity.m.

{
    id target = nil;
    if ([self primaryTarget] != nil)
    {
        ShipEntity* ship = [self primaryTarget];
        if ([self isDefenseTarget:ship]) 
        {
            [self removeDefenseTarget:ship];
        }
        // for compatibility with 1.76 behaviour of this function, only pass
        // the target as a function parameter if the target is still a potential
        // valid target (e.g. not scooped, docked, hyperspaced, etc.)
        target = (ship && ship->isShip && [self isValidTarget:ship]) ? (id)ship : nil;
        if ([self primaryAggressor] == ship) 
        {
            DESTROY(_primaryAggressor);
        }
        DESTROY(_primaryTarget);
    }
    // always do target lost
    [self doScriptEvent:OOJSID("shipTargetLost") withArgument:target];
    if (target == nil) [shipAI message:@"TARGET_LOST"];  // stale target? no major urgency.
    else [shipAI reactToMessage:@"TARGET_LOST" context:@"flight updates"];  // execute immediately otherwise.
}

References _primaryAggressor, _primaryTarget, DESTROY, doScriptEvent:withArgument:, Entity::isShip, isValidTarget:, AI::message:, nil, noteLostTarget, primaryAggressor, primaryTarget, AI::reactToMessage:context:, and removeDefenseTarget:.

Referenced by getTractoredBy:, PlayerEntity(OOControlsPrivate)::handleButtonIdent, PlayerEntity(OOControlsPrivate)::handleButtonTargetMissile, StationEntity::launchDefenseShip, StationEntity::launchPirateShip, StationEntity::launchPolice, PlayerEntity::loseTargetStatus, ShipEntity(PureAI)::markTargetForFines, ShipEntity(PureAI)::markTargetForOffence:, maxFlightSpeed, noteLostTarget, noteLostTargetAndGoIdle, PlayerEntity(OOControlsPrivate)::pollFlightControls:, removeTarget:, scoopUpProcess:processEvents:processMessages:, PlayerEntity::selectNextMissile, ShipEntity(PureAI)::sendTargetCommsMessage:, update:, PlayerEntity(OOPrivate)::updateTargeting, and PlayerEntity(OOPrivate)::witchStart.

Here is the call graph for this function:

Here is the caller graph for this function:

noteLostTargetAndGoIdle

- (void) noteLostTargetAndGoIdle

Definition at line 10219 of file ShipEntity.m.

{
    behaviour = BEHAVIOUR_IDLE;
    frustration = 0.0;
    [self noteLostTarget];
}

References behaviour, frustration, noteLostTarget, and noteLostTargetAndGoIdle.

Referenced by behaviour_attack_break_off_target:, behaviour_attack_broadside:, behaviour_attack_broadside_target:leftside:, behaviour_attack_fly_from_target:, behaviour_attack_fly_to_target:, behaviour_attack_mining_target:, behaviour_attack_slow_dogfight:, behaviour_attack_sniper:, behaviour_close_to_broadside_range:, behaviour_close_with_target:, behaviour_flee_target:, behaviour_fly_to_target_six:, behaviour_intercept_target:, behaviour_running_defense:, behaviour_track_target:, evasiveAction:, maxFlightSpeed, noteLostTargetAndGoIdle, ShipEntity(AI)::performMining, trackPrimaryTarget:delta_t:, and trackSideTarget:delta_t:.

Here is the call graph for this function:

Here is the caller graph for this function:

noteTakingDamage:from:type:

- (void) noteTakingDamage:		(double)	amount
from:		(Entity *)	entity
type:		(OOShipDamageType)	type

Reimplemented in DockEntity.

Definition at line 8975 of file ShipEntity.m.

                         :(double)amount from:(Entity *)entity type:(OOShipDamageType)type
{
    if (amount < 0 || (amount == 0 && [[UNIVERSE gameController] isGamePaused]))  return;
    
    JSContext *context = OOJSAcquireContext();
    
    jsval amountVal = JSVAL_VOID;
    JS_NewNumberValue(context, amount, &amountVal);
    jsval entityVal = OOJSValueFromNativeObject(context, entity);
    jsval typeVal = OOJSValueFromShipDamageType(context, type);
    
    ShipScriptEvent(context, self, "shipTakingDamage", amountVal, entityVal, typeVal);
    OOJSRelinquishContext(context);
    
    if ([entity isShip]) {
//      ShipEntity* attacker = (ShipEntity *)entity;
        if ([self hasHostileTarget] && accuracy >= COMBAT_AI_IS_SMART && (randf()*10.0 < accuracy || desired_speed < 0.5 * maxFlightSpeed) && behaviour != BEHAVIOUR_EVASIVE_ACTION && behaviour != BEHAVIOUR_FLEE_EVASIVE_ACTION && behaviour != BEHAVIOUR_SCRIPTED_ATTACK_AI)
        {
            if (behaviour == BEHAVIOUR_FLEE_TARGET)
            {
// jink should be sufficient to avoid being hit most of the time
// if not, this will make a sharp turn and then select a new jink position
                behaviour = BEHAVIOUR_FLEE_EVASIVE_ACTION;
            }
            else
            {
                behaviour = BEHAVIOUR_EVASIVE_ACTION;
            }
            frustration = 0.0;
        }
    }
 
}

References accuracy, behaviour, COMBAT_AI_IS_SMART, desired_speed, frustration, hasHostileTarget, Entity::isShip, maxFlightSpeed, OOJSAcquireContext(), OOJSRelinquishContext(), OOJSValueFromNativeObject(), OOJSValueFromShipDamageType(), randf(), ShipScriptEvent, and UNIVERSE.

Referenced by DockEntity::noteTakingDamage:from:type:, PlayerEntity::takeEnergyDamage:from:becauseOf:weaponIdentifier:, takeEnergyDamage:from:becauseOf:weaponIdentifier:, takeHeatDamage:, and takeScrapeDamage:from:.

Here is the call graph for this function:

Here is the caller graph for this function:

noteTargetDestroyed:

- (void) noteTargetDestroyed:

(ShipEntity *)

target

Definition at line 10226 of file ShipEntity.m.

                            :(ShipEntity *)target
{
    [self collectBountyFor:(ShipEntity *)target];
    if ([self primaryTarget] == target)
    {
        [self removeTarget:target];
        [self doScriptEvent:OOJSID("shipTargetDestroyed") withArgument:target];
        [shipAI message:@"TARGET_DESTROYED"];
    }
    if ([self isDefenseTarget:target]) 
    {
        [self removeDefenseTarget:target];
        [shipAI message:@"DEFENSE_TARGET_DESTROYED"];
        [self doScriptEvent:OOJSID("defenseTargetDestroyed") withArgument:target];
    }
}

References collectBountyFor:, doScriptEvent:withArgument:, AI::message:, primaryTarget, removeDefenseTarget:, and removeTarget:.

Referenced by PlayerEntity::takeEnergyDamage:from:becauseOf:weaponIdentifier:, takeEnergyDamage:from:becauseOf:weaponIdentifier:, and takeScrapeDamage:from:.

Here is the call graph for this function:

Here is the caller graph for this function:

noticeECM

- (void) noticeECM

Reimplemented in PlayerEntity.

Definition at line 12342 of file ShipEntity.m.

{
    if (accuracy >= COMBAT_AI_ISNT_AWFUL && missiles > 0 && [[missile_list[0] identifier] isEqualTo:@"EQ_MISSILE"])
    {
// if we're being ECMd, and our missiles appear to be standard, and we
// have some combat sense, wait a bit before firing the next one!
        missile_launch_time = [UNIVERSE getTime] + fmax(2.0,missile_load_time); // set minimum launchtime for the next missile.
    }
}

References accuracy, COMBAT_AI_ISNT_AWFUL, missile_launch_time, missile_list, missile_load_time, missiles, and noticeECM.

Referenced by coordinates, noticeECM, and OOECMBlastEntity::update:.

Here is the call graph for this function:

Here is the caller graph for this function:

numberOfScannedShips

- (int) numberOfScannedShips

Definition at line 9912 of file ShipEntity.m.

{
    return n_scanned_ships;
}

References int(), n_scanned_ships, and numberOfScannedShips.

Referenced by maxFlightSpeed, and numberOfScannedShips.

Here is the call graph for this function:

Here is the caller graph for this function:

octree

- (Octree *) octree

References volume.

Here is the call graph for this function:

onTarget:withWeapon:

- (BOOL) onTarget:		(OOWeaponFacing)	direction
withWeapon:		(OOWeaponType)	weapon

Definition at line 11389 of file ShipEntity.m.

                 :(OOWeaponFacing)direction withWeapon:(OOWeaponType)weapon_type
{
    // initialize dq to a value that would normally return NO; dq is handled inside the defaultless switch(direction) statement
    // and should alaways be recalculated anyway. Initialization here needed to silence compiler warning - Nikos 20120526
    GLfloat dq = -1.0f;
    GLfloat d2, radius, astq;
    Vector rel_pos, urp;
    if ([weapon_type isTurretLaser])
    {
        return YES;
    }
    
    Entity  *target = [self primaryTarget];
    if (target == nil)  return NO;
    if ([target status] == STATUS_DEAD)  return NO;
    
    if (isSunlit && (target->isSunlit == NO) && (randf() < 0.75))
    {
        return NO;  // 3/4 of the time you can't see from a lit place into a darker place
    }
    radius = target->collision_radius;
    rel_pos = HPVectorToVector(HPvector_subtract([self calculateTargetPosition], position));
    d2 = magnitude2(rel_pos);
    urp = vector_normal_or_zbasis(rel_pos);
    
    switch (direction)
    {
        case WEAPON_FACING_FORWARD:
            dq = +dot_product(urp, v_forward);     // cosine of angle between v_forward and unit relative position
            break;
            
        case WEAPON_FACING_AFT:
            dq = -dot_product(urp, v_forward);     // cosine of angle between v_forward and unit relative position
            break;
            
        case WEAPON_FACING_PORT:
            dq = -dot_product(urp, v_right);     // cosine of angle between v_right and unit relative position
            break;
            
        case WEAPON_FACING_STARBOARD:
            dq = +dot_product(urp, v_right);     // cosine of angle between v_right and unit relative position
            break;
            
        case WEAPON_FACING_NONE:
            break;
    }
 
    if (dq < 0.0)  return NO;
    
    GLfloat aim = [self currentAimTolerance];
    if (dq > aim*aim) return YES;
 
    // cosine of 1/3 of half angle subtended by target (mostly they'll
    // fire sooner anyway due to currentAimTolerance, but this should
    // almost always be a solid hit)
    astq = sqrt(1.0 - radius * radius / (d2 * 9));  
 
    return (fabs(dq) >= astq);
}

References calculateTargetPosition, Entity::collision_radius, currentAimTolerance, Entity::isSunlit, nil, Entity::position, primaryTarget, randf(), Entity::status, v_forward, v_right, WEAPON_FACING_AFT, WEAPON_FACING_FORWARD, WEAPON_FACING_NONE, WEAPON_FACING_PORT, and WEAPON_FACING_STARBOARD.

Here is the call graph for this function:

oo_jsClassName

- (NSString *) oo_jsClassName

implementation

Reimplemented from Entity.

Reimplemented in DockEntity, PlayerEntity, and StationEntity.

Provided by category ShipEntity(OOJavaScriptExtensions).

Definition at line 128 of file EntityOOJavaScriptExtensions.m.

{
    return @"Ship";
}

orientationChanged

- (void) orientationChanged

implementation

Reimplemented from Entity.

Reimplemented in PlayerEntity.

Definition at line 6787 of file ShipEntity.m.

{
    [super orientationChanged];
    
    v_forward   = vector_forward_from_quaternion(orientation);
    v_up        = vector_up_from_quaternion(orientation);
    v_right      = vector_right_from_quaternion(orientation);
}

References Entity::orientation, Entity::orientationChanged, orientationChanged, v_forward, v_right, v_up, vector_forward_from_quaternion(), vector_right_from_quaternion(), and vector_up_from_quaternion().

Referenced by applyRoll:andClimb:, applyRoll:climb:andYaw:, ballTrackLeadingTarget:atTarget:, orientationChanged, and trackOntoTarget:withDForward:.

Here is the call graph for this function:

Here is the caller graph for this function:

overrideScriptInfo:

- (void) overrideScriptInfo:

(NSDictionary *)

override

Definition at line 14588 of file ShipEntity.m.

                           :(NSDictionary *)override
{
    if (scriptInfo == nil)  scriptInfo = [override retain];
    else if (override != nil)
    {
        NSMutableDictionary *newInfo = [NSMutableDictionary dictionaryWithDictionary:scriptInfo];
        [newInfo addEntriesFromDictionary:override];
        [scriptInfo release];
        scriptInfo = [newInfo copy];
    }
}

References nil, and scriptInfo.

Referenced by setUpOneStandardSubentity:asTurret:.

Here is the caller graph for this function:

parcelCount

- (NSUInteger) parcelCount

Reimplemented in PlayerEntity.

Definition at line 3911 of file ShipEntity.m.

{
    return 0;
}

References parcelCount.

Referenced by isFrangible, and parcelCount.

Here is the call graph for this function:

Here is the caller graph for this function:

parcelListForScripting

- (NSArray *) parcelListForScripting

Reimplemented in PlayerEntity.

Definition at line 3316 of file ShipEntity.m.

{
    return [NSArray array];
}

References parcelListForScripting.

Referenced by cargo, parcelListForScripting, and ShipGetProperty().

Here is the call graph for this function:

Here is the caller graph for this function:

passengerCapacity

- (NSUInteger) passengerCapacity

Reimplemented in PlayerEntity.

Definition at line 3923 of file ShipEntity.m.

{
    return 0;
}

References passengerCapacity.

Referenced by equipmentListForScripting, equipmentValidToAdd:whileLoading:inContext:, isFrangible, passengerCapacity, and ShipRemoveEquipment().

Here is the call graph for this function:

Here is the caller graph for this function:

passengerCount

- (NSUInteger) passengerCount

Reimplemented in PlayerEntity.

Definition at line 3917 of file ShipEntity.m.

{
    return 0;
}

References passengerCount.

Referenced by equipmentValidToAdd:whileLoading:inContext:, isFrangible, and passengerCount.

Here is the call graph for this function:

Here is the caller graph for this function:

passengerListForScripting

- (NSArray *) passengerListForScripting

Reimplemented in PlayerEntity.

Definition at line 3310 of file ShipEntity.m.

{
    return [NSArray array];
}

References passengerListForScripting.

Referenced by cargo, passengerListForScripting, and ShipGetProperty().

Here is the call graph for this function:

Here is the caller graph for this function:

patrolReportIn

- (void) patrolReportIn

implementation

Provided by category ShipEntity(PureAI).

Definition at line 2057 of file ShipEntityAI.m.

{
    // Set a report time in the patrolled station to delay a new launch.
    ShipEntity *the_station = [[self group] leader];
    if(!the_station || ![the_station isStation]) the_station = [UNIVERSE station];
    [(StationEntity*)the_station acceptPatrolReportFrom:self];
}

pauseAI:

- (void) pauseAI: (NSString *) intervalString

implementation

Provided by category ShipEntity(PureAI).

Definition at line 851 of file ShipEntityAI.m.

                :(NSString *)intervalString
{
    [shipAI setNextThinkTime:[UNIVERSE getTime] + [intervalString doubleValue]];
}

pendingEscortCount

- (uint8_t) pendingEscortCount

Definition at line 7004 of file ShipEntity.m.

{
    return _pendingEscortCount;
}

References _pendingEscortCount, and pendingEscortCount.

Referenced by Universe::addShipAt:withRole:withinRadius:, StationEntity::launchIndependentShip:, DockEntity::launchShip:, messageTime, pendingEscortCount, PlayerEntity::showShipModelWithKey:shipData:personality:factorX:factorY:factorZ:inContext:, and Universe::witchspaceShipWithPrimaryRole:.

Here is the call graph for this function:

Here is the caller graph for this function:

performAttack

- (void) performAttack

Provided by category ShipEntity(AI).

Definition at line 378 of file ShipEntityAI.m.

{
    if (behaviour != BEHAVIOUR_EVASIVE_ACTION)
    {
        behaviour = BEHAVIOUR_ATTACK_TARGET;
        desired_range = 1250 * randf() + 750; // 750 til 2000
        frustration = 0.0;   
    }
}

performBuoyTumble

- (void) performBuoyTumble

implementation

Provided by category ShipEntity(AI).

Definition at line 510 of file ShipEntityAI.m.

{
    stick_roll = 0.10;
    stick_pitch = 0.15;
    behaviour = BEHAVIOUR_TUMBLE;
    frustration = 0.0;
}

performCollect

- (void) performCollect

Provided by category ShipEntity(AI).

Definition at line 389 of file ShipEntityAI.m.

{
    behaviour = BEHAVIOUR_COLLECT_TARGET;
    frustration = 0.0;
}

performEscort

- (void) performEscort

Provided by category ShipEntity(AI).

Definition at line 396 of file ShipEntityAI.m.

{
    if(behaviour != BEHAVIOUR_FORMATION_FORM_UP) 
    {
        behaviour = BEHAVIOUR_FORMATION_FORM_UP;
        frustration = 0.0; // behavior changed, reset frustration.
    }
}

performFaceDestination

- (void) performFaceDestination

Provided by category ShipEntity(AI).

Definition at line 406 of file ShipEntityAI.m.

{
    behaviour = BEHAVIOUR_FACE_DESTINATION;
    frustration = 0.0;
}

performFlee

- (void) performFlee

Provided by category ShipEntity(AI).

Definition at line 413 of file ShipEntityAI.m.

{
    if (behaviour != BEHAVIOUR_FLEE_EVASIVE_ACTION)
    {
        behaviour = BEHAVIOUR_FLEE_TARGET;
        [self setEvasiveJink:400.0];
        frustration = 0.0;
        if (accuracy > COMBAT_AI_ISNT_AWFUL)
        {
            // alert! they've got us in their sights! react!!
            if ([self approachAspectToPrimaryTarget] > 0.9995)
            {
                behaviour = randf() < 0.15 ? BEHAVIOUR_EVASIVE_ACTION : BEHAVIOUR_FLEE_EVASIVE_ACTION;
            }
        }
    }
}

Referenced by ShipEntity(AI)::broadcastDistressMessageWithDumping:, and ShipEntity(PureAI)::fightOrFleeMissile.

Here is the caller graph for this function:

performFlyRacepoints

- (void) performFlyRacepoints

implementation

Provided by category ShipEntity(PureAI).

Definition at line 2732 of file ShipEntityAI.m.

{
    next_navpoint_index = 0;
    desired_range = collision_radius;
    behaviour = BEHAVIOUR_FLY_THRU_NAVPOINTS;
}

performFlyToRangeFromDestination

- (void) performFlyToRangeFromDestination

Provided by category ShipEntity(AI).

Definition at line 432 of file ShipEntityAI.m.

{
    behaviour = BEHAVIOUR_FLY_RANGE_FROM_DESTINATION;
    frustration = 0.0;
}

performHold

- (void) performHold

Provided by category ShipEntity(AI).

Definition at line 439 of file ShipEntityAI.m.

{
    desired_speed = 0.0;
    behaviour = BEHAVIOUR_TRACK_TARGET;
    frustration = 0.0;
}

performHyperSpaceExit

- (void) performHyperSpaceExit

implementation

Provided by category ShipEntity(PureAI).

Definition at line 1629 of file ShipEntityAI.m.

{
    [self performHyperSpaceExitReplace:YES];
}

performHyperSpaceExitReplace:

- (BOOL) performHyperSpaceExitReplace: (BOOL) replace

implementation

Provided by category ShipEntity(OOAIPrivate).

Definition at line 2758 of file ShipEntityAI.m.

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

Referenced by ShipEntity(PureAI)::performHyperSpaceExit, and ShipEntity(PureAI)::performHyperSpaceExitWithoutReplacing.

Here is the caller graph for this function:

performHyperSpaceExitReplace:toSystem:

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

implementation

Provided by category ShipEntity(OOAIPrivate).

Definition at line 2764 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;
}

Referenced by ShipEntity(OOAIPrivate)::performHyperSpaceExitReplace:, and ShipEntity(AI)::performHyperSpaceToSpecificSystem:.

Here is the caller graph for this function:

performHyperSpaceExitWithoutReplacing

- (void) performHyperSpaceExitWithoutReplacing

implementation

Provided by category ShipEntity(PureAI).

Definition at line 1635 of file ShipEntityAI.m.

{
    [self performHyperSpaceExitReplace:NO];
}

performHyperSpaceToSpecificSystem:

- (BOOL) performHyperSpaceToSpecificSystem:

(OOSystemID)

systemID

Provided by category ShipEntity(AI).

Definition at line 536 of file ShipEntityAI.m.

                                          :(OOSystemID)systemID
{
    return [self performHyperSpaceExitReplace:NO toSystem:systemID];
}

Referenced by ShipExitSystem().

Here is the caller graph for this function:

performIdle

- (void) performIdle

Provided by category ShipEntity(AI).

Definition at line 447 of file ShipEntityAI.m.

{
    behaviour = BEHAVIOUR_IDLE;
    frustration = 0.0;
}

performIntercept

- (void) performIntercept

Provided by category ShipEntity(AI).

Definition at line 454 of file ShipEntityAI.m.

{
    behaviour = BEHAVIOUR_INTERCEPT_TARGET;
    frustration = 0.0;
}

performLandOnPlanet

- (void) performLandOnPlanet

Provided by category ShipEntity(AI).

Definition at line 461 of file ShipEntityAI.m.

{
    OOPlanetEntity  *nearest = [self findNearestPlanet];
    if (isNearPlanetSurface)
    {
        _destination = [nearest position];
        behaviour = BEHAVIOUR_LAND_ON_PLANET;
        planetForLanding = [nearest universalID];
    }
    else
    {
        behaviour = BEHAVIOUR_IDLE;
        [shipAI message:@"NO_PLANET_NEARBY"];
    }
    
    frustration = 0.0;
}

performMining

- (void) performMining

Provided by category ShipEntity(AI).

Definition at line 480 of file ShipEntityAI.m.

{
    Entity *target = [self primaryTarget];
    // mining is not seen as hostile behaviour, so ensure it is only used against rocks.
    if (target &&  [target scanClass] == CLASS_ROCK)
    {
        behaviour = BEHAVIOUR_ATTACK_MINING_TARGET;
        frustration = 0.0;
    }
    else
    {   
        [self noteLostTargetAndGoIdle];
    }
}

performScriptedAI

- (void) performScriptedAI

Provided by category ShipEntity(AI).

Definition at line 496 of file ShipEntityAI.m.

{
    behaviour = BEHAVIOUR_SCRIPTED_AI;
    frustration = 0.0;
}

performScriptedAttackAI

- (void) performScriptedAttackAI

Provided by category ShipEntity(AI).

Definition at line 503 of file ShipEntityAI.m.

{
    behaviour = BEHAVIOUR_SCRIPTED_ATTACK_AI;
    frustration = 0.0;
}

performStop

- (void) performStop

Provided by category ShipEntity(AI).

Definition at line 519 of file ShipEntityAI.m.

{
    behaviour = BEHAVIOUR_STOP_STILL;
    desired_speed = 0.0;
    frustration = 0.0;
}

performTumble

- (void) performTumble

Provided by category ShipEntity(AI).

Definition at line 527 of file ShipEntityAI.m.

{
    stick_roll = max_flight_roll*2.0*(randf() - 0.5);
    stick_pitch = max_flight_pitch*2.0*(randf() - 0.5);
    behaviour = BEHAVIOUR_TUMBLE;
    frustration = 0.0;
}

Referenced by Universe::addWreckageFrom:withRole:at:scale:lifetime:, and behaviour_tractored:.

Here is the caller graph for this function:

portWeaponOffset

- (NSArray *) portWeaponOffset

References starboardWeaponOffset.

positionOffsetForAlignment:

- (Vector) positionOffsetForAlignment:

(NSString*)

align

Definition at line 9546 of file ShipEntity.m.

                                     :(NSString*) align
{
    NSString* padAlign = [NSString stringWithFormat:@"%@---", align];
    Vector result = kZeroVector;
    switch ([padAlign characterAtIndex:0])
    {
        case (unichar)'c':
        case (unichar)'C':
            result.x = 0.5 * (boundingBox.min.x + boundingBox.max.x);
            break;
        case (unichar)'M':
            result.x = boundingBox.max.x;
            break;
        case (unichar)'m':
            result.x = boundingBox.min.x;
            break;
    }
    switch ([padAlign characterAtIndex:1])
    {
        case (unichar)'c':
        case (unichar)'C':
            result.y = 0.5 * (boundingBox.min.y + boundingBox.max.y);
            break;
        case (unichar)'M':
            result.y = boundingBox.max.y;
            break;
        case (unichar)'m':
            result.y = boundingBox.min.y;
            break;
    }
    switch ([padAlign characterAtIndex:2])
    {
        case (unichar)'c':
        case (unichar)'C':
            result.z = 0.5 * (boundingBox.min.z + boundingBox.max.z);
            break;
        case (unichar)'M':
            result.z = boundingBox.max.z;
            break;
        case (unichar)'m':
            result.z = boundingBox.min.z;
            break;
    }
    return result;
}

References Entity::boundingBox, and kZeroVector.

positionOffsetForShipInRotationToAlignment

- (Vector) positionOffsetForShipInRotationToAlignment		(ShipEntity *)	ship
		(Quaternion)	q
		(NSString *)	align

Definition at line 9593 of file ShipEntity.m.

{
    NSString* padAlign = [NSString stringWithFormat:@"%@---", align];
    Vector i = vector_right_from_quaternion(q);
    Vector j = vector_up_from_quaternion(q);
    Vector k = vector_forward_from_quaternion(q);
    BoundingBox arbb = [ship findBoundingBoxRelativeToPosition:kZeroHPVector InVectors:i :j :k];
    Vector result = kZeroVector;
    switch ([padAlign characterAtIndex:0])
    {
        case (unichar)'c':
        case (unichar)'C':
            result.x = 0.5 * (arbb.min.x + arbb.max.x);
            break;
        case (unichar)'M':
            result.x = arbb.max.x;
            break;
        case (unichar)'m':
            result.x = arbb.min.x;
            break;
    }
    switch ([padAlign characterAtIndex:1])
    {
        case (unichar)'c':
        case (unichar)'C':
            result.y = 0.5 * (arbb.min.y + arbb.max.y);
            break;
        case (unichar)'M':
            result.y = arbb.max.y;
            break;
        case (unichar)'m':
            result.y = arbb.min.y;
            break;
    }
    switch ([padAlign characterAtIndex:2])
    {
        case (unichar)'c':
        case (unichar)'C':
            result.z = 0.5 * (arbb.min.z + arbb.max.z);
            break;
        case (unichar)'M':
            result.z = arbb.max.z;
            break;
        case (unichar)'m':
            result.z = arbb.min.z;
            break;
    }
    return result;
}

References findBoundingBoxRelativeToPosition:InVectors:i:j:, kZeroVector, positionOffsetForShipInRotationToAlignment, vector_forward_from_quaternion(), vector_right_from_quaternion(), and vector_up_from_quaternion().

Referenced by maxFlightSpeed, and positionOffsetForShipInRotationToAlignment.

Here is the call graph for this function:

Here is the caller graph for this function:

prevBeacon

- (Entity< OOBeaconEntity > *) prevBeacon

implementation

Reimplemented from <OOBeaconEntity>.

Definition at line 1625 of file ShipEntity.m.

{
    return [_prevBeacon weakRefUnderlyingObject];
}

References prevBeacon, and OOWeakReference::weakRefUnderlyingObject.

Referenced by prevBeacon, and setPrevBeacon:.

Here is the call graph for this function:

Here is the caller graph for this function:

primaryAggressor

- (Entity *) primaryAggressor

Definition at line 9937 of file ShipEntity.m.

{
    Entity *result = [_primaryAggressor weakRefUnderlyingObject];
    if (result == nil || ![self isValidTarget:result])
    {
        DESTROY(_primaryAggressor);
        return nil;
    }
    return result;
}

References _primaryAggressor, DESTROY, nil, primaryAggressor, and OOWeakReference::weakRefUnderlyingObject.

Referenced by ShipEntity(PureAI)::addPrimaryAggressorAsDefenseTarget, PlayerEntity::addRoleForAggression:, becomeExplosion, PlayerEntity::interpretAIMessage:, interpretAIMessage:, maxFlightSpeed, noteLostTarget, primaryAggressor, ShipEntity(PureAI)::setTargetToPrimaryAggressor, and ShipGetProperty().

Here is the call graph for this function:

Here is the caller graph for this function:

primaryRole

- (NSString *) primaryRole

References isMissile, isPirate, isPolice, isThargoid, and isTrader.

Here is the call graph for this function:

primaryTarget

- (id) primaryTarget

Definition at line 10121 of file ShipEntity.m.

{
    id result = [_primaryTarget weakRefUnderlyingObject];
    if ((result == nil && _primaryTarget != nil)
            || ![self isValidTarget:result])
    {
        DESTROY(_primaryTarget);
        return nil;
    }
    else if (EXPECT_NOT(result == self))
    {
        /*  Added in response to a crash report showing recursion in
            [PlayerEntity hasHostileTarget].
            -- Ahruman 2009-12-17
        */
        DESTROY(_primaryTarget);
    }
    return result;
}

References _primaryTarget, DESTROY, EXPECT_NOT, nil, primaryTarget, and OOWeakReference::weakRefUnderlyingObject.

Referenced by ShipEntity(OOAIPrivate)::acceptDistressMessageFrom:, StationEntity(OOAIPrivate)::acceptDistressMessageFrom:, approachAspectToPrimaryTarget, avoidCollision, behaviour_attack_break_off_target:, behaviour_attack_broadside_target:leftside:, behaviour_attack_fly_from_target:, behaviour_attack_fly_to_target:, behaviour_attack_slow_dogfight:, behaviour_attack_sniper:, behaviour_attack_target:, behaviour_close_to_broadside_range:, behaviour_close_with_target:, behaviour_evasive_action:, behaviour_flee_target:, behaviour_fly_to_target_six:, behaviour_intercept_target:, behaviour_track_as_turret:, behaviour_track_target:, calculateTargetPosition, ShipEntity(PureAI)::checkGroupOddsVersusTarget, ShipEntity(PureAI)::checkTargetLegalStatus, deployEscorts, PlayerEntity::dialTargetName, PlayerEntity::doBookkeeping:, dockEscorts, ShipEntity(Private)::drawDebugStuff, HeadUpDisplay(Private)::drawScanner:, HeadUpDisplay(Private)::drawSecondaryTargetReticle:, dumpSelfState, ShipEntity(AI)::enterTargetWormhole, evasiveAction:, ShipEntity(PureAI)::fightOrFleeMissile, fireDirectLaserShot:, fireLaserShotInDirection:weaponIdentifier:, PlayerEntity::fireMissile, fireMissile, fireSubentityLaserShot:, Universe::forceWitchspaceEntries, getTractoredBy:, ShipEntity(AI)::groupAttackTarget, PlayerEntity(OOControlsPrivate)::handleAutopilotOn:, PlayerEntity(OOControlsPrivate)::handleButtonTargetMissile, PlayerEntity::hasHostileTarget, hasHostileTarget, StationEntity::hasHostileTarget, hasProximityAlertIgnoringTarget:, HeadUpDisplay::hudDrawReticleOnTarget, OOShipDebugInspectorModule::inspectTarget:, ShipEntity(OOEntityInspectorExtensions)::inspTargetLine, interpretAIMessage:, IsHostileAgainstTargetPredicate(), isHostileTo:, StationEntity::launchDefenseShip, StationEntity::launchPirateShip, StationEntity::launchPolice, PlayerEntity::localMarket, PlayerEntity::loseTargetStatus, PlayerEntity::marketScreenTitle, ShipEntity(PureAI)::markTargetForFines, ShipEntity(PureAI)::markTargetForOffence:, maxFlightSpeed, missileTrackPrimaryTarget:, noteLostTarget, noteTargetDestroyed:, onTarget:withWeapon:, ShipEntity(AI)::performMining, PlayerEntity(OOControlsPrivate)::pollFlightControls:, primaryTarget, PlayerEntity::printIdentLockedOnForMissile:, rangeToPrimaryTarget, ShipEntity(AI)::recallDockingInstructions, PlayerEntity::safeAllMissiles, ShipEntity(PureAI)::safeScriptActionOnTarget:, ShipEntity(PureAI)::scriptActionOnTarget:, PlayerEntity::selectNextMissile, ShipEntity(PureAI)::sendTargetCommsMessage:, ShipEntity(PureAI)::setDestinationToTarget, ShipEntity(PureAI)::setDestinationWithinTarget, PlayerEntity::setDockingClearanceStatus:, PlayerEntity::setGuiToMarketScreen, PlayerEntity::setNextCompassMode, PlayerEntity::setPrevCompassMode, ShipEntity(PureAI)::setRacepointsFromTarget, ShipEntity(OOJavaScriptExtensions)::setTargetForScript:, ShipEntity(PureAI)::setTargetToPrimaryAggressor, ShipFireMissile(), ShipGetProperty(), ShipEntity(ScriptMethods)::spawnShipsWithRole:count:, startTrackingCurve, ShipEntity(PureAI)::storeTarget, ShipEntity(PureAI)::suggestEscort, ShipEntity(PureAI)::targetNextBeaconWithCode:, trackOntoTarget:withDForward:, trackPrimaryTarget:delta_t:, trackSideTarget:delta_t:, update:, PlayerEntity(OOPrivate)::updateAlertConditionForNearbyEntities, PlayerEntity(OOPrivate)::updateTargeting, updateTrackingCurve, PlayerEntity::validateCompassTarget, OODebugController::validateMenuItem:, ShipEntity(AI)::wormholeEscorts, and ShipEntity(PureAI)::wormholeGroup.

Here is the call graph for this function:

primaryTargetWithoutValidityCheck

- (id) primaryTargetWithoutValidityCheck

Definition at line 10144 of file ShipEntity.m.

{
    id result = [_primaryTarget weakRefUnderlyingObject];
    if (EXPECT_NOT(result == self))
    {
        // just in case
        DESTROY(_primaryTarget);
        return nil;
    }
    return result;
}

References _primaryTarget, DESTROY, EXPECT_NOT, nil, primaryTargetWithoutValidityCheck, and OOWeakReference::weakRefUnderlyingObject.

Referenced by canStillTrackPrimaryTarget, maxFlightSpeed, primaryTargetWithoutValidityCheck, realAlertCondition, and scoopUpProcess:processEvents:processMessages:.

Here is the call graph for this function:

Here is the caller graph for this function:

processBehaviour:

- (void) processBehaviour:

(OOTimeDelta)

delta_t

Definition at line 2793 of file ShipEntity.m.

                         :(OOTimeDelta)delta_t
{
    BOOL applyThrust = YES;
    switch (behaviour)
    {
    case BEHAVIOUR_TUMBLE :
        [self behaviour_tumble: delta_t];
        break;
 
    case BEHAVIOUR_STOP_STILL :
    case BEHAVIOUR_STATION_KEEPING :
        [self behaviour_stop_still: delta_t];
        break;
 
    case BEHAVIOUR_IDLE :
        if ([self isSubEntity])
        {
            applyThrust = NO;
        }
        [self behaviour_idle: delta_t];
        break;
 
    case BEHAVIOUR_TRACTORED :
        [self behaviour_tractored: delta_t];
        break;
 
    case BEHAVIOUR_TRACK_TARGET :
        [self behaviour_track_target: delta_t];
        break;
 
    case BEHAVIOUR_INTERCEPT_TARGET :
    case BEHAVIOUR_COLLECT_TARGET :
        [self behaviour_intercept_target: delta_t];
        break;
 
    case BEHAVIOUR_ATTACK_TARGET :
        [self behaviour_attack_target: delta_t];
        break;
 
    case BEHAVIOUR_ATTACK_FLY_TO_TARGET_SIX :
    case BEHAVIOUR_ATTACK_FLY_TO_TARGET_TWELVE :
        [self behaviour_fly_to_target_six: delta_t];
        break;
 
    case BEHAVIOUR_ATTACK_MINING_TARGET :
        [self behaviour_attack_mining_target: delta_t];
        break;
 
    case BEHAVIOUR_ATTACK_FLY_TO_TARGET :
        [self behaviour_attack_fly_to_target: delta_t];
        break;
 
    case BEHAVIOUR_ATTACK_FLY_FROM_TARGET :
        [self behaviour_attack_fly_from_target: delta_t];
        break;
 
    case BEHAVIOUR_ATTACK_BREAK_OFF_TARGET :
        [self behaviour_attack_break_off_target: delta_t];
        break;
 
    case BEHAVIOUR_ATTACK_SLOW_DOGFIGHT :
        [self behaviour_attack_slow_dogfight: delta_t];
        break;
 
    case BEHAVIOUR_RUNNING_DEFENSE :
        [self behaviour_running_defense: delta_t];
        break;
 
    case BEHAVIOUR_ATTACK_BROADSIDE :
        [self behaviour_attack_broadside: delta_t];
        break;
 
    case BEHAVIOUR_ATTACK_BROADSIDE_LEFT :
        [self behaviour_attack_broadside_left: delta_t];
        break;
 
    case BEHAVIOUR_ATTACK_BROADSIDE_RIGHT :
        [self behaviour_attack_broadside_right: delta_t];
        break;
 
    case BEHAVIOUR_CLOSE_TO_BROADSIDE_RANGE :
        [self behaviour_close_to_broadside_range: delta_t];
        break;
 
    case BEHAVIOUR_CLOSE_WITH_TARGET :
        [self behaviour_close_with_target: delta_t];
        break;
 
    case BEHAVIOUR_ATTACK_SNIPER :
        [self behaviour_attack_sniper: delta_t];
        break;
 
    case BEHAVIOUR_EVASIVE_ACTION :
    case BEHAVIOUR_FLEE_EVASIVE_ACTION :
        [self behaviour_evasive_action: delta_t];
        break;
 
    case BEHAVIOUR_FLEE_TARGET :
        [self behaviour_flee_target: delta_t];
        break;
 
    case BEHAVIOUR_FLY_RANGE_FROM_DESTINATION :
        [self behaviour_fly_range_from_destination: delta_t];
        break;
 
    case BEHAVIOUR_FACE_DESTINATION :
        [self behaviour_face_destination: delta_t];
        break;
 
    case BEHAVIOUR_LAND_ON_PLANET :
        [self behaviour_land_on_planet: delta_t];
        break;
                
    case BEHAVIOUR_FORMATION_FORM_UP :
        [self behaviour_formation_form_up: delta_t];
        break;
 
    case BEHAVIOUR_FLY_TO_DESTINATION :
        [self behaviour_fly_to_destination: delta_t];
        break;
 
    case BEHAVIOUR_FLY_FROM_DESTINATION :
    case BEHAVIOUR_FORMATION_BREAK :
        [self behaviour_fly_from_destination: delta_t];
        break;
 
    case BEHAVIOUR_AVOID_COLLISION :
        [self behaviour_avoid_collision: delta_t];
        break;
 
    case BEHAVIOUR_TRACK_AS_TURRET :
        applyThrust = NO;
        [self behaviour_track_as_turret: delta_t];
        break;
 
    case BEHAVIOUR_FLY_THRU_NAVPOINTS :
        [self behaviour_fly_thru_navpoints: delta_t];
        break;
 
    case BEHAVIOUR_SCRIPTED_AI:
    case BEHAVIOUR_SCRIPTED_ATTACK_AI:
        [self behaviour_scripted_ai: delta_t];
        break;
 
    case BEHAVIOUR_ENERGY_BOMB_COUNTDOWN:
        applyThrust = NO;
        // Do nothing
        break;
    }
 
    // generally the checks above should be turning this *off* for subents
    if (applyThrust)
    {
        [self applyAttitudeChanges:delta_t];
        [self applyThrust:delta_t];
    }
}

References applyAttitudeChanges:, applyThrust:, behaviour, behaviour_attack_break_off_target:, behaviour_attack_broadside:, behaviour_attack_broadside_left:, behaviour_attack_broadside_right:, behaviour_attack_fly_from_target:, behaviour_attack_fly_to_target:, behaviour_attack_mining_target:, behaviour_attack_slow_dogfight:, behaviour_attack_sniper:, behaviour_attack_target:, behaviour_avoid_collision:, behaviour_close_to_broadside_range:, behaviour_close_with_target:, behaviour_evasive_action:, behaviour_face_destination:, behaviour_flee_target:, behaviour_fly_from_destination:, behaviour_fly_range_from_destination:, behaviour_fly_thru_navpoints:, behaviour_fly_to_destination:, behaviour_fly_to_target_six:, behaviour_formation_form_up:, behaviour_idle:, behaviour_intercept_target:, behaviour_land_on_planet:, behaviour_running_defense:, behaviour_scripted_ai:, behaviour_stop_still:, behaviour_track_as_turret:, behaviour_track_target:, behaviour_tractored:, behaviour_tumble:, and Entity::isSubEntity.

Referenced by PlayerEntity(OOPrivate)::performAutopilotUpdates:, and update:.

Here is the call graph for this function:

Here is the caller graph for this function:

proximityAlert

- (Entity *) proximityAlert

Definition at line 7044 of file ShipEntity.m.

{
    Entity* prox = [_proximityAlert weakRefUnderlyingObject];
    if (prox == nil)
    {
        DESTROY(_proximityAlert);
    }
    return prox;
}

References _proximityAlert, DESTROY, nil, proximityAlert, and OOWeakReference::weakRefUnderlyingObject.

Referenced by avoidCollision, behaviour_attack_broadside_target:leftside:, behaviour_attack_fly_to_target:, behaviour_attack_mining_target:, behaviour_attack_slow_dogfight:, behaviour_avoid_collision:, behaviour_close_to_broadside_range:, behaviour_close_with_target:, behaviour_evasive_action:, behaviour_fly_to_target_six:, dumpSelfState, hasProximityAlertIgnoringTarget:, maxFlightSpeed, proximityAlert, setProximityAlert:, and ShipGetProperty().

Here is the call graph for this function:

Here is the caller graph for this function:

randomEjectaTemperature

- (float) randomEjectaTemperature

Definition at line 8796 of file ShipEntity.m.

{
    return [self randomEjectaTemperatureWithMaxFactor:0.99f];
}

References randomEjectaTemperature, and randomEjectaTemperatureWithMaxFactor:.

Referenced by becomeExplosion, dumpItem:, maxFlightSpeed, randomEjectaTemperature, releaseCargoPodsDebris, and ShipEntity(ScriptMethods)::spawnShipsWithRole:count:.

Here is the call graph for this function:

Here is the caller graph for this function:

randomEjectaTemperatureWithMaxFactor:

- (float) randomEjectaTemperatureWithMaxFactor:

(float)

factor

Definition at line 8802 of file ShipEntity.m.

                                              :(float)factor
{
    const float kRange = 0.02f;
    factor -= kRange;
    
    float parentTemp = [self temperature];
    float adjusted = parentTemp * (bellf(5) * (kRange * 2.0f) - kRange + factor);
    if (adjusted > SHIP_MAX_CABIN_TEMP)
    {
        adjusted = SHIP_MAX_CABIN_TEMP;
    }
    
    // Interpolate so that result == parentTemp when parentTemp is SHIP_MIN_CABIN_TEMP
    float interp = OOClamp_0_1_f((parentTemp - SHIP_MIN_CABIN_TEMP) / (SHIP_MAX_CABIN_TEMP - SHIP_MIN_CABIN_TEMP));
    
    return OOLerp(SHIP_MIN_CABIN_TEMP, adjusted, interp);
}

References bellf(), SHIP_MAX_CABIN_TEMP, SHIP_MIN_CABIN_TEMP, and temperature.

Referenced by ShipEntity(Private)::launchPodWithCrew:, and randomEjectaTemperature.

Here is the call graph for this function:

Here is the caller graph for this function:

randomPauseAI:

- (void) randomPauseAI: (NSString *) intervalString

implementation

Provided by category ShipEntity(PureAI).

Definition at line 857 of file ShipEntityAI.m.

                      :(NSString *)intervalString
{
    NSArray*    tokens = ScanTokensFromString(intervalString);
    double start, end;
    
    if ([tokens count] != 2)
    {
        OOLog(@"ai.syntax.randomPauseAI", @"***** ERROR: cannot read min and max value for randomPauseAI:, needs 2 values: '%@'.", intervalString);
        return;
    }
    
    start = [tokens oo_doubleAtIndex:0];
    end   = [tokens oo_doubleAtIndex:1];
    
    [shipAI setNextThinkTime:[UNIVERSE getTime] + (start + (end - start)*randf())];
}

randomSeedForShaders

- (uint32_t) randomSeedForShaders

implementation

Definition at line 9778 of file ShipEntity.m.

{
    return entity_personality * 0x00010001;
}

References entity_personality, and randomSeedForShaders.

Referenced by randomSeedForShaders.

Here is the call graph for this function:

Here is the caller graph for this function:

rangeToDestination

- (GLfloat) rangeToDestination

Definition at line 11112 of file ShipEntity.m.

{
    return HPdistance(position, _destination);
}

References _destination, Entity::position, and rangeToDestination.

Referenced by behaviour, behaviour_avoid_collision:, behaviour_face_destination:, behaviour_fly_from_destination:, behaviour_fly_range_from_destination:, behaviour_fly_to_destination:, behaviour_fly_to_target_six:, behaviour_formation_form_up:, behaviour_intercept_target:, behaviour_tractored:, and rangeToDestination.

Here is the call graph for this function:

Here is the caller graph for this function:

rangeToPrimaryTarget

- (double) rangeToPrimaryTarget

Definition at line 11237 of file ShipEntity.m.

{
    return [self rangeToSecondaryTarget:[self primaryTarget]];
}

References primaryTarget, rangeToPrimaryTarget, and rangeToSecondaryTarget:.

Referenced by behaviour_attack_break_off_target:, behaviour_attack_broadside:, behaviour_attack_broadside_target:leftside:, behaviour_attack_fly_from_target:, behaviour_attack_fly_to_target:, behaviour_attack_mining_target:, behaviour_attack_slow_dogfight:, behaviour_attack_sniper:, behaviour_attack_target:, behaviour_close_to_broadside_range:, behaviour_close_with_target:, behaviour_evasive_action:, behaviour_flee_target:, behaviour_fly_to_target_six:, behaviour_intercept_target:, behaviour_running_defense:, behaviour_scripted_ai:, coordinates, and rangeToPrimaryTarget.

Here is the call graph for this function:

Here is the caller graph for this function:

rangeToSecondaryTarget:

- (double) rangeToSecondaryTarget:

(Entity *)

target

Definition at line 11243 of file ShipEntity.m.

                                 :(Entity *)target
{
    double dist;
    Vector delta;
    if (target == nil)   // leave now!
        return 0.0;
    delta = HPVectorToVector(HPvector_subtract(target->position, position));
    dist = magnitude(delta);
    dist -= target->collision_radius;
    dist -= collision_radius;
    return dist;
}

References Entity::collision_radius, nil, and Entity::position.

Referenced by behaviour_track_as_turret:, fireDirectLaserDefensiveShot, and rangeToPrimaryTarget.

Here is the caller graph for this function:

rawEscortGroup

- (OOShipGroup *) rawEscortGroup

implementation

Provided by category ShipEntity(DebugRawAccess).

Definition at line 6957 of file ShipEntity.m.

{
    return _escortGroup;
}

References ShipEntity(Debug)::rawEscortGroup.

Referenced by ShipEntity(Debug)::rawEscortGroup, and OOShipDebugInspectorModule::update.

Here is the call graph for this function:

Here is the caller graph for this function:

reactionTime

- (float) reactionTime

References avoidCollision, calculateTargetPosition, calculateTrackingCurve, hasAutoCloak, isCloaked, messageTime, resumePostProximityAlert, scannerDisplayColor1, scannerDisplayColor2, scannerDisplayColorHostile1, scannerDisplayColorHostile2, startTrackingCurve, and updateTrackingCurve.

Here is the call graph for this function:

reactToAIMessage:context:

- (void) reactToAIMessage:		(NSString *)	message
context:		(NSString *)	debugContext

Definition at line 14717 of file ShipEntity.m.

                         :(NSString *)message context:(NSString *)debugContext
{
    [shipAI reactToMessage:message context:debugContext];
}

References AI::reactToMessage:context:.

Referenced by broadcastEnergyBlastImminent, broadcastHitByLaserFrom:, doScriptEvent:andReactToAIMessage:, doScriptEvent:withArgument:andReactToAIMessage:, fireMissileWithIdentifier:andTarget:, fireSubentityLaserShot:, ShipEntity(AI)::groupAttackTarget, ShipEntity(PureAI)::messageMother:, ShipReactToAIMessage(), OOECMBlastEntity::update:, ShipEntity(AI)::wormholeEscorts, and ShipEntity(PureAI)::wormholeGroup.

Here is the call graph for this function:

Here is the caller graph for this function:

realAlertCondition

- (OOAlertCondition) realAlertCondition

Reimplemented in PlayerEntity.

Definition at line 14759 of file ShipEntity.m.

{
    if ([self status] == STATUS_DOCKED) 
    {
        return ALERT_CONDITION_DOCKED;
    }
    if ([self hasHostileTarget])
    {
        return ALERT_CONDITION_RED;
    }
    else
    {
        NSEnumerator *sEnum = [_defenseTargets objectEnumerator];
        ShipEntity *ship = nil;
        double scanrange2 = scannerRange * scannerRange;
        while ((ship = [sEnum nextObject]))
        {
            if ([ship hasHostileTarget] || ([ship isPlayer] && [PLAYER weaponsOnline]))
            {
                if (HPdistance2([ship position],position) < scanrange2)
                {
                    return ALERT_CONDITION_RED;
                }
            }
        }
        // also need to check primary target separately
        if ([self hasHostileTarget])
        {
            Entity *ptarget = [self primaryTargetWithoutValidityCheck];
            if (ptarget != nil && [ptarget isShip])
            {
                ship = (ShipEntity *)ptarget;
                if ([ship hasHostileTarget] || ([ship isPlayer] && [PLAYER weaponsOnline]))
                {
                    if (HPdistance2([ship position],position) < scanrange2 * 1.5625)
                    {
                        return ALERT_CONDITION_RED;
                    }
                }
            }
        }
        if (_group)
        {
            sEnum = [_group objectEnumerator];
            while ((ship = [sEnum nextObject]))
            {
                if ([ship hasHostileTarget] || ([ship isPlayer] && [PLAYER weaponsOnline]))
                {
                    if (HPdistance2([ship position],position) < scanrange2)
                    {
                        return ALERT_CONDITION_RED;
                    }
                }
            }
        }
        if (_escortGroup && _group != _escortGroup)
        {
            sEnum = [_escortGroup objectEnumerator];
            while ((ship = [sEnum nextObject]))
            {
                if ([ship hasHostileTarget] || ([ship isPlayer] && [PLAYER weaponsOnline]))
                {
                    if (HPdistance2([ship position],position) < scanrange2)
                    {
                        return ALERT_CONDITION_RED;
                    }
                }
            }
        }
    }
    return ALERT_CONDITION_YELLOW;
}

References _escortGroup, _group, ALERT_CONDITION_DOCKED, ALERT_CONDITION_RED, ALERT_CONDITION_YELLOW, hasHostileTarget, Entity::isPlayer, Entity::isShip, nil, OOShipGroup::objectEnumerator, OOWeakSet::objectEnumerator, PLAYER, Entity::position, primaryTargetWithoutValidityCheck, realAlertCondition, scannerRange, and Entity::status.

Referenced by isMissile, and realAlertCondition.

Here is the call graph for this function:

Here is the caller graph for this function:

recallDockingInstructions

- (void) recallDockingInstructions

Provided by category ShipEntity(AI).

Definition at line 599 of file ShipEntityAI.m.

{
    if (dockingInstructions != nil)
    {
        _destination = [dockingInstructions oo_hpvectorForKey:@"destination"];
        desired_speed = fmin([dockingInstructions oo_floatForKey:@"speed"], maxFlightSpeed);
        desired_range = [dockingInstructions oo_floatForKey:@"range"];
        if ([dockingInstructions objectForKey:@"station"])
        {
            StationEntity *targetStation = [[dockingInstructions objectForKey:@"station"] weakRefUnderlyingObject];
            if (targetStation != nil)
            {
                [self addTarget:targetStation];
                [self setTargetStation:targetStation];
            }
            else 
            {
                [self removeTarget:[self primaryTarget]];
            }
        }
        docking_match_rotation = [dockingInstructions oo_boolForKey:@"match_rotation"];
    }
}

Referenced by ShipEntity(AI)::requestDockingCoordinates.

Here is the caller graph for this function:

recallStoredTarget

- (void) recallStoredTarget

implementation

Provided by category ShipEntity(PureAI).

Definition at line 2140 of file ShipEntityAI.m.

{
    ShipEntity  *oldTarget = (ShipEntity*)[self rememberedShip];
    BOOL    found = NO;
    
    if (oldTarget && ![oldTarget isCloaked])
    {
        GLfloat range2 = HPdistance2([oldTarget position], position);
        if (range2 <= scannerRange * scannerRange && range2 <= SCANNER_MAX_RANGE2)
        {
            found = YES;
        }
    }
    
    if (found)
    {
        [self setFoundTarget:oldTarget];
        [shipAI message:@"TARGET_FOUND"];
    }
    else
    {
        if (oldTarget == nil) DESTROY(_rememberedShip); // ship no longer exists
        [shipAI message:@"NOTHING_FOUND"];
    }
    
}

receiveCommsMessage:from:

- (void) receiveCommsMessage:		(NSString *)	message_text
from:		(ShipEntity *)	other

Reimplemented in PlayerEntity.

Definition at line 14240 of file ShipEntity.m.

                            :(NSString *) message_text from:(ShipEntity *) other
{
    // Too complex for AI scripts to handle, JS event only.
    [self doScriptEvent:OOJSID("commsMessageReceived") withArgument:message_text andArgument:other];
}

References doScriptEvent:withArgument:andArgument:.

Referenced by broadcastMessage:withUnpilotedOverride:, PlayerEntity::receiveCommsMessage:from:, and sendMessage:toShip:withUnpilotedOverride:.

Here is the call graph for this function:

Here is the caller graph for this function:

reference

- (Vector) reference

References reportAIMessages.

refreshEscortPositions

- (void) refreshEscortPositions

implementation

Provided by category ShipEntity(Private).

Definition at line 13790 of file ShipEntity.m.

{
    if (!_escortPositionsValid)
    {
        JSContext           *context = OOJSAcquireContext();
        jsval               result;
        jsval               args[] = { INT_TO_JSVAL(0), INT_TO_JSVAL(_maxEscortCount) };
        BOOL                OK;
        
        // Reset validity first so updateEscortFormation can be called from the update callback.
        _escortPositionsValid = YES;
        
        uint8_t i;
        for (i = 0; i < _maxEscortCount; i++)
        {
            args[0] = INT_TO_JSVAL(i);
            OK = [script callMethod:OOJSID("coordinatesForEscortPosition")
                          inContext:context
                      withArguments:args count:sizeof args / sizeof *args
                             result:&result];
            
            if (OK)  OK = JSValueToVector(context, result, &_escortPositions[i]);
            
            if (!OK)  _escortPositions[i] = kZeroVector;
        }
        
        OOJSRelinquishContext(context);
    }
}

References JSValueToVector(), kZeroVector, OOJSAcquireContext(), OOJSRelinquishContext(), and ShipEntity(Private)::refreshEscortPositions.

Referenced by ShipEntity(Private)::refreshEscortPositions, setUpEscorts, ShipEntity(Private)::setUpMixedEscorts, and update:.

Here is the call graph for this function:

Here is the caller graph for this function:

releaseCargoPodsDebris

- (void) releaseCargoPodsDebris

implementation

Definition at line 9085 of file ShipEntity.m.

{
    HPVector xposition = position;
    NSUInteger i;
    Vector v;
    Quaternion q;
    int speed_low = 200;
 
    NSArray *jetsam = nil;  // this will contain the stuff to get thrown out
    unsigned cargo_chance = 70;
    jetsam = [NSArray arrayWithArray:cargo];   // what the ship is carrying
    [cargo removeAllObjects];   // dispense with it!
    unsigned limit = 15;
    //  Throw out cargo
    NSUInteger n_jetsam = [jetsam count];
                    
    for (i = 0; i < n_jetsam; i++)
    {
        if (Ranrot() % 100 < cargo_chance)  //  chance of any given piece of cargo surviving decompression
        {
            // a higher chance of getting at least a couple of bits of cargo out
            if (cargo_chance > 10)
            {
                if (EXPECT_NOT([self isPlayer]))
                {
                    cargo_chance -= 20;
                }
                else
                {
                    cargo_chance -= 30;
                }
            }
            limit--;
            ShipEntity* cargoObj = [jetsam objectAtIndex:i];
            ShipEntity* container = [UNIVERSE reifyCargoPod:cargoObj];
            /* TODO: this debris position/velocity setting code is
             * duplicated - sometimes not very cleanly - all over the
             * place. Unify to a single function - CIM */
            HPVector  rpos = xposition;
            Vector  rrand = OORandomPositionInBoundingBox(boundingBox);
            rpos.x += rrand.x; rpos.y += rrand.y; rpos.z += rrand.z;
            rpos.x += (ranrot_rand() % 7) - 3;
            rpos.y += (ranrot_rand() % 7) - 3;
            rpos.z += (ranrot_rand() % 7) - 3;
            [container setPosition:rpos];
            v.x = 0.1 *((ranrot_rand() % speed_low) - speed_low / 2);
            v.y = 0.1 *((ranrot_rand() % speed_low) - speed_low / 2);
            v.z = 0.1 *((ranrot_rand() % speed_low) - speed_low / 2);
            [container setVelocity:vector_add(v,[self velocity])];
            quaternion_set_random(&q);
            [container setOrientation:q];
                            
            [container setTemperature:[self randomEjectaTemperature]];
            [container setScanClass: CLASS_CARGO];
            [UNIVERSE addEntity:container]; // STATUS_IN_FLIGHT, AI state GLOBAL
 
            AI *containerAI = [container getAI];
            if ([containerAI hasSuspendedStateMachines]) // check if new or recycled cargo.
            {
                [containerAI exitStateMachineWithMessage:nil];
                [container setThrust:[container maxThrust]]; // restore old value. Was set to zero on previous scooping.
                [container setOwner:container];
            }
        }
        if (limit <= 0)
        {
            break; // even really big ships won't have too much cargo survive an explosion
        }
    }
 
}

References Entity::boundingBox, AI::exitStateMachineWithMessage:, EXPECT_NOT, getAI, Entity::isPlayer, maxThrust, nil, OORandomPositionInBoundingBox(), Entity::position, quaternion_set_random(), randomEjectaTemperature, Ranrot(), ranrot_rand, releaseCargoPodsDebris, Entity::setOrientation:, setOwner:, Entity::setPosition:, Entity::setScanClass:, setTemperature:, setThrust:, Entity::setVelocity:, and velocity.

Referenced by becomeExplosion, becomeLargeExplosion:, and releaseCargoPodsDebris.

Here is the call graph for this function:

Here is the caller graph for this function:

rememberedShip

- (Entity *) rememberedShip

Definition at line 9994 of file ShipEntity.m.

{
    Entity *result = [_rememberedShip weakRefUnderlyingObject];
    if (result == nil || ![self isValidTarget:result])
    {
        DESTROY(_rememberedShip);
        return nil;
    }
    return result;
}

References _rememberedShip, DESTROY, nil, rememberedShip, and OOWeakReference::weakRefUnderlyingObject.

Referenced by maxFlightSpeed, and rememberedShip.

Here is the call graph for this function:

Here is the caller graph for this function:

removeAllDefenseTargets

- (void) removeAllDefenseTargets

Definition at line 11225 of file ShipEntity.m.

{
    [_defenseTargets removeAllObjects];
}

References removeAllDefenseTargets, and OOWeakSet::removeAllObjects.

Referenced by isMissile, and removeAllDefenseTargets.

Here is the call graph for this function:

Here is the caller graph for this function:

removeAllEquipment

- (void) removeAllEquipment

Definition at line 3897 of file ShipEntity.m.

{
    [_equipment release];
    _equipment = nil;
}

References _equipment, nil, and removeAllEquipment.

Referenced by dealloc, PlayerEntity::getDestroyedBy:damageType:, isFrangible, PlayerEntity(Contracts)::newShipCommonSetup:yardInfo:baseInfo:, removeAllEquipment, removeEquipmentItem:, PlayerEntity::setCommanderDataFromDictionary:, PlayerEntity::setUpShipFromDictionary:, and ShipEntity(LoadRestore)::shipRestoredFromDictionary:useFallback:context:.

Here is the call graph for this function:

Here is the caller graph for this function:

removeCargo:amount:

- (BOOL) removeCargo:		(OOCommodityType)	commodity
amount:		(OOCargoQuantity)	amount

Definition at line 8470 of file ShipEntity.m.

                    :(OOCommodityType)commodity amount:(OOCargoQuantity) amount
{
    OOCargoQuantity found = 0;
    ShipEntity *pod = nil;
    foreach (pod, cargo)
    {
        if ([[pod commodityType] isEqualToString:commodity])
        {
            found++;
        }
    }
    if (found < amount)
    {
        // don't remove any if there aren't enough to remove the full amount
        return NO;
    }
    
    NSUInteger i = [cargo count] - 1;
    // iterate downwards to be safe removing during iteration
    while (amount > 0)
    {
        if ([[[cargo objectAtIndex:i] commodityType] isEqualToString:commodity])
        {
            amount--;
            [cargo removeObjectAtIndex:i];
        }
        // check above means array index can't underflow here
        i--;
    }
 
    return YES;
}

References cargo, commodityType, and nil.

Here is the call graph for this function:

removeCollisionException:

- (void) removeCollisionException:

(ShipEntity *)

ship

Definition at line 11139 of file ShipEntity.m.

                                 :(ShipEntity *)ship
{
    if (_collisionExceptions != nil)
    {
        [_collisionExceptions removeObject:ship];
    }
}

References _collisionExceptions, nil, and OOWeakSet::removeObject:.

Referenced by ShipRemoveCollisionException().

Here is the call graph for this function:

Here is the caller graph for this function:

removeDefenseTarget:

- (void) removeDefenseTarget:

(Entity *)

target

Definition at line 11231 of file ShipEntity.m.

                            :(Entity *)target
{
    [_defenseTargets removeObject:target];
}

References OOWeakSet::removeObject:.

Referenced by ShipEntity(PureAI)::becomeUncontrolledThargon, behaviour_track_as_turret:, fireDirectLaserDefensiveShot, noteLostTarget, noteTargetDestroyed:, and validateDefenseTargets.

Here is the call graph for this function:

Here is the caller graph for this function:

removeEquipmentItem:

- (void) removeEquipmentItem:

(NSString *)

equipmentKey

Reimplemented in PlayerEntity.

Definition at line 3642 of file ShipEntity.m.

                            :(NSString *)equipmentKey
{
    NSString        *equipmentTypeCheckKey = equipmentKey;
    NSString        *lcEquipmentKey = [equipmentKey lowercaseString];
    NSUInteger      equipmentIndex = NSNotFound;
    // determine the equipment type and make sure it works also in the case of damaged equipment
    if ([equipmentKey hasSuffix:@"_DAMAGED"])
    {
        equipmentTypeCheckKey = [equipmentKey substringToIndex:[equipmentKey length] - [@"_DAMAGED" length]];
    }
    OOEquipmentType *eqType = [OOEquipmentType equipmentTypeWithIdentifier:equipmentTypeCheckKey];
    if (eqType == nil)  return;
    
    if ([eqType isMissileOrMine] || ([self isThargoid] && ([lcEquipmentKey hasSuffix:@"thargon"] || [lcEquipmentKey hasPrefix:@"thargon"])))
    {
        [self removeExternalStore:eqType];
    }
    else
    {
        if ([_equipment containsObject:equipmentKey])
        {
            if (![equipmentKey isEqualToString:@"EQ_PASSENGER_BERTH"])
            {
                equipment_weight -= [eqType requiredCargoSpace]; // all other cases;
            }
                        
            if ([equipmentKey isEqualToString:@"EQ_CLOAKING_DEVICE"])
            {
                if ([self isCloaked])  [self setCloaked:NO];
            }
 
            if (!isPlayer)
            {
                if([equipmentKey isEqualToString:@"EQ_SHIELD_BOOSTER"])
                {
                    maxEnergy -= 256.0f;
                    if (maxEnergy < energy) energy = maxEnergy;
                }
                else if([equipmentKey isEqualToString:@"EQ_SHIELD_ENHANCER"]) 
                {
                    maxEnergy -= 256.0f;
                    energy_recharge_rate /= 1.5;
                    if (maxEnergy < energy) energy = maxEnergy;
                }
                else if ([equipmentKey isEqual:@"EQ_CARGO_BAY"])
                {
                    max_cargo -= extra_cargo;
                }
            }
        }
        
        if (![equipmentKey hasSuffix:@"_DAMAGED"] && ![eqType canCarryMultiple])
        {
            NSString *damagedKey = [equipmentKey stringByAppendingString:@"_DAMAGED"];
            if ([_equipment containsObject:damagedKey])
            {
                equipmentIndex = [_equipment indexOfObject:damagedKey];
                if (equipmentIndex != NSNotFound)
                {
                    // remove damaged counterpart
                    [_equipment removeObjectAtIndex:equipmentIndex];
                }
                equipment_weight -= [eqType requiredCargoSpace];
            }
        }
        equipmentIndex = [_equipment indexOfObject:equipmentKey];
        if (equipmentIndex != NSNotFound)
        {
            [_equipment removeObjectAtIndex:equipmentIndex];
        }
        // this event must come after the item is actually removed
        [self doScriptEvent:OOJSID("equipmentRemoved") withArgument:equipmentKey];
        
        // if all docking computers are damaged while active
        if ([self isPlayer] && [self status] == STATUS_AUTOPILOT_ENGAGED && ![self hasDockingComputer])
        {
            [(PlayerEntity *)self disengageAutopilot];
        }
 
 
        if ([_equipment count] == 0)  [self removeAllEquipment];
    }
}

References _equipment, count, disengageAutopilot, doScriptEvent:withArgument:, Entity::energy, energy_recharge_rate, equipment_weight, OOEquipmentType::equipmentTypeWithIdentifier:, extra_cargo, hasDockingComputer, isCloaked, Entity::isPlayer, isThargoid, max_cargo, Entity::maxEnergy, nil, removeAllEquipment, removeExternalStore:, OOEquipmentType::requiredCargoSpace, setCloaked:, and Entity::status.

Referenced by abandonShip, launchCascadeMine, Universe::makeDemoShipWithRole:spinning:, PlayerEntity::removeEquipmentItem:, Universe::setupIntroFirstGo:, ShipRemoveEquipment(), ShipSetEquipmentStatus(), and Universe::update:.

Here is the call graph for this function:

Here is the caller graph for this function:

removeExhaust:

- (void) removeExhaust:

(OOExhaustPlumeEntity *)

exhaust

Definition at line 9506 of file ShipEntity.m.

                      :(OOExhaustPlumeEntity *)exhaust
{
    [subEntities removeObject:exhaust];
    [exhaust setOwner:nil];
}

References Entity::setOwner:.

Referenced by ExhaustPlumeRemove().

Here is the call graph for this function:

Here is the caller graph for this function:

removeExternalStore:

- (BOOL) removeExternalStore:

(OOEquipmentType *)

eqType

Reimplemented in PlayerEntity.

Definition at line 3727 of file ShipEntity.m.

                            :(OOEquipmentType *)eqType
{
    NSString    *identifier = [eqType identifier];
    unsigned    i;
    
    for (i = 0; i < missiles; i++)
    {
        if ([[missile_list[i] identifier] isEqualTo:identifier])
        {
            // now 'delete' [i] by compacting the array
            while ( ++i < missiles ) missile_list[i - 1] = missile_list[i];
            
            missiles--;
            return YES;
        }
    }
    return NO;
}

References OOEquipmentType::identifier, missile_list, and missiles.

Referenced by removeEquipmentItem:, and PlayerEntity::removeFromPylon:.

Here is the call graph for this function:

Here is the caller graph for this function:

removeFlasher:

- (void) removeFlasher:

(OOFlasherEntity *)

flasher

Definition at line 9513 of file ShipEntity.m.

                      :(OOFlasherEntity *)flasher
{
    [subEntities removeObject:flasher];
    [flasher setOwner:nil];
}

References Entity::setOwner:.

Referenced by FlasherRemove().

Here is the call graph for this function:

Here is the caller graph for this function:

removeMissiles

- (OOCreditsQuantity) removeMissiles

Reimplemented in PlayerEntity.

Definition at line 3904 of file ShipEntity.m.

{
    missiles = 0;
    return 0;
}

References missiles, and removeMissiles.

Referenced by isFrangible, removeMissiles, ShipAwardEquipment(), and ShipEntity(LoadRestore)::shipRestoredFromDictionary:useFallback:context:.

Here is the call graph for this function:

Here is the caller graph for this function:

removeRole:

- (void) removeRole:

(NSString *)

role

Definition at line 7288 of file ShipEntity.m.

                   :(NSString *)role
{
    if ([self hasRole:role])
    {
        OORoleSet *newRoles = [roleSet roleSetWithRemovedRole:role];
        if (newRoles != nil)
        {
            [roleSet release];
            roleSet = [newRoles retain];
        }
    }
}

References nil, roleSet, and OORoleSet::roleSetWithRemovedRole:.

Referenced by setIsBoulder:.

Here is the call graph for this function:

Here is the caller graph for this function:

removeScript

- (void) removeScript

Definition at line 1148 of file ShipEntity.m.

{
    [script autorelease];
    script = nil;
}

References nil, removeScript, and script.

Referenced by removeScript, and ShipRemove().

Here is the call graph for this function:

Here is the caller graph for this function:

removeTarget:

- (void) removeTarget:

(Entity *)

targetEntity

Definition at line 10073 of file ShipEntity.m.

                     :(Entity *) targetEntity
{
    if(targetEntity != nil) [self noteLostTarget];
    else DESTROY(_primaryTarget);
    // targetEntity == nil is currently only true for mounted player missiles. 
    // we don't want to send lostTarget messages while the missile is mounted.
    
    [[self shipSubEntityEnumerator] makeObjectsPerformSelector:@selector(removeTarget:) withObject:targetEntity];
}

References _primaryTarget, DESTROY, nil, noteLostTarget, and shipSubEntityEnumerator.

Referenced by ShipEntity(PureAI)::becomeUncontrolledThargon, PlayerEntity::doBookkeeping:, noteTargetDestroyed:, ShipEntity(AI)::recallDockingInstructions, PlayerEntity::safeAllMissiles, PlayerEntity::selectNextMissile, and ShipEntity(OOJavaScriptExtensions)::setTargetForScript:.

Here is the call graph for this function:

Here is the caller graph for this function:

repeatString:times:

- (NSString *) repeatString: (NSString *) str times: (NSUInteger) times

implementation

Definition at line 798 of file ShipEntity.m.

                           :(NSString *)str times:(NSUInteger)times
{
    if (times == 0)  return @"";
    
    NSMutableString     *result = [NSMutableString stringWithCapacity:[str length] * times];
    
    for (NSUInteger i = 0; i < times; i++)
    {
        [result appendString:str];
    }
    
    return result;
}

Referenced by serializeShipSubEntities.

Here is the caller graph for this function:

reportAIMessages

- (BOOL) reportAIMessages

References checkForAegis, crew, destinationSystem, findNearestPlanet, findNearestPlanetExcludingMoons, findNearestStellarBody, forceAegisCheck, homeSystem, transitionToAegisNone, and withinStationAegis.

Here is the call graph for this function:

requestDockingCoordinates

- (void) requestDockingCoordinates

Provided by category ShipEntity(AI).

Definition at line 542 of file ShipEntityAI.m.

{
    /*- requests coordinates from the target station
     if the target station can't be found
     then use the nearest it can find (which may be a rock hermit) -*/
    
    StationEntity   *station =  nil;
    Entity          *targStation = nil;
    NSString        *message = nil;
    double      distanceToStation2 = 0.0;
    
    targStation = [self targetStation];
    if ([targStation isStation])
    {
        station = (StationEntity*)targStation;
    }
    else
    {
        station = [UNIVERSE nearestShipMatchingPredicate:IsStationPredicate
                                               parameter:nil
                                        relativeToEntity:self];
    }
    
    distanceToStation2 = HPdistance2([station position], [self position]);
    
    // Player check for being inside the aegis already exists in PlayerEntityControls. We just
    // check here that distance to station is less than 2.5 times scanner range to avoid problems with
    // NPC ships getting stuck with a dockingAI while just outside the aegis - Nikos 20090630, as proposed by Eric
    // On very busy systems (> 50 docking ships) docking ships can be sent to a hold position outside the range, 
    // so also test for presence of dockingInstructions. - Eric 20091130
    if (station != nil && (distanceToStation2 < SCANNER_MAX_RANGE2 * 6.25 || dockingInstructions != nil))
    {
        // remember the instructions
        [dockingInstructions release];
        dockingInstructions = [[station dockingInstructionsForShip:self] retain];
        if (dockingInstructions != nil)
        {
            [self recallDockingInstructions];
            
            message = [dockingInstructions objectForKey:@"ai_message"];
            if (message != nil)  [shipAI message:message];
            message = [dockingInstructions objectForKey:@"comms_message"];
            if (message != nil)  [station sendExpandedMessage:message toShip:self];
        }
    }
    else
    {
        DESTROY(dockingInstructions);
    }
    
    if (dockingInstructions == nil)
    {
        [shipAI message:@"NO_STATION_FOUND"];
    }
}

requestNewTarget

- (void) requestNewTarget

implementation

Provided by category ShipEntity(PureAI).

Definition at line 2233 of file ShipEntityAI.m.

{
    ShipEntity *mother = [[self group] leader];
    if (mother == nil)
    {
        [shipAI message:@"MOTHER_LOST"];
        return;
    }
    
    /*-- Locates all the ships in range targeting the mother ship and chooses the nearest/biggest --*/
    DESTROY(_foundTarget);
    [self checkScanner];
    unsigned i;
    GLfloat found_d2 = scannerRange * scannerRange;
    GLfloat max_e = 0;
    for (i = 0; i < n_scanned_ships ; i++)
    {
        ShipEntity *thing = scanned_ships[i];
        GLfloat d2 = distance2_scanned_ships[i];
        GLfloat e1 = [thing energy];
        if ((d2 < found_d2) && ![thing isCloaked] && (([thing isThargoid] && ![mother isThargoid]) || (([thing primaryTarget] == mother) && [thing hasHostileTarget])))
        {
            if (e1 > max_e)
            {
                [self setFoundTarget:thing];
                max_e = e1;
            }
        }
    }
    
    [self checkFoundTarget];
}

rescaleBy:

- (void) rescaleBy: (GLfloat) factor

implementation

Reimplemented from <OOSubEntity>.

Provided by category ShipEntity(Private).

Definition at line 9043 of file ShipEntity.m.

                  :(GLfloat)factor
{
    [self rescaleBy:factor writeToCache:YES];
}

References rescaleBy:writeToCache:.

Here is the call graph for this function:

rescaleBy:writeToCache:

- (void) rescaleBy: (GLfloat) factor writeToCache: (BOOL) writeToCache

implementation

Reimplemented from <OOSubEntity>.

Provided by category ShipEntity(Private).

Definition at line 9049 of file ShipEntity.m.

                  :(GLfloat)factor writeToCache:(BOOL)writeToCache
{
    _scaleFactor *= factor;
    OOMesh *mesh = nil;
 
    NSDictionary *shipDict = [self shipInfoDictionary];
    NSString *modelName = [shipDict oo_stringForKey:@"model"];
    if (modelName != nil)
    {
        mesh = [OOMesh meshWithName:modelName
                           cacheKey:[NSString stringWithFormat:@"%@-%.3f",_shipKey,_scaleFactor]
                 materialDictionary:[shipDict oo_dictionaryForKey:@"materials"]
                  shadersDictionary:[shipDict oo_dictionaryForKey:@"shaders"]
                             smooth:[shipDict oo_boolForKey:@"smooth" defaultValue:NO]
                       shaderMacros:OODefaultShipShaderMacros()
                       shaderBindingTarget:self
                        scaleFactor:factor
                     cacheWriteable:writeToCache];
 
        if (mesh == nil)  return;
        [self setMesh:mesh];
    }
 
    // rescale subentities
    Entity<OOSubEntity> *se = nil;
    foreach (se, [self subEntities])
    {
        [se setPosition:HPvector_multiply_scalar([se position], factor)];
        [se rescaleBy:factor writeToCache:writeToCache];
    }
    
    // rescale mass
    mass *= factor * factor * factor;
}

References OOMesh::meshWithName:cacheKey:materialDictionary:shadersDictionary:smooth:shaderMacros:shaderBindingTarget:scaleFactor:cacheWriteable:, nil, Entity::position, rescaleBy:writeToCache:, setMesh:, Entity::setPosition:, and shipInfoDictionary.

Referenced by Universe::addWreckageFrom:withRole:at:scale:lifetime:, ShipEntity(Private)::rescaleBy:, and ShipEntity(Private)::rescaleBy:writeToCache:.

Here is the call graph for this function:

Here is the caller graph for this function:

resetExhaustPlumes

- (void) resetExhaustPlumes

Definition at line 9800 of file ShipEntity.m.

{
    NSEnumerator *exEnum = nil;
    OOExhaustPlumeEntity *exEnt = nil;
    
    for (exEnum = [self exhaustEnumerator]; (exEnt = [exEnum nextObject]); )
    {
        [exEnt resetPlume];
    }
}

References exhaustEnumerator, nil, resetExhaustPlumes, and OOExhaustPlumeEntity::resetPlume.

Referenced by EntitySetProperty(), DockEntity::launchShip:, maxFlightSpeed, PlayerEntity(OOPrivate)::performWitchspaceExitUpdates:, resetExhaustPlumes, and wasAddedToUniverse.

Here is the call graph for this function:

Here is the caller graph for this function:

resetShotTime

- (void) resetShotTime

Definition at line 11638 of file ShipEntity.m.

{
    shot_time = 0.0;
}

References resetShotTime, and shot_time.

Referenced by coordinates, fireDirectLaserShotAt:, fireLaserShotInDirection:weaponIdentifier:, fireMissileWithIdentifier:andTarget:, fireSubentityLaserShot:, fireTurretCannon:, PlayerEntity::launchEscapeCapsule, resetShotTime, and PlayerEntity(OOPrivate)::showGameOver.

Here is the call graph for this function:

Here is the caller graph for this function:

respondToAttackFrom:becauseOf:

- (void) respondToAttackFrom:		(Entity *)	from
becauseOf:		(Entity *)	other

Definition at line 2960 of file ShipEntity.m.

                           :(Entity *)from becauseOf:(Entity *)other
{
    Entity              *source = nil;
    
    if ([other isKindOfClass:[ShipEntity class]])
    {
        source = other;
 
        // JSAIs handle friendly fire themselves
        if (![self hasNewAI])
        {
        
            ShipEntity *hunter = (ShipEntity *)other;
            //if we are in the same group, then we have to be careful about how we handle things
            if ([self isPolice] && [hunter isPolice]) 
            {
                //police never get into a fight with each other
                return;
            }
        
            OOShipGroup *group = [self group];
        
            if (group != nil && group == [hunter group]) 
            {
                //we are in the same group, do we forgive you?
                //criminals are less likely to forgive
                if (randf() < (0.8 - (bounty/100))) 
                {
                    //it was an honest mistake, lets get on with it
                    return;
                }
            
                ShipEntity *groupLeader = [group leader];
                if (hunter == groupLeader)
                {
                    //oops we were attacked by our leader, desert him
                    [group removeShip:self];
                }
                else 
                {
                    //evict them from our group
                    [group removeShip:hunter];
                
                    [groupLeader setFoundTarget:other];
                    [groupLeader setPrimaryAggressor:hunter];
                    [groupLeader respondToAttackFrom:from becauseOf:other];
                }
            }
        }
    }
    else
    {
        source = from;
    }   
    
    [self doScriptEvent:OOJSID("shipBeingAttacked") withArgument:source andReactToAIMessage:@"ATTACKED"];
    if ([source isShip]) [(ShipEntity *)source doScriptEvent:OOJSID("shipAttackedOther") withArgument:self];
}

References bounty, doScriptEvent:withArgument:, doScriptEvent:withArgument:andReactToAIMessage:, group, hasNewAI, isPolice, Entity::isShip, OOShipGroup::leader, nil, randf(), OOShipGroup::removeShip:, respondToAttackFrom:becauseOf:, setFoundTarget:, and setPrimaryAggressor:.

Referenced by respondToAttackFrom:becauseOf:, takeEnergyDamage:from:becauseOf:weaponIdentifier:, and StationEntity::takeEnergyDamage:from:becauseOf:weaponIdentifier:.

Here is the call graph for this function:

Here is the caller graph for this function:

resumePostProximityAlert

- (void) resumePostProximityAlert

Definition at line 6874 of file ShipEntity.m.

{
    if (!previousCondition)  return;
 
    behaviour =        [previousCondition oo_intForKey:@"behaviour"];
    [_primaryTarget release];
    _primaryTarget =  [[previousCondition objectForKey:@"primaryTarget"] weakRetain];
    [self startTrackingCurve];
    desired_range =    [previousCondition oo_floatForKey:@"desired_range"];
    desired_speed =    [previousCondition oo_floatForKey:@"desired_speed"];
    _destination =  [previousCondition oo_hpvectorForKey:@"destination"];
 
    [previousCondition release];
    previousCondition = nil;
    frustration = 0.0;
    
    DESTROY(_proximityAlert);
    
    //[shipAI message:@"RESTART_DOCKING"];  // if docking, start over, other AIs will ignore this message
}

References _destination, _primaryTarget, _proximityAlert, behaviour, desired_range, desired_speed, DESTROY, frustration, nil, previousCondition, resumePostProximityAlert, and startTrackingCurve.

Referenced by behaviour_avoid_collision:, reactionTime, and resumePostProximityAlert.

Here is the call graph for this function:

Here is the caller graph for this function:

rightVector

- (Vector) rightVector

Definition at line 1283 of file ShipEntity.m.

{
    return v_right;
}

References rightVector, and v_right.

Referenced by rightVector, totalBoundingBox, and OOExhaustPlumeEntity::update:.

Here is the call graph for this function:

Here is the caller graph for this function:

roleSet

- (OORoleSet *) roleSet

References primaryRole.

rollD:

- (void) rollD: (NSString *) die_number

implementation

Provided by category ShipEntity(PureAI).

Definition at line 2267 of file ShipEntityAI.m.

              :(NSString *)die_number
{
    int die_sides = [die_number intValue];
    if (die_sides > 0)
    {
        int die_roll = 1 + (ranrot_rand() % die_sides);
        NSString* result = [NSString stringWithFormat:@"ROLL_%d", die_roll];
        [shipAI reactToMessage:result context:@"rollD:"];
    }
    else
    {
        OOLog(@"ai.rollD.invalidValue", @"***** ERROR: invalid value supplied to rollD: '%@'.", die_number);
    }
}

rollToMatchUp:rotating:

- (GLfloat) rollToMatchUp:		(Vector)	up_vec
rotating:		(GLfloat)	match_roll

Definition at line 11082 of file ShipEntity.m.

                         :(Vector)up_vec rotating:(GLfloat)match_roll
{
    GLfloat cosTheta = dot_product(up_vec, v_up);   // == cos of angle between up vectors
    GLfloat sinTheta = dot_product(up_vec, v_right);
 
    if (!isPlayer)
    {
        match_roll = -match_roll;   // make necessary corrections for a different viewpoint
        sinTheta = -sinTheta;
    }
 
    if (cosTheta < 0.0f)
    {
        cosTheta = -cosTheta;
        sinTheta = -sinTheta;
    }
 
    if (sinTheta > 0.0f)
    {
        // increase roll rate
        return cosTheta * cosTheta * match_roll + sinTheta * sinTheta * max_flight_roll;
    }
    else
    {
        // decrease roll rate
        return cosTheta * cosTheta * match_roll - sinTheta * sinTheta * max_flight_roll;
    }
}

References Entity::isPlayer, max_flight_roll, v_right, and v_up.

Referenced by trackDestination:delta_t:.

Here is the caller graph for this function:

safeScriptActionOnTarget:

- (void) safeScriptActionOnTarget: (NSString *) action

implementation

Provided by category ShipEntity(PureAI).

Definition at line 2601 of file ShipEntityAI.m.

                                 :(NSString *)action
{
    PlayerEntity    *player = PLAYER;
    ShipEntity      *targEnt = [self primaryTarget];
    ShipEntity      *oldTarget = nil;
    
    if ([targEnt isShip])
    {
        oldTarget = [player scriptTarget];
        [player setScriptTarget:(ShipEntity*)targEnt];
        [player runUnsanitizedScriptActions:[NSArray arrayWithObject:action]
                          allowingAIMethods:YES
                            withContextName:[NSString stringWithFormat:@"<AI \"%@\" state %@ - safeScriptActionOnTarget:>", [[self getAI] name], [[self getAI] state]]
                                  forTarget:targEnt];
        [player setScriptTarget:oldTarget];
    }
}

savedShipDictionaryWithContext:

- (NSDictionary *) savedShipDictionaryWithContext:

(NSMutableDictionary *)

context

Provided by category ShipEntity(LoadRestore).

Definition at line 79 of file ShipEntityLoadRestore.m.

                                                 :(NSMutableDictionary *)context
{
    NSMutableDictionary *result = [NSMutableDictionary dictionary];
    if (context == nil)  context = [NSMutableDictionary dictionary];
    
    [result setObject:_shipKey forKey:KEY_SHIP_KEY];
    
    NSMutableDictionary *updatedShipInfo = [NSMutableDictionary dictionaryWithDictionary:shipinfoDictionary];
    
    [updatedShipInfo setObject:[[self roleSet] roleString] forKey:KEY_ROLES];
    [updatedShipInfo oo_setUnsignedInteger:fuel forKey:KEY_FUEL];
    [updatedShipInfo oo_setUnsignedLongLong:bounty forKey:KEY_BOUNTY];
    [updatedShipInfo setObject:OOStringFromWeaponType(forward_weapon_type) forKey:KEY_FORWARD_WEAPON];
    [updatedShipInfo setObject:OOStringFromWeaponType(aft_weapon_type) forKey:KEY_AFT_WEAPON];
    [updatedShipInfo setObject:OOStringFromScanClass(scanClass) forKey:KEY_SCAN_CLASS];
    
    NSArray *deletes = nil;
    [self simplifyShipdata:updatedShipInfo andGetDeletes:&deletes];
    
    [result setObject:updatedShipInfo forKey:KEY_SHIPDATA_OVERRIDES];
    if (deletes != nil)  [result setObject:deletes forKey:KEY_SHIPDATA_DELETES];
    
    if (!HPvector_equal([self position], kZeroHPVector))
    {
        [result oo_setHPVector:[self position] forKey:KEY_POSITION];
    }
    if (!quaternion_equal([self normalOrientation], kIdentityQuaternion))
    {
        [result oo_setQuaternion:[self normalOrientation] forKey:KEY_ORIENTATION];
    }
    
    if (energy != maxEnergy)  [result oo_setFloat:energy / maxEnergy forKey:KEY_ENERGY_LEVEL];
    
    [result setObject:[self primaryRole] forKey:KEY_PRIMARY_ROLE];
    
    // Add equipment.
    NSArray *equipment = [[self equipmentEnumerator] allObjects];
    if ([equipment count] != 0)  [result setObject:equipment forKey:KEY_EQUIPMENT];
    
    // Add missiles.
    if (missiles > 0)
    {
        NSMutableArray *missileArray = [NSMutableArray array];
        unsigned i;
        for (i = 0; i < missiles; i++)
        {
            NSString *missileType = [missile_list[i] identifier];
            if (missileType != nil)  [missileArray addObject:missileType];
        }
        [result setObject:missileArray forKey:KEY_MISSILES];
    }
    
    // Add groups.
    if (_group != nil)
    {
        [result oo_setUnsignedInteger:GroupIDForGroup(_group, context) forKey:KEY_GROUP_ID];
        if ([_group leader] == self)  [result oo_setBool:YES forKey:KEY_IS_GROUP_LEADER];
        NSString *groupName = [_group name];
        if (groupName != nil)
        {
            [result setObject:groupName forKey:KEY_GROUP_NAME];
        }
    }
    if (_escortGroup != nil)
    {
        [result oo_setUnsignedInteger:GroupIDForGroup(_escortGroup, context) forKey:KEY_ESCORT_GROUP_ID];
    }
    /*  Eric: 
        The escortGroup property is removed from the lead ship, on entering witchspace.
        But it is needed in the save file to correctly restore an escorted group.
    */
    else if (_group != nil && [_group leader] == self)
    {
        [result oo_setUnsignedInteger:GroupIDForGroup(_group, context) forKey:KEY_ESCORT_GROUP_ID];
    }
    
    // FIXME: AI.
    // Eric: I think storing the AI name should be enough. On entering a wormhole, the stack is cleared so there are no preserved AI states.
    // Also the AI restarts itself with the GLOBAL state, so no need to store any old state. 
    if ([[[self getAI] name] isEqualToString:@"nullAI.plist"])
    {
        // might be a JS version
        [result setObject:[[self getAI] associatedJS] forKey:KEY_AI];
        // if there isn't, loading nullAI.js will load nullAI.plist anyway
    }
    else
    {
        [result setObject:[[self getAI] name] forKey:KEY_AI];
    }
    
    return result;
}

scanClass

- (OOScanClass) scanClass

implementation

Reimplemented from Entity.

Definition at line 2063 of file ShipEntity.m.

{
    if (cloaking_device_active)  return CLASS_NO_DRAW;
    return scanClass;
}

References cloaking_device_active, and scanClass.

Referenced by PlayerEntity::addRoleForAggression:, Universe::addShipAt:withRole:withinRadius:, Universe::addShips:withRole:atPosition:withCoordinateSystem:, AuthorityPredicate, avoidCollision, StationEntity::becomeExplosion, behaviour_idle:, behaviour_intercept_target:, behaviour_track_as_turret:, broadcastHitByLaserFrom:, canAcceptEscort:, canScoop:, cascadeIfAppropriateWithDamageAmount:cascadeOwner:, PlayerEntity::collectBountyFor:, ShipEntity(PureAI)::fightOrFleeMissile, fireDirectLaserDefensiveShot, fireMissileWithIdentifier:andTarget:, interpretAIMessage:, isFriendlyTo:, isPolice, isThargoid, isUnpiloted, PlayerEntity::isValidTarget:, isValidTarget:, StationEntity::launchDefenseShip, StationEntity::launchIndependentShip:, StationEntity::launchPatrol, StationEntity::launchPolice, StationEntity::launchShipWithRole:, legalStatus, markAsOffender:withReason:, scanClass, scanDescription, ShipEntity(PureAI)::scanForFormationLeader, ShipEntity(OOAIPrivate)::scanForNearestShipWithPredicate:parameter:, ShipEntity(PureAI)::scanForOffenders, scannerDisplayColorForShip:otherShip:isHostile:flash:scannerDisplayColor1:scannerDisplayColor2:scannerDisplayColorH1:, setAccuracy:, setBounty:withReason:, setCommsMessageColor, PlayerEntity::setUpAndConfirmOK:saveGame:, setUpShipFromDictionary:, trackPrimaryTarget:delta_t:, trackSideTarget:delta_t:, update:, and StationEntity::update:.

Here is the call graph for this function:

Here is the caller graph for this function:

scanDescription

- (NSString *) scanDescription

Definition at line 7165 of file ShipEntity.m.

{
    if (scan_description != nil)
    {
        return scan_description;
    }
    else
    {
        NSString *desc = nil;
        switch ([self scanClass])
        {
        case CLASS_NEUTRAL:
            {
                int legal = [self legalStatus];
                int legal_i = 0;
                if (legal > 0)
                {
                    legal_i =  (legal <= 50) ? 1 : 2;
                }
                desc = [[[UNIVERSE descriptions] oo_arrayForKey:@"legal_status"] oo_stringAtIndex:legal_i];
            }
            break;
    
        case CLASS_THARGOID:
            desc = DESC(@"legal-desc-alien");
            break;
        
        case CLASS_POLICE:
            desc = DESC(@"legal-desc-system-vessel");
            break;
        
        case CLASS_MILITARY:
            desc = DESC(@"legal-desc-military-vessel");
            break;
        
        default:
            break;
        }
        return desc;
    }
}

References DESC, legalStatus, nil, scan_description, scanClass, and scanDescription.

Referenced by displayName, HeadUpDisplay::hudDrawReticleOnTarget, and scanDescription.

Here is the call graph for this function:

Here is the caller graph for this function:

scanDescriptionForScripting

- (NSString *) scanDescriptionForScripting

Definition at line 7159 of file ShipEntity.m.

{
    return scan_description;
}

References scan_description, and scanDescriptionForScripting.

Referenced by displayName, scanDescriptionForScripting, and ShipGetProperty().

Here is the call graph for this function:

Here is the caller graph for this function:

scanForFormationLeader

- (void) scanForFormationLeader

implementation

Provided by category ShipEntity(PureAI).

Definition at line 1881 of file ShipEntityAI.m.

{
    //-- Locates the nearest suitable formation leader in range --//
    DESTROY(_foundTarget);
    [self checkScannerIgnoringUnpowered];
    unsigned i;
    GLfloat found_d2 = scannerRange * scannerRange;
    for (i = 0; i < n_scanned_ships; i++)
    {
        ShipEntity *ship = scanned_ships[i];
        if ((ship != self) && (!ship->isPlayer) && (ship->scanClass == scanClass) && [ship primaryTarget] != self && ![ship isCloaked]) // look for alike
        {
            GLfloat d2 = distance2_scanned_ships[i];
            if ((d2 < found_d2) && [ship canAcceptEscort:self])
            {
                found_d2 = d2;
                [self setFoundTarget:ship];
            }
        }
    }
    
    if ([self foundTarget] != nil)  [shipAI message:@"TARGET_FOUND"];
    else
    {
        [shipAI message:@"NOTHING_FOUND"];
        if ([self hasPrimaryRole:@"wingman"])
        {
            // become free-lance police :)
            [self setAITo:@"route1patrolAI.plist"]; // use this to avoid referencing a released AI
            [self setPrimaryRole:@"police"]; // other wingman can now select this ship as leader.
        }
    }
    
}

scanForHostiles

- (void) scanForHostiles

Provided by category ShipEntity(AI).

Definition at line 314 of file ShipEntityAI.m.

{
    /*-- Locates all the ships in range targeting the receiver and chooses the nearest --*/
    DESTROY(_foundTarget);
    
    [self checkScanner];
    unsigned i;
    GLfloat found_d2 = scannerRange * scannerRange;
    for (i = 0; i < n_scanned_ships ; i++)
    {
        ShipEntity *thing = scanned_ships[i];
        GLfloat d2 = distance2_scanned_ships[i];
        if ((d2 < found_d2) 
            && ([thing isThargoid] || (([thing primaryTarget] == self) && [thing hasHostileTarget]) || [thing isDefenseTarget:self])
            && ![thing isCloaked])
        {
            [self setFoundTarget:thing];
            found_d2 = d2;
        }
    }
    
    [self checkFoundTarget];
}

Referenced by PlayerEntity(Scripting)::targetNearestHostile.

Here is the caller graph for this function:

scanForLoot

- (void) scanForLoot

implementation

Provided by category ShipEntity(PureAI).

Definition at line 1057 of file ShipEntityAI.m.

{
    /*-- Locates the nearest debris in range --*/
    if (!isStation)
    {
        if (![self hasCargoScoop])
        {
            [shipAI message:@"NOTHING_FOUND"];      //can't collect loot if you have no scoop!
            return;
        }
        if ([cargo count] >= [self maxAvailableCargoSpace])
        {
            if (max_cargo)  [shipAI message:@"HOLD_FULL"]; //can't collect loot if holds are full!
            [shipAI message:@"NOTHING_FOUND"];      //can't collect loot if holds are full!
            return;
        }
    }
    else
    {
        if (magnitude2([self velocity]))
        {
            [shipAI message:@"NOTHING_FOUND"];      //can't collect loot if you're a moving station
            return;
        }
    }
    
    [self checkScanner];
    
    double found_d2 = scannerRange * scannerRange;
    DESTROY(_foundTarget);
    unsigned i;
    for (i = 0; i < n_scanned_ships; i++)
    {
        ShipEntity *other = (ShipEntity *)scanned_ships[i];
        if ([other scanClass] == CLASS_CARGO && [other cargoType] != CARGO_NOT_CARGO && [other status] != STATUS_BEING_SCOOPED)
        {
            if ((![self isPolice]) || ([[other commodityType] isEqualToString:@"slaves"])) // police only rescue lifepods and slaves
            {
                GLfloat d2 = distance2_scanned_ships[i];
                if (d2 < found_d2)
                {
                    found_d2 = d2;
                    [self setFoundTarget:other];
                }
            }
        }
    }
    [self checkFoundTarget];
}

scanForNearestIncomingMissile

- (void) scanForNearestIncomingMissile

Provided by category ShipEntity(AI).

Definition at line 624 of file ShipEntityAI.m.

{
    BinaryOperationPredicateParameter param =
    {
        HasScanClassPredicate, [NSNumber numberWithInt:CLASS_MISSILE],
        IsHostileAgainstTargetPredicate, self
    };
    [self scanForNearestShipWithPredicate:ANDPredicate parameter:&param];
}

Referenced by PlayerEntity(Scripting)::targetNearestIncomingMissile.

Here is the caller graph for this function:

scanForNearestMerchantman

- (void) scanForNearestMerchantman

implementation

Provided by category ShipEntity(PureAI).

Definition at line 994 of file ShipEntityAI.m.

{
    float               d2, found_d2;
    unsigned            i;
    ShipEntity          *ship = nil;
    
    //-- Locates the nearest merchantman in range.
    [self checkScannerIgnoringUnpowered];
    
    found_d2 = scannerRange * scannerRange;
    DESTROY(_foundTarget);
    
    for (i = 0; i < n_scanned_ships ; i++)
    {
        ship = scanned_ships[i];
        if ([ship isPirateVictim] && ([ship status] != STATUS_DEAD) && ([ship status] != STATUS_DOCKED) && ![ship isCloaked])
        {
            d2 = distance2_scanned_ships[i];
            if (PIRATES_PREFER_PLAYER && (d2 < desired_range * desired_range) && ship->isPlayer && [self isPirate])
            {
                d2 = 0.0;
            }
            else d2 = distance2_scanned_ships[i];
            if (d2 < found_d2)
            {
                found_d2 = d2;
                [self setFoundTarget:ship];
            }
        }
    }
    [self checkFoundTarget];
}

scanForNearestShipHavingAnyRole:

- (void) scanForNearestShipHavingAnyRole: (NSString *) scanRoles

implementation

Provided by category ShipEntity(PureAI).

Definition at line 2302 of file ShipEntityAI.m.

                                        :(NSString *)scanRoles
{
    NSSet *set = [NSSet setWithArray:ScanTokensFromString(scanRoles)];
    [self scanForNearestShipWithPredicate:HasRoleInSetPredicate parameter:set];
}

scanForNearestShipHavingRole:

- (void) scanForNearestShipHavingRole: (NSString *) scanRole

implementation

Provided by category ShipEntity(PureAI).

Definition at line 2289 of file ShipEntityAI.m.

                                     :(NSString *)scanRole
{
    [self scanForNearestShipWithPredicate:HasRolePredicate parameter:scanRole];
}

Referenced by ShipEntity(PureAI)::thargonCheckMother.

Here is the caller graph for this function:

scanForNearestShipMatchingPredicate:

- (void) scanForNearestShipMatchingPredicate: (NSString *) predicateExpression

implementation

Provided by category ShipEntity(PureAI).

Definition at line 2349 of file ShipEntityAI.m.

                                            :(NSString *)predicateExpression
{
    /*  Takes a boolean-valued JS expression where "ship" is the ship being
     evaluated and "this" is our ship's ship script. the expression is
     turned into a JS function of the form:
     
     function _oo_AIScanPredicate(ship)
     {
     return $expression;
     }
     
     Examples of expressions:
     ship.isWeapon
     this.someComplicatedPredicate(ship)
     function (ship) { ...do something complicated... } ()
     */
    
    static NSMutableDictionary  *scriptCache = nil;
    NSString                    *aiName = nil;
    NSString                    *key = nil;
    OOJSFunction                *function = nil;
    JSContext                   *context = NULL;
    
    context = OOJSAcquireContext();
    
    if (predicateExpression == nil)  predicateExpression = @"false";
    
    aiName = [[self getAI] name];
#ifndef NDEBUG
    /*  In debug/test release builds, scripts are cached per AI in order to be
     able to report errors correctly. For end-user releases, we only cache
     one copy of each predicate, potentially leading to error messages for
     the wrong AI.
     */
    key = [NSString stringWithFormat:@"%@\n%@", aiName, predicateExpression];
#else
    key = predicateExpression;
#endif
    
    // Look for cached function
    function = [scriptCache objectForKey:key];
    if (function == nil)
    {
        NSString                    *predicateCode = nil;
        const char                  *argNames[] = { "ship" };
        
        // Stuff expression in a function.
        predicateCode = [NSString stringWithFormat:@"return %@;", predicateExpression];
        function = [[OOJSFunction alloc] initWithName:@"_oo_AIScanPredicate"
                                                scope:NULL
                                                 code:predicateCode
                                        argumentCount:1
                                        argumentNames:argNames
                                             fileName:aiName
                                           lineNumber:0
                                              context:context];
        [function autorelease];
        
        // Cache function.
        if (function != nil)
        {
            if (scriptCache == nil)  scriptCache = [[NSMutableDictionary alloc] init];
            [scriptCache setObject:function forKey:key];
        }
    }
    
    if (function != nil)
    {
        JSFunctionPredicateParameter param =
        {
            .context = context,
            .function = [function functionValue],
            .jsThis = OOJSObjectFromNativeObject(context, self)
        };
        [self scanForNearestShipWithPredicate:JSFunctionPredicate parameter:&param];
    }
    else
    {
        // Report error (once per occurrence)
        static NSMutableSet         *errorCache = nil;
        
        if (![errorCache containsObject:key])
        {
            OOLog(@"ai.scanForNearestShipMatchingPredicate.compile.failed", @"Could not compile JavaScript predicate \"%@\" for AI %@.", predicateExpression, [[self getAI] name]);
            if (errorCache == nil)  errorCache = [[NSMutableSet alloc] init];
            [errorCache addObject:key];
        }
        
        // Select nothing
        DESTROY(_foundTarget);
        [[self getAI] message:@"NOTHING_FOUND"];
    }
    
    JS_ReportPendingException(context);
    OOJSRelinquishContext(context);
}

scanForNearestShipNotHavingAnyRole:

- (void) scanForNearestShipNotHavingAnyRole: (NSString *) scanRoles

implementation

Provided by category ShipEntity(PureAI).

Definition at line 2335 of file ShipEntityAI.m.

                                           :(NSString *)scanRoles
{
    NSSet *set = [NSSet setWithArray:ScanTokensFromString(scanRoles)];
    [self scanForNearestShipWithNegatedPredicate:HasRoleInSetPredicate parameter:set];
}

scanForNearestShipNotHavingRole:

- (void) scanForNearestShipNotHavingRole: (NSString *) scanRole

implementation

Provided by category ShipEntity(PureAI).

Definition at line 2322 of file ShipEntityAI.m.

                                        :(NSString *)scanRole
{
    [self scanForNearestShipWithNegatedPredicate:HasRolePredicate parameter:scanRole];
}

scanForNearestShipWithAnyPrimaryRole:

- (void) scanForNearestShipWithAnyPrimaryRole: (NSString *) scanRoles

implementation

Provided by category ShipEntity(PureAI).

Definition at line 2295 of file ShipEntityAI.m.

                                             :(NSString *)scanRoles
{
    NSSet *set = [NSSet setWithArray:ScanTokensFromString(scanRoles)];
    [self scanForNearestShipWithPredicate:HasPrimaryRoleInSetPredicate parameter:set];
}

scanForNearestShipWithNegatedPredicate:parameter:

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

implementation

Provided by category ShipEntity(OOAIPrivate).

Definition at line 2877 of file ShipEntityAI.m.

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

Referenced by ShipEntity(PureAI)::scanForNearestShipNotHavingAnyRole:, ShipEntity(PureAI)::scanForNearestShipNotHavingRole:, ShipEntity(PureAI)::scanForNearestShipWithoutAnyPrimaryRole:, ShipEntity(PureAI)::scanForNearestShipWithoutPrimaryRole:, and ShipEntity(PureAI)::scanForNearestShipWithoutScanClass:.

Here is the caller graph for this function:

scanForNearestShipWithoutAnyPrimaryRole:

- (void) scanForNearestShipWithoutAnyPrimaryRole: (NSString *) scanRoles

implementation

Provided by category ShipEntity(PureAI).

Definition at line 2328 of file ShipEntityAI.m.

                                                :(NSString *)scanRoles
{
    NSSet *set = [NSSet setWithArray:ScanTokensFromString(scanRoles)];
    [self scanForNearestShipWithNegatedPredicate:HasPrimaryRoleInSetPredicate parameter:set];
}

scanForNearestShipWithoutPrimaryRole:

- (void) scanForNearestShipWithoutPrimaryRole: (NSString *) scanRole

implementation

Provided by category ShipEntity(PureAI).

Definition at line 2316 of file ShipEntityAI.m.

                                             :(NSString *)scanRole
{
    [self scanForNearestShipWithNegatedPredicate:HasPrimaryRolePredicate parameter:scanRole];
}

scanForNearestShipWithoutScanClass:

- (void) scanForNearestShipWithoutScanClass: (NSString *) scanScanClass

implementation

Provided by category ShipEntity(PureAI).

Definition at line 2342 of file ShipEntityAI.m.

                                           :(NSString *)scanScanClass
{
    NSNumber *parameter = [NSNumber numberWithInt:OOScanClassFromString(scanScanClass)];
    [self scanForNearestShipWithNegatedPredicate:HasScanClassPredicate parameter:parameter];
}

scanForNearestShipWithPredicate:parameter:

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

implementation

Provided by category ShipEntity(OOAIPrivate).

Definition at line 2849 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];
}

Referenced by ShipEntity(AI)::scanForNearestIncomingMissile, ShipEntity(PureAI)::scanForNearestShipHavingAnyRole:, ShipEntity(PureAI)::scanForNearestShipHavingRole:, ShipEntity(PureAI)::scanForNearestShipMatchingPredicate:, ShipEntity(PureAI)::scanForNearestShipWithAnyPrimaryRole:, ShipEntity(OOAIPrivate)::scanForNearestShipWithNegatedPredicate:parameter:, ShipEntity(PureAI)::scanForNearestShipWithPrimaryRole:, and ShipEntity(PureAI)::scanForNearestShipWithScanClass:.

Here is the caller graph for this function:

scanForNearestShipWithPrimaryRole:

- (void) scanForNearestShipWithPrimaryRole: (NSString *) scanRole

implementation

Provided by category ShipEntity(PureAI).

Definition at line 2283 of file ShipEntityAI.m.

                                          :(NSString *)scanRole
{
    [self scanForNearestShipWithPredicate:HasPrimaryRolePredicate parameter:scanRole];
}

Referenced by ShipEntity(PureAI)::scanForThargoid.

Here is the caller graph for this function:

scanForNearestShipWithScanClass:

- (void) scanForNearestShipWithScanClass: (NSString *) scanScanClass

implementation

Provided by category ShipEntity(PureAI).

Definition at line 2309 of file ShipEntityAI.m.

                                        :(NSString *)scanScanClass
{
    NSNumber *parameter = [NSNumber numberWithInt:OOScanClassFromString(scanScanClass)];
    [self scanForNearestShipWithPredicate:HasScanClassPredicate parameter:parameter];
}

scanForNonThargoid

- (void) scanForNonThargoid

implementation

Provided by category ShipEntity(PureAI).

Definition at line 1698 of file ShipEntityAI.m.

{
    /*-- Locates all the non thargoid ships in range and chooses the nearest --*/
    DESTROY(_foundTarget);
    
    [self checkScanner];
    unsigned i;
    GLfloat found_d2 = scannerRange * scannerRange;
    for (i = 0; i < n_scanned_ships ; i++)
    {
        ShipEntity *thing = scanned_ships[i];
        GLfloat d2 = distance2_scanned_ships[i];
        if (([thing scanClass] != CLASS_CARGO) && ([thing status] != STATUS_DOCKED) && ![thing isThargoid] && ![thing isCloaked] && (d2 < found_d2))
        {
            [self setFoundTarget:thing];
            if ([thing isPlayer]) d2 = 0.0;   // prefer the player
            found_d2 = d2;
        }
    }
 
    [self checkFoundTarget];
}

scanForOffenders

- (void) scanForOffenders

implementation

Provided by category ShipEntity(PureAI).

Definition at line 1563 of file ShipEntityAI.m.

{
    /*-- Locates all the ships in range and compares their legal status or bounty against ranrot_rand() & 255 - chooses the worst offender --*/
    NSDictionary        *systeminfo = [UNIVERSE currentSystemData];
    float gov_factor =  0.4 * [(NSNumber *)[systeminfo objectForKey:KEY_GOVERNMENT] intValue]; // 0 .. 7 (0 anarchic .. 7 most stable) --> [0.0, 0.4, 0.8, 1.2, 1.6, 2.0, 2.4, 2.8]
    //
    if ([UNIVERSE sun] == nil)
        gov_factor = 1.0;
    //
    DESTROY(_foundTarget);
    
    // find the worst offender on the scanner
    //
    [self checkScanner];
    unsigned i;
    float   worst_legal_factor = 0;
    GLfloat found_d2 = scannerRange * scannerRange;
    OOShipGroup *group = [self group];
    for (i = 0; i < n_scanned_ships ; i++)
    {
        ShipEntity *ship = scanned_ships[i];
        if ((ship->scanClass != CLASS_CARGO)&&([ship status] != STATUS_DEAD)&&([ship status] != STATUS_DOCKED)&& ![ship isCloaked])
        {
            GLfloat d2 = distance2_scanned_ships[i];
            float   legal_factor = [ship legalStatus] * gov_factor;
            int random_factor = ranrot_rand() & 255;   // 25% chance of spotting a fugitive in 15s
            if ((d2 < found_d2)&&(random_factor < legal_factor)&&(legal_factor > worst_legal_factor))
            {
                if (group == nil || group != [ship group])  // fellows with bounty can't be offenders
                {
                    [self setFoundTarget:ship];
                    worst_legal_factor = legal_factor;
                }
            }
        }
    }
    
    [self checkFoundTarget];
}

scanForRandomLoot

- (void) scanForRandomLoot

implementation

Provided by category ShipEntity(PureAI).

Definition at line 1108 of file ShipEntityAI.m.

{
    /*-- Locates the all debris in range and chooses a piece at random from the first sixteen found --*/
    if (![self isStation] && ![self hasCargoScoop])
    {
        [shipAI message:@"NOTHING_FOUND"];      //can't collect loot if you have no scoop!
        return;
    }
    //
    [self checkScanner];
    //
    ShipEntity* thing_uids_found[16];
    unsigned things_found = 0;
    DESTROY(_foundTarget);
    unsigned i;
    for (i = 0; (i < n_scanned_ships)&&(things_found < 16) ; i++)
    {
        ShipEntity *other = scanned_ships[i];
        if ([other scanClass] == CLASS_CARGO && [other cargoType] != CARGO_NOT_CARGO && [other status] != STATUS_BEING_SCOOPED)
        {
            thing_uids_found[things_found++] = other;
        }
    }
    
    if (things_found != 0)
    {
        [self setFoundTarget:thing_uids_found[ranrot_rand() % things_found]];
        [shipAI message:@"TARGET_FOUND"];
    }
    else
        [shipAI message:@"NOTHING_FOUND"];
}

scanForRandomMerchantman

- (void) scanForRandomMerchantman

implementation

Provided by category ShipEntity(PureAI).

Definition at line 1028 of file ShipEntityAI.m.

{
    unsigned            n_found, i;
    
    //-- Locates one of the merchantman in range.
    [self checkScannerIgnoringUnpowered];
    ShipEntity*     ids_found[n_scanned_ships];
    
    n_found = 0;
    DESTROY(_foundTarget);
    for (i = 0; i < n_scanned_ships ; i++)
    {
        ShipEntity *ship = scanned_ships[i];
        if (([ship status] != STATUS_DEAD) && ([ship status] != STATUS_DOCKED) && [ship isPirateVictim] && ![ship isCloaked])
            ids_found[n_found++] = ship;
    }
    if (n_found == 0)
    {
        [shipAI message:@"NOTHING_FOUND"];
    }
    else
    {
        i = ranrot_rand() % n_found; // pick a number from 0 -> (n_found - 1)
        [self setFoundTarget:ids_found[i]];
        [shipAI message:@"TARGET_FOUND"];
    }
}

scanForRocks

- (void) scanForRocks

implementation

Provided by category ShipEntity(PureAI).

Definition at line 2167 of file ShipEntityAI.m.

{
    /*-- Locates the all boulders and asteroids in range and selects nearest --*/
    
    // find boulders then asteroids within range
    //
    DESTROY(_foundTarget);
    [self checkScanner];
    unsigned i;
    GLfloat found_d2 = scannerRange * scannerRange;
    for (i = 0; i < n_scanned_ships; i++)
    {
        ShipEntity *thing = scanned_ships[i];
        if ([thing isBoulder])
        {
            GLfloat d2 = distance2_scanned_ships[i];
            if (d2 < found_d2)
            {
                [self setFoundTarget:thing];
                found_d2 = d2;
            }
        }
    }
    if ([self foundTarget] == nil)
    {
        for (i = 0; i < n_scanned_ships; i++)
        {
            ShipEntity *thing = scanned_ships[i];
            if ([thing hasRole:@"asteroid"])
            {
                GLfloat d2 = distance2_scanned_ships[i];
                if (d2 < found_d2)
                {
                    [self setFoundTarget:thing];
                    found_d2 = d2;
                }
            }
        }
    }
    
    [self checkFoundTarget];
}

scanForThargoid

- (void) scanForThargoid

implementation

Provided by category ShipEntity(PureAI).

Definition at line 1692 of file ShipEntityAI.m.

{
    return [self scanForNearestShipWithPrimaryRole:@"thargoid"];
}

scannedShips

- (ShipEntity **) scannedShips

Definition at line 9905 of file ShipEntity.m.

{
    scanned_ships[n_scanned_ships] = nil;   // terminate array
    return scanned_ships;
}

References nil, scanned_ships, and scannedShips.

Referenced by maxFlightSpeed, and scannedShips.

Here is the call graph for this function:

Here is the caller graph for this function:

scannerDisplayColor1

- (OOColor *) scannerDisplayColor1

Definition at line 6628 of file ShipEntity.m.

{
    return [[scanner_display_color1 retain] autorelease];
}

References scannerDisplayColor1.

Referenced by HeadUpDisplay(Private)::drawScanner:, reactionTime, scannerDisplayColor1, scannerDisplayColorForShip:otherShip:isHostile:flash:scannerDisplayColor1:scannerDisplayColor2:scannerDisplayColorH1:, and ShipGetProperty().

Here is the call graph for this function:

Here is the caller graph for this function:

scannerDisplayColor2

- (OOColor *) scannerDisplayColor2

Definition at line 6634 of file ShipEntity.m.

{
    return [[scanner_display_color2 retain] autorelease];
}

References scannerDisplayColor2.

Referenced by HeadUpDisplay(Private)::drawScanner:, reactionTime, scannerDisplayColor2, scannerDisplayColorForShip:otherShip:isHostile:flash:scannerDisplayColor1:scannerDisplayColor2:scannerDisplayColorH1:, and ShipGetProperty().

Here is the call graph for this function:

Here is the caller graph for this function:

scannerDisplayColorForShip:otherShip:isHostile:flash:scannerDisplayColor1:scannerDisplayColor2:scannerDisplayColorH1:

- (GLfloat *) scannerDisplayColorForShip:		(ShipEntity*)
otherShip:		(BOOL)
isHostile:		(BOOL)
flash:		(OOColor *)
scannerDisplayColor1:		(OOColor *)
scannerDisplayColor2:		(OOColor *)
scannerDisplayColorH1:		(OOColor *)	scannerDisplayColorH2

Definition at line 6498 of file ShipEntity.m.

                                        :(ShipEntity*)otherShip :(BOOL)isHostile :(BOOL)flash :(OOColor *)scannerDisplayColor1 :(OOColor *)scannerDisplayColor2 :(OOColor *)scannerDisplayColorH1 :(OOColor *)scannerDisplayColorH2
{
    if (isHostile)
    {
        /* if there are any scripted scanner hostile display colours
         * for the ship, use them - otherwise fall through to the
         * normal scripted colours, then the scan class colours */
        if (scannerDisplayColorH1 || scannerDisplayColorH2)
        {
            if (scannerDisplayColorH1 && !scannerDisplayColorH2)
            {
                [scannerDisplayColorH1 getRed:&scripted_color[0] green:&scripted_color[1] blue:&scripted_color[2] alpha:&scripted_color[3]];
            }
        
            if (!scannerDisplayColorH1 && scannerDisplayColorH2)
            {
                [scannerDisplayColorH2 getRed:&scripted_color[0] green:&scripted_color[1] blue:&scripted_color[2] alpha:&scripted_color[3]];
            }
        
            if (scannerDisplayColorH1 && scannerDisplayColorH2)
            {
                if (flash)
                    [scannerDisplayColorH1 getRed:&scripted_color[0] green:&scripted_color[1] blue:&scripted_color[2] alpha:&scripted_color[3]];
                else
                    [scannerDisplayColorH2 getRed:&scripted_color[0] green:&scripted_color[1] blue:&scripted_color[2] alpha:&scripted_color[3]];
            }
        
            return scripted_color;
        }
    }
 
    // if there are any scripted scanner display colors for the ship, use them
    if (scannerDisplayColor1 || scannerDisplayColor2)
    {
        if (scannerDisplayColor1 && !scannerDisplayColor2)
        {
            [scannerDisplayColor1 getRed:&scripted_color[0] green:&scripted_color[1] blue:&scripted_color[2] alpha:&scripted_color[3]];
        }
        
        if (!scannerDisplayColor1 && scannerDisplayColor2)
        {
            [scannerDisplayColor2 getRed:&scripted_color[0] green:&scripted_color[1] blue:&scripted_color[2] alpha:&scripted_color[3]];
        }
        
        if (scannerDisplayColor1 && scannerDisplayColor2)
        {
            if (flash)
                [scannerDisplayColor1 getRed:&scripted_color[0] green:&scripted_color[1] blue:&scripted_color[2] alpha:&scripted_color[3]];
            else
                [scannerDisplayColor2 getRed:&scripted_color[0] green:&scripted_color[1] blue:&scripted_color[2] alpha:&scripted_color[3]];
        }
        
        return scripted_color;
    }
 
    // no scripted scanner display colors defined, proceed as per standard
    if ([self isJammingScanning])
    {
        if (![otherShip hasMilitaryScannerFilter])
            return jammed_color;
        else
        {
            if (flash)
                return mascem_color1;
            else
            {
                if (isHostile)
                    return hostile_color;
                else
                    return mascem_color2;
            }
        }
    }
 
    switch (scanClass)
    {
        case CLASS_ROCK :
        case CLASS_CARGO :
            return cargo_color;
        case CLASS_THARGOID :
            if (flash)
                return hostile_color;
            else
                return friendly_color;
        case CLASS_MISSILE :
            return missile_color;
        case CLASS_STATION :
            return friendly_color;
        case CLASS_BUOY :
            if (flash)
                return friendly_color;
            else
                return neutral_color;
        case CLASS_POLICE :
        case CLASS_MILITARY :
            if ((isHostile)&&(flash))
                return police_color2;
            else
                return police_color1;
        case CLASS_MINE :
            if (flash)
                return neutral_color;
            else
                return hostile_color;
        default :
            if (isHostile)
                return hostile_color;
    }
    return neutral_color;
}

References cargo_color, friendly_color, OOColor::getRed:green:blue:alpha:, hasMilitaryScannerFilter, hostile_color, isJammingScanning, jammed_color, mascem_color1, mascem_color2, missile_color, neutral_color, police_color1, police_color2, scanClass, scannerDisplayColor1, scannerDisplayColor2, and scripted_color.

Here is the call graph for this function:

scannerDisplayColorHostile1

- (OOColor *) scannerDisplayColorHostile1

Definition at line 6658 of file ShipEntity.m.

{
    return [[scanner_display_color_hostile1 retain] autorelease];
}

References scannerDisplayColorHostile1.

Referenced by HeadUpDisplay(Private)::drawScanner:, reactionTime, scannerDisplayColorHostile1, and ShipGetProperty().

Here is the call graph for this function:

Here is the caller graph for this function:

scannerDisplayColorHostile2

- (OOColor *) scannerDisplayColorHostile2

Definition at line 6664 of file ShipEntity.m.

{
    return [[scanner_display_color_hostile2 retain] autorelease];
}

References scannerDisplayColorHostile2.

Referenced by HeadUpDisplay(Private)::drawScanner:, reactionTime, scannerDisplayColorHostile2, and ShipGetProperty().

Here is the call graph for this function:

Here is the caller graph for this function:

scannerRange

- (GLfloat) scannerRange

References reference.

scoopIn:

- (void) scoopIn:

(ShipEntity *)

other

Definition at line 12907 of file ShipEntity.m.

                :(ShipEntity *)other
{
    [other getTractoredBy:self];
}

Referenced by collideWithShip:.

Here is the caller graph for this function:

scoopUp:

- (void) scoopUp:

(ShipEntity *)

other

Definition at line 12919 of file ShipEntity.m.

                :(ShipEntity *)other
{
    [self scoopUpProcess:other processEvents:YES processMessages:YES];
}

References scoopUpProcess:processEvents:processMessages:.

Referenced by behaviour_tractored:.

Here is the call graph for this function:

Here is the caller graph for this function:

scoopUpProcess:processEvents:processMessages:

- (void) scoopUpProcess:		(ShipEntity *)	other
processEvents:		(BOOL)	proc_events
processMessages:		(BOOL)	proc_messages

Definition at line 12925 of file ShipEntity.m.

                       :(ShipEntity *)other processEvents:(BOOL) procEvents processMessages:(BOOL) procMessages
{
    if (other == nil)  return;
    
    OOCommodityType  co_type = nil;
    OOCargoQuantity  co_amount;
    
    // don't even think of trying to scoop if the cargo hold is already full
    if (max_cargo && [cargo count] >= [self maxAvailableCargoSpace])
    {
        [other setStatus:STATUS_IN_FLIGHT];
        return;
    }
    
    switch ([other cargoType])
    {
        case CARGO_RANDOM:
            co_type = [other commodityType];
            co_amount = [other commodityAmount];
            break;
        
        case CARGO_SCRIPTED_ITEM:
            {
                //scripting
                PlayerEntity *player = PLAYER;
                [player setScriptTarget:self];
                if (procEvents)
                {
                    [other doScriptEvent:OOJSID("shipWasScooped") withArgument:self];
                }
                
                if ([other commodityType] != nil)
                {
                    co_type = [other commodityType];
                    co_amount = [other commodityAmount];
                    // don't show scoop message now, will happen later.
                }
                else
                {
                    if (isPlayer && [other showScoopMessage] && procMessages)
                    {
                        [UNIVERSE clearPreviousMessage];
                        NSString *shipName = [other displayName];
                        [UNIVERSE addMessage:OOExpandKey(@"scripted-item-scooped", shipName) forCount:4];
                    }
                    [other setCommodityForPod:nil andAmount:0];
                    co_amount = 0;
                    co_type = nil;
                }
            }
            break;
        
        default :
            co_amount = 0;
            co_type = nil;
            break;
    }
    
    /*  Bug: docking failed due to NSRangeException while looking for element
        NSNotFound of cargo mainfest in -[PlayerEntity unloadCargoPods].
        Analysis: bad cargo pods being generated due to
        -[Universe commodityForName:] looking in wrong place for names.
        Fix 1: fix -[Universe commodityForName:].
        Fix 2: catch NSNotFound here and substitute random cargo type.
        -- Ahruman 20070714
    */
    if (co_type == nil && co_amount > 0)
    {
        co_type = [UNIVERSE getRandomCommodity];
        co_amount = [UNIVERSE getRandomAmountOfCommodity:co_type];
    }
    
    if (co_amount > 0)
    {
        [other setCommodity:co_type andAmount:co_amount];   // belt and braces setting this!
        cargo_flag = CARGO_FLAG_CANISTERS;
        
        if (isPlayer)
        {
            if ([other crew])           
            {
                if ([other showScoopMessage] && procMessages)
                {
                    [UNIVERSE clearPreviousMessage];
                    unsigned i;
                    for (i = 0; i < [[other crew] count]; i++)
                    {
                        OOCharacter *rescuee = [[other crew] objectAtIndex:i];
                        NSString *characterName = [rescuee name];
                        if ([rescuee legalStatus])
                        {
                            [UNIVERSE addMessage:OOExpandKey(@"scoop-captured-character", characterName) forCount: 4.5];
                        }
                        else if ([rescuee insuranceCredits])
                        {
                            [UNIVERSE addMessage:OOExpandKey(@"scoop-rescued-character", characterName) forCount: 4.5];
                        }
                        else
                        {
                            [UNIVERSE addMessage: DESC(@"scoop-got-slave") forCount: 4.5];
                        }
                    }
                }
                if (procEvents) 
                {
                    [(PlayerEntity *)self playEscapePodScooped];
                }
            }
            else
            {
                if ([other showScoopMessage] && procMessages)
                {
                    [UNIVERSE clearPreviousMessage];
                    [UNIVERSE addMessage:[UNIVERSE describeCommodity:co_type amount:co_amount] forCount:4.5];
                }
            }
        }
        [cargo insertObject:other atIndex:0];   // places most recently scooped object at eject position
        [other setStatus:STATUS_IN_HOLD];
        [other performTumble];
        [shipAI message:@"CARGO_SCOOPED"];
        if (max_cargo && [cargo count] >= [self maxAvailableCargoSpace])  [shipAI message:@"HOLD_FULL"];
    }
    if (procEvents)
    {
        [self doScriptEvent:OOJSID("shipScoopedOther") withArgument:other]; // always fire, even without commodity.
    }
 
    // if shipScoopedOther does something strange to the object, we must
    // then remove it from the hold, or it will be over-retained
    if ([other status] != STATUS_IN_HOLD) 
    {
        if ([cargo containsObject:other])
        {
            [cargo removeObject:other];
        }
    }
 
    [[other collisionArray] removeObject:self];           // so it can't be scooped twice!
    // make sure other ships trying to scoop it lose it
    // probably already happened, but some may have acquired it
    // after the scooping started, and they might get stuck in a scooping
    // attempt as a result
    [self checkScannerIgnoringUnpowered];
    unsigned i;
    ShipEntity *scooper;
    for (i = 0; i < n_scanned_ships ; i++)
    {
        scooper = (ShipEntity *)scanned_ships[i];
        if (self != scooper && (id) other == [scooper primaryTargetWithoutValidityCheck])
        {
            [scooper noteLostTarget];
        }
    }
 
    [self suppressTargetLost];
    [UNIVERSE removeEntity:other];
}

References cargo, cargo_flag, CARGO_FLAG_CANISTERS, CARGO_RANDOM, CARGO_SCRIPTED_ITEM, cargoType, checkScannerIgnoringUnpowered, Entity::collisionArray, commodityType, count, crew, doScriptEvent:withArgument:, Entity::isPlayer, legalStatus, max_cargo, maxAvailableCargoSpace, AI::message:, n_scanned_ships, OOCharacter::name, nil, noteLostTarget, PLAYER, primaryTargetWithoutValidityCheck, scanned_ships, PlayerEntity::setScriptTarget:, Entity::setStatus:, showScoopMessage, Entity::status, and suppressTargetLost.

Referenced by scoopUp:, and ShipAddCargoEntity().

Here is the call graph for this function:

Here is the caller graph for this function:

script

- (OOJSScript *) script

References scriptInfo.

scriptActionOnTarget:

- (void) scriptActionOnTarget: (NSString *) action

implementation

Provided by category ShipEntity(PureAI).

Definition at line 2567 of file ShipEntityAI.m.

                             :(NSString *)action
{
    PlayerEntity    *player = PLAYER;
    ShipEntity      *targEnt = [self primaryTarget];
    ShipEntity      *oldTarget = nil;
    
#ifndef NDEBUG
    static BOOL     deprecationWarning = NO;
    
    if (!deprecationWarning)
    {
        deprecationWarning = YES;
        OOLog(@"script.deprecated.scriptActionOnTarget", @"----- WARNING in AI %@: the AI method scriptActionOnTarget: is deprecated and should not be used. It is slow and has unpredictable side effects. The recommended alternative is to use sendScriptMessage: to call a function in a ship's JavaScript ship script instead. scriptActionOnTarget: should not be used at all from scripts. An alternative is safeScriptActionOnTarget:, which is similar to scriptActionOnTarget: but has less side effects.", [AI currentlyRunningAIDescription]);
    }
    else
    {
        OOLog(@"script.deprecated.scriptActionOnTarget.repeat", @"----- WARNING in AI %@: the AI method scriptActionOnTarget: is deprecated and should not be used.", [AI currentlyRunningAIDescription]);
    }
#endif
    
    if ([targEnt isShip])
    {
        oldTarget = [player scriptTarget];
        [player setScriptTarget:(ShipEntity*)targEnt];
        [player runUnsanitizedScriptActions:[NSArray arrayWithObject:action]
                          allowingAIMethods:YES
                            withContextName:[NSString stringWithFormat:@"<AI \"%@\" state %@ - scriptActionOnTarget:>", [[self getAI] name], [[self getAI] state]]
                                  forTarget:targEnt];
        [player checkScript];    // react immediately to any changes this makes
        [player setScriptTarget:oldTarget];
    }
}

scriptedMisjump

- (BOOL) scriptedMisjump

Definition at line 1289 of file ShipEntity.m.

{
    return scripted_misjump;
}

References scripted_misjump, and scriptedMisjump.

Referenced by PlayerEntity::enterWitchspace, PlayerEntity::enterWormhole:, enterWormhole:replacing:, scriptedMisjump, and scriptInfo.

Here is the call graph for this function:

Here is the caller graph for this function:

scriptedMisjumpRange

- (GLfloat) scriptedMisjumpRange

Definition at line 1301 of file ShipEntity.m.

{
    return _scriptedMisjumpRange;
}

References _scriptedMisjumpRange, and scriptedMisjumpRange.

Referenced by PlayerEntity::enterWitchspace, PlayerEntity::enterWormhole:, enterWormhole:replacing:, scriptedMisjumpRange, and scriptInfo.

Here is the call graph for this function:

Here is the caller graph for this function:

scriptInfo

- (NSDictionary *) scriptInfo

References entityForShaderProperties, isDemoShip, scriptedMisjump, and scriptedMisjumpRange.

Here is the call graph for this function:

selectMissile

- (OOEquipmentType *) selectMissile

Definition at line 3838 of file ShipEntity.m.

{
    OOEquipmentType     *missileType = nil;
    NSString            *role = nil;
    double              chance = randf();
    BOOL                thargoidMissile = NO;
    
    if ([self isThargoid])
    {
        if (_missileRole != nil) missileType = [self verifiedMissileTypeFromRole:_missileRole];
        if (missileType == nil) {
            _missileRole = @"EQ_THARGON";   // no valid missile_role defined, use thargoid fallback from now on.
            missileType = [self verifiedMissileTypeFromRole:_missileRole];
        }
    }
    else
    {
        // All other ships: random role 10% of the cases when auto weapons is set, if a missile_role is defined.
        // Without auto weapons, never random.
        float randomSelectionChance = chance;
        if(![self hasAutoWeapons])  randomSelectionChance = 0.0f;
        if (randomSelectionChance < 0.9f && _missileRole != nil)
        {
            missileType = [self verifiedMissileTypeFromRole:_missileRole];
        }
        
        if (missileType == nil)  // the random 10% , or no valid missile_role defined
        {
            if (chance < 0.9f && _missileRole != nil)    // no valid missile_role defined?
            {
                _missileRole = nil;  // use generic ship fallback from now on.
            }
            
            // assign random missiles 20% of the time without missile_role (or 10% with valid missile_role)
            if (chance > 0.8f) role = @"missile";
            // otherwise use the standard role
            else role = @"EQ_MISSILE";
            
            missileType = [self verifiedMissileTypeFromRole:role];
        }
    }
    
    if (missileType == nil) OOLogERR(@"ship.setUp.missiles", @"could not resolve missile / mine type for ship \"%@\". Original missile role:\"%@\".", [self name],_missileRole);
    
    role = [[missileType identifier] lowercaseString];
    thargoidMissile = [self isThargoid] && ([role hasSuffix:@"thargon"] || [role hasPrefix:@"thargon"]);
 
    if (thargoidMissile || (!thargoidMissile && [missileType isMissileOrMine]))
    {
        return missileType;
    }
    else
    {
        OOLogWARN(@"ship.setUp.missiles", @"missile_role \"%@\" is not a valid missile / mine type for ship \"%@\".%@", [missileType identifier] , [self name],@" No missile selected.");
        return nil;
    }
}

References _missileRole, hasAutoWeapons, OOEquipmentType::identifier, isThargoid, name, nil, OOLogERR, OOLogWARN, randf(), selectMissile, and verifiedMissileTypeFromRole:.

Referenced by isFrangible, selectMissile, setUpShipFromDictionary:, and ShipSelectNewMissile().

Here is the call graph for this function:

Here is the caller graph for this function:

sendAIMessage:

- (void) sendAIMessage:

(NSString *)

message

Definition at line 14723 of file ShipEntity.m.

                      :(NSString *)message
{
    [shipAI message:message];   
}

References AI::message:.

Referenced by DockEntity::abortAllDockings, StationEntity::abortDockingForShip:, ShipEntity(PureAI)::messageSelf:, DockEntity::pruneAndCountShipsOnApproach, and ShipSendAIMessage().

Here is the call graph for this function:

Here is the caller graph for this function:

sendExpandedMessage:toShip:

- (void) sendExpandedMessage:		(NSString *)	message_text
toShip:		(ShipEntity*)	other_ship

Definition at line 14151 of file ShipEntity.m.

                            :(NSString *)message_text toShip:(ShipEntity *)other_ship
{
    if (!other_ship || !crew)
        return; // nobody to receive or send the signal
    if ((lastRadioMessage) && (messageTime > 0.0) && [message_text isEqual:lastRadioMessage])
        return; // don't send the same message too often
    [lastRadioMessage autorelease];
    lastRadioMessage = [message_text retain];
 
    double d2 = HPdistance2(position, [other_ship position]);
    if (d2 > scannerRange * scannerRange)
    {
        // out of comms range
        return;
    }
    
    Random_Seed very_random_seed;
    very_random_seed.a = rand() & 255;
    very_random_seed.b = rand() & 255;
    very_random_seed.c = rand() & 255;
    very_random_seed.d = rand() & 255;
    very_random_seed.e = rand() & 255;
    very_random_seed.f = rand() & 255;
    seed_RNG_only_for_planet_description(very_random_seed);
    
    NSDictionary *specials = [NSDictionary dictionaryWithObjectsAndKeys:
                              [self displayName], @"[self:name]",
                              [other_ship identFromShip: self], @"[target:name]",
                              nil];
    NSString *expandedMessage = OOExpandDescriptionString(OOStringExpanderDefaultRandomSeed(), message_text, specials, nil, nil, kOOExpandNoOptions);
    
    [self sendMessage:expandedMessage toShip:other_ship withUnpilotedOverride:NO];
}

References Random_Seed::a, Random_Seed::b, Random_Seed::c, crew, Random_Seed::d, displayName, Random_Seed::e, Random_Seed::f, identFromShip:, kOOExpandNoOptions, lastRadioMessage, messageTime, nil, OOExpandDescriptionString(), OOStringExpanderDefaultRandomSeed(), Entity::position, scannerRange, seed_RNG_only_for_planet_description(), and sendMessage:toShip:withUnpilotedOverride:.

Referenced by DockEntity::abortAllDockings, StationEntity::abortAllDockings, DockEntity::abortDockingForShip:, StationEntity::acceptDockingClearanceRequestFrom:, DockEntity(OOPrivate)::addShipToShipsOnApproach:, ShipEntity(AI)::broadcastDistressMessageWithDumping:, DockEntity::dockingInstructionsForShip:, StationEntity(OOPrivate)::holdPositionInstructionForShip:, interpretAIMessage:, StationEntity::noteDockedShip:, ShipEntity(AI)::requestDockingCoordinates, ShipEntity(PureAI)::sendTargetCommsMessage:, and StationEntity::update:.

Here is the call graph for this function:

Here is the caller graph for this function:

sendMessage:toShip:withUnpilotedOverride:

- (void) sendMessage:		(NSString *)	message_text
toShip:		(ShipEntity*)	other_ship
withUnpilotedOverride:		(BOOL)	unpilotedOverride

Definition at line 14128 of file ShipEntity.m.

                    :(NSString *) message_text toShip:(ShipEntity*) other_ship withUnpilotedOverride:(BOOL)unpilotedOverride
{
    if (!other_ship || !message_text) return;
    if (!crew && !unpilotedOverride) return;
    
    double d2 = HPdistance2(position, [other_ship position]);
    if (d2 > scannerRange * scannerRange)
        return;                 // out of comms range
 
    NSString *expandedMessage = OOExpand(message_text); // consistent with broadcast message.
 
    if (other_ship->isPlayer)
    {
        [self setCommsMessageColor];
        [(PlayerEntity *)other_ship receiveCommsMessage:expandedMessage from:self];
        messageTime = 6.0;
        [UNIVERSE resetCommsLogColor];
    }
    else
        [other_ship receiveCommsMessage:expandedMessage from:self];
}

References crew, Entity::isPlayer, messageTime, OOExpand, Entity::position, PlayerEntity::receiveCommsMessage:from:, receiveCommsMessage:from:, scannerRange, and setCommsMessageColor.

Referenced by sendExpandedMessage:toShip:, and ShipCommsMessage().

Here is the call graph for this function:

Here is the caller graph for this function:

sendScriptMessage:

- (void) sendScriptMessage: (NSString *) message

implementation

Provided by category ShipEntity(PureAI).

Definition at line 2621 of file ShipEntityAI.m.

                          :(NSString *)message
{
    NSArray *components = ScanTokensFromString(message);
    
    if ([components count] == 1)
    {
        [self doScriptEvent:OOJSIDFromString(message)];
    }
    else
    {
        NSString *function = [components objectAtIndex:0];
        components = [components subarrayWithRange:NSMakeRange(1, [components count] - 1)];
        [self doScriptEvent:OOJSIDFromString(function) withArgument:components];
    }
}

sendTargetCommsMessage:

- (void) sendTargetCommsMessage: (NSString *) message

implementation

Provided by category ShipEntity(PureAI).

Definition at line 2085 of file ShipEntityAI.m.

                               :(NSString*) message
{
    ShipEntity *ship = [self primaryTarget];
    if ((ship == nil) || ([ship status] == STATUS_DEAD) || ([ship status] == STATUS_DOCKED))
    {
        [self noteLostTarget];
        return;
    }
    [self sendExpandedMessage:message toShip:[self primaryTarget]];
}

serializeShipSubEntities

- (NSString *) serializeShipSubEntities

Definition at line 813 of file ShipEntity.m.

{   
    NSMutableString     *result = [NSMutableString stringWithCapacity:4];
    NSEnumerator        *subEnum = nil;
    ShipEntity          *se = nil;
    NSUInteger          diff, i = 0;
    
    for (subEnum = [self shipSubEntityEnumerator]; (se = [subEnum nextObject]); )
    {
        diff = [se subIdx] - i;
        i += diff + 1;
        [result appendString:[self repeatString:@"0" times:diff]];
        [result appendString:@"1"];
    }
    // add trailing zeroes
    [result appendString:[self repeatString:@"0" times:[self maxShipSubEntities] - i]];
    return result;
}

References maxShipSubEntities, nil, repeatString:times:, serializeShipSubEntities, shipSubEntityEnumerator, and subIdx.

Referenced by PlayerEntity::commanderDataDictionary, serializeShipSubEntities, and subEntities.

Here is the call graph for this function:

Here is the caller graph for this function:

setAccuracy:

- (void) setAccuracy:

(GLfloat)

new_accuracy

Definition at line 1223 of file ShipEntity.m.

                    :(GLfloat) new_accuracy
{
    if (new_accuracy < 0.0f && scanClass == CLASS_MISSILE)
    {
        new_accuracy = 0.0;
    }
    else if (new_accuracy < -5.0f)
    {
        new_accuracy = -5.0;
    }
    else if (new_accuracy > 10.0f)
    {
        new_accuracy = 10.0;
    }
    accuracy = new_accuracy;
    pitch_tolerance = 0.01 * (85.0f + accuracy);
// especially against small targets, less good pilots will waste some shots
    aim_tolerance = 240.0 - (18.0f * accuracy);
 
    if (accuracy >= COMBAT_AI_ISNT_AWFUL && missile_load_time < 0.1)
    {
        missile_load_time = 2.0; // smart enough not to waste all missiles on 1 ECM!
    }
}

References accuracy, aim_tolerance, COMBAT_AI_ISNT_AWFUL, missile_load_time, pitch_tolerance, and scanClass.

Referenced by setUpShipFromDictionary:, and ShipSetProperty().

Here is the call graph for this function:

Here is the caller graph for this function:

setAfterburnerFactor:

- (void) setAfterburnerFactor:

(GLfloat)

new

Definition at line 4107 of file ShipEntity.m.

                             :(GLfloat)new
{
    afterburner_speed_factor = new;
}

References afterburner_speed_factor.

Referenced by ShipSetProperty().

Here is the caller graph for this function:

setAfterburnerRate:

- (void) setAfterburnerRate:

(GLfloat)

new

Definition at line 4113 of file ShipEntity.m.

                           :(GLfloat)new
{
    afterburner_rate = new;
}

References afterburner_rate.

Referenced by ShipSetProperty().

Here is the caller graph for this function:

setAI:

- (void) setAI:

(AI *)

ai

Definition at line 8002 of file ShipEntity.m.

              :(AI *)ai
{
    [ai retain];
    if (shipAI)
    {
        [shipAI clearAllData];
        [shipAI autorelease];
    }
    shipAI = ai;
}

References AI::clearAllData, and shipAI.

Here is the call graph for this function:

setAIScript:

- (void) setAIScript:

(NSString *)

aiString

Provided by category ShipEntity(AI).

Definition at line 284 of file ShipEntityAI.m.

                    :(NSString *)aiString
{
    NSMutableDictionary     *properties = nil;
    
    properties = [NSMutableDictionary dictionary];
    [properties setObject:self forKey:@"ship"];
    
    [aiScript autorelease];
    aiScript = [OOScript jsAIScriptFromFileNamed:aiString properties:properties];
    if (aiScript == nil)
    {
        OOLog(@"ai.load.failed.unknownAI",@"Unable to load JS AI %@ for ship %@ (%@ for role %@)",aiString,self,[self shipDataKey],[self primaryRole]);
        aiScript = [OOScript jsAIScriptFromFileNamed:@"oolite-nullAI.js" properties:properties];
    }
    else
    {
        aiScriptWakeTime = 0;
        haveStartedJSAI = NO;
    }
    [aiScript retain];
}

Referenced by AI::restorePreviousStateMachine, and ShipEntity(AI)::setAITo:.

Here is the caller graph for this function:

setAIScriptWakeTime:

- (void) setAIScriptWakeTime:

(OOTimeAbsolute)

t

Definition at line 1414 of file ShipEntity.m.

                            :(OOTimeAbsolute) t
{
    aiScriptWakeTime = t;
}

References aiScriptWakeTime.

Referenced by ShipSetProperty().

Here is the caller graph for this function:

setAITo:

- (void) setAITo:

(NSString *)

aiString

Provided by category ShipEntity(AI).

Definition at line 252 of file ShipEntityAI.m.

                :(NSString *)aiString
{
    // don't try to load real AIs if the game hasn't started yet
    if (![PLAYER scriptsLoaded])
    {
        aiString = @"oolite-nullAI.js";
    }
    if ([aiString hasSuffix:@".plist"])
    {
        [[self getAI] setStateMachine:aiString withJSScript:@"oolite-nullAI.js"];
        [self setAIScript:@"oolite-nullAI.js"];
    }
    else if ([aiString hasSuffix:@".js"])
    {
        [[self getAI] setStateMachine:@"nullAI.plist" withJSScript:aiString];
        [self setAIScript:aiString];
    }
    else
    {
        NSString *path = [ResourceManager pathForFileNamed:[aiString stringByAppendingString:@".js"] inFolder:@"AIs"];
        if (path == nil) // no js, use plist
        {
            [self setAITo:[aiString stringByAppendingString:@".plist"]];
        }
        else
        {
            [self setAITo:[aiString stringByAppendingString:@".js"]];
        }
    }
}

Referenced by abandonShip, ShipEntity(PureAI)::becomeUncontrolledThargon, deployEscorts, dockEscorts, getTractoredBy:, Universe::newShipWithRole:, PlayerEntity::resetAutopilotAI, ShipEntity(PureAI)::scanForFormationLeader, PlayerEntity(Scripting)::sendAllShipsAway, ShipEntity(AI)::setAITo:, ShipEntity(PureAI)::setPlanetPatrolCoordinates, setStateMachine:, setUpShipFromDictionary:, ShipEntity(LoadRestore)::shipRestoredFromDictionary:useFallback:context:, ShipSetAI(), PlayerEntity::showShipModelWithKey:shipData:personality:factorX:factorY:factorZ:inContext:, and ShipEntity(AI)::switchAITo:.

Here is the caller graph for this function:

setAutoCloak:

- (void) setAutoCloak:

(BOOL)

automatic

Definition at line 6695 of file ShipEntity.m.

                    :(BOOL)automatic
{
    cloakAutomatic = !!automatic;
}

References cloakAutomatic.

Referenced by ShipSetProperty().

Here is the caller graph for this function:

setBeaconCode:

- (void) setBeaconCode: (NSString *) bcode

implementation

Reimplemented from <OOBeaconEntity>.

Definition at line 1552 of file ShipEntity.m.

                      :(NSString *)bcode
{
    if ([bcode length] == 0)  bcode = nil;
    
    if (_beaconCode != bcode)
    {
        [_beaconCode release];
        _beaconCode = [bcode copy];
        
        DESTROY(_beaconDrawable);
    }
    // if not blanking code and label is currently blank, default label to code
    if (bcode != nil && (_beaconLabel == nil || [_beaconLabel length] == 0))
    {
        [self setBeaconLabel:bcode];
    }
}

References _beaconCode, _beaconDrawable, _beaconLabel, DESTROY, nil, and setBeaconLabel:.

Referenced by WormholeEntity::disgorgeShips, setUpShipFromDictionary:, and ShipSetProperty().

Here is the call graph for this function:

Here is the caller graph for this function:

setBeaconLabel:

- (void) setBeaconLabel: (NSString *) blabel

implementation

Reimplemented from <OOBeaconEntity>.

Definition at line 1577 of file ShipEntity.m.

                       :(NSString *)blabel
{
    if ([blabel length] == 0)  blabel = nil;
    
    if (_beaconLabel != blabel)
    {
        [_beaconLabel release];
        _beaconLabel = [OOExpand(blabel) retain];
    }
}

References _beaconLabel, and nil.

Referenced by setBeaconCode:, setUpShipFromDictionary:, and ShipSetProperty().

Here is the caller graph for this function:

setBehaviour:

- (void) setBehaviour:

(OOBehaviour)

cond

Definition at line 10250 of file ShipEntity.m.

                     :(OOBehaviour) cond
{
    if (cond != behaviour)
    {
        frustration = 0.0;   // change is a GOOD thing
        behaviour = cond;
    }
}

References behaviour, and frustration.

Referenced by launchCascadeMine, PlayerEntity::launchMine:, PlayerEntity(Scripting)::processSceneString:atOffset:, setUpOneStandardSubentity:asTurret:, and takeEnergyDamage:from:becauseOf:weaponIdentifier:.

Here is the caller graph for this function:

setBounty:

- (void) setBounty:

(OOCreditsQuantity)

amount

Reimplemented in PlayerEntity.

Definition at line 8246 of file ShipEntity.m.

                  :(OOCreditsQuantity) amount
{
    [self setBounty:amount withReason:kOOLegalStatusReasonUnknown];
}

References setBounty:withReason:.

Here is the call graph for this function:

setBounty:withReason:

- (void) setBounty:		(OOCreditsQuantity)	amount
withReason:		(OOLegalStatusReason)	reason

Reimplemented in PlayerEntity.

Definition at line 8252 of file ShipEntity.m.

                  :(OOCreditsQuantity) amount withReason:(OOLegalStatusReason)reason
{
    if ([self isSubEntity]) 
    {
        [[self parentEntity] setBounty:amount withReason:reason];
    }
    else 
    {
        if ((scanClass == CLASS_THARGOID || scanClass == CLASS_STATION) && reason != kOOLegalStatusReasonSetup && reason != kOOLegalStatusReasonByScript)
        {
            return; // no standard bounties for Thargoids / Stations
        }
        if (scanClass == CLASS_POLICE && amount != 0)
        {
            return; // police never have bounties
        }
        NSString* nReason = OOStringFromLegalStatusReason(reason);
        [self setBounty:amount withReasonAsString:nReason];
    }
}

References Entity::isSubEntity, OOStringFromLegalStatusReason(), Entity::parentEntity, scanClass, setBounty:withReason:, and setBounty:withReasonAsString:.

Referenced by Universe::addShipAt:withRole:withinRadius:, becomeExplosion, WormholeEntity::disgorgeShips, interpretAIMessage:, StationEntity::launchIndependentShip:, StationEntity::launchPatrol, StationEntity::launchPirateShip, StationEntity::launchPolice, Universe::newShipWithRole:, setBounty:, setBounty:withReason:, ShipEntity(Private)::setUpOneEscort:inGroup:withRole:atPosition:andCount:, setUpShipFromDictionary:, ShipSetProperty(), update:, and Universe::witchspaceShipWithPrimaryRole:.

Here is the call graph for this function:

Here is the caller graph for this function:

setBounty:withReasonAsString:

- (void) setBounty:		(OOCreditsQuantity)	amount
withReasonAsString:		(NSString *)	reason

Reimplemented in PlayerEntity.

Definition at line 8273 of file ShipEntity.m.

                  :(OOCreditsQuantity) amount withReasonAsString:(NSString*)reason
{
    if ([self isSubEntity]) 
    {
        [[self parentEntity] setBounty:amount withReasonAsString:reason];
    }
    else 
    {
        JSContext *context = OOJSAcquireContext();
    
        jsval amountVal = JSVAL_VOID;
        JS_NewNumberValue(context, (int)amount-(int)bounty, &amountVal);
 
        bounty = amount; // can't set the new bounty until the size of the change is known
 
        jsval reasonVal = OOJSValueFromNativeObject(context,reason);
        
        ShipScriptEvent(context, self, "shipBountyChanged", amountVal, reasonVal);
        
        OOJSRelinquishContext(context);
 
    }
}

References bounty, Entity::isSubEntity, OOJSAcquireContext(), OOJSRelinquishContext(), OOJSValueFromNativeObject(), Entity::parentEntity, setBounty:withReasonAsString:, and ShipScriptEvent.

Referenced by setBounty:withReason:, setBounty:withReasonAsString:, and ShipSetBounty().

Here is the call graph for this function:

Here is the caller graph for this function:

setCargo:

- (void) setCargo:

(NSArray *)

some_cargo

Definition at line 8449 of file ShipEntity.m.

                 :(NSArray *) some_cargo
{
    [cargo removeAllObjects];
    [cargo addObjectsFromArray:some_cargo];
}

Referenced by setCargoFlag:.

Here is the caller graph for this function:

setCargoFlag:

- (void) setCargoFlag:

(OOCargoFlag)

flag

Definition at line 8517 of file ShipEntity.m.

                     :(OOCargoFlag) flag
{
    if (cargo_flag != flag)
    {
        cargo_flag = flag;
        NSArray *newCargo = nil;
        unsigned num = 0;
        if (likely_cargo > 0)
        {
            num = likely_cargo * (0.5+randf());
            if (num > [self maxAvailableCargoSpace])
            {
                num = [self maxAvailableCargoSpace];
            }
        }
        else
        {
            num = [self maxAvailableCargoSpace];
        }
        if (num > 200)
        {
            num = 200; 
            /* no core NPC ship carries this much when generated (the
             * Anaconda could, but doesn't): let's not waste time generating
             * thousands of pods - even if they are semi-virtual - for some
             * massive OXP ship */
        }
        if (num > 0)
        {
            switch (cargo_flag)
            {
            case CARGO_FLAG_FULL_UNIFORM:
                newCargo = [UNIVERSE getContainersOfCommodity:[shipinfoDictionary oo_stringForKey:@"cargo_carried"] :num];
                break;
            case CARGO_FLAG_FULL_PLENTIFUL:
                newCargo = [UNIVERSE getContainersOfGoods:num scarce:NO legal:YES];
                break;
            case CARGO_FLAG_FULL_SCARCE:
                newCargo = [UNIVERSE getContainersOfGoods:num scarce:YES legal:YES];
                break;
            case CARGO_FLAG_FULL_MEDICAL:
                newCargo = [UNIVERSE getContainersOfCommodity:@"Narcotics" :num];
                break;
            case CARGO_FLAG_FULL_CONTRABAND:
                newCargo = [UNIVERSE getContainersOfGoods:num scarce:YES legal:NO];
                break;
            case CARGO_FLAG_PIRATE:
                newCargo = [UNIVERSE getContainersOfGoods:(Ranrot() % (1+num/2)) scarce:YES legal:NO];
                break;
            case CARGO_FLAG_FULL_PASSENGERS:
                // TODO: allow passengers to survive
            case CARGO_FLAG_NONE:
            default:
                break;
            }
        }
        [self setCargo:newCargo];
    }
}

References cargo_flag, CARGO_FLAG_FULL_CONTRABAND, CARGO_FLAG_FULL_MEDICAL, CARGO_FLAG_FULL_PASSENGERS, CARGO_FLAG_FULL_PLENTIFUL, CARGO_FLAG_FULL_SCARCE, CARGO_FLAG_FULL_UNIFORM, CARGO_FLAG_NONE, CARGO_FLAG_PIRATE, likely_cargo, maxAvailableCargoSpace, nil, randf(), and setCargo:.

Referenced by Universe::addShipAt:withRole:withinRadius:, StationEntity::launchEscort, StationEntity::launchIndependentShip:, PlanetEntity::launchShuttle, StationEntity::launchShuttle, ShipSetCargoType(), and Universe::witchspaceShipWithPrimaryRole:.

Here is the call graph for this function:

Here is the caller graph for this function:

setCloaked:

- (void) setCloaked:

(BOOL)

cloak

Definition at line 6682 of file ShipEntity.m.

                  :(BOOL)cloak
{
    if (cloak)  [self activateCloakingDevice];
    else  [self deactivateCloakingDevice];
}

References activateCloakingDevice, and deactivateCloakingDevice.

Referenced by removeEquipmentItem:, and ShipSetProperty().

Here is the call graph for this function:

Here is the caller graph for this function:

setCommodity:andAmount:

- (void) setCommodity:		(OOCommodityType)	co_type
andAmount:		(OOCargoQuantity)	co_amount

Definition at line 8322 of file ShipEntity.m.

                     :(OOCommodityType)co_type andAmount:(OOCargoQuantity)co_amount
{
    if (co_type != nil)
    {
        /* The tmp variable is needed as scoopUp can cause the method
         * to be passed a reference to self.commodity_type, so DESTROY
         * then copying the parameter segfaults */
        NSString *tmp = [co_type copy];
        DESTROY(commodity_type);
        commodity_type = tmp;
        commodity_amount = co_amount;
    }
}

References commodity_amount, commodity_type, DESTROY, and nil.

Referenced by PlayerEntity(ScriptMethods)::awardCommodityType:amount:, becomeExplosion, Universe::cargoPodFromTemplate:, PlayerEntity::createCargoPodWithType:andAmount:, Universe::fillCargopodWithRandomCargo:, ShipEntity(Private)::launchPodWithCrew:, PlayerEntity::loadCargoPodsForType:amount:, setCommodityForPod:andAmount:, Universe(OOPrivate)::setUpCargoPods, and PlayerEntity::unloadCargoPodsForType:amount:.

Here is the caller graph for this function:

setCommodityForPod:andAmount:

- (void) setCommodityForPod:		(OOCommodityType)	co_type
andAmount:		(OOCargoQuantity)	co_amount

Definition at line 8337 of file ShipEntity.m.

                           :(OOCommodityType)co_type andAmount:(OOCargoQuantity)co_amount
{
    // can be nil for pods
    if (co_type == nil)
    {
        DESTROY(commodity_type);
        commodity_amount = 0;
        return;
    }
    // pod content should never be greater than 1 ton or this will give cargo counting problems elsewhere in the code.
    // so do first a mass check for cargo added by script/plist.
    OOMassUnit    unit = [[UNIVERSE commodityMarket] massUnitForGood:co_type];
    if (unit == UNITS_TONS && co_amount > 1) co_amount = 1;
    else if (unit == UNITS_KILOGRAMS && co_amount > 1000) co_amount = 1000;
    else if (unit == UNITS_GRAMS && co_amount > 1000000) co_amount = 1000000;
    [self setCommodity:co_type andAmount:co_amount];
}

References commodity_amount, commodity_type, DESTROY, nil, setCommodity:andAmount:, UNITS_GRAMS, UNITS_KILOGRAMS, and UNITS_TONS.

Referenced by setUpShipFromDictionary:, and ShipSetCargo().

Here is the call graph for this function:

Here is the caller graph for this function:

setCommsMessageColor

- (void) setCommsMessageColor

Definition at line 14229 of file ShipEntity.m.

{
    float hue = 0.0625f * (universalID & 15);
    [[UNIVERSE commLogGUI] setTextColor:[OOColor colorWithHue:hue saturation:0.375f brightness:1.0f alpha:1.0f]];
    if (scanClass == CLASS_THARGOID)
        [[UNIVERSE commLogGUI] setTextColor:[OOColor greenColor]];
    if (scanClass == CLASS_POLICE)
        [[UNIVERSE commLogGUI] setTextColor:[OOColor cyanColor]];
}

References OOColor::colorWithHue:saturation:brightness:alpha:, OOColor::cyanColor, OOColor::greenColor, scanClass, setCommsMessageColor, and Entity::universalID.

Referenced by broadcastMessage:withUnpilotedOverride:, sendMessage:toShip:withUnpilotedOverride:, setCommsMessageColor, and sunGlareFilter.

Here is the call graph for this function:

Here is the caller graph for this function:

setCoordinate:

- (void) setCoordinate:

(HPVector)

coord

Definition at line 10270 of file ShipEntity.m.

                      :(HPVector) coord // The name "setCoordinates" is already used by AI scripting.
{
    coordinates = coord;
}

References coordinates.

Referenced by ShipSetProperty().

Here is the caller graph for this function:

setCoordinates:

- (void) setCoordinates: (NSString *) system_x_y_z

implementation

Provided by category ShipEntity(PureAI).

Definition at line 2447 of file ShipEntityAI.m.

                       :(NSString *)system_x_y_z
{
    NSArray*    tokens = ScanTokensFromString(system_x_y_z);
    NSString*   systemString = nil;
    NSString*   xString = nil;
    NSString*   yString = nil;
    NSString*   zString = nil;
    
    if ([tokens count] != 4)
    {
        OOLog(@"ai.syntax.setCoordinates", @"***** ERROR: cannot setCoordinates: '%@'.",system_x_y_z);
        return;
    }
    
    systemString = (NSString *)[tokens objectAtIndex:0];
    xString = (NSString *)[tokens objectAtIndex:1];
    if ([xString hasPrefix:@"rand:"])
        xString = [NSString stringWithFormat:@"%.3f", bellf([(NSString*)[[xString componentsSeparatedByString:@":"] objectAtIndex:1] intValue])];
    yString = (NSString *)[tokens objectAtIndex:2];
    if ([yString hasPrefix:@"rand:"])
        yString = [NSString stringWithFormat:@"%.3f", bellf([(NSString*)[[yString componentsSeparatedByString:@":"] objectAtIndex:1] intValue])];
    zString = (NSString *)[tokens objectAtIndex:3];
    if ([zString hasPrefix:@"rand:"])
        zString = [NSString stringWithFormat:@"%.3f", bellf([(NSString*)[[zString componentsSeparatedByString:@":"] objectAtIndex:1] intValue])];
    
    HPVector posn = make_HPvector([xString floatValue], [yString floatValue], [zString floatValue]);
    GLfloat scalar = 1.0;
    
    coordinates = [UNIVERSE coordinatesForPosition:posn withCoordinateSystem:systemString returningScalar:&scalar];
    
    [shipAI message:@"APPROACH_COORDINATES"];
}

setCoordinatesFromPosition

- (void) setCoordinatesFromPosition

implementation

Provided by category ShipEntity(PureAI).

Definition at line 1225 of file ShipEntityAI.m.

{
    coordinates = position;
}

setCourseToPlanet

- (void) setCourseToPlanet

implementation

Provided by category ShipEntity(PureAI).

Definition at line 1311 of file ShipEntityAI.m.

{
    /*- selects the nearest planet it can find -*/
    OOPlanetEntity  *the_planet =  [self findNearestPlanetExcludingMoons];
    if (the_planet)
    {
        double variation = (aegis_status == AEGIS_NONE ? 0.5 : 0.2); // more random deviation when far from planet.
        HPVector p_pos = the_planet->position;
        double p_cr = the_planet->collision_radius;     // the surface
        HPVector p1 = HPvector_between(p_pos, position);
        p1 = HPvector_normal(p1);           // vector towards ship
        p1.x += variation * (randf() - variation);
        p1.y += variation * (randf() - variation);
        p1.z += variation * (randf() - variation);
        p1 = HPvector_normal(p1); 
        _destination = HPvector_add(p_pos, HPvector_multiply_scalar(p1, p_cr)); // on surface
        desired_range = collision_radius + 100.0;  // +100m from the destination
    }
    else
    {
        [shipAI message:@"NO_PLANET_FOUND"];
    }
}

setCourseToWitchpoint

- (void) setCourseToWitchpoint

implementation

Provided by category ShipEntity(PureAI).

Definition at line 1604 of file ShipEntityAI.m.

{
    if (UNIVERSE)
    {
        _destination = [UNIVERSE getWitchspaceExitPosition];
        desired_range = 10000.0;   // 10km away
    }
}

setCrew:

- (void) setCrew:

(NSArray *)

crewArray

Definition at line 7951 of file ShipEntity.m.

                :(NSArray *)crewArray
{
    if ([self isExplicitlyUnpiloted])
    {
        //unpiloted ships cannot have crew
        // but may have crew before isExplicitlyUnpiloted set, so force *that* to clear too
        [crew autorelease];
        crew = nil;
        return;
    }
    //do not set to hulk here when crew is nil (or 0).  Some things like missiles have no crew.
    [crew autorelease];
    crew = [crewArray copy];
}

References crew, isExplicitlyUnpiloted, and nil.

Referenced by Universe::addShipAt:withRole:withinRadius:, Universe::addShipWithRole:launchPos:rfactor:, launchEscapeCapsule, ShipEntity(Private)::launchPodWithCrew:, PlayerEntity(Contracts)::processEscapePods, setSingleCrewWithRole:, setUpShipFromDictionary:, ShipSetCrew(), and Universe::witchspaceShipWithPrimaryRole:.

Here is the call graph for this function:

Here is the caller graph for this function:

setDemoShip:

- (void) setDemoShip:

(OOScalar)

demoRate

Definition at line 14606 of file ShipEntity.m.

                    : (OOScalar) rate
{
    demoStartOrientation = orientation;
    demoRate = rate;
    isDemoShip = YES;
    [self setPitch: 0.0f];
    [self setRoll: 0.0f];
}

References demoRate, demoStartOrientation, isDemoShip, Entity::orientation, setPitch:, and setRoll:.

Referenced by Universe::makeDemoShipWithRole:spinning:, Universe::setupIntroFirstGo:, PlayerEntity::showShipModelWithKey:shipData:personality:factorX:factorY:factorZ:inContext:, and Universe::update:.

Here is the call graph for this function:

Here is the caller graph for this function:

setDemoStartTime:

- (void) setDemoStartTime:

(OOTimeAbsolute)

time

Definition at line 14620 of file ShipEntity.m.

                         : (OOTimeAbsolute) time
{
    demoStartTime = time;
}

References demoStartTime.

Referenced by Universe::setupIntroFirstGo:, PlayerEntity::showShipModelWithKey:shipData:personality:factorX:factorY:factorZ:inContext:, and Universe::update:.

Here is the caller graph for this function:

setDesiredRange:

- (void) setDesiredRange:

(double)

amount

Definition at line 8602 of file ShipEntity.m.

                        :(double) amount
{
    desired_range = amount;
}

References desired_range.

Referenced by ShipSetProperty().

Here is the caller graph for this function:

setDesiredRangeForWaypoint

- (void) setDesiredRangeForWaypoint

implementation

Provided by category ShipEntity(PureAI).

Definition at line 916 of file ShipEntityAI.m.

{
    desired_range = fmax(maxFlightSpeed / max_flight_pitch / 6, 50.0); // some ships need a longer range to reach a waypoint.
}

setDesiredRangeTo:

- (void) setDesiredRangeTo: (NSString *) rangeString

implementation

Provided by category ShipEntity(PureAI).

Definition at line 911 of file ShipEntityAI.m.

                          :(NSString *)rangeString
{
    desired_range = [rangeString doubleValue];
}

setDesiredSpeed:

- (void) setDesiredSpeed:

(double)

amount

Definition at line 8584 of file ShipEntity.m.

                        :(double) amount
{
    desired_speed = amount;
}

References desired_speed.

Referenced by PlayerEntity::launchEscapeCapsule, DockEntity::launchShip:, ShipSetProperty(), and takeEnergyDamage:from:becauseOf:weaponIdentifier:.

Here is the caller graph for this function:

setDestination:

- (void) setDestination:

(HPVector)

dest

Definition at line 13675 of file ShipEntity.m.

                       :(HPVector) dest
{
    _destination = dest;
    frustration = 0.0;   // new destination => no frustration!
}

References _destination, and frustration.

Referenced by Universe::setupIntroFirstGo:, and Universe::update:.

Here is the caller graph for this function:

setDestinationFromCoordinates

- (void) setDestinationFromCoordinates

implementation

Provided by category ShipEntity(PureAI).

Definition at line 1219 of file ShipEntityAI.m.

{
    _destination = coordinates;
}

setDestinationSystem:

- (void) setDestinationSystem:

(OOSystemID)

s

Definition at line 7923 of file ShipEntity.m.

                             :(OOSystemID)s
{
    destination_system = s;
}

References destination_system.

Referenced by ShipSetProperty().

Here is the caller graph for this function:

setDestinationToCurrentLocation

- (void) setDestinationToCurrentLocation

implementation

Provided by category ShipEntity(PureAI).

Definition at line 896 of file ShipEntityAI.m.

{
    // randomly add a .5m variance
    _destination = HPvector_add(position, OOHPVectorRandomSpatial(0.5));
}

setDestinationToDockingAbort

- (void) setDestinationToDockingAbort

implementation

Provided by category ShipEntity(PureAI).

Definition at line 2211 of file ShipEntityAI.m.

{
    Entity *the_target = [self targetStation];
    if (!the_target) {
        /* Probably the player trying to dock with docking computer
         * from out of scanner range */
        the_target = [UNIVERSE station];
    }
    double bo_distance = 8000; //   8km back off
    HPVector v0 = position;
    HPVector d0 = (the_target) ? the_target->position : kZeroHPVector;
    v0.x += (randf() - 0.5)*collision_radius;  v0.y += (randf() - 0.5)*collision_radius;  v0.z += (randf() - 0.5)*collision_radius;
    v0.x -= d0.x;  v0.y -= d0.y;  v0.z -= d0.z;
    v0 = HPvector_normal_or_fallback(v0, make_HPvector(0, 0, -1));
    
    v0.x *= bo_distance;    v0.y *= bo_distance;    v0.z *= bo_distance;
    v0.x += d0.x;  v0.y += d0.y;  v0.z += d0.z;
    coordinates = v0;
    _destination = v0;
}

setDestinationToJinkPosition

- (void) setDestinationToJinkPosition

implementation

Provided by category ShipEntity(PureAI).

Definition at line 903 of file ShipEntityAI.m.

{
    Vector front = vector_multiply_scalar([self forwardVector], flightSpeed / max_flight_pitch * 2);
    _destination = HPvector_add(position, vectorToHPVector(vector_add(front, OOVectorRandomSpatial(100))));
    pitching_over = YES; // don't complete roll first, but immediately start with pitching. 
}

setDestinationToStationBeacon

- (void) setDestinationToStationBeacon

implementation

Provided by category ShipEntity(PureAI).

Definition at line 1620 of file ShipEntityAI.m.

{
    if ([UNIVERSE station])
    {
        _destination = [[UNIVERSE station] beaconPosition];
    }
}

setDestinationToTarget

- (void) setDestinationToTarget

implementation

Provided by category ShipEntity(PureAI).

Definition at line 1425 of file ShipEntityAI.m.

{
    Entity *the_target = [self primaryTarget];
    if (the_target)
        _destination = the_target->position;
}

setDestinationToWitchpoint

- (void) setDestinationToWitchpoint

implementation

Provided by category ShipEntity(PureAI).

Definition at line 1614 of file ShipEntityAI.m.

{
    _destination = [UNIVERSE getWitchspaceExitPosition];
}

setDestinationWithinTarget

- (void) setDestinationWithinTarget

implementation

Provided by category ShipEntity(PureAI).

Definition at line 1433 of file ShipEntityAI.m.

{
    Entity *the_target = [self primaryTarget];
    if (the_target)
    {
        HPVector pos = the_target->position;
        Quaternion q;   quaternion_set_random(&q);
        Vector v = vector_forward_from_quaternion(q);
        GLfloat d = (randf() - randf()) * the_target->collision_radius;
        _destination = make_HPvector(pos.x + d * v.x, pos.y + d * v.y, pos.z + d * v.z);
    }
}

setDisplayName:

- (void) setDisplayName:

(NSString *)

inName

Definition at line 7229 of file ShipEntity.m.

                       :(NSString *)inName
{
    [displayName release];
    displayName = [inName copy];
}

References displayName.

Referenced by setUpOneStandardSubentity:asTurret:, and ShipSetProperty().

Here is the caller graph for this function:

setEnergyRechargeRate:

- (void) setEnergyRechargeRate:

(GLfloat)

new

Definition at line 7508 of file ShipEntity.m.

                              :(GLfloat)new
{
    energy_recharge_rate = new;
}

References energy_recharge_rate.

Referenced by ShipSetProperty().

Here is the caller graph for this function:

setEntityPersonalityInt:

- (void) setEntityPersonalityInt:

(uint16_t)

value

Definition at line 9784 of file ShipEntity.m.

                                :(uint16_t)value
{
    if (value <= ENTITY_PERSONALITY_MAX)
    {
        entity_personality = value;
        [[self mesh] rebindMaterials];
    }
}

References entity_personality, ENTITY_PERSONALITY_MAX, mesh, and OOMesh::rebindMaterials.

Referenced by PlayerEntity(Contracts)::buySelectedShip, PlayerEntity(LoadSave)::loadPlayerFromFile:asNew:, MissionRunScreen(), PlayerReplaceShip(), PlayerEntity(Contracts)::replaceShipWithNamedShip:, setUpOneStandardSubentity:asTurret:, ShipSetProperty(), and PlayerEntity::showShipModelWithKey:shipData:personality:factorX:factorY:factorZ:inContext:.

Here is the call graph for this function:

Here is the caller graph for this function:

setEscortDestination:

- (void) setEscortDestination:

(HPVector)

dest

Definition at line 13682 of file ShipEntity.m.

                             :(HPVector) dest
{
    _destination = dest; // don't reset frustration for escorts.
}

References _destination.

Referenced by ShipSetProperty(), and update:.

Here is the caller graph for this function:

setEscortGroup:

- (void) setEscortGroup:

(OOShipGroup *)

group

Definition at line 6944 of file ShipEntity.m.

                       :(OOShipGroup *)group
{
    if (group != _escortGroup)
    {
        [_escortGroup release];
        _escortGroup = [group retain];
        [group setLeader:self];    // A ship is always leader of its own escort group.
        [self updateEscortFormation];
    }
}

References _escortGroup, group, OOShipGroup::setLeader:, and updateEscortFormation.

Referenced by ShipEntity(LoadRestore)::shipRestoredFromDictionary:useFallback:context:, and update:.

Here is the call graph for this function:

Here is the caller graph for this function:

setEvasiveJink:

- (void) setEvasiveJink:

(GLfloat)

z

Definition at line 10409 of file ShipEntity.m.

                       :(GLfloat) z
{
    if (accuracy < COMBAT_AI_ISNT_AWFUL)
    {
        jink = kZeroVector;
    }
    else 
    {
        jink.x = (ranrot_rand() % 256) - 128.0;
        jink.y = (ranrot_rand() % 256) - 128.0;
        jink.z = z;
        
        // make sure we don't accidentally have near-zero jink
        if (jink.x < 0.0) 
        {
            jink.x -= 128.0;
        }
        else
        {
            jink.x += 128.0;
        }
        if (jink.y < 0) 
        {
            jink.y -= 128.0;
        }
        else
        {
            jink.y += 128.0;
        }
    }
}

References accuracy, COMBAT_AI_ISNT_AWFUL, jink, kZeroVector, and ranrot_rand.

Referenced by behaviour_attack_broadside_target:leftside:, behaviour_attack_fly_from_target:, behaviour_attack_fly_to_target:, behaviour_attack_sniper:, behaviour_attack_target:, behaviour_evasive_action:, ShipEntity(AI)::performFlee, and trackPrimaryTarget:delta_t:.

Here is the caller graph for this function:

setExhaustEmissiveColor:

- (void) setExhaustEmissiveColor:

(OOColor *)

color

Definition at line 11707 of file ShipEntity.m.

                                :(OOColor *) color
{
    if (color)
    {
        [exhaust_emissive_color release];
        exhaust_emissive_color = [color retain];
    }
}

References exhaust_emissive_color.

Referenced by ShipSetProperty().

Here is the caller graph for this function:

setFoundTarget:

- (void) setFoundTarget:

(Entity *)

targetEntity

Reimplemented in PlayerEntity.

Definition at line 9930 of file ShipEntity.m.

                       :(Entity *) targetEntity
{
    [_foundTarget release];
    _foundTarget = [targetEntity weakRetain];
}

References _foundTarget, and OOWeakRefObject::weakRetain.

Referenced by ShipEntity(OOAIPrivate)::acceptDistressMessageFrom:, broadcastEnergyBlastImminent, broadcastHitByLaserFrom:, enterWormhole:replacing:, ShipEntity(PureAI)::fightOrFleeHostiles, ShipEntity(PureAI)::fightOrFleeMissile, fireSubentityLaserShot:, ShipEntity(AI)::groupAttackTarget, ShipEntity(OOAIPrivate)::performHyperSpaceExitReplace:toSystem:, ShipEntity(PureAI)::recallStoredTarget, ShipEntity(PureAI)::requestNewTarget, respondToAttackFrom:becauseOf:, ShipEntity(PureAI)::scanForFormationLeader, ShipEntity(AI)::scanForHostiles, ShipEntity(PureAI)::scanForLoot, ShipEntity(PureAI)::scanForNearestMerchantman, ShipEntity(OOAIPrivate)::scanForNearestShipWithPredicate:parameter:, ShipEntity(PureAI)::scanForNonThargoid, ShipEntity(PureAI)::scanForOffenders, ShipEntity(PureAI)::scanForRandomLoot, ShipEntity(PureAI)::scanForRandomMerchantman, ShipEntity(PureAI)::scanForRocks, ShipSetProperty(), takeEnergyDamage:from:becauseOf:weaponIdentifier:, and StationEntity::takeEnergyDamage:from:becauseOf:weaponIdentifier:.

Here is the call graph for this function:

Here is the caller graph for this function:

setFuel:

- (void) setFuel:

(OOFuelQuantity)

amount

Definition at line 8110 of file ShipEntity.m.

                :(OOFuelQuantity) amount
{
    if (amount > [self fuelCapacity])  amount = [self fuelCapacity];
    
    fuel = amount;
}

References fuel, and fuelCapacity.

Referenced by ShipEntity(PureAI)::addFuel:, PlayerEntity(Scripting)::awardEquipment:, PlayerEntity(Scripting)::awardFuel:, PlayerEntity::doBookkeeping:, StationEntity::launchIndependentShip:, Universe::makeSunSkimmer:andSetAI:, PlayerEntity(Contracts)::newShipCommonSetup:yardInfo:baseInfo:, PlayerEntity(Scripting)::sendAllShipsAway, PlayerEntity(Scripting)::setFuelLeak:, ShipSetProperty(), and update:.

Here is the call graph for this function:

Here is the caller graph for this function:

setGroup:

- (void) setGroup:

(OOShipGroup *)

group

Definition at line 6914 of file ShipEntity.m.

                 :(OOShipGroup *)group
{
    if (group != _group)
    {
        if (_escortGroup != _group) 
        {
            if (self == [_group leader])  [_group setLeader:nil];
            [_group removeShip:self];
        }
        [_group release];
        [group addShip:self];
        _group = [group retain];
        
        [[group leader] updateEscortFormation];
    }
}

References _escortGroup, _group, OOShipGroup::addShip:, group, OOShipGroup::leader, OOShipGroup::removeShip:, OOShipGroup::setLeader:, and updateEscortFormation.

Referenced by abandonShip, acceptAsEscort:, Universe::addShipsAt:withRole:quantity:withinRadius:asGroup:, ShipEntity(PureAI)::becomeUncontrolledThargon, deployEscorts, dockEscorts, ShipEntity(PureAI)::escortCheckMother, fireMissileWithIdentifier:andTarget:, StationEntity::launchDefenseShip, StationEntity::launchIndependentShip:, StationEntity::launchMiner, StationEntity::launchPatrol, StationEntity::launchPirateShip, StationEntity::launchPolice, StationEntity::launchScavenger, StationEntity::launchShipWithRole:, OOShipGroup::removeShip:, setUpEscorts, ShipEntity(Private)::setUpMixedEscorts, ShipEntity(Private)::setUpOneEscort:inGroup:withRole:atPosition:andCount:, StationEntity::setUpShipFromDictionary:, ShipGroupAddShip(), ShipEntity(LoadRestore)::shipRestoredFromDictionary:useFallback:context:, ShipSetProperty(), ShipEntity(AI)::suggestEscortTo:, and ShipEntity(PureAI)::thargonCheckMother.

Here is the call graph for this function:

Here is the caller graph for this function:

setHeatInsulation:

- (void) setHeatInsulation:

(GLfloat)

value

Definition at line 8827 of file ShipEntity.m.

                          :(GLfloat) value
{
    _heatInsulation = value;
}

References _heatInsulation.

Referenced by Universe::addWreckageFrom:withRole:at:scale:lifetime:, StationEntity::launchDefenseShip, StationEntity::launchMiner, StationEntity::launchPatrol, StationEntity::launchPirateShip, StationEntity::launchPolice, StationEntity::launchScavenger, Universe::makeSunSkimmer:andSetAI:, PlayerEntity::setCommanderDataFromDictionary:, ShipEntity(Private)::setUpOneEscort:inGroup:withRole:atPosition:andCount:, setUpShipFromDictionary:, and ShipSetProperty().

Here is the caller graph for this function:

setHomeSystem:

- (void) setHomeSystem:

(OOSystemID)

s

Definition at line 7917 of file ShipEntity.m.

                      :(OOSystemID)s
{
    home_system = s;
}

References home_system.

Referenced by ShipSetProperty().

Here is the caller graph for this function:

setHulk:

- (void) setHulk:

(BOOL)

isNowHulk

Definition at line 8966 of file ShipEntity.m.

                :(BOOL)isNowHulk
{
    if (![self isSubEntity]) 
    {
        isHulk = isNowHulk;
    }
}

References isHulk, and Entity::isSubEntity.

Referenced by launchEscapeCapsule, and setUpShipFromDictionary:.

Here is the caller graph for this function:

setHyperspaceSpinTime:

- (void) setHyperspaceSpinTime:

(float)

new

Definition at line 3219 of file ShipEntity.m.

                              :(float)new
{
    hyperspaceMotorSpinTime = new;
}

References hyperspaceMotorSpinTime.

Referenced by ShipSetProperty().

Here is the caller graph for this function:

setIsBoulder:

- (void) setIsBoulder:

(BOOL)

flag

Definition at line 1659 of file ShipEntity.m.

                     :(BOOL)flag
{
    if (flag)  [self addRole:kBoulderRole];
    else  [self removeRole:kBoulderRole];
}

References addRole:, and removeRole:.

Referenced by becomeExplosion, and ShipSetProperty().

Here is the call graph for this function:

Here is the caller graph for this function:

setIsMissileFlag:

- (void) setIsMissileFlag:

(BOOL)

newValue

Definition at line 12323 of file ShipEntity.m.

                         :(BOOL)newValue
{
    isMissile = !!newValue; // set the isMissile flag, used for tracking submunitions and preventing collisions at launch.
}

References isMissile.

Referenced by fireMissileWithIdentifier:andTarget:, and ShipEntity(ScriptMethods)::spawnShipsWithRole:count:.

Here is the caller graph for this function:

setIsWreckage:

- (void) setIsWreckage:

(BOOL)

isw

Definition at line 9158 of file ShipEntity.m.

                      :(BOOL)isw
{
    isWreckage = isw;
}

References isWreckage.

Referenced by Universe::addWreckageFrom:withRole:at:scale:lifetime:.

Here is the caller graph for this function:

setLaserColor:

- (void) setLaserColor:

(OOColor *)

color

Definition at line 11697 of file ShipEntity.m.

                      :(OOColor *) color
{
    if (color)
    {
        [laser_color release];
        laser_color = [color retain];
    }
}

References laser_color.

Referenced by setWeaponDataFromType:.

Here is the caller graph for this function:

setLastAegisLock:

- (void) setLastAegisLock:

(Entity<OOStellarBody> *)

lastAegisLock

Definition at line 7898 of file ShipEntity.m.

                         :(Entity<OOStellarBody> *)lastAegisLock
{
    [_lastAegisLock release];
    _lastAegisLock = [lastAegisLock weakRetain];
}

References _lastAegisLock.

Referenced by checkForAegis, and PlayerEntity::completeSetUpAndSetTarget:.

Here is the caller graph for this function:

setLastEscortTarget:

- (void) setLastEscortTarget:

(Entity *)

targetEntity

Definition at line 9968 of file ShipEntity.m.

                            :(Entity *) targetEntity
{
    [_lastEscortTarget release];
    _lastEscortTarget = [targetEntity weakRetain];
}

References _lastEscortTarget, and OOWeakRefObject::weakRetain.

Referenced by deployEscorts.

Here is the call graph for this function:

Here is the caller graph for this function:

setLaunchDelay:

- (void) setLaunchDelay:

(double)

delay

Definition at line 7939 of file ShipEntity.m.

                       :(double)delay
{
    launch_delay = delay;
}

References launch_delay.

Referenced by DockEntity::launchShip:.

Here is the caller graph for this function:

setMaxAvailableCargoSpace:

- (void) setMaxAvailableCargoSpace:

(OOCargoQuantity)

new

Definition at line 8374 of file ShipEntity.m.

                                  :(OOCargoQuantity)new
{
    max_cargo = new + equipment_weight;
}

References equipment_weight, and max_cargo.

Referenced by ShipSetProperty().

Here is the caller graph for this function:

setMaxEscortCount:

- (void) setMaxEscortCount:

(uint8_t)

newCount

Definition at line 7022 of file ShipEntity.m.

                          :(uint8_t)newCount
{
    _maxEscortCount = newCount;
}

References _maxEscortCount.

Referenced by ShipSetProperty().

Here is the caller graph for this function:

setMaxFlightPitch:

- (void) setMaxFlightPitch:

(GLfloat)

new

Reimplemented in PlayerEntity.

Definition at line 8753 of file ShipEntity.m.

                          :(GLfloat)new
{
    max_flight_pitch = new;
}

References max_flight_pitch.

Referenced by ShipSetProperty().

Here is the caller graph for this function:

setMaxFlightRoll:

- (void) setMaxFlightRoll:

(GLfloat)

new

Reimplemented in PlayerEntity.

Definition at line 8765 of file ShipEntity.m.

                         :(GLfloat)new
{
    max_flight_roll = new;
}

References max_flight_roll.

Referenced by ShipSetProperty().

Here is the caller graph for this function:

setMaxFlightSpeed:

- (void) setMaxFlightSpeed:

(GLfloat)

new

Definition at line 8759 of file ShipEntity.m.

                          :(GLfloat)new
{
    maxFlightSpeed = new;
}

References maxFlightSpeed.

Referenced by ShipSetProperty().

Here is the caller graph for this function:

setMaxFlightYaw:

- (void) setMaxFlightYaw:

(GLfloat)

new

Reimplemented in PlayerEntity.

Definition at line 8771 of file ShipEntity.m.

                        :(GLfloat)new
{
    max_flight_yaw = new;
}

References max_flight_yaw.

Referenced by ShipSetProperty().

Here is the caller graph for this function:

setMaxThrust:

- (void) setMaxThrust:

(GLfloat)

new

Definition at line 4125 of file ShipEntity.m.

                     :(GLfloat)new
{
    max_thrust = new;
}

References max_thrust.

Referenced by ShipSetProperty().

Here is the caller graph for this function:

setMesh:

- (void) setMesh:

(OOMesh *)

mesh

Definition at line 1254 of file ShipEntity.m.

               :(OOMesh *)mesh
{
    if (mesh != [self mesh])
    {
        [self setDrawable:mesh];
        [octree autorelease];
        octree = [[mesh octree] retain];
    }
}

References mesh, OOMesh::octree, octree, and OOEntityWithDrawable::setDrawable:.

Referenced by PlayerEntity::doBookkeeping:, PlayerEntity::launchEscapeCapsule, ShipEntity(Private)::rescaleBy:writeToCache:, and ShipSetMaterialsInternal().

Here is the call graph for this function:

Here is the caller graph for this function:

setMessageTime:

- (void) setMessageTime:

(double)

value

Definition at line 6902 of file ShipEntity.m.

                       :(double) value
{
    messageTime = value;
}

References messageTime.

Referenced by HeadUpDisplay::refreshLastTransmitter.

Here is the caller graph for this function:

setMissileLoadTime:

- (void) setMissileLoadTime:

(OOTimeDelta)

newMissileLoadTime

Definition at line 12335 of file ShipEntity.m.

                           :(OOTimeDelta)newMissileLoadTime
{
    missile_load_time = fmax(0.0, newMissileLoadTime);
}

References missile_load_time.

Referenced by ShipSetProperty().

Here is the caller graph for this function:

setName:

- (void) setName:

(NSString *)

inName

Reimplemented in PlayerEntity.

Definition at line 7208 of file ShipEntity.m.

                :(NSString *)inName
{
    [name release];
    name = [inName copy];
}

References name.

Referenced by ShipSetProperty().

Here is the caller graph for this function:

setNextBeacon:

- (void) setNextBeacon: (Entity <OOBeaconEntity> *) beaconShip

implementation

Reimplemented from <OOBeaconEntity>.

Definition at line 1647 of file ShipEntity.m.

                      :(Entity <OOBeaconEntity> *)beaconShip
{
    if (beaconShip != [self nextBeacon])
    {
        [_nextBeacon release];
        _nextBeacon = [beaconShip weakRetain];
    }
}

References _nextBeacon, and nextBeacon.

Referenced by PlayerEntity::setNextCompassMode, and PlayerEntity::setPrevCompassMode.

Here is the call graph for this function:

Here is the caller graph for this function:

setOwner:

- (void) setOwner: (Entity *) who_owns_entity

implementation

Reimplemented from Entity.

Definition at line 6721 of file ShipEntity.m.

                 :(Entity *)who_owns_entity
{
    [super setOwner:who_owns_entity];
    
    /*  Reset shader binding target so that bind-to-super works.
        This is necessary since we don't know about the owner in
        setUpShipFromDictionary:, when the mesh is initially set up.
        -- Ahruman 2008-04-19
    */
    if (isSubEntity)
    {
        [[self drawable] setBindingTarget:self];
    }
}

References OOEntityWithDrawable::drawable, Entity::isSubEntity, OODrawable::setBindingTarget:, and Entity::setOwner:.

Referenced by abandonShip, ShipEntity(Private)::addSubEntity:, behaviour_tractored:, dockEscorts, dumpItem:, ShipEntity(PureAI)::escortCheckMother, fireMissileWithIdentifier:andTarget:, getTractoredBy:, launchCascadeMine, StationEntity::launchDefenseShip, PlayerEntity::launchEscapeCapsule, StationEntity::launchIndependentShip:, PlayerEntity::launchMine:, StationEntity::launchPirateShip, ShipEntity(Private)::launchPodWithCrew:, releaseCargoPodsDebris, OOShipGroup::removeShip:, ShipEntity(Private)::setUpOneEscort:inGroup:withRole:atPosition:andCount:, setUpShipFromDictionary:, ShipEntity(LoadRestore)::shipRestoredFromDictionary:useFallback:context:, ShipEntity(ScriptMethods)::spawnShipsWithRole:count:, ShipEntity(Private)::subEntityDied:, ShipEntity(AI)::suggestEscortTo:, ShipEntity(PureAI)::thargonCheckMother, and update:.

Here is the call graph for this function:

Here is the caller graph for this function:

setPendingEscortCount:

- (void) setPendingEscortCount:

(uint8_t)

count

Definition at line 7010 of file ShipEntity.m.

                              :(uint8_t)count
{
    _pendingEscortCount = MIN(count, _maxEscortCount);
}

References _maxEscortCount, _pendingEscortCount, count, and MIN.

Referenced by StationEntity::launchIndependentShip:, DockEntity::launchShip:, Universe::makeDemoShipWithRole:spinning:, Universe::setupIntroFirstGo:, and PlayerEntity::showShipModelWithKey:shipData:personality:factorX:factorY:factorZ:inContext:.

Here is the caller graph for this function:

setPitch:

- (void) setPitch:

(double)

amount

Definition at line 8222 of file ShipEntity.m.

                 :(double) amount
{
    flightPitch = amount * M_PI / 2.0;
}

References flightPitch, and M_PI.

Referenced by WormholeEntity::disgorgeShips, dumpItem:, launchCascadeMine, DockEntity::launchShip:, PlayerEntity(Scripting)::processSceneString:atOffset:, setDemoShip:, and Universe::setUpSpace.

Here is the caller graph for this function:

setPlanetPatrolCoordinates

- (void) setPlanetPatrolCoordinates

implementation

Provided by category ShipEntity(PureAI).

Definition at line 1937 of file ShipEntityAI.m.

{
    // check we've arrived near the last given coordinates
    HPVector r_pos = HPvector_subtract(position, coordinates);
    if (HPmagnitude2(r_pos) < 1000000 || patrol_counter == 0)
    {
        Entity *the_sun = [UNIVERSE sun];
        ShipEntity *the_station = [[self group] leader];
        if(!the_station || ![the_station isStation]) the_station = [UNIVERSE station];
        if ((!the_sun)||(!the_station))
            return;
        HPVector sun_pos = the_sun->position;
        HPVector stn_pos = the_station->position;
        HPVector sun_dir = HPvector_subtract(sun_pos,stn_pos);
        Vector vSun = make_vector(0, 0, 1);
        if (sun_dir.x||sun_dir.y||sun_dir.z)
            vSun = HPVectorToVector(HPvector_normal(sun_dir));
        Vector v0 = [the_station forwardVector];
        Vector v1 = cross_product(v0, vSun);
        Vector v2 = cross_product(v0, v1);
        switch (patrol_counter)
        {
            case 0:     // first go to 5km ahead of the station
                coordinates = make_HPvector(stn_pos.x + 5000 * v0.x, stn_pos.y + 5000 * v0.y, stn_pos.z + 5000 * v0.z);
                desired_range = 250.0;
                break;
            case 1:     // go to 25km N of the station
                coordinates = make_HPvector(stn_pos.x + 25000 * v1.x, stn_pos.y + 25000 * v1.y, stn_pos.z + 25000 * v1.z);
                desired_range = 250.0;
                break;
            case 2:     // go to 25km E of the station
                coordinates = make_HPvector(stn_pos.x + 25000 * v2.x, stn_pos.y + 25000 * v2.y, stn_pos.z + 25000 * v2.z);
                desired_range = 250.0;
                break;
            case 3:     // go to 25km S of the station
                coordinates = make_HPvector(stn_pos.x - 25000 * v1.x, stn_pos.y - 25000 * v1.y, stn_pos.z - 25000 * v1.z);
                desired_range = 250.0;
                break;
            case 4:     // go to 25km W of the station
                coordinates = make_HPvector(stn_pos.x - 25000 * v2.x, stn_pos.y - 25000 * v2.y, stn_pos.z - 25000 * v2.z);
                desired_range = 250.0;
                break;
            default:    // We should never come here
                coordinates = make_HPvector(stn_pos.x + 5000 * v0.x, stn_pos.y + 5000 * v0.y, stn_pos.z + 5000 * v0.z);
                desired_range = 250.0;
                break;
        }
        patrol_counter++;
        if (patrol_counter > 4)
        {
            if (randf() < .25)
            {
                // consider docking
                [self setTargetStation:the_station];
                [self setAITo:@"dockingAI.plist"];
                return;
            }
            else
            {
                // go around again
                patrol_counter = 1;
            }
        }
    }
    [shipAI message:@"APPROACH_COORDINATES"];
}

setPrevBeacon:

- (void) setPrevBeacon: (Entity <OOBeaconEntity> *) beaconShip

implementation

Reimplemented from <OOBeaconEntity>.

Definition at line 1637 of file ShipEntity.m.

                      :(Entity <OOBeaconEntity> *)beaconShip
{
    if (beaconShip != [self prevBeacon])
    {
        [_prevBeacon release];
        _prevBeacon = [beaconShip weakRetain];
    }
}

References _prevBeacon, and prevBeacon.

Here is the call graph for this function:

setPrimaryAggressor:

- (void) setPrimaryAggressor:

(Entity *)

targetEntity

Definition at line 9949 of file ShipEntity.m.

                            :(Entity *) targetEntity
{
    [_primaryAggressor release];
    _primaryAggressor = [targetEntity weakRetain];
}

References _primaryAggressor, and OOWeakRefObject::weakRetain.

Referenced by ShipEntity(PureAI)::fightOrFleeHostiles, ShipEntity(PureAI)::fightOrFleeMissile, fireMissileWithIdentifier:andTarget:, fireSubentityLaserShot:, respondToAttackFrom:becauseOf:, ShipSetProperty(), takeEnergyDamage:from:becauseOf:weaponIdentifier:, and StationEntity::takeEnergyDamage:from:becauseOf:weaponIdentifier:.

Here is the call graph for this function:

Here is the caller graph for this function:

setPrimaryRole:

- (void) setPrimaryRole:

(NSString *)

role

Definition at line 7317 of file ShipEntity.m.

                      :(NSString *)role
{
    if (![role isEqual:primaryRole])
    {
        [primaryRole release];
        primaryRole = [role copy];
    }
}

References primaryRole.

Referenced by StationEntity::becomeExplosion, StationEntity::launchDefenseShip, StationEntity::launchIndependentShip:, StationEntity::launchPatrol, StationEntity::launchPirateShip, StationEntity::launchPolice, StationEntity::launchShipWithRole:, Universe::newDockWithName:andScaleFactor:, Universe::newShipWithName:usePlayerProxy:isSubentity:andScaleFactor:, Universe::newShipWithRole:, ShipEntity(PureAI)::scanForFormationLeader, PlayerEntity(Scripting)::sendAllShipsAway, ShipEntity(Private)::setUpOneEscort:inGroup:withRole:atPosition:andCount:, PlayerEntity::setUpShipFromDictionary:, ShipEntity(LoadRestore)::shipRestoredFromDictionary:useFallback:context:, and ShipSetProperty().

Here is the caller graph for this function:

setProximityAlert:

- (void) setProximityAlert:

(ShipEntity *)

targetEntity

Definition at line 7055 of file ShipEntity.m.

                          :(ShipEntity*) other
{
    if (!other)
    {
        DESTROY(_proximityAlert);
        return;
    }
 
    if ([other mass] < 2000) // we are not alerted by small objects. (a cargopod has a mass of about 1000)
        return;
    
 
    if (isStation) // stations don't worry about colliding with things
        return; 
 
    /* Ignore station collision warnings if launching or docking */
    if ((other->isStation) && ([self status] == STATUS_LAUNCHING || 
                               dockingInstructions != nil))
    {
        return; 
    }   
 
    if (!crew) // Ships without pilot (cargo, rocks, missiles, buoys etc) will not get alarmed. (escape-pods have pilots)
        return;
    
    // check vectors
    Vector vdiff = HPVectorToVector(HPvector_between(position, other->position));
    GLfloat d_forward = dot_product(vdiff, v_forward);
    GLfloat d_up = dot_product(vdiff, v_up);
    GLfloat d_right = dot_product(vdiff, v_right);
    if ((d_forward > 0.0)&&(flightSpeed > 0.0))  // it's ahead of us and we're moving forward
        d_forward *= 0.25 * maxFlightSpeed / flightSpeed;  // extend the collision zone forward up to 400%
    double d2 = d_forward * d_forward + d_up * d_up + d_right * d_right;
    double cr2 = collision_radius * 2.0 + other->collision_radius;  cr2 *= cr2; // check with twice the combined radius
 
    if (d2 > cr2) // we're okay
    return;
 
    if (behaviour == BEHAVIOUR_AVOID_COLLISION)    //  already avoiding something
    {
        ShipEntity* prox = (ShipEntity*)[self proximityAlert];
        if ((prox)&&(prox != other))
        {
            // check which subtends the greatest angle
            GLfloat sa_prox = prox->collision_radius * prox->collision_radius / HPdistance2(position, prox->position);
            GLfloat sa_other = other->collision_radius *  other->collision_radius / HPdistance2(position, other->position);
            if (sa_prox < sa_other)  return;
        }
    }
    [_proximityAlert release];
    _proximityAlert = [other weakRetain];
}

References _proximityAlert, behaviour, Entity::collision_radius, crew, DESTROY, dockingInstructions, flightSpeed, Entity::isStation, Entity::mass, maxFlightSpeed, nil, Entity::position, proximityAlert, Entity::status, v_forward, v_right, v_up, and OOWeakRefObject::weakRetain.

Referenced by CollisionRegion::findCollisions.

Here is the call graph for this function:

Here is the caller graph for this function:

setRacepointsFromTarget

- (void) setRacepointsFromTarget

implementation

Provided by category ShipEntity(PureAI).

Definition at line 2710 of file ShipEntityAI.m.

{
    // two point - one at z - cr one at z + cr
    ShipEntity *ship = [self primaryTarget];
    if (ship == nil)
    {
        [shipAI message:@"NOTHING_FOUND"];
        return;
    }
    Vector k = ship->v_forward;
    GLfloat c = ship->collision_radius;
    HPVector o = ship->position;
    navpoints[0] = make_HPvector(o.x - c * k.x, o.y - c * k.y, o.z - c * k.z);
    navpoints[1] = make_HPvector(o.x + c * k.x, o.y + c * k.y, o.z + c * k.z);
    navpoints[2] = make_HPvector(o.x + 2.0 * c * k.x, o.y + 2.0 * c * k.y, o.z + 2.0 * c * k.z);
    number_of_navpoints = 2;
    next_navpoint_index = 0;
    _destination = navpoints[0];
    [shipAI message:@"RACEPOINTS_SET"];
}

setRawRoll:

- (void) setRawRoll:

(double)

amount

Definition at line 8216 of file ShipEntity.m.

                   :(double) amount
{
    flightRoll = amount;
}

References flightRoll.

Referenced by StationSetProperty().

Here is the caller graph for this function:

setReactionTime:

- (void) setReactionTime:

(float)

newReactionTime

Definition at line 6293 of file ShipEntity.m.

                        : (float) newReactionTime
{
    reactionTime = newReactionTime;
}

References reactionTime.

Referenced by ShipSetProperty().

Here is the caller graph for this function:

setReference:

- (void) setReference:

(Vector)

v

Definition at line 7556 of file ShipEntity.m.

                     :(Vector) v
{
    reference = v;
}

References reference.

Referenced by setUpOneStandardSubentity:asTurret:.

Here is the caller graph for this function:

setRememberedShip:

- (void) setRememberedShip:

(Entity *)

targetEntity

Definition at line 10006 of file ShipEntity.m.

                          :(Entity *) targetEntity
{
    [_rememberedShip release];
    _rememberedShip = [targetEntity weakRetain];
}

References _rememberedShip, and OOWeakRefObject::weakRetain.

Referenced by ShipEntity(PureAI)::storeTarget.

Here is the call graph for this function:

Here is the caller graph for this function:

setReportAIMessages:

- (void) setReportAIMessages:

(BOOL)

yn

Definition at line 7568 of file ShipEntity.m.

                            :(BOOL) yn
{
    reportAIMessages = yn;
}

References reportAIMessages.

Referenced by ShipSetProperty(), and OOShipDebugInspectorModule::takeReportAIMessagesFrom:.

Here is the caller graph for this function:

setRoll:

- (void) setRoll:

(double)

amount

Definition at line 8210 of file ShipEntity.m.

                :(double) amount
{
    flightRoll = amount * M_PI / 2.0;
}

References flightRoll, and M_PI.

Referenced by Universe::addEntity:, WormholeEntity::disgorgeShips, dumpItem:, launchCascadeMine, PlayerEntity::launchEscapeCapsule, DockEntity::launchShip:, PlayerEntity(Scripting)::processSceneString:atOffset:, and setDemoShip:.

Here is the caller graph for this function:

setScanDescription:

- (void) setScanDescription:

(NSString *)

inName

Definition at line 7236 of file ShipEntity.m.

                           :(NSString *)inName
{
    [scan_description release];
    scan_description = [inName copy];
}

References scan_description.

Referenced by ShipSetProperty().

Here is the caller graph for this function:

setScannerDisplayColor1:

- (void) setScannerDisplayColor1:

(OOColor *)

color1

Definition at line 6610 of file ShipEntity.m.

                               :(OOColor *)color
{
    DESTROY(scanner_display_color1);
    
    if (color == nil)  color = [OOColor colorWithDescription:[[self shipInfoDictionary] objectForKey:@"scanner_display_color1"]];
    scanner_display_color1 = [color retain];
}

References OOColor::colorWithDescription:, DESTROY, nil, scanner_display_color1, and shipInfoDictionary.

Referenced by setUpShipFromDictionary:, and ShipSetProperty().

Here is the call graph for this function:

Here is the caller graph for this function:

setScannerDisplayColor2:

- (void) setScannerDisplayColor2:

(OOColor *)

color2

Definition at line 6619 of file ShipEntity.m.

                               :(OOColor *)color
{
    DESTROY(scanner_display_color2);
    
    if (color == nil)  color = [OOColor colorWithDescription:[[self shipInfoDictionary] objectForKey:@"scanner_display_color2"]];
    scanner_display_color2 = [color retain];
}

References OOColor::colorWithDescription:, DESTROY, nil, scanner_display_color2, and shipInfoDictionary.

Referenced by setUpShipFromDictionary:, and ShipSetProperty().

Here is the call graph for this function:

Here is the caller graph for this function:

setScannerDisplayColorHostile1:

- (void) setScannerDisplayColorHostile1:

(OOColor *)

color1

Definition at line 6640 of file ShipEntity.m.

                                      :(OOColor *)color
{
    DESTROY(scanner_display_color_hostile1);
    
    if (color == nil)  color = [OOColor colorWithDescription:[[self shipInfoDictionary] objectForKey:@"scanner_hostile_display_color1"]];
    scanner_display_color_hostile1 = [color retain];
}

References OOColor::colorWithDescription:, DESTROY, nil, scanner_display_color_hostile1, and shipInfoDictionary.

Referenced by setUpShipFromDictionary:, and ShipSetProperty().

Here is the call graph for this function:

Here is the caller graph for this function:

setScannerDisplayColorHostile2:

- (void) setScannerDisplayColorHostile2:

(OOColor *)

color2

Definition at line 6649 of file ShipEntity.m.

                                      :(OOColor *)color
{
    DESTROY(scanner_display_color_hostile2);
    
    if (color == nil)  color = [OOColor colorWithDescription:[[self shipInfoDictionary] objectForKey:@"scanner_hostile_display_color2"]];
    scanner_display_color_hostile2 = [color retain];
}

References OOColor::colorWithDescription:, DESTROY, nil, scanner_display_color_hostile2, and shipInfoDictionary.

Referenced by setUpShipFromDictionary:, and ShipSetProperty().

Here is the call graph for this function:

Here is the caller graph for this function:

setScannerRange:

- (void) setScannerRange:

(GLfloat)

value

Definition at line 7544 of file ShipEntity.m.

                        : (GLfloat) value
{
    scannerRange = value;
}

References scannerRange.

setScriptedMisjump:

- (void) setScriptedMisjump:

(BOOL)

newValue

Definition at line 1295 of file ShipEntity.m.

                           :(BOOL)newValue
{
    scripted_misjump = !!newValue;
}

References scripted_misjump.

Referenced by enterWormhole:replacing:, PlayerEntity(OOPrivate)::performWitchspaceExitUpdates:, and ShipSetProperty().

Here is the caller graph for this function:

setScriptedMisjumpRange:

- (void) setScriptedMisjumpRange:

(GLfloat)

newValue

Definition at line 1307 of file ShipEntity.m.

                                :(GLfloat)newValue
{
    _scriptedMisjumpRange = newValue;
}

References _scriptedMisjumpRange.

Referenced by enterWormhole:replacing:, PlayerEntity(OOPrivate)::performWitchspaceExitUpdates:, and ShipSetProperty().

Here is the caller graph for this function:

setShipClassName:

- (void) setShipClassName:

(NSString *)

inName

Definition at line 7222 of file ShipEntity.m.

                         :(NSString *)inName
{
    [shipClassName release];
    shipClassName = [inName copy];
}

References shipClassName.

Referenced by PlayerEntity(Contracts)::newShipCommonSetup:yardInfo:baseInfo:, PlayerEntity::setCommanderDataFromDictionary:, and ShipSetProperty().

Here is the caller graph for this function:

setShipDataKey:

- (void) setShipDataKey:

(NSString *)

key

Definition at line 1986 of file ShipEntity.m.

                      :(NSString *)key
{
    DESTROY(_shipKey);
    _shipKey = [key copy];
}

References _shipKey, and DESTROY.

Referenced by PlayerEntity(Contracts)::newShipCommonSetup:yardInfo:baseInfo:, PlayerEntity::setCommanderDataFromDictionary:, and PlayerEntity::setUpAndConfirmOK:saveGame:.

Here is the caller graph for this function:

setShipHitByLaser:

- (void) setShipHitByLaser: (ShipEntity *) ship

implementation

Provided by category ShipEntity(Private).

Definition at line 10182 of file ShipEntity.m.

                          :(ShipEntity *)ship
{
    if (ship != [self shipHitByLaser])
    {
        [_shipHitByLaser release];
        _shipHitByLaser = [ship weakRetain];
    }
}

References OOWeakRefObject::weakRetain.

Referenced by fireDirectLaserShotAt:, fireLaserShotInDirection:weaponIdentifier:, and fireSubentityLaserShot:.

Here is the call graph for this function:

Here is the caller graph for this function:

setShipScript:

- (void) setShipScript:

(NSString *)

script_name

Definition at line 8038 of file ShipEntity.m.

                      :(NSString *)script_name
{
    NSMutableDictionary     *properties = nil;
    NSArray                 *actions = nil;
    
    properties = [NSMutableDictionary dictionary];
    [properties setObject:self forKey:@"ship"];
    
    [script autorelease];
    script = [OOScript jsScriptFromFileNamed:script_name properties:properties];
    
    if (script == nil)
    {
        actions = [shipinfoDictionary oo_arrayForKey:@"launch_actions"];
        if (actions)
        {
            OOStandardsDeprecated([NSString stringWithFormat:@"The launch_actions ship key is deprecated on %@.",[self displayName]]);
            if (!OOEnforceStandards()) 
            {
                [properties setObject:actions forKey:@"legacy_launchActions"];  
            }
        }
 
        actions = [shipinfoDictionary oo_arrayForKey:@"script_actions"];
        if (actions)
        {
            OOStandardsDeprecated([NSString stringWithFormat:@"The script_actions ship key is deprecated on %@.",[self displayName]]);
            if (!OOEnforceStandards()) 
            {
                [properties setObject:actions forKey:@"legacy_scriptActions"];  
            }
        }
 
        actions = [shipinfoDictionary oo_arrayForKey:@"death_actions"];
        if (actions)
        {
            OOStandardsDeprecated([NSString stringWithFormat:@"The death_actions ship key is deprecated on %@.",[self displayName]]);
            if (!OOEnforceStandards()) 
            {
                [properties setObject:actions forKey:@"legacy_deathActions"];   
            }
        }
 
        actions = [shipinfoDictionary oo_arrayForKey:@"setup_actions"];
        if (actions)
        {
            OOStandardsDeprecated([NSString stringWithFormat:@"The setup_actions ship key is deprecated on %@.",[self displayName]]);
            if (!OOEnforceStandards()) 
            {
                [properties setObject:actions forKey:@"legacy_setupActions"];   
            }
        }
        
        script = [OOScript jsScriptFromFileNamed:@"oolite-default-ship-script.js"
                                      properties:properties];
    }
    [script retain];
}

References displayName, OOScript::jsScriptFromFileNamed:properties:, nil, OOEnforceStandards(), OOStandardsDeprecated(), and script.

Referenced by setUpShipFromDictionary:, and ShipSetScript().

Here is the call graph for this function:

Here is the caller graph for this function:

setShipUniqueName:

- (void) setShipUniqueName:

(NSString *)

inName

Definition at line 7215 of file ShipEntity.m.

                          :(NSString *)inName
{
    [shipUniqueName release];
    shipUniqueName = [inName copy];
}

References shipUniqueName.

Referenced by PlayerEntity(Contracts)::newShipCommonSetup:yardInfo:baseInfo:, PlayerEntity::setCommanderDataFromDictionary:, and ShipSetProperty().

Here is the caller graph for this function:

setSingleCrewWithRole:

- (void) setSingleCrewWithRole:

(NSString *)

crewRole

Convenience to set the crew to a single character of the given role, originating in the ship's home system. Does nothing if unpiloted.

Definition at line 7967 of file ShipEntity.m.

                              :(NSString *)crewRole
{
    if (![self isUnpiloted])
    {
        OOCharacter *crewMember = [OOCharacter randomCharacterWithRole:crewRole
                                                 andOriginalSystem:[self homeSystem]];
        [self setCrew:[NSArray arrayWithObject:crewMember]];
    }
}

References homeSystem, isUnpiloted, OOCharacter::randomCharacterWithRole:andOriginalSystem:, and setCrew:.

Referenced by StationEntity::launchDefenseShip, StationEntity::launchEscort, StationEntity::launchIndependentShip:, StationEntity::launchMiner, StationEntity::launchPatrol, StationEntity::launchPirateShip, StationEntity::launchPolice, StationEntity::launchScavenger, StationEntity::launchShipWithRole:, PlanetEntity::launchShuttle, StationEntity::launchShuttle, ShipEntity(Private)::setUpOneEscort:inGroup:withRole:atPosition:andCount:, and StationEntity::setUpShipFromDictionary:.

Here is the call graph for this function:

Here is the caller graph for this function:

setSpeed:

- (void) setSpeed:

(double)

amount

Definition at line 8578 of file ShipEntity.m.

                 :(double) amount
{
    flightSpeed = amount;
}

References flightSpeed.

Referenced by ShipEntity(PureAI)::becomeUncontrolledThargon, WormholeEntity::disgorgeShips, fireMissileWithIdentifier:andTarget:, launchCascadeMine, PlayerEntity::launchEscapeCapsule, and DockEntity::launchShip:.

Here is the caller graph for this function:

setSpeedFactorTo:

- (void) setSpeedFactorTo: (NSString *) speedString

implementation

Provided by category ShipEntity(PureAI).

Definition at line 927 of file ShipEntityAI.m.

                         :(NSString *)speedString
{
    desired_speed = maxFlightSpeed * [speedString doubleValue];
}

setSpeedTo:

- (void) setSpeedTo: (NSString *) speedString

implementation

Provided by category ShipEntity(PureAI).

Definition at line 921 of file ShipEntityAI.m.

                   :(NSString *)speedString
{
    desired_speed = [speedString doubleValue];
}

setSpeedToCruiseSpeed

- (void) setSpeedToCruiseSpeed

implementation

Provided by category ShipEntity(PureAI).

Definition at line 932 of file ShipEntityAI.m.

{
    desired_speed = cruiseSpeed;
}

setStateMachine:

- (void) setStateMachine:

(NSString *)

ai_desc

Definition at line 7996 of file ShipEntity.m.

                        :(NSString *)smName
{
    [self setAITo:smName];
}

References setAITo:.

Here is the call graph for this function:

setStateTo:

- (void) setStateTo: (NSString *) state

implementation

Provided by category ShipEntity(PureAI).

Definition at line 845 of file ShipEntityAI.m.

                   :(NSString *)state
{
    [[self getAI] setState:state];
}

setStatus:

- (void) setStatus: (OOEntityStatus) stat

implementation

Reimplemented from Entity.

Definition at line 7929 of file ShipEntity.m.

                  :(OOEntityStatus) stat
{
    if ([self status] == stat) return;
    [super setStatus:stat];
    if (stat == STATUS_LAUNCHING)
    {
        launch_time = [UNIVERSE getTime];
    }
}

References launch_time, Entity::setStatus:, and Entity::status.

Referenced by Universe::addEntity:, DockEntity::addShipToLaunchQueue:withPriority:, PlayerEntity(ScriptMethods)::awardCommodityType:amount:, ballTrackLeadingTarget:atTarget:, becomeExplosion, becomeLargeExplosion:, PlayerEntity(Controls)::beginWitchspaceCountdown:, behaviour_tractored:, PlayerEntity(Contracts)::buySelectedShip, PlayerEntity(Controls)::cancelWitchspaceCountdown, PlayerEntity(Scripting)::checkScript, PlayerEntity::createCargoPodWithType:andAmount:, PlayerEntity::deferredInit, PlayerEntity::disengageAutopilot, PlayerEntity::doBookkeeping:, PlayerEntity::docked, PlayerEntity::endScenario:, PlayerEntity::engageAutopilotToStation:, PlayerEntity::enterDock:, PlayerEntity::enterGalacticWitchspace, PlayerEntity::enterWitchspace, PlayerEntity::enterWormhole:, getTractoredBy:, Universe::handleOoliteException:, Universe::initWithGameView:, initWithKey:definition:, PlayerEntity::interpretAIMessage:, PlayerEntity::isDocked, PlayerEntity::launchEscapeCapsule, PlayerEntity(Scripting)::launchFromStation, DockEntity::launchShip:, PlayerEntity::leaveWitchspace, PlayerEntity::loadCargoPodsForType:amount:, Universe::makeDemoShipWithRole:spinning:, noteKilledBy:damageType:, PlayerEntity(OOPrivate)::performLaunchingUpdates:, PlayerEntity(OOPrivate)::performWitchspaceCountdownUpdates:, PlayerEntity(OOPrivate)::performWitchspaceExitUpdates:, PlayerShipBeginGalacticHyperspaceCountdown(), PlayerEntity(OOControlsPrivate)::pollFlightControls:, PlayerEntity(Scripting)::processSceneString:atOffset:, Universe::reinitAndShowDemo:, PlayerEntity::setDockedAtMainStation, PlayerEntity::setUpAndConfirmOK:saveGame:, Universe::setupIntroFirstGo:, setUpOneStandardSubentity:asTurret:, Universe::setUpSpace, PlayerEntity::showShipModelWithKey:shipData:personality:factorX:factorY:factorZ:inContext:, WormholeEntity::suckInShip:, update:, Universe::update:, PlayerEntity::witchJumpChecklist:, and witchspaceLeavingEffects.

Here is the call graph for this function:

Here is the caller graph for this function:

setSubEntityRotationalVelocity:

- (void) setSubEntityRotationalVelocity:

(Quaternion)

rv

Definition at line 1175 of file ShipEntity.m.

                                       :(Quaternion)rv
{
    subentityRotationalVelocity = rv;
}

References subentityRotationalVelocity.

Referenced by ShipSetProperty().

Here is the caller graph for this function:

setSubEntityTakingDamage:

- (void) setSubEntityTakingDamage:

(ShipEntity *)

sub

Definition at line 1372 of file ShipEntity.m.

                                 :(ShipEntity *)sub
{
#ifndef NDEBUG
    // Sanity checks: sub must be a ship subentity of self, or nil.
    if (sub != nil)
    {
        if (![self hasSubEntity:sub])
        {
            OOLog(@"ship.subentity.sanityCheck.failed.details", @"Attempt to set subentity taking damage of %@ to %@, which is not a subentity.", [self shortDescription], sub);
            sub = nil;
        }
        else if (![sub isShip])
        {
            OOLog(@"ship.subentity.sanityCheck.failed", @"Attempt to set subentity taking damage of %@ to %@, which is not a ship.", [self shortDescription], sub);
            sub = nil;
        }
    }
#endif
    
    [_subEntityTakingDamage release];
    _subEntityTakingDamage = [sub weakRetain];
}

References _subEntityTakingDamage, Entity::isShip, nil, OOLog, and OOWeakRefObject::weakRetain.

Referenced by dealloc, Universe::firstShipHitByLaserFromShip:inDirection:offset:gettingRangeFound:, ShipEntity(Private)::subEntityDied:, ShipEntity(Private)::subEntityReallyDied:, and subEntityTakingDamage.

Here is the call graph for this function:

Here is the caller graph for this function:

setSubIdx:

- (void) setSubIdx:

(NSUInteger)

value

Definition at line 780 of file ShipEntity.m.

                  :(NSUInteger)value
{
    _subIdx = value;
}

References _subIdx.

Referenced by setUpOneStandardSubentity:asTurret:.

Here is the caller graph for this function:

setSunGlareFilter:

- (void) setSunGlareFilter:

(GLfloat)

newValue

Definition at line 1211 of file ShipEntity.m.

                          :(GLfloat)newValue
{
    sunGlareFilter = OOClamp_0_1_f(newValue);
}

References sunGlareFilter.

Referenced by ShipSetProperty().

Here is the caller graph for this function:

setSunSkimEndCoordinates

- (void) setSunSkimEndCoordinates

implementation

Provided by category ShipEntity(PureAI).

Definition at line 2027 of file ShipEntityAI.m.

{
    if ([UNIVERSE sun] == nil)
    {
        [shipAI message:@"NO_SUN_FOUND"];
        return;
    }
    
    coordinates = [UNIVERSE getSunSkimEndPositionForShip:self];
    [shipAI message:@"APPROACH_COORDINATES"];
}

setSunSkimExitCoordinates

- (void) setSunSkimExitCoordinates

implementation

Provided by category ShipEntity(PureAI).

Definition at line 2040 of file ShipEntityAI.m.

{
    Entity *the_sun = [UNIVERSE sun];
    if (the_sun == nil)  return;
    HPVector v1 = [UNIVERSE getSunSkimEndPositionForShip:self];
    HPVector vs = the_sun->position;
    HPVector vout = HPvector_subtract(v1,vs);
    if (vout.x||vout.y||vout.z)
        vout = HPvector_normal(vout);
    else
        vout.z = 1.0;
    v1.x += 10000 * vout.x;    v1.y += 10000 * vout.y;    v1.z += 10000 * vout.z;
    coordinates = v1;
    [shipAI message:@"APPROACH_COORDINATES"];
}

setSunSkimStartCoordinates

- (void) setSunSkimStartCoordinates

implementation

Provided by category ShipEntity(PureAI).

Definition at line 2005 of file ShipEntityAI.m.

{
    if ([UNIVERSE sun] == nil)
    {
        [shipAI message:@"NO_SUN_FOUND"];
        return;
    }
    
    HPVector v0 = [UNIVERSE getSunSkimStartPositionForShip:self];
    
    if (!HPvector_equal(v0, kZeroHPVector))
    {
        coordinates = v0;
        [shipAI message:@"APPROACH_COORDINATES"];
    }
    else
    {
        [shipAI message:@"WAIT_FOR_SUN"];
    }
}

setSuppressExplosion:

- (void) setSuppressExplosion:

(BOOL)

suppress

Definition at line 9794 of file ShipEntity.m.

                            :(BOOL)suppress
{
    suppressExplosion = !!suppress;
}

References suppressExplosion.

Referenced by becomeExplosion, becomeLargeExplosion:, and deserializeShipSubEntitiesFrom:.

Here is the caller graph for this function:

setTakeOffFromPlanet

- (void) setTakeOffFromPlanet

implementation

Provided by category ShipEntity(PureAI).

Definition at line 1336 of file ShipEntityAI.m.

{
    /*- selects the nearest planet it can find -*/
    OOPlanetEntity  *the_planet =  [self findNearestPlanet];
    if (the_planet)
    {
        _destination = HPvector_add([the_planet position], HPvector_multiply_scalar(
                                                                               HPvector_normal(HPvector_subtract([the_planet position],position)),-10000.0-the_planet->collision_radius));// 10km straight up
        desired_range = 50.0;
    }
    else
    {
        OOLog(@"ai.setTakeOffFromPlanet.noPlanet", @"%@", @"***** Error. Planet not found during take off!");
    }
}

setTargetForScript:

- (void) setTargetForScript:

(ShipEntity *)

target

Provided by category ShipEntity(OOJavaScriptExtensions).

Definition at line 140 of file EntityOOJavaScriptExtensions.m.

                           :(ShipEntity *)target
{
    ShipEntity *me = self;
    
    // Ensure coherence by not fiddling with subentities.
    while ([me isSubEntity])
    {
        if (me == [me owner] || [me owner] == nil)  break;
        me = (ShipEntity *)[me owner];
    }
    while ([target isSubEntity])
    {
        if (target == [target owner] || [target owner] == nil)  break;
        target = (ShipEntity *)[target owner];
    }
    if (![me isKindOfClass:[ShipEntity class]])  return;
    if (target != nil)
    {
        [me addTarget:target];
    }
    else  [me removeTarget:[me primaryTarget]];
}

Referenced by ShipSetProperty().

Here is the caller graph for this function:

setTargetStation:

- (void) setTargetStation:

(Entity *)

targetEntity

Definition at line 10025 of file ShipEntity.m.

                         :(Entity *) targetEntity
{
    [_targetStation release];
    _targetStation = [targetEntity weakRetain];
}

References _targetStation, and OOWeakRefObject::weakRetain.

Referenced by PlayerEntity::disengageAutopilot, dockEscorts, PlayerEntity::engageAutopilotToStation:, ShipEntity(AI)::recallDockingInstructions, ShipEntity(PureAI)::setPlanetPatrolCoordinates, ShipEntity(PureAI)::setTargetToLastStation, setTargetToNearestStationIncludingHostiles:, ShipEntity(PureAI)::setTargetToRandomStation, and setTargetToSystemStation.

Here is the call graph for this function:

Here is the caller graph for this function:

setTargetToFoundTarget

- (void) setTargetToFoundTarget

implementation

Provided by category ShipEntity(PureAI).

Definition at line 1142 of file ShipEntityAI.m.

{
    if ([self foundTarget] != nil)
    {
        [self addTarget:[self foundTarget]];
    }
    else
    {
        [shipAI message:@"TARGET_LOST"]; // to prevent the ship going for a wrong, previous target. Should not be a reactToMessage.
    }
}

setTargetToLastStation

- (void) setTargetToLastStation

implementation

Provided by category ShipEntity(PureAI).

Definition at line 2543 of file ShipEntityAI.m.

{
    Entity  *station = [self targetStation];
    
    if (station != nil && [station isStation])
    {
        [self addTarget:station];
    }
    else
    {
        [shipAI message:@"NO_STATION_FOUND"];
        [self setTargetStation:nil];
    }
    
}

setTargetToNearestFriendlyStation

- (void) setTargetToNearestFriendlyStation

Definition at line 13985 of file ShipEntity.m.

{
    [self setTargetToNearestStationIncludingHostiles:NO];
}

References setTargetToNearestFriendlyStation, and setTargetToNearestStationIncludingHostiles:.

Referenced by coordinates, and setTargetToNearestFriendlyStation.

Here is the call graph for this function:

Here is the caller graph for this function:

setTargetToNearestStation

- (void) setTargetToNearestStation

Definition at line 13992 of file ShipEntity.m.

{
    [self setTargetToNearestStationIncludingHostiles:YES];
}

References setTargetToNearestStation, and setTargetToNearestStationIncludingHostiles:.

Referenced by coordinates, and setTargetToNearestStation.

Here is the call graph for this function:

Here is the caller graph for this function:

setTargetToNearestStationIncludingHostiles:

- (void) setTargetToNearestStationIncludingHostiles: (BOOL) includeHostiles

implementation

Definition at line 13934 of file ShipEntity.m.

                                                   :(BOOL) includeHostiles
{
    // check if the groupID (parent ship) points to a station...
    Entity      *mother = [[self group] leader];
    if ([mother isStation])
    {
        [self addTarget:mother];
        [self setTargetStation:mother];
        return; // head for mother!
    }
 
    /*- selects the nearest station it can find -*/
    if (!UNIVERSE)
        return;
    int         ent_count = UNIVERSE->n_entities;
    Entity      **uni_entities = UNIVERSE->sortedEntities;  // grab the public sorted list
    Entity      *my_entities[ent_count];
    int i;
    int station_count = 0;
    for (i = 0; i < ent_count; i++)
        if (uni_entities[i]->isStation)
            my_entities[station_count++] = [uni_entities[i] retain];        //  retained
    //
    StationEntity *thing = nil, *station = nil;
    double range2, nearest2 = SCANNER_MAX_RANGE2 * 1000000.0; // 1000x typical scanner range (25600 km), squared.
    for (i = 0; i < station_count; i++)
    {
        thing = (StationEntity *)my_entities[i];
        range2 = HPdistance2(position, thing->position);
        if (range2 < nearest2 && (includeHostiles || ![thing isHostileTo:self]))
        {
            station = thing;
            nearest2 = range2;
        }
    }
    for (i = 0; i < station_count; i++)
        [my_entities[i] release];       //  released
    //
    if (station)
    {
        [self addTarget:station];
        [self setTargetStation:station];
    }
    else
    {
        [shipAI message:@"NO_STATION_FOUND"];
    }
}

References addTarget:, group, Entity::isStation, OOShipGroup::leader, AI::message:, nil, Entity::position, SCANNER_MAX_RANGE2, setTargetStation:, and UNIVERSE.

Referenced by setTargetToNearestFriendlyStation, and setTargetToNearestStation.

Here is the call graph for this function:

Here is the caller graph for this function:

setTargetToPrimaryAggressor

- (void) setTargetToPrimaryAggressor

implementation

Provided by category ShipEntity(PureAI).

Definition at line 943 of file ShipEntityAI.m.

{
    Entity *primeAggressor = [self primaryAggressor];
    if (!primeAggressor)
        return;
    if ([self primaryTarget] == primeAggressor)
        return;
    
    // a more considered approach here:
    // if we're already busy attacking a target we don't necessarily want to break off
    //
    if ([self hasHostileTarget] && randf() < 0.75) // if I'm attacking, ignore 75% of new aggressor's attacks
    {
                // but add them as a secondary target anyway
        [self addDefenseTarget:(ShipEntity*)primeAggressor];
        return;
    }
    // react only if the primary aggressor is not a friendly ship, else ignore it
    if ([primeAggressor isShip] && ![(ShipEntity *)primeAggressor isFriendlyTo:self])
    {
        // inform our old target of our new target
        //
        Entity *primeTarget = [self primaryTarget];
        if ((primeTarget)&&(primeTarget->isShip))
        {
            ShipEntity *currentShip = [self primaryTarget];
            [[currentShip getAI] message:[NSString stringWithFormat:@"%@ %d %d", AIMS_AGGRESSOR_SWITCHED_TARGET, universalID, [[self primaryAggressor] universalID]]];
            [currentShip doScriptEvent:OOJSID("shipAttackerDistracted") withArgument:[self primaryAggressor]];
        }
        
        // okay, so let's now target the aggressor
        [self addTarget:[self primaryAggressor]];
    }
}

setTargetToRandomStation

- (void) setTargetToRandomStation

implementation

Provided by category ShipEntity(PureAI).

Definition at line 2490 of file ShipEntityAI.m.

{
    /*- selects the nearest station it can find -*/
    int             ent_count = UNIVERSE->n_entities;
    Entity          **uni_entities = UNIVERSE->sortedEntities;  // grab the public sorted list
    Entity          *my_entities[ent_count];
    StationEntity   *station = nil, *my_station = nil;
    double          maxRange2 = desired_range * desired_range;
    int             i;
    int             station_count = 0;
    
    for (i = 0; i < ent_count; i++)
    {
        // find stations within range but exclude carriers.
        if (uni_entities[i]->isStation)
        {
            my_station = (StationEntity*)uni_entities[i];
            if ([my_station maxFlightSpeed] == 0 && [my_station hasNPCTraffic] && HPdistance2(position, [my_station position]) < maxRange2)
            {
                my_entities[station_count++] = [uni_entities[i] retain];        //  retained
            }
        }
    }
    
    if (station_count != 0)
    {
        // select a random station
        station = (StationEntity *)my_entities[ranrot_rand() % station_count];
        // if more than one candidate do not select main station
        if (station == [UNIVERSE station] && station_count > 1)
        {
            while (station == [UNIVERSE station])
            {
                station = (StationEntity *)my_entities[ranrot_rand() % station_count];
            }
        }
    }
    
    for (i = 0; i < station_count; i++)
        [my_entities[i] release];       //  released
    //
    if (station)
    {
        [self addTarget:station];
        [self setTargetStation:station];
        [shipAI message:@"STATION_FOUND"];
    }
    else
    {
        [shipAI message:@"NO_STATION_IN_RANGE"];
    }
}

setTargetToSystemStation

- (void) setTargetToSystemStation

Definition at line 13999 of file ShipEntity.m.

{
    StationEntity* system_station = [UNIVERSE station];
    
    if (!system_station)
    {
        [shipAI message:@"NOTHING_FOUND"];
        [shipAI message:@"NO_STATION_FOUND"];
        DESTROY(_primaryTarget);
        [self setTargetStation:nil];
        return;
    }
    
    if (!system_station->isStation)
    {
        [shipAI message:@"NOTHING_FOUND"];
        [shipAI message:@"NO_STATION_FOUND"];
        DESTROY(_primaryTarget);
        [self setTargetStation:nil];
        return;
    }
    
    [self addTarget:system_station];
    [self setTargetStation:system_station];
    return;
}

References _primaryTarget, addTarget:, DESTROY, Entity::isStation, AI::message:, setTargetStation:, and setTargetToSystemStation.

Referenced by coordinates, and setTargetToSystemStation.

Here is the call graph for this function:

Here is the caller graph for this function:

setTemperature:

- (void) setTemperature:

(GLfloat)

value

Definition at line 8790 of file ShipEntity.m.

                       :(GLfloat) value
{
    ship_temperature = value;
}

References ship_temperature.

Referenced by Universe::addWreckageFrom:withRole:at:scale:lifetime:, becomeExplosion, dumpItem:, ShipEntity(Private)::launchPodWithCrew:, releaseCargoPodsDebris, ShipSetProperty(), and ShipEntity(ScriptMethods)::spawnShipsWithRole:count:.

Here is the caller graph for this function:

setThankedShip:

- (void) setThankedShip:

(Entity *)

targetEntity

Definition at line 9987 of file ShipEntity.m.

                       :(Entity *) targetEntity
{
    [_thankedShip release];
    _thankedShip = [targetEntity weakRetain];
}

References _thankedShip, and OOWeakRefObject::weakRetain.

Referenced by interpretAIMessage:.

Here is the call graph for this function:

Here is the caller graph for this function:

setThrust:

- (void) setThrust:

(double)

amount

Definition at line 8234 of file ShipEntity.m.

                  :(double) amount
{
    thrust = amount;
}

References thrust.

Referenced by behaviour_tractored:, dumpItem:, PlayerEntity::launchEscapeCapsule, releaseCargoPodsDebris, and ShipSetProperty().

Here is the caller graph for this function:

setThrustFactorTo:

- (void) setThrustFactorTo: (NSString *) thrustFactorString

implementation

Provided by category ShipEntity(PureAI).

Definition at line 937 of file ShipEntityAI.m.

                          :(NSString *)thrustFactorString
{
    thrust = OOClamp_0_1_f([thrustFactorString doubleValue]) * max_thrust;
}

setThrustForDemo:

- (void) setThrustForDemo:

(float)

factor

Definition at line 8240 of file ShipEntity.m.

                         :(float) factor
{
    flightSpeed = factor * maxFlightSpeed;
}

References flightSpeed, and maxFlightSpeed.

setTotalVelocity:

- (void) setTotalVelocity:

(Vector)

vel

Definition at line 12843 of file ShipEntity.m.

                         :(Vector)vel
{
    [self setVelocity:vector_subtract(vel, [self thrustVector])];
}

References Entity::setVelocity:, and thrustVector.

Referenced by ShipSetProperty().

Here is the call graph for this function:

Here is the caller graph for this function:

setTrackCloseContacts:

- (void) setTrackCloseContacts:

(BOOL)

value

Definition at line 14392 of file ShipEntity.m.

                              :(BOOL) value
{
    if (value == (BOOL)trackCloseContacts)  return;
    
    trackCloseContacts = value;
    [closeContactsInfo release];
    
    if (trackCloseContacts)
    {
        closeContactsInfo = [[NSMutableDictionary alloc] init];
    }
    else
    {
        closeContactsInfo = nil;
    }
}

References closeContactsInfo, nil, and trackCloseContacts.

Referenced by dealloc, setUpShipFromDictionary:, and ShipSetProperty().

Here is the caller graph for this function:

setUpCargoType:

- (void) setUpCargoType:

(NSString *)

cargoString

Definition at line 1023 of file ShipEntity.m.

                       :(NSString *) cargoString
{
    cargo_type = StringToCargoType(cargoString);
    
    switch (cargo_type)
    {
        case CARGO_SLAVES:
            commodity_amount = 1;
            DESTROY(commodity_type);
            commodity_type = @"slaves";
            cargo_type = CARGO_RANDOM; // not realy random, but it tells that cargo is selected.
            break;
            
        case CARGO_ALLOY:
            commodity_amount = 1;
            DESTROY(commodity_type);
            commodity_type = @"alloys";
            cargo_type = CARGO_RANDOM;
            break;
            
        case CARGO_MINERALS:
            commodity_amount = 1;
            DESTROY(commodity_type);
            commodity_type = @"minerals";
            cargo_type = CARGO_RANDOM;
            break;
            
        case CARGO_THARGOID:
            commodity_amount = 1;
            DESTROY(commodity_type);
            commodity_type = @"alien_items";
            cargo_type = CARGO_RANDOM;
            break;
            
        case CARGO_SCRIPTED_ITEM:
            commodity_amount = 1; // value > 0 is needed to be recognised as cargo by scripts;
            DESTROY(commodity_type); // will be defined elsewhere when needed.
            break;
            
        case CARGO_RANDOM:
            // Could already be set by the cargo_carried key. If not, ensure at least one.
            if (commodity_amount == 0) commodity_amount = 1;
            break;
 
        default:
            break;
    }
}

References CARGO_ALLOY, CARGO_MINERALS, CARGO_RANDOM, CARGO_SCRIPTED_ITEM, CARGO_SLAVES, CARGO_THARGOID, cargo_type, commodity_amount, commodity_type, DESTROY, and StringToCargoType().

Referenced by setUpShipFromDictionary:.

Here is the call graph for this function:

Here is the caller graph for this function:

setUpEscorts

- (void) setUpEscorts

Definition at line 1691 of file ShipEntity.m.

{
    // Ensure that we do not try to create escorts if we are an escort ship ourselves.
    // This could lead to circular reference memory overflows (e.g. "boa-mk2" trying to create 4 "boa-mk2"
    // escorts or the case of two ships specifying eachother as escorts) - Nikos 20090510
    if ([self isEscort])
    {
        OOLogWARN(@"ship.setUp.escortShipCircularReference", 
                @"Ship %@ requested escorts, when it is an escort ship itself. Avoiding possible circular reference overflow by ignoring escort setup.", self);
        return;
    }
 
    if ([shipinfoDictionary objectForKey:@"escort_roles"] != nil)
    {
        [self setUpMixedEscorts];
        return;
    }
 
    NSString        *defaultRole = @"escort";
    NSString        *escortRole = nil;
    NSString        *escortShipKey = nil;
    
    if (_pendingEscortCount == 0)  return;
    
    if (_maxEscortCount < _pendingEscortCount)
    {
        if ([self hasPrimaryRole:@"police"] || [self hasPrimaryRole:@"hunter"])
        {
            _maxEscortCount = MAX_ESCORTS; // police and hunters get up to MAX_ESCORTS, overriding the 'escorts' key.
            [self updateEscortFormation];
        }
        else
        {
            _pendingEscortCount = _maxEscortCount;    // other ships can only get what's defined inside their 'escorts' key.
        }
    }
    
    if ([self isPolice])  defaultRole = @"wingman";
    
    escortRole = [shipinfoDictionary oo_stringForKey:@"escort_role" defaultValue:nil];
    if (escortRole == nil)
        escortRole = [shipinfoDictionary oo_stringForKey:@"escort-role" defaultValue:defaultRole];
    if (![escortRole isEqualToString: defaultRole])
    {
        if (![[UNIVERSE newShipWithRole:escortRole] autorelease])
        {
            escortRole = defaultRole;
        }
    }
    
    escortShipKey = [shipinfoDictionary oo_stringForKey:@"escort_ship" defaultValue:nil];
    if (escortShipKey == nil)
        escortShipKey = [shipinfoDictionary oo_stringForKey:@"escort-ship"];
    
    if (escortShipKey != nil)
    {
        if (![[UNIVERSE newShipWithName:escortShipKey] autorelease])
        {
            escortShipKey = nil;
        }
        else
        {
            escortRole = [NSString stringWithFormat:@"[%@]",escortShipKey];
        }
    }
 
    OOShipGroup *escortGroup = [self escortGroup];
    if ([self group] == nil)
    {
        [self setGroup:escortGroup]; // should probably become a copy of the escortGroup post NMSR.
    }
    [escortGroup setLeader:self];
    
    [self refreshEscortPositions];
    
    uint8_t currentEscortCount = [escortGroup count] - 1;  // always at least 0.
    
    while (_pendingEscortCount > 0 && ([self isThargoid] || currentEscortCount < _maxEscortCount))
    {
         // The following line adds escort 1 in position 1, etc... up to MAX_ESCORTS.
        HPVector ex_pos = [self coordinatesForEscortPosition:currentEscortCount];
        
        ShipEntity *escorter = nil;
        
        escorter = [UNIVERSE newShipWithRole:escortRole];   // retained
        
        if (escorter == nil)  break;
        [self setUpOneEscort:escorter inGroup:escortGroup withRole:escortRole atPosition:ex_pos andCount:currentEscortCount];
 
        [escorter release];
 
        _pendingEscortCount--;
        currentEscortCount = [escortGroup count] - 1;
    }
    // done assigning escorts
    _pendingEscortCount = 0;
}

References _maxEscortCount, _pendingEscortCount, coordinatesForEscortPosition:, OOShipGroup::count, escortGroup, group, isEscort, isPolice, isThargoid, MAX_ESCORTS, nil, OOLogWARN, refreshEscortPositions, setGroup:, OOShipGroup::setLeader:, setUpEscorts, setUpMixedEscorts, setUpOneEscort:inGroup:withRole:atPosition:andCount:, shipinfoDictionary, UNIVERSE, and updateEscortFormation.

Referenced by findBoundingBoxRelativeToPosition:InVectors:i:j:, StationEntity::launchIndependentShip:, setUpEscorts, and wasAddedToUniverse.

Here is the call graph for this function:

Here is the caller graph for this function:

setUpFromDictionary:

- (BOOL) setUpFromDictionary:

(NSDictionary *)

shipDict

Definition at line 240 of file ShipEntity.m.

                            :(NSDictionary *) shipDict
{
    OOJS_PROFILE_ENTER
    
    // Settings shared by players & NPCs.
    //
    // In order for default values to work and float values to not be junk,
    // replace nil with empty dictionary. -- Ahruman 2008-04-28
    shipinfoDictionary = [shipDict copy];
    if (shipinfoDictionary == nil)  shipinfoDictionary = [[NSDictionary alloc] init];
    shipDict = shipinfoDictionary;    // Ensure no mutation.
    
    // set these flags explicitly.
    haveExecutedSpawnAction = NO;
    haveStartedJSAI = NO;
    scripted_misjump        = NO;
    _scriptedMisjumpRange      = 0.5;
    being_fined = NO;
    isNearPlanetSurface = NO;
    suppressAegisMessages = NO;
    isMissile = NO;
    suppressExplosion = NO;
    _lightsActive = YES;
    
 
    // set things from dictionary from here out - default values might require adjustment -- Kaks 20091130
    _scaleFactor = [shipDict oo_floatForKey:@"model_scale_factor" defaultValue:1.0f];
 
 
    float defaultSpeed = isStation ? 0.0f : 160.0f;
    maxFlightSpeed = [shipDict oo_floatForKey:@"max_flight_speed" defaultValue:defaultSpeed];
    max_flight_roll = [shipDict oo_floatForKey:@"max_flight_roll" defaultValue:2.0f];
    max_flight_pitch = [shipDict oo_floatForKey:@"max_flight_pitch" defaultValue:1.0f];
    max_flight_yaw = [shipDict oo_floatForKey:@"max_flight_yaw" defaultValue:max_flight_pitch];   // Note by default yaw == pitch
    cruiseSpeed = maxFlightSpeed*0.8f;
    
    max_thrust = [shipDict oo_floatForKey:@"thrust" defaultValue:15.0f];
    thrust = max_thrust;
 
    afterburner_rate = [shipDict oo_floatForKey:@"injector_burn_rate" defaultValue:AFTERBURNER_BURNRATE];
    afterburner_speed_factor = [shipDict oo_floatForKey:@"injector_speed_factor" defaultValue:7.0f];
    if (afterburner_speed_factor < 1.0)
    {
        OOLog(@"ship.setup.injectorSpeed",@"injector_speed_factor cannot be lower than 1.0 for %@",self);
        afterburner_speed_factor = 1.0;
    }
#if OO_VARIABLE_TORUS_SPEED
    else if (afterburner_speed_factor > MIN_HYPERSPEED_FACTOR)
    {
        OOLog(@"ship.setup.injectorSpeed",@"injector_speed_factor cannot be higher than minimum torus speed factor (%f) for %@.",MIN_HYPERSPEED_FACTOR,self);
        afterburner_speed_factor = MIN_HYPERSPEED_FACTOR;
    }
#else
    else if (afterburner_speed_factor > HYPERSPEED_FACTOR)
    {
        OOLog(@"ship.setup.injectorSpeed",@"injector_speed_factor cannot be higher than torus speed factor (%f) for %@.",HYPERSPEED_FACTOR,self);
        afterburner_speed_factor = HYPERSPEED_FACTOR;
    }
#endif
 
    maxEnergy = [shipDict oo_floatForKey:@"max_energy" defaultValue:200.0f];
    energy_recharge_rate = [shipDict oo_floatForKey:@"energy_recharge_rate" defaultValue:1.0f];
    
    _showDamage = [shipDict oo_boolForKey:@"show_damage" defaultValue:(energy_recharge_rate > 0)];
    // Each new ship should start in seemingly good operating condition, unless specifically told not to - this does not affect the ship's energy levels
    [self setThrowSparks:[shipDict oo_boolForKey:@"throw_sparks" defaultValue:NO]];
    
    weapon_facings = [shipDict oo_intForKey:@"weapon_facings" defaultValue:VALID_WEAPON_FACINGS] & VALID_WEAPON_FACINGS;
    if (weapon_facings & WEAPON_FACING_FORWARD)
        forward_weapon_type = OOWeaponTypeFromString([shipDict oo_stringForKey:@"forward_weapon_type" defaultValue:@"EQ_WEAPON_NONE"]);
    if (weapon_facings & WEAPON_FACING_AFT)
        aft_weapon_type = OOWeaponTypeFromString([shipDict oo_stringForKey:@"aft_weapon_type" defaultValue:@"EQ_WEAPON_NONE"]);
    if (weapon_facings & WEAPON_FACING_PORT)
        port_weapon_type = OOWeaponTypeFromString([shipDict oo_stringForKey:@"port_weapon_type" defaultValue:@"EQ_WEAPON_NONE"]);
    if (weapon_facings & WEAPON_FACING_STARBOARD)
        starboard_weapon_type = OOWeaponTypeFromString([shipDict oo_stringForKey:@"starboard_weapon_type" defaultValue:@"EQ_WEAPON_NONE"]);
 
    cloaking_device_active = NO;
    military_jammer_active = NO;
    cloakPassive = [shipDict oo_boolForKey:@"cloak_passive" defaultValue:YES]; // Nikos - switched passive cloak default to YES 20120523
    cloakAutomatic = [shipDict oo_boolForKey:@"cloak_automatic" defaultValue:YES];
 
    missiles = [shipDict oo_intForKey:@"missiles" defaultValue:0];
    /* TODO: The following initializes the missile list to be blank, which prevents a crash caused by hasOneEquipmentItem trying to access a missile list
             previously initialized but then released.  See issue #204.  We need to investigate further the cause of the missile list being released.
            - kanthoney 10/03/2017
        Update 20170818: The issue seems to have been resolved properly using the fix below and the problem was apparently an access of the
        missile_list array elements before their initialization and while we were checking whether equipment can be added or not. There is
        probably not much more that can be done here, unless someone would like to have a go at refactoring the entire ship initialization
        code. In any case, the crash is no more and the applied solution is both simple and logical - Nikos
    */
    unsigned i;
    for (i = 0; i < missiles; i++)
    {
        missile_list[i] = nil;
    }
    max_missiles = [shipDict oo_intForKey:@"max_missiles" defaultValue:missiles];
    if (max_missiles > SHIPENTITY_MAX_MISSILES) max_missiles = SHIPENTITY_MAX_MISSILES;
    if (missiles > max_missiles) missiles = max_missiles;
    missile_load_time = fmax(0.0, [shipDict oo_doubleForKey:@"missile_load_time" defaultValue:0.0]); // no negative load times
    missile_launch_time = [UNIVERSE getTime] + missile_load_time;
    
    // upgrades:
    equipment_weight = 0; 
    if ([shipDict oo_fuzzyBooleanForKey:@"has_ecm"])  [self addEquipmentItem:@"EQ_ECM" inContext:@"npc"];
    if ([shipDict oo_fuzzyBooleanForKey:@"has_scoop"])  [self addEquipmentItem:@"EQ_FUEL_SCOOPS" inContext:@"npc"];
    if ([shipDict oo_fuzzyBooleanForKey:@"has_escape_pod"])  [self addEquipmentItem:@"EQ_ESCAPE_POD" inContext:@"npc"];
    if ([shipDict oo_fuzzyBooleanForKey:@"has_cloaking_device"])  [self addEquipmentItem:@"EQ_CLOAKING_DEVICE" inContext:@"npc"];
    if ([shipDict oo_floatForKey:@"has_energy_bomb"] > 0)
    {
        /*  NOTE: has_energy_bomb actually refers to QC mines.
            
            max_missiles for NPCs is a newish addition, and ships have
            traditionally not needed to reserve a slot for a Q-mine added this
            way. If has_energy_bomb is possible, and max_missiles is not
            explicit, we add an extra missile slot to compensate.
            -- Ahruman 2011-03-25
        */
        if ([shipDict oo_fuzzyBooleanForKey:@"has_energy_bomb"])
        {
            if (max_missiles == missiles && max_missiles < SHIPENTITY_MAX_MISSILES && [shipDict objectForKey:@"max_missiles"] == nil)
            {
                max_missiles++;
            }
            [self addEquipmentItem:@"EQ_QC_MINE" inContext:@"npc"];
        }
    }
 
    if ([shipDict oo_fuzzyBooleanForKey:@"has_fuel_injection"])  [self addEquipmentItem:@"EQ_FUEL_INJECTION" inContext:@"npc"];
 
#if USEMASC
    if ([shipDict oo_fuzzyBooleanForKey:@"has_military_jammer"])  [self addEquipmentItem:@"EQ_MILITARY_JAMMER" inContext:@"npc"];
    if ([shipDict oo_fuzzyBooleanForKey:@"has_military_scanner_filter"])  [self addEquipmentItem:@"EQ_MILITARY_SCANNER_FILTER" inContext:@"npc"];
#endif
    
    
    // can it be 'mined' for alloys?
    canFragment = [shipDict oo_fuzzyBooleanForKey:@"fragment_chance" defaultValue:0.9];
    isWreckage = NO;
 
    // can subentities be destroyed separately?
    isFrangible = [shipDict oo_boolForKey:@"frangible" defaultValue:YES];
    
    max_cargo = [shipDict oo_unsignedIntForKey:@"max_cargo"];
    extra_cargo = [shipDict oo_unsignedIntForKey:@"extra_cargo" defaultValue:15];
    
    hyperspaceMotorSpinTime = [shipDict oo_floatForKey:@"hyperspace_motor_spin_time" defaultValue:DEFAULT_HYPERSPACE_SPIN_TIME];
    if(![shipDict oo_boolForKey:@"hyperspace_motor" defaultValue:YES]) hyperspaceMotorSpinTime = -1;
    
    [name autorelease];
    name = [[shipDict oo_stringForKey:@"name" defaultValue:@"?"] copy];
    
    [shipUniqueName autorelease];
    shipUniqueName = [[shipDict oo_stringForKey:@"ship_name" defaultValue:@""] copy];
 
    [shipClassName autorelease];
    shipClassName = [[shipDict oo_stringForKey:@"ship_class_name" defaultValue:name] copy];
 
    [displayName autorelease];
    displayName = [[shipDict oo_stringForKey:@"display_name" defaultValue:nil] copy];
    
    // Load the model (must be before subentities)
    NSString *modelName = [shipDict oo_stringForKey:@"model"];
    if (modelName != nil)
    {
        OOMesh *mesh = nil;
 
        mesh = [OOMesh meshWithName:modelName
                           cacheKey:[NSString stringWithFormat:@"%@-%.3f",_shipKey,_scaleFactor]
                 materialDictionary:[shipDict oo_dictionaryForKey:@"materials"]
                  shadersDictionary:[shipDict oo_dictionaryForKey:@"shaders"]
                             smooth:[shipDict oo_boolForKey:@"smooth" defaultValue:NO]
                       shaderMacros:OODefaultShipShaderMacros()
                       shaderBindingTarget:self
                        scaleFactor:_scaleFactor
                     cacheWriteable:YES];
 
        if (mesh == nil)  return NO;
        [self setMesh:mesh];
    }
    
    float density = [shipDict oo_floatForKey:@"density" defaultValue:1.0f];
    if (octree)  mass = (GLfloat)(density * 20.0f * [octree volume]);
    
    DESTROY(default_laser_color);
    default_laser_color = [[OOColor brightColorWithDescription:[shipDict objectForKey:@"laser_color"]] retain];
    
    if (default_laser_color == nil) 
    {
        [self setLaserColor:[OOColor redColor]];
    }
    else
    {
        [self setLaserColor:default_laser_color];
    }
    // exhaust emissive color
    OORGBAComponents defaultExhaustEmissiveColorComponents; // pale blue is exhaust default color
    defaultExhaustEmissiveColorComponents.r = 0.7f;
    defaultExhaustEmissiveColorComponents.g = 0.9f;
    defaultExhaustEmissiveColorComponents.b = 1.0f;
    defaultExhaustEmissiveColorComponents.a = 0.9f;
    OOColor *color = [OOColor brightColorWithDescription:[shipDict objectForKey:@"exhaust_emissive_color"]];
    if (color == nil)  color = [OOColor colorWithRGBAComponents:defaultExhaustEmissiveColorComponents];
    [self setExhaustEmissiveColor:color];
    
    [self clearSubEntities];
    [self setUpSubEntities];
 
// correctly initialise weaponRange, etc. (must be after subentity setup)
    if (isWeaponNone(forward_weapon_type))
    {
        OOWeaponType            weapon_type = nil;
        BOOL hasTurrets = NO;
        NSEnumerator    *subEnum = [self shipSubEntityEnumerator];
        ShipEntity      *se = nil;
        while (isWeaponNone(weapon_type) && (se = [subEnum nextObject]))
        {
            weapon_type = se->forward_weapon_type;
            if (se->behaviour == BEHAVIOUR_TRACK_AS_TURRET)
            {
                hasTurrets = YES;
            }
        }
        if (isWeaponNone(weapon_type) && hasTurrets)
        { /* safety for ships only equipped with turrets
             note: this was hard-coded to 10000.0, although turrets have a notably 
             shorter range. We are using a multiplier of 1.667 in order to not change
             something that already works, but probably it would be best to use
             TURRET_SHOT_RANGE * COMBAT_WEAPON_RANGE_FACTOR here
          */
            weaponRange = TURRET_SHOT_RANGE * 1.667;
        }
        else
        {
            [self setWeaponDataFromType:weapon_type];
        }
    }
    else
    {
        [self setWeaponDataFromType:forward_weapon_type];
    }
    
    // rotating subentities
    subentityRotationalVelocity = kIdentityQuaternion;
    if ([shipDict objectForKey:@"rotational_velocity"])
    {
        subentityRotationalVelocity = [shipDict oo_quaternionForKey:@"rotational_velocity"];
    }
 
    // set weapon offsets
    NSString *weaponMountMode = [shipDict oo_stringForKey:@"weapon_mount_mode" defaultValue:@"single"];
    _multiplyWeapons = [weaponMountMode isEqualToString:@"multiply"];
    forwardWeaponOffset = [[self getWeaponOffsetFrom:shipDict withKey:@"weapon_position_forward" inMode:weaponMountMode] retain];
    aftWeaponOffset = [[self getWeaponOffsetFrom:shipDict withKey:@"weapon_position_aft" inMode:weaponMountMode] retain];
    portWeaponOffset = [[self getWeaponOffsetFrom:shipDict withKey:@"weapon_position_port" inMode:weaponMountMode] retain];
    starboardWeaponOffset = [[self getWeaponOffsetFrom:shipDict withKey:@"weapon_position_starboard" inMode:weaponMountMode] retain];
 
    
    tractor_position = vector_multiply_scalar([shipDict oo_vectorForKey:@"scoop_position"],_scaleFactor);
    
 
    
    // sun glare filter - default is high filter, both for HDR and SDR
    [self setSunGlareFilter:[shipDict oo_floatForKey:@"sun_glare_filter" defaultValue:0.97f]];
    
    // Get scriptInfo dictionary, containing arbitrary stuff scripts might be interested in.
    scriptInfo = [[shipDict oo_dictionaryForKey:@"script_info" defaultValue:nil] retain];
 
    explosionType = [[shipDict oo_arrayForKey:@"explosion_type" defaultValue:nil] retain];
 
    isDemoShip = NO;
    
    return YES;
    
    OOJS_PROFILE_EXIT
}

References _lightsActive, _scriptedMisjumpRange, being_fined, haveExecutedSpawnAction, haveStartedJSAI, isMissile, isNearPlanetSurface, nil, OOJS_PROFILE_ENTER, scripted_misjump, shipinfoDictionary, suppressAegisMessages, and suppressExplosion.

setUpMixedEscorts

- (void) setUpMixedEscorts

implementation

Provided by category ShipEntity(Private).

Definition at line 1790 of file ShipEntity.m.

{
    NSArray *escortRoles = [shipinfoDictionary oo_arrayForKey:@"escort_roles" defaultValue:nil];
    if (escortRoles == nil)
    {
        OOLogWARN(@"eship.setUp.escortShipRoles", 
                  @"Ship %@ has bad escort_roles definition.", self);
        return;
    }
    NSEnumerator                *edefEnumerator = nil;
    NSDictionary                *escortDefinition = nil;
    NSDictionary        *systeminfo = nil;
    OOGovernmentID        government;
 
    systeminfo = [UNIVERSE currentSystemData];
    government = [systeminfo oo_unsignedCharForKey:KEY_GOVERNMENT];
 
    OOShipGroup *escortGroup = [self escortGroup];
    if ([self group] == nil)
    {
        [self setGroup:escortGroup]; // should probably become a copy of the escortGroup post NMSR.
    }
    [escortGroup setLeader:self];
    _maxEscortCount = MAX_ESCORTS;
    [self refreshEscortPositions];
    
    uint8_t currentEscortCount = [escortGroup count] - 1;  // always at least 0
    
    _maxEscortCount = 0;
    int8_t i = 0;
    for (edefEnumerator = [escortRoles objectEnumerator]; (escortDefinition = [edefEnumerator nextObject]); )
    {
        if (currentEscortCount >= MAX_ESCORTS)
        {
            break;
        }
        // int rather than uint because, at least for min, there is a
        // use to giving a negative value
        int8_t min = [escortDefinition oo_intForKey:@"min" defaultValue:0];
        int8_t max = [escortDefinition oo_intForKey:@"max" defaultValue:2];
        NSString *escortRole = [escortDefinition oo_stringForKey:@"role" defaultValue:@"escort"];
        int8_t desired = max;
        if (min < desired)
        {
            for (i = min ; i < max ; i++)
            {
                if (Ranrot()%11 < government+2)
                {
                    desired--;
                }
            }
        }
        for (i = 0; i < desired; i++)
        {
            if (currentEscortCount >= MAX_ESCORTS)
            {
                break;
            }
            if (![escortRole isEqualToString:@""])
            {
                HPVector ex_pos = [self coordinatesForEscortPosition:currentEscortCount];
                ShipEntity *escorter = [UNIVERSE newShipWithRole:escortRole];   // retained
                if (escorter == nil)
                {
                    break;
                }
                [self setUpOneEscort:escorter inGroup:escortGroup withRole:escortRole atPosition:ex_pos andCount:currentEscortCount];
                [escorter release];
            }
            currentEscortCount++;
            _maxEscortCount++;
        }
    }
    // done assigning escorts
    _pendingEscortCount = 0;
}

References coordinatesForEscortPosition:, OOShipGroup::count, escortGroup, MAX_ESCORTS, nil, OOLogWARN, Ranrot(), refreshEscortPositions, setGroup:, OOShipGroup::setLeader:, ShipEntity(Private)::setUpMixedEscorts, and setUpOneEscort:inGroup:withRole:atPosition:andCount:.

Referenced by setUpEscorts, and ShipEntity(Private)::setUpMixedEscorts.

Here is the call graph for this function:

Here is the caller graph for this function:

setUpOneEscort:inGroup:withRole:atPosition:andCount:

- (void) setUpOneEscort: (ShipEntity *) escorter inGroup: (OOShipGroup *) escortGroup withRole: (NSString *) escortRole atPosition: (HPVector) ex_pos andCount: (uint8_t) currentEscortCount

implementation

Provided by category ShipEntity(Private).

Definition at line 1868 of file ShipEntity.m.

                       :(ShipEntity *)escorter inGroup:(OOShipGroup *)escortGroup withRole:(NSString *)escortRole atPosition:(HPVector)ex_pos andCount:(uint8_t)currentEscortCount
{
    NSString        *autoAI = nil;
    NSString        *pilotRole = nil;
    NSDictionary    *autoAIMap = nil;
    NSDictionary    *escortShipDict = nil;
    AI              *escortAI = nil; 
    NSString        *defaultRole = @"escort";
 
    if ([self isPolice])
    {
        defaultRole = @"wingman";
        pilotRole = @"police"; // police are always insured.
    }
    else
    {
        pilotRole = bounty ? @"pirate" : @"hunter"; // hunters have insurancies, pirates not.
    }
    
    double dd = escorter->collision_radius;
        
    if (EXPECT(currentEscortCount < (uint8_t)MAX_ESCORTS))
    {
        // spread them around a little randomly
        ex_pos.x += dd * 6.0 * (randf() - 0.5);
        ex_pos.y += dd * 6.0 * (randf() - 0.5);
        ex_pos.z += dd * 6.0 * (randf() - 0.5);
    }
    else
    {
        // Thargoid armada(!) Add more distance between the 'escorts'.
        ex_pos.x += dd * 12.0 * (randf() - 0.5);
        ex_pos.y += dd * 12.0 * (randf() - 0.5);
        ex_pos.z += dd * 12.0 * (randf() - 0.5);
    }
        
    [escorter setPosition:ex_pos];   // minimise lollipop flash
        
    if ([escorter crew] == nil)
    {
        [escorter setSingleCrewWithRole:pilotRole];
    }
        
    [escorter setPrimaryRole:defaultRole];    //for mothership
    // in case this hasn't yet been set, make sure escorts get a real scan class
    // shouldn't happen very often, but is possible
    if (scanClass == CLASS_NOT_SET)
    {
        scanClass = CLASS_NEUTRAL;
    }
    [escorter setScanClass:scanClass];      // you are the same as I
        
    if ([self bounty] == 0)  [escorter setBounty:0 withReason:kOOLegalStatusReasonSetup]; // Avoid dirty escorts for clean mothers
        
    // find the right autoAI.
    escortShipDict = [escorter shipInfoDictionary];
    autoAIMap = [ResourceManager dictionaryFromFilesNamed:@"autoAImap.plist" inFolder:@"Config" andMerge:YES];
    autoAI = [autoAIMap oo_stringForKey:defaultRole];
    if (autoAI==nil) // no 'wingman' defined in autoAImap?
    {
        autoAI = [autoAIMap oo_stringForKey:@"escort" defaultValue:@"nullAI.plist"];
    }
        
    escortAI = [escorter getAI];
        
    // Let the populator decide which AI to use, unless we have a working alternative AI & we specify auto_ai = NO !
    if ( (escortRole && [escortShipDict oo_fuzzyBooleanForKey:@"auto_ai" defaultValue:YES])
         || ([[escortAI name] isEqualToString: @"nullAI.plist"] && ![autoAI isEqualToString:@"nullAI.plist"]) )
    {
        [escorter switchAITo:autoAI];
    }
 
    [escorter setGroup:escortGroup];
    [escorter setOwner:self];   // mark self as group leader
 
    
    if ([self status] == STATUS_DOCKED)
    {
        [[self owner] addShipToLaunchQueue:escorter withPriority:NO];
    }
    else
    {
        [UNIVERSE addEntity:escorter];  // STATUS_IN_FLIGHT, AI state GLOBAL
        [escortAI setState:@"FLYING_ESCORT"];   // Begin escort flight. (If the AI doesn't define FLYING_ESCORT, this has no effect.)
        [escorter doScriptEvent:OOJSID("spawnedAsEscort") withArgument:self];
    }
    
    if([escorter heatInsulation] < [self heatInsulation]) [escorter setHeatInsulation:[self heatInsulation]]; // give escorts same protection as mother.
    if(([escorter maxFlightSpeed] < cruiseSpeed) && ([escorter maxFlightSpeed] > cruiseSpeed * 0.3)) 
        cruiseSpeed = [escorter maxFlightSpeed] * 0.99;  // adapt patrolSpeed to the slowest escort but ignore the very slow ones.
        
        
    if (bounty)
    {
        int extra = 1 | (ranrot_rand() & 15);
        // if mothership is offender, make sure escorter is too.
        [escorter markAsOffender:extra withReason:kOOLegalStatusReasonSetup];
    }
    else
    {
        // otherwise force the escort to be clean
        [escorter setBounty:0 withReason:kOOLegalStatusReasonSetup];
    }
    
}

References Entity::collision_radius, ResourceManager::dictionaryFromFilesNamed:inFolder:andMerge:, doScriptEvent:withArgument:, EXPECT, getAI, heatInsulation, markAsOffender:withReason:, MAX_ESCORTS, maxFlightSpeed, nil, Entity::owner, randf(), ranrot_rand, setBounty:withReason:, setGroup:, setHeatInsulation:, setOwner:, Entity::setPosition:, setPrimaryRole:, Entity::setScanClass:, setSingleCrewWithRole:, AI::setState:, shipInfoDictionary, and switchAITo:.

Referenced by setUpEscorts, and ShipEntity(Private)::setUpMixedEscorts.

Here is the call graph for this function:

Here is the caller graph for this function:

setUpOneFlasher:

- (BOOL) setUpOneFlasher: (NSDictionary *) subentDict

implementation

Provided by category ShipEntity(Private).

Definition at line 926 of file ShipEntity.m.

                        :(NSDictionary *) subentDict
{
    OOFlasherEntity *flasher = [OOFlasherEntity flasherWithDictionary:subentDict];
    [flasher setPosition:HPvector_multiply_scalar([subentDict oo_hpvectorForKey:@"position"],_scaleFactor)];
    [flasher rescaleBy:_scaleFactor];
    [self addSubEntity:flasher];
    return YES;
}

References addSubEntity:, OOFlasherEntity::flasherWithDictionary:, OOFlasherEntity::rescaleBy:, and Entity::setPosition:.

Referenced by ShipEntity(Private)::setUpOneSubentity:.

Here is the call graph for this function:

Here is the caller graph for this function:

setUpOneStandardSubentity:asTurret:

- (BOOL) setUpOneStandardSubentity:		(NSDictionary *)	subentDict
asTurret:		(BOOL)	asTurret

Definition at line 936 of file ShipEntity.m.

                                  :(NSDictionary *)subentDict asTurret:(BOOL)asTurret
{
    ShipEntity          *subentity = nil;
    NSString            *subentKey = nil;
    HPVector                subPosition;
    Quaternion          subOrientation;
    
    subentKey = [subentDict oo_stringForKey:@"subentity_key"];
    if (subentKey == nil) {
        OOLog(@"setup.ship.badEntry.subentities",@"Failed to set up entity - no subentKey in %@",subentDict);
        return NO;
    }
    
    if (!asTurret && [self isStation] && [subentDict oo_boolForKey:@"is_dock"])
    {
        subentity = [UNIVERSE newDockWithName:subentKey andScaleFactor:_scaleFactor];
    }
    else 
    {
        subentity = [UNIVERSE newSubentityWithName:subentKey andScaleFactor:_scaleFactor];
    }
    if (subentity == nil) {
        OOLog(@"setup.ship.badEntry.subentities",@"Failed to set up entity %@",subentKey);
        return NO;
    }
    
    subPosition = HPvector_multiply_scalar([subentDict oo_hpvectorForKey:@"position"],_scaleFactor);
    subOrientation = [subentDict oo_quaternionForKey:@"orientation"];
    
    [subentity setPosition:subPosition];
    [subentity setOrientation:subOrientation];
    [subentity setReference:vector_forward_from_quaternion(subOrientation)];
    // subentities inherit parent personality
    [subentity setEntityPersonalityInt:[self entityPersonalityInt]];
 
    if (asTurret)
    {
        [subentity setBehaviour:BEHAVIOUR_TRACK_AS_TURRET];
        [subentity setWeaponRechargeRate:[subentDict oo_floatForKey:@"fire_rate" defaultValue:TURRET_SHOT_FREQUENCY]];
        [subentity setWeaponEnergy:[subentDict oo_floatForKey:@"weapon_energy" defaultValue:TURRET_TYPICAL_ENERGY]];
        [subentity setWeaponRange:[subentDict oo_floatForKey:@"weapon_range" defaultValue:TURRET_SHOT_RANGE]];
        [subentity setStatus: STATUS_ACTIVE];
    }
    else
    {
        [subentity setStatus:STATUS_INACTIVE];
    }
    
    [subentity overrideScriptInfo:[subentDict oo_dictionaryForKey:@"script_info"]];
    
    [self addSubEntity:subentity];
    [subentity setSubIdx:_maxShipSubIdx];
    _maxShipSubIdx++;
    
    // update subentities
    BoundingBox sebb = [subentity findSubentityBoundingBox];
    bounding_box_add_vector(&totalBoundingBox, sebb.max);
    bounding_box_add_vector(&totalBoundingBox, sebb.min);
 
    if (!asTurret && [self isStation] && [subentDict oo_boolForKey:@"is_dock"])
    {
        BOOL allow_docking = [subentDict oo_boolForKey:@"allow_docking" defaultValue:YES];
        BOOL ddc = [subentDict oo_boolForKey:@"disallowed_docking_collides" defaultValue:NO];
        BOOL allow_launching = [subentDict oo_boolForKey:@"allow_launching" defaultValue:YES];
        // do not include this key in OOShipRegistry; should never be set by shipdata
        BOOL virtual_dock = [subentDict oo_boolForKey:@"_is_virtual_dock" defaultValue:NO];
        if (virtual_dock)
        {
            [(DockEntity *)subentity setVirtual];
        }
        
        [(DockEntity *)subentity setDimensionsAndCorridor:allow_docking:ddc:allow_launching];
        [subentity setDisplayName:[subentDict oo_stringForKey:@"dock_label" defaultValue:@"the docking bay"]];
    }
 
    [subentity release];
    
    return YES;
}

References _maxShipSubIdx, _scaleFactor, addSubEntity:, entityPersonalityInt, findSubentityBoundingBox, Entity::isStation, nil, OOLog, overrideScriptInfo:, setBehaviour:, setDisplayName:, setEntityPersonalityInt:, Entity::setOrientation:, Entity::setPosition:, setReference:, setStatus:, setSubIdx:, DockEntity::setVirtual, setWeaponEnergy:, setWeaponRange:, setWeaponRechargeRate:, and totalBoundingBox.

Referenced by ShipEntity(Private)::setUpOneSubentity:.

Here is the call graph for this function:

Here is the caller graph for this function:

setUpOneSubentity:

- (BOOL) setUpOneSubentity: (NSDictionary *) subentDict

implementation

Provided by category ShipEntity(Private).

Definition at line 906 of file ShipEntity.m.

                          :(NSDictionary *) subentDict
{
    OOJS_PROFILE_ENTER
    
    NSString            *type = nil;
    
    type = [subentDict oo_stringForKey:@"type"];
    if ([type isEqualToString:@"flasher"])
    {
        return [self setUpOneFlasher:subentDict];
    }
    else
    {
        return [self setUpOneStandardSubentity:subentDict asTurret:[type isEqualToString:@"ball_turret"]];
    }
    
    OOJS_PROFILE_EXIT
}

References nil, OOJS_PROFILE_ENTER, OOJS_PROFILE_EXIT, setUpOneFlasher:, and setUpOneStandardSubentity:asTurret:.

Referenced by setUpSubEntities.

Here is the call graph for this function:

Here is the caller graph for this function:

setUpShipFromDictionary:

- (BOOL) setUpShipFromDictionary:

(NSDictionary *)

shipDict

Reimplemented in DockEntity, PlayerEntity, and StationEntity.

Definition at line 519 of file ShipEntity.m.

                                :(NSDictionary *) shipDict
{
    OOJS_PROFILE_ENTER
    
    if (![self setUpFromDictionary:shipDict]) return NO;
    
    // NPC-only settings.
    //
    orientation = kIdentityQuaternion;
    rotMatrix  = kIdentityMatrix;
    v_forward  = kBasisZVector;
    v_up        = kBasisYVector;
    v_right      = kBasisXVector;
    reference  = v_forward;  // reference vector for (* turrets *)
    
    isShip = YES;
 
    // scan class settings. 'scanClass' is in common usage, but we could also have a more standard 'scan_class' key with higher precedence. Kaks 20090810 
    // let's see if scan_class is set... 
    scanClass = OOScanClassFromString([shipDict oo_stringForKey:@"scan_class" defaultValue:@"CLASS_NOT_SET"]);
    
    // if not, try 'scanClass'. NOTE: non-standard capitalization is documented and entrenched.
    if (scanClass == CLASS_NOT_SET)
    {
        scanClass = OOScanClassFromString([shipDict oo_stringForKey:@"scanClass" defaultValue:@"CLASS_NOT_SET"]);
    }
 
    [scan_description autorelease];
    scan_description = [[shipDict oo_stringForKey:@"scan_description" defaultValue:nil] copy];
 
    // FIXME: give NPCs shields instead.
    
    if ([shipDict oo_fuzzyBooleanForKey:@"has_shield_booster"])  [self addEquipmentItem:@"EQ_SHIELD_BOOSTER" inContext:@"npc"];
    if ([shipDict oo_fuzzyBooleanForKey:@"has_shield_enhancer"])  [self addEquipmentItem:@"EQ_SHIELD_ENHANCER" inContext:@"npc"];
    
    // Start with full energy banks.
    energy = maxEnergy;
    weapon_temp              = 0.0f;
    forward_weapon_temp      = 0.0f;
    aft_weapon_temp          = 0.0f;
    port_weapon_temp        = 0.0f;
    starboard_weapon_temp  = 0.0f;
    
    // setWeaponDataFromType inside setUpFromDictionary should set weapon_damage from the front laser.
    // no weapon_damage? It's a missile: set weapon_damage from shipdata!
    if (weapon_damage == 0.0) 
    {
        weapon_damage_override = weapon_damage = [shipDict oo_floatForKey:@"weapon_energy" defaultValue:0]; // any damage value for missiles/bombs
    }
    else
    {
        weapon_damage_override = 0;
    }
 
    scannerRange = [shipDict oo_floatForKey:@"scanner_range" defaultValue:(float)SCANNER_MAX_RANGE];
    
    fuel = [shipDict oo_unsignedShortForKey:@"fuel"];   // Does it make sense that this defaults to 0? Should it not be 70? -- Ahruman
    
    fuel_accumulator = 1.0;
    
    [self setBounty:[shipDict oo_unsignedIntForKey:@"bounty" defaultValue:0] withReason:kOOLegalStatusReasonSetup];
    
    [shipAI autorelease];
    shipAI = [[AI alloc] init];
    [shipAI setOwner:self];
    [self setAITo:[shipDict oo_stringForKey:@"ai_type" defaultValue:@"nullAI.plist"]];
    
    likely_cargo = [shipDict oo_unsignedIntForKey:@"likely_cargo"];
    noRocks = [shipDict oo_fuzzyBooleanForKey:@"no_boulders"];
    
    commodity_amount = 0;
    commodity_type = nil;
    NSString *cargoString = [shipDict oo_stringForKey:@"cargo_carried"];
    if (cargoString != nil)
    {
        if ([cargoString isEqualToString:@"SCARCE_GOODS"])
        {
            cargo_flag = CARGO_FLAG_FULL_SCARCE;
        }
        else if ([cargoString isEqualToString:@"PLENTIFUL_GOODS"])
        {
            cargo_flag = CARGO_FLAG_FULL_PLENTIFUL;
        }
        else
        {
            cargo_flag = CARGO_FLAG_FULL_UNIFORM;
 
            OOCommodityType  c_commodity = nil;
            int             c_amount = 1;
            NSScanner       *scanner = [NSScanner scannerWithString:cargoString];
            if ([scanner scanInt:&c_amount])
            {
                [scanner ooliteScanCharactersFromSet:[NSCharacterSet whitespaceCharacterSet] intoString:NULL];  // skip whitespace
                c_commodity = [[scanner string] substringFromIndex:[scanner scanLocation]];
                if ([[UNIVERSE commodities] goodDefined:c_commodity])
                {
                    [self setCommodityForPod:c_commodity andAmount:c_amount];
                } 
                else
                {
                    c_commodity = [[UNIVERSE commodities] goodNamed:c_commodity];
                    if ([[UNIVERSE commodities] goodDefined:c_commodity])
                    {
                        [self setCommodityForPod:c_commodity andAmount:c_amount];
                    }
                }                   
            }
            else
            {
                c_amount = 1;
                c_commodity = [shipDict oo_stringForKey:@"cargo_carried"];
                if ([[UNIVERSE commodities] goodDefined:c_commodity])
                {
                    [self setCommodityForPod:c_commodity andAmount:c_amount];
                } 
                else
                {
                    c_commodity = [[UNIVERSE commodities] goodNamed:c_commodity];
                    if ([[UNIVERSE commodities] goodDefined:c_commodity])
                    {
                        [self setCommodityForPod:c_commodity andAmount:c_amount];
                    }
                }
            }
        }
    }
    
    cargoString = [shipDict oo_stringForKey:@"cargo_type"];
    if (cargoString)
    {
        if (cargo != nil) [cargo autorelease];
        cargo = [[NSMutableArray alloc] initWithCapacity:max_cargo]; // alloc retains;
        
        [self setUpCargoType:cargoString];
    }
    else if (scanClass != CLASS_CARGO)
    {
        if (cargo != nil) [cargo autorelease];
        cargo = [[NSMutableArray alloc] initWithCapacity:max_cargo]; // alloc retains;
        // if not CLASS_CARGO, and no cargo type set, default to CARGO_NOT_CARGO
        cargo_type = CARGO_NOT_CARGO;
    }
    
    hasScoopMessage = [shipDict oo_boolForKey:@"has_scoop_message" defaultValue:YES];
 
    
    [roleSet release];
    roleSet = [[[OORoleSet roleSetWithString:[shipDict oo_stringForKey:@"roles"]] roleSetWithRemovedRole:@"player"] retain];
    [primaryRole release];
    primaryRole = nil;
    
    [self setOwner:self];
    [self setHulk:[shipDict oo_boolForKey:@"is_hulk"]];
    
    // these are the colors used for the "lollipop" of the ship. Any of the two (or both, for flash effect) can be defined. nil means use default from shipData.
    [self setScannerDisplayColor1:nil];
    [self setScannerDisplayColor2:nil];
    // and the same for the "hostile" colours
    [self setScannerDisplayColorHostile1:nil];
    [self setScannerDisplayColorHostile2:nil];
 
 
    // Populate the missiles here. Must come after scanClass.
    _missileRole = [shipDict oo_stringForKey:@"missile_role"];
    unsigned    i, j;
    for (i = 0, j = 0; i < missiles; i++)
    {
        missile_list[i] = [self selectMissile];
        // could loop forever (if missile_role is badly defined, selectMissile might return nil in some cases) . Try 3 times, and if no luck, skip
        if (missile_list[i] == nil && j < 3)
        {
            j++;
            i--;
        }
        else
        {
            j = 0;
            if (missile_list[i] == nil)
            {
                missiles--;
            }
        }
    }
 
    // accuracy. Must come after scanClass, because we are using scanClass to determine if this is a missile.
 
// missiles: range 0 to +10
// ships: range -5 to +10, but randomly only -5 <= accuracy < +5
// enables "better" AIs at +5 and above
// police and military always have positive accuracy
 
    accuracy = [shipDict oo_floatForKey:@"accuracy" defaultValue:-100.0f];  // Out-of-range default
    if (accuracy < -5.0f || accuracy > 10.0f)
    {
        accuracy = (randf() * 10.0)-5.0;
 
        if (accuracy < 0.0f && (scanClass == CLASS_MILITARY || scanClass == CLASS_POLICE))
        { // police and military pilots have a better average skill. 
            accuracy = -accuracy;
        }
    }
    if (scanClass == CLASS_MISSILE)
    { // missile accuracy range is 0 to 10
        accuracy = OOClamp_0_max_f(accuracy, 10.0f);
    }
    [self setAccuracy:accuracy]; // set derived variables
    _missed_shots = 0;
 
    //  escorts
    _maxEscortCount = MIN([shipDict oo_unsignedCharForKey:@"escorts" defaultValue:0], (uint8_t)MAX_ESCORTS);
    _pendingEscortCount = _maxEscortCount;
    if (_pendingEscortCount == 0 && [shipDict oo_arrayForKey:@"escort_roles" defaultValue:nil] != nil)
    {
        // mostly ignored by setUpMixedEscorts, but needs to be high
        // enough that it doesn't end up at zero (e.g. by governmental
        // reductions in [Universe addShipAt]
        _pendingEscortCount = MAX_ESCORTS;
    }
 
    
    // beacons
    [self setBeaconCode:[shipDict oo_stringForKey:@"beacon"]];
    [self setBeaconLabel:[shipDict oo_stringForKey:@"beacon_label" defaultValue:[shipDict oo_stringForKey:@"beacon"]]];
 
    
    // contact tracking entities
    [self setTrackCloseContacts:[shipDict oo_boolForKey:@"track_contacts" defaultValue:NO]];
    
    // ship skin insulation factor (1.0 is normal)
    [self setHeatInsulation:[shipDict oo_floatForKey:@"heat_insulation" defaultValue:[self hasHeatShield] ? 2.0 : 1.0]];
    
    // unpiloted (like missiles asteroids etc.)
    _explicitlyUnpiloted = [shipDict oo_fuzzyBooleanForKey:@"unpiloted"];
    if (_explicitlyUnpiloted)
    {
        [self setCrew:nil];
    }
    else 
    {
        // crew and passengers
        NSDictionary *cdict = [[UNIVERSE characters] objectForKey:[shipDict oo_stringForKey:@"pilot"]];
        if (cdict != nil)
        {
            OOCharacter *pilot = [OOCharacter characterWithDictionary:cdict];
            [self setCrew:[NSArray arrayWithObject:pilot]];
        }
    }
    
    [self setShipScript:[shipDict oo_stringForKey:@"script"]];
 
    home_system = [UNIVERSE currentSystemID];
    destination_system = [UNIVERSE currentSystemID];
 
    reactionTime = [shipDict oo_floatForKey: @"reaction_time" defaultValue: COMBAT_AI_STANDARD_REACTION_TIME];
    
    return YES;
    
    OOJS_PROFILE_EXIT
}

References _explicitlyUnpiloted, _maxEscortCount, _missed_shots, _missileRole, _pendingEscortCount, accuracy, addEquipmentItem:inContext:, aft_weapon_temp, cargo, cargo_flag, CARGO_FLAG_FULL_PLENTIFUL, CARGO_FLAG_FULL_SCARCE, CARGO_FLAG_FULL_UNIFORM, CARGO_NOT_CARGO, cargo_type, OOCharacter::characterWithDictionary:, commodity_amount, commodity_type, destination_system, Entity::energy, forward_weapon_temp, fuel, fuel_accumulator, hasHeatShield, hasScoopMessage, home_system, Entity::isShip, kBasisXVector, kBasisYVector, kBasisZVector, kIdentityMatrix, kIdentityQuaternion, likely_cargo, MAX_ESCORTS, Entity::maxEnergy, MIN, missile_list, missiles, nil, noRocks, OOJS_PROFILE_ENTER, OOJS_PROFILE_EXIT, OOScanClassFromString(), Entity::orientation, port_weapon_temp, primaryRole, randf(), reactionTime, reference, roleSet, OORoleSet::roleSetWithString:, Entity::rotMatrix, scan_description, scanClass, scannerRange, selectMissile, setAccuracy:, setAITo:, setBeaconCode:, setBeaconLabel:, setBounty:withReason:, setCommodityForPod:andAmount:, setCrew:, setHeatInsulation:, setHulk:, AI::setOwner:, setOwner:, setScannerDisplayColor1:, setScannerDisplayColor2:, setScannerDisplayColorHostile1:, setScannerDisplayColorHostile2:, setShipScript:, setTrackCloseContacts:, setUpCargoType:, shipAI, starboard_weapon_temp, UNIVERSE, v_forward, v_right, v_up, weapon_damage, weapon_damage_override, and weapon_temp.

Here is the call graph for this function:

setUpSubEntities

- (BOOL) setUpSubEntities

Reimplemented in StationEntity.

Definition at line 855 of file ShipEntity.m.

{
    OOJS_PROFILE_ENTER
    
    unsigned int    i;
    NSDictionary    *shipDict = [self shipInfoDictionary];
    NSArray         *plumes = [shipDict oo_arrayForKey:@"exhaust"];
    
    _profileRadius = collision_radius;
    _maxShipSubIdx = 0;
    
    for (i = 0; i < [plumes count]; i++)
    {
        NSArray *definition = ScanTokensFromString([plumes oo_stringAtIndex:i]);
        OOExhaustPlumeEntity *exhaust = [OOExhaustPlumeEntity exhaustForShip:self withDefinition:definition andScale:_scaleFactor];
        [self addSubEntity:exhaust];
    }
    
    NSArray *subs = [shipDict oo_arrayForKey:@"subentities"];
    
    totalBoundingBox = boundingBox;
    
    for (i = 0; i < [subs count]; i++)
    {
        [self setUpOneSubentity:[subs oo_dictionaryAtIndex:i]];
    }
    
    no_draw_distance = _profileRadius * _profileRadius * NO_DRAW_DISTANCE_FACTOR * NO_DRAW_DISTANCE_FACTOR * 2.0;
    
    return YES;
    
    OOJS_PROFILE_EXIT
}

References _maxShipSubIdx, _profileRadius, addSubEntity:, Entity::boundingBox, Entity::collision_radius, OOExhaustPlumeEntity::exhaustForShip:withDefinition:andScale:, Entity::no_draw_distance, NO_DRAW_DISTANCE_FACTOR, OOJS_PROFILE_ENTER, OOJS_PROFILE_EXIT, ScanTokensFromString(), setUpOneSubentity:, setUpSubEntities, shipInfoDictionary, and totalBoundingBox.

Referenced by findBoundingBoxRelativeToPosition:InVectors:i:j:, PlayerEntity(Contracts)::newShipCommonSetup:yardInfo:baseInfo:, setUpSubEntities, ShipRestoreSubEntities(), and PlayerEntity(OOPrivate)::tryBuyingItem:.

Here is the call graph for this function:

Here is the caller graph for this function:

setWeaponDataFromType:

- (void) setWeaponDataFromType:

(OOWeaponType)

weapon_type

Definition at line 7482 of file ShipEntity.m.

                              : (OOWeaponType) weapon_type
{
    weaponRange = getWeaponRangeFromType(weapon_type);
    weapon_energy_use = [weapon_type weaponEnergyUse];
    weapon_recharge_rate = [weapon_type weaponRechargeRate];
    weapon_shot_temperature = [weapon_type weaponShotTemperature];
    weapon_damage = [weapon_type weaponDamage];
 
    if (default_laser_color == nil)
    {
        OOColor *wcol = [weapon_type weaponColor];
        if (wcol != nil)
        {
            [self setLaserColor:wcol];
        }
    }
 
}

References default_laser_color, getWeaponRangeFromType(), nil, setLaserColor:, weapon_damage, weapon_energy_use, weapon_recharge_rate, weapon_shot_temperature, OOEquipmentType::weaponColor, OOEquipmentType::weaponDamage, OOEquipmentType::weaponEnergyUse, weaponRange, OOEquipmentType::weaponRechargeRate, and OOEquipmentType::weaponShotTemperature.

Referenced by behaviour_attack_broadside:, behaviour_close_to_broadside_range:, PlayerEntity::currentWeaponStats, fireAftWeapon:, fireMainWeapon:, firePortWeapon:, fireStarboardWeapon:, fireSubentityLaserShot:, and PlayerEntity::setCommanderDataFromDictionary:.

Here is the call graph for this function:

Here is the caller graph for this function:

setWeaponEnergy:

- (void) setWeaponEnergy:

(float)

value

Definition at line 7526 of file ShipEntity.m.

                        :(float)value
{
    weapon_damage = value;
}

References weapon_damage.

Referenced by setUpOneStandardSubentity:asTurret:.

Here is the caller graph for this function:

setWeaponMount:toWeapon:

- (BOOL) setWeaponMount:		(OOWeaponFacing)	facing
toWeapon:		(NSString *)	eqKey

Reimplemented in PlayerEntity.

Definition at line 3494 of file ShipEntity.m.

                       :(OOWeaponFacing)facing toWeapon:(NSString *)eqKey
{
    // sets WEAPON_NONE if not recognised
    if (weapon_facings & facing) 
    {
        OOWeaponType chosen_weapon = OOWeaponTypeFromEquipmentIdentifierStrict(eqKey);
        switch (facing)
        {
            case WEAPON_FACING_FORWARD:
                forward_weapon_type = chosen_weapon;
                break;
                
            case WEAPON_FACING_AFT:
                aft_weapon_type = chosen_weapon;
                break;
                
            case WEAPON_FACING_PORT:
                port_weapon_type = chosen_weapon;
                break;
                
            case WEAPON_FACING_STARBOARD:
                starboard_weapon_type = chosen_weapon;
                break;
                
            case WEAPON_FACING_NONE:
                break;
        }
 
        return YES;
    }
    else
    {
        return NO;
    }
}

References aft_weapon_type, forward_weapon_type, OOWeaponTypeFromEquipmentIdentifierStrict(), port_weapon_type, starboard_weapon_type, WEAPON_FACING_AFT, WEAPON_FACING_FORWARD, WEAPON_FACING_NONE, WEAPON_FACING_PORT, WEAPON_FACING_STARBOARD, and weapon_facings.

Referenced by ShipSetProperty().

Here is the call graph for this function:

Here is the caller graph for this function:

setWeaponRange:

- (void) setWeaponRange:

(GLfloat)

value

Definition at line 7476 of file ShipEntity.m.

                       : (GLfloat) value
{
    weaponRange = value;
}

References weaponRange.

Referenced by setUpOneStandardSubentity:asTurret:.

Here is the caller graph for this function:

setWeaponRechargeRate:

- (void) setWeaponRechargeRate:

(float)

value

Definition at line 7520 of file ShipEntity.m.

                              :(float)value
{
    weapon_recharge_rate = value;
}

References weapon_recharge_rate.

Referenced by setUpOneStandardSubentity:asTurret:.

Here is the caller graph for this function:

setYaw:

- (void) setYaw:

(double)

amount

Definition at line 8228 of file ShipEntity.m.

               :(double) amount
{
    flightYaw = amount * M_PI / 2.0;
}

References flightYaw, and M_PI.

Referenced by DockEntity::launchShip:.

Here is the caller graph for this function:

shieldBoostFactor

- (float) shieldBoostFactor

Definition at line 4060 of file ShipEntity.m.

{
    float boostFactor = 1.0f;
    if ([self hasShieldBooster])  boostFactor += 1.0f;
    if ([self hasMilitaryShieldEnhancer])  boostFactor += 1.0f;
    
    return boostFactor;
}

References hasMilitaryShieldEnhancer, hasShieldBooster, and shieldBoostFactor.

Referenced by isFrangible, maxAftShieldLevel, maxForwardShieldLevel, and shieldBoostFactor.

Here is the call graph for this function:

Here is the caller graph for this function:

shieldRechargeRate

- (float) shieldRechargeRate

Definition at line 4084 of file ShipEntity.m.

{
    return [self hasMilitaryShieldEnhancer] ? 3.0f : 2.0f;
}

References hasMilitaryShieldEnhancer, and shieldRechargeRate.

Referenced by isFrangible, and shieldRechargeRate.

Here is the call graph for this function:

Here is the caller graph for this function:

shipAIScript

- (OOScript *) shipAIScript

Definition at line 1402 of file ShipEntity.m.

{
    return aiScript;
}

References aiScript, and shipAIScript.

Referenced by shipAIScript, and ShipGetProperty().

Here is the call graph for this function:

Here is the caller graph for this function:

shipAIScriptWakeTime

- (OOTimeAbsolute) shipAIScriptWakeTime

Definition at line 1408 of file ShipEntity.m.

{
    return aiScriptWakeTime;
}

References aiScriptWakeTime, and shipAIScriptWakeTime.

Referenced by shipAIScriptWakeTime.

Here is the call graph for this function:

Here is the caller graph for this function:

shipClassName

- (NSString *) shipClassName

References displayName.

shipDataKey

- (NSString *) shipDataKey

Definition at line 1974 of file ShipEntity.m.

{
    return _shipKey;
}

References _shipKey, and shipDataKey.

Referenced by PlayerEntity::availableFacings, PlayerEntity(Contracts)::buySelectedShip, PlayerEntity::commanderDataDictionary, PlayerEntity::createDoppelganger, PlayerEntity::doBookkeeping:, dumpSelfState, equipmentValidToAdd:whileLoading:inContext:, findBoundingBoxRelativeToPosition:InVectors:i:j:, fuelChargeRate, PlayerEntity(Contracts)::newShipCommonSetup:yardInfo:baseInfo:, PlayerEntity(Scripting)::processSceneString:atOffset:, PlayerEntity::renovationFactor, PlayerEntity::resetHud, PlayerEntity::setCommanderDataFromDictionary:, PlayerEntity::setGuiToEquipShipScreen:selectingFacingFor:, PlayerEntity::setGuiToStatusScreen, Universe(OOPrivate)::setUpInitialUniverse, StationEntity::setUpSubEntities, PlayerEntity::setWeaponMount:toWeapon:inContext:, shipDataKey, shipDataKeyAutoRole, ShipGetProperty(), and ShipEntity(LoadRestoreInternal)::simplifyShipdata:andGetDeletes:.

Here is the call graph for this function:

Here is the caller graph for this function:

shipDataKeyAutoRole

- (NSString *) shipDataKeyAutoRole

Definition at line 1980 of file ShipEntity.m.

{
    return [[[NSString alloc] initWithFormat:@"[%@]",[self shipDataKey]] autorelease];
}

References shipDataKey, and shipDataKeyAutoRole.

Referenced by findBoundingBoxRelativeToPosition:InVectors:i:j:, hasRole:, and shipDataKeyAutoRole.

Here is the call graph for this function:

Here is the caller graph for this function:

shipHitByLaser

- (ShipEntity *) shipHitByLaser

Definition at line 10176 of file ShipEntity.m.

{
    return [_shipHitByLaser weakRefUnderlyingObject];
}

References shipHitByLaser, and OOWeakReference::weakRefUnderlyingObject.

Referenced by maxFlightSpeed, PlayerEntity(OOControlsPrivate)::pollFlightControls:, and shipHitByLaser.

Here is the call graph for this function:

Here is the caller graph for this function:

shipInfoDictionary

- (NSDictionary *) shipInfoDictionary

Definition at line 1993 of file ShipEntity.m.

{
    return shipinfoDictionary;
}

References shipInfoDictionary, and shipinfoDictionary.

Referenced by Universe::addEntity:, becomeExplosion, clearSubEntities, PlayerEntity::commanderDataDictionary, countsAsKill, findBoundingBoxRelativeToPosition:InVectors:i:j:, hasAutoAI, hasAutoWeapons, ShipEntity(Private)::rescaleBy:writeToCache:, setScannerDisplayColor1:, setScannerDisplayColor2:, setScannerDisplayColorHostile1:, setScannerDisplayColorHostile2:, ShipEntity(Private)::setUpOneEscort:inGroup:withRole:atPosition:andCount:, setUpSubEntities, shipInfoDictionary, and ShipSetMaterialsInternal().

Here is the call graph for this function:

Here is the caller graph for this function:

shipRestoredFromDictionary:useFallback:context:

+ (id) shipRestoredFromDictionary:		(NSDictionary *)	dictionary
useFallback:		(BOOL)	fallback
context:		(NSMutableDictionary *)	context

Provided by category ShipEntity(LoadRestore).

Definition at line 173 of file ShipEntityLoadRestore.m.

                                 :(NSDictionary *)dict
                      useFallback:(BOOL)fallback
                          context:(NSMutableDictionary *)context
{
    if (dict == nil)  return nil;
    if (context == nil)  context = [NSMutableDictionary dictionary];
    
    ShipEntity *ship = nil;
    
    NSString *shipKey = [dict oo_stringForKey:KEY_SHIP_KEY];
    NSDictionary *shipData = [[OOShipRegistry sharedRegistry] shipInfoForKey:shipKey];
    
    if (shipData != nil)
    {
        NSMutableDictionary *mergedData = [NSMutableDictionary dictionaryWithDictionary:shipData];
        
        StripIgnoredKeys(mergedData);
        NSArray *deletes = [dict oo_arrayForKey:KEY_SHIPDATA_DELETES];
        if (deletes != nil)  [mergedData removeObjectsForKeys:deletes];
        [mergedData addEntriesFromDictionary:[dict oo_dictionaryForKey:KEY_SHIPDATA_OVERRIDES]];
        [mergedData oo_setBool:NO forKey:@"auto_ai"];
        [mergedData oo_setUnsignedInteger:0 forKey:@"escorts"];
        
        Class shipClass = [UNIVERSE shipClassForShipDictionary:mergedData];
        ship = [[[shipClass alloc] initWithKey:shipKey definition:mergedData] autorelease];
        
        // FIXME: restore AI.
        [ship setAITo:[dict oo_stringForKey:KEY_AI defaultValue:@"nullAI.plist"]];
        
        [ship setPrimaryRole:[dict oo_stringForKey:KEY_PRIMARY_ROLE]];
    
    }
    else
    {
        // Unknown ship; fall back on role if desired and possible.
        NSString *shipPrimaryRole = [dict oo_stringForKey:KEY_PRIMARY_ROLE];
        if (!fallback || shipPrimaryRole == nil)  return nil;
        
        ship = [[UNIVERSE newShipWithRole:shipPrimaryRole] autorelease];
        if (ship == nil)  return nil;
    }
    
    // The following stuff is deliberately set up the same way even if using role fallback.
    [ship setPosition:[dict oo_hpvectorForKey:KEY_POSITION]];
    [ship setNormalOrientation:[dict oo_quaternionForKey:KEY_ORIENTATION]];
    
    float energyLevel = [dict oo_floatForKey:KEY_ENERGY_LEVEL defaultValue:1.0f];
    [ship setEnergy:energyLevel * [ship maxEnergy]];
    
    [ship removeAllEquipment];
    NSEnumerator *eqEnum = nil;
    NSString *eqKey = nil;
    for (eqEnum = [[dict oo_arrayForKey:KEY_EQUIPMENT] objectEnumerator]; (eqKey = [eqEnum nextObject]); )
    {
        [ship addEquipmentItem:eqKey withValidation:NO inContext:@"loading"];
    }
    
    [ship removeMissiles];
    for (eqEnum = [[dict oo_arrayForKey:KEY_MISSILES] objectEnumerator]; (eqKey = [eqEnum nextObject]); )
    {
        [ship addEquipmentItem:eqKey withValidation:NO inContext:@"loading"];
    }
    
    // Groups.
    NSUInteger groupID = [dict oo_integerForKey:KEY_GROUP_ID defaultValue:NSNotFound];
    if (groupID != NSNotFound)
    {
        OOShipGroup *group = GroupForGroupID(groupID, context);
        [ship setGroup:group];  // Handles adding to group
        if ([dict oo_boolForKey:KEY_IS_GROUP_LEADER])  [group setLeader:ship];
        NSString *groupName = [dict oo_stringForKey:KEY_GROUP_NAME];
        if (groupName != nil)  [group setName:groupName];
        if ([ship hasPrimaryRole:@"escort"] && ship != [group leader])
        {
            [ship setOwner:[group leader]];
        }
    }
    
    groupID = [dict oo_integerForKey:KEY_ESCORT_GROUP_ID defaultValue:NSNotFound];
    if (groupID != NSNotFound)
    {
        OOShipGroup *group = GroupForGroupID(groupID, context);
        [group setLeader:ship];
        [group setName:@"escort group"];
        [ship setEscortGroup:group];
    }
    
    return ship;
}

Referenced by WormholeEntity::initWithDict:.

Here is the caller graph for this function:

shipScript

- (OOScript *) shipScript

Definition at line 1396 of file ShipEntity.m.

{
    return script;
}

References script, and shipScript.

Referenced by ShipGetProperty(), and shipScript.

Here is the call graph for this function:

Here is the caller graph for this function:

shipSubEntityEnumerator

- (NSEnumerator *) shipSubEntityEnumerator

Definition at line 1337 of file ShipEntity.m.

{
    return [[self subEntities] objectEnumeratorFilteredWithSelector:@selector(isShip)];
}

References shipSubEntityEnumerator, and subEntities.

Referenced by addTarget:, becomeExplosion, becomeLargeExplosion:, behaviour_attack_target:, PlayerEntity::canAddEquipment:inContext:, deserializeShipSubEntitiesFrom:, PlayerEntity::doesHitLine:v0:v1:, doesHitLine:v0:v1:, fireMainWeapon:, fireWeapon:direction:range:, hasPrimaryWeapon:, laserHeatLevelForward, PlayerEntity(Contracts)::missingSubEntitiesAdjustment, removeTarget:, serializeShipSubEntities, StationEntity::setUpSubEntities, shipSubEntityEnumerator, subEntities, ShipEntity(OOJavaScriptExtensions)::subEntitiesForScript, switchLightsOff, switchLightsOn, turretCount, and weaponTypeIDForFacing:strict:.

Here is the call graph for this function:

Here is the caller graph for this function:

shipUniqueName

- (NSString *) shipUniqueName

References shipClassName.

shortDescriptionComponents

- (NSString *) shortDescriptionComponents

implementation

Definition at line 1199 of file ShipEntity.m.

{
    return [NSString stringWithFormat:@"\"%@\"", [self name]];
}

References name, and shortDescriptionComponents.

Referenced by shortDescriptionComponents.

Here is the call graph for this function:

Here is the caller graph for this function:

shotTime

- (OOTimeDelta) shotTime

Definition at line 11632 of file ShipEntity.m.

{
    return shot_time;
}

References shot_time, and shotTime.

Referenced by canCollide, coordinates, dumpSelfState, fireSubentityLaserShot:, fireTurretCannon:, fireWeapon:direction:range:, shotTime, and weaponRecoveryTime.

Here is the call graph for this function:

Here is the caller graph for this function:

showDamage

- (BOOL) showDamage

Definition at line 9164 of file ShipEntity.m.

{
    return _showDamage;
}

References _showDamage, and showDamage.

Referenced by maxFlightSpeed, and showDamage.

Here is the call graph for this function:

Here is the caller graph for this function:

showScoopMessage

- (BOOL) showScoopMessage

Definition at line 8505 of file ShipEntity.m.

{
    return hasScoopMessage;
}

References hasScoopMessage, and showScoopMessage.

Referenced by cargo, scoopUpProcess:processEvents:processMessages:, and showScoopMessage.

Here is the call graph for this function:

Here is the caller graph for this function:

simplifyShipdata:andGetDeletes:

- (void) simplifyShipdata: (NSMutableDictionary *) data andGetDeletes: (NSArray **) deletes

implementation

Provided by category ShipEntity(LoadRestoreInternal).

Definition at line 264 of file ShipEntityLoadRestore.m.

                         :(NSMutableDictionary *)data andGetDeletes:(NSArray **)deletes
{
    NSParameterAssert(data != nil && deletes != NULL);
    *deletes = nil;
    
    // Get original ship data.
    NSMutableDictionary *referenceData = [NSMutableDictionary dictionaryWithDictionary:[[OOShipRegistry sharedRegistry] shipInfoForKey:[self shipDataKey]]];
    
    // Discard stuff that we handle separately.
    StripIgnoredKeys(referenceData);
    StripIgnoredKeys(data);
    
    // Note items that are in referenceData, but not data.
    NSMutableArray *foundDeletes = [NSMutableArray array];
    NSEnumerator *enumerator = nil;
    NSString *key = nil;
    for (enumerator = [referenceData keyEnumerator]; (key = [enumerator nextObject]); )
    {
        if ([data objectForKey:key] == nil)
        {
            [foundDeletes addObject:key];
        }
    }
    if ([foundDeletes count] != 0)  *deletes = foundDeletes;
    
    // after rev3010 this loop was using cycles without doing anything - commenting this whole loop out for now. -- kaks 20100207
/*
    // Discard anything that hasn't changed.
    for (enumerator = [data keyEnumerator]; (key = [enumerator nextObject]); )
    {
        id referenceVal = [referenceData objectForKey:key];
        id myVal = [data objectForKey:key];
        if ([referenceVal isEqual:myVal])
        {
        //  [data removeObjectForKey:key];
        }
    }
*/
}

References count, nil, OOShipRegistry::sharedRegistry, shipDataKey, OOShipRegistry::shipInfoForKey:, and StripIgnoredKeys().

Referenced by ShipEntity(LoadRestore)::savedShipDictionaryWithContext:.

Here is the call graph for this function:

Here is the caller graph for this function:

spawn:

- (void) spawn:

(NSString *)

roles_number

Definition at line 14321 of file ShipEntity.m.

              :(NSString *)roles_number
{
    NSArray     *tokens = ScanTokensFromString(roles_number);
    NSString    *roleString = nil;
    NSString    *numberString = nil;
    NSUInteger  number;
    
    if ([tokens count] != 2)
    {
        OOLog(kOOLogSyntaxAddShips, @"***** Could not spawn: \"%@\" (must be two tokens, role and number)",roles_number);
        return;
    }
    
    roleString = [tokens oo_stringAtIndex:0];
    numberString = [tokens oo_stringAtIndex:1];
    
    number = [numberString intValue];
    
    [self spawnShipsWithRole:roleString count:number];
}

References count, kOOLogSyntaxAddShips, nil, OOLog, ScanTokensFromString(), and spawnShipsWithRole:count:.

Here is the call graph for this function:

spawnShipsWithRole:count:

- (NSArray *) spawnShipsWithRole:		(NSString *)	role
count:		(NSUInteger)	count

Provided by category ShipEntity(ScriptMethods).

Definition at line 64 of file ShipEntityScriptMethods.m.

                                :(NSString *)role count:(NSUInteger)count
{
    ShipEntity              *ship = [self rootShipEntity];  // FIXME: (EMMSTRAN) implement an -absolutePosition method, use that in spawnShipWithRole:near:, and use self instead of root.
    ShipEntity              *spawned = nil;
    NSMutableArray          *result = nil;
    
    if (count == 0)  return [NSArray array];
    
    OOLog(kOOLogNoteAddShips, @"Spawning %ld x '%@' near %@ %d", count, role, [self shortDescription], [self universalID]);
    
    result = [NSMutableArray arrayWithCapacity:count];
    
    do
    {
        spawned = [UNIVERSE spawnShipWithRole:role near:ship];
        if (spawned != nil)
        {
            [spawned setTemperature:[self randomEjectaTemperature]];
            if ([self isMissileFlagSet] && [[spawned shipInfoDictionary] oo_boolForKey:@"is_submunition"])
            {
                [spawned setOwner:[self owner]];
                [spawned addTarget:[self primaryTarget]];
                [spawned setIsMissileFlag:YES];
            }
            [result addObject:spawned];
        }
    }
    while (--count);
    
    return result;
}

Referenced by ShipSpawn(), and spawn:.

Here is the caller graph for this function:

speedFactor

- (GLfloat) speedFactor

Definition at line 8777 of file ShipEntity.m.

{
    if (maxFlightSpeed <= 0.0)  return 0.0;
    return flightSpeed / maxFlightSpeed;
}

References flightSpeed, maxFlightSpeed, and speedFactor.

Referenced by maxFlightSpeed, speedFactor, and OOExhaustPlumeEntity::update:.

Here is the call graph for this function:

Here is the caller graph for this function:

starboardWeaponOffset

- (NSArray *) starboardWeaponOffset

References hasAutoWeapons, and isFrangible.

Here is the call graph for this function:

startTrackingCurve

- (void) startTrackingCurve

Definition at line 6315 of file ShipEntity.m.

{
    Entity *target = [self primaryTarget];
    if (target == nil)
    {
        return;
    }
    OOTimeAbsolute now = [UNIVERSE getTime];
    trackingCurvePositions[0] = [target position];
    trackingCurvePositions[1] = [target position];
    trackingCurvePositions[2] = [target position];
    trackingCurvePositions[3] = [target position];
    trackingCurveTimes[0] = now;
    trackingCurveTimes[1] = now - reactionTime/3.0;
    trackingCurveTimes[2] = now - reactionTime*2.0/3.0;
    trackingCurveTimes[3] = now - reactionTime;
    [self calculateTrackingCurve];
    return;
}

References calculateTrackingCurve, nil, Entity::position, primaryTarget, reactionTime, startTrackingCurve, trackingCurvePositions, and trackingCurveTimes.

Referenced by addTarget:, reactionTime, resumePostProximityAlert, and startTrackingCurve.

Here is the call graph for this function:

Here is the caller graph for this function:

stationGroup

- (OOShipGroup *) stationGroup

Definition at line 6964 of file ShipEntity.m.

{
    if (_group == nil)
    {
        _group = [[OOShipGroup alloc] initWithName:@"station group"];
        [_group setLeader:self];
    }
    
    return _group;
}

References _group, nil, OOShipGroup::setLeader:, and stationGroup.

Referenced by StationEntity::launchDefenseShip, StationEntity::launchMiner, StationEntity::launchPatrol, StationEntity::launchPirateShip, StationEntity::launchPolice, StationEntity::launchScavenger, StationEntity::launchShipWithRole:, messageTime, StationEntity::setUpShipFromDictionary:, and stationGroup.

Here is the call graph for this function:

Here is the caller graph for this function:

storeTarget

- (void) storeTarget

implementation

Provided by category ShipEntity(PureAI).

Definition at line 2125 of file ShipEntityAI.m.

{
    Entity  *target = [self primaryTarget];
    
    if (target)
    {
        [self setRememberedShip:target];
    }
    else
    {
        DESTROY(_rememberedShip);
    }
    
}

subEntities

- (NSArray *) subEntities

References clearSubEntities, exhaustEnumerator, flasherEnumerator, maxShipSubEntities, octree, serializeShipSubEntities, shipSubEntityEnumerator, subEntityCount, subEntityEnumerator, subEntityRotationalVelocity, subEntityTakingDamage, and subIdx.

Here is the call graph for this function:

subEntitiesForScript

- (NSArray *) subEntitiesForScript

Provided by category ShipEntity(OOJavaScriptExtensions).

Definition at line 134 of file EntityOOJavaScriptExtensions.m.

{
    return [[self shipSubEntityEnumerator] allObjects];
}

Referenced by ShipGetProperty(), and ShipRestoreSubEntities().

Here is the caller graph for this function:

subEntityCount

- (NSUInteger) subEntityCount

Definition at line 1319 of file ShipEntity.m.

{
    return [subEntities count];
}

References subEntityCount.

Referenced by drawImmediate:translucent:, dumpSelfState, subEntities, subEntityCount, and update:.

Here is the call graph for this function:

Here is the caller graph for this function:

subEntityDied:

- (void) subEntityDied: (ShipEntity *) sub

implementation

Provided by category ShipEntity(Private).

Definition at line 9520 of file ShipEntity.m.

                     :(ShipEntity *)sub
{
    if ([self subEntityTakingDamage] == sub)  [self setSubEntityTakingDamage:nil];
    
    [sub setOwner:nil];
    // TODO? Recalculating collision radius should increase collision testing efficiency,
    // but for most ship models the difference would be marginal. -- Kaks 20110429
    mass -= [sub mass]; // missing subents affect fuel charge rate, etc..
    [subEntities removeObject:sub];
}

References Entity::mass, setOwner:, and setSubEntityTakingDamage:.

Referenced by becomeExplosion.

Here is the call graph for this function:

Here is the caller graph for this function:

subEntityEnumerator

- (NSEnumerator *) subEntityEnumerator

Definition at line 1331 of file ShipEntity.m.

{
    return [[self subEntities] objectEnumerator];
}

References subEntities, and subEntityEnumerator.

Referenced by subEntities, and subEntityEnumerator.

Here is the call graph for this function:

Here is the caller graph for this function:

subEntityReallyDied:

- (void) subEntityReallyDied: (ShipEntity *) sub

implementation

Reimplemented from Entity.

Provided by category ShipEntity(Private).

Definition at line 9532 of file ShipEntity.m.

                           :(ShipEntity *)sub
{
    if ([self subEntityTakingDamage] == sub)  [self setSubEntityTakingDamage:nil];
    
    if ([self hasSubEntity:sub])
    {
        OOLogERR(@"shipEntity.bug.subEntityRetainUnderflow", @"Subentity of %@ died while still in subentity list! This is bad. Leaking subentity list to avoid crash. %@", self, @"This is an internal error, please report it.");
        
        // Leak subentity list.
        subEntities = nil;
    }
}

References nil, OOLogERR, and setSubEntityTakingDamage:.

Referenced by dealloc.

Here is the call graph for this function:

Here is the caller graph for this function:

subEntityRotationalVelocity

- (Quaternion) subEntityRotationalVelocity

Definition at line 1169 of file ShipEntity.m.

{
    return subentityRotationalVelocity;
}

References subEntityRotationalVelocity, and subentityRotationalVelocity.

Referenced by subEntities, and subEntityRotationalVelocity.

Here is the call graph for this function:

Here is the caller graph for this function:

subEntityTakingDamage

- (ShipEntity *) subEntityTakingDamage

Definition at line 1355 of file ShipEntity.m.

{
    ShipEntity *result = [_subEntityTakingDamage weakRefUnderlyingObject];
    
#ifndef NDEBUG
    // Sanity check - there have been problems here, see fireLaserShotInDirection:
    // -parentEntity will take care of reporting insanity.
    if ([result parentEntity] != self)  result = nil;
#endif
    
    // Clear the weakref if the subentity is dead.
    if (result == nil)  [self setSubEntityTakingDamage:nil];
    
    return result;
}

References nil, Entity::parentEntity, setSubEntityTakingDamage:, subEntityTakingDamage, and OOWeakReference::weakRefUnderlyingObject.

Referenced by fireDirectLaserShotAt:, fireLaserShotInDirection:weaponIdentifier:, fireSubentityLaserShot:, subEntities, and subEntityTakingDamage.

Here is the call graph for this function:

Here is the caller graph for this function:

subIdx

- (NSUInteger) subIdx

Definition at line 786 of file ShipEntity.m.

{
    return _subIdx;
}

References _subIdx, and subIdx.

Referenced by deserializeShipSubEntitiesFrom:, serializeShipSubEntities, subEntities, and subIdx.

Here is the call graph for this function:

Here is the caller graph for this function:

suggestEscort

- (void) suggestEscort

implementation

Provided by category ShipEntity(PureAI).

Definition at line 1832 of file ShipEntityAI.m.

{
    ShipEntity   *mother = [self primaryTarget];
    [self suggestEscortTo:mother];
}

suggestEscortTo:

- (BOOL) suggestEscortTo:

(ShipEntity *)

mother

Provided by category ShipEntity(AI).

Definition at line 720 of file ShipEntityAI.m.

                        :(ShipEntity *)mother
{
    if (mother)
    {
#ifndef NDEBUG
        if (reportAIMessages)
        {
            OOLog(@"ai.suggestEscort", @"DEBUG: %@ suggests escorting %@", self, mother);
        }
#endif
        
        if ([mother acceptAsEscort:self])
        {
            // copy legal status across
            if (([mother legalStatus] > 0)&&(bounty <= 0))
            {
                int extra = 1 | (ranrot_rand() & 15);
//              [mother setBounty: [mother legalStatus] + extra withReason:kOOLegalStatusReasonAssistingOffender];
                [self markAsOffender:extra withReason:kOOLegalStatusReasonAssistingOffender];
                //              bounty += extra;    // obviously we're dodgier than we thought!
            }
            
            [self setOwner:mother];
            [self setGroup:[mother escortGroup]];
            [shipAI message:@"ESCORTING"];
            return YES;
        }
        
#ifndef NDEBUG
        if (reportAIMessages)
        {
            OOLog(@"ai.suggestEscort.refused", @"DEBUG: %@ refused by %@", self, mother);
        }
#endif
        
    }
    [self setOwner:self];
    [shipAI message:@"NOT_ESCORTING"];
    [self doScriptEvent:OOJSID("escortRejected") withArgument:mother];
    return NO;
}

Referenced by ShipEntity(PureAI)::suggestEscort.

Here is the caller graph for this function:

sunGlareFilter

- (GLfloat) sunGlareFilter

References checkShipsInVicinityForWitchJumpExit, int(), isMining, markedForFines, markForFines, setCommsMessageColor, and trackCloseContacts.

Here is the call graph for this function:

suppressFlightNotifications

- (BOOL) suppressFlightNotifications

Definition at line 2057 of file ShipEntity.m.

{
    return suppressAegisMessages;
}

References suppressAegisMessages, and suppressFlightNotifications.

Referenced by isFrangible, and suppressFlightNotifications.

Here is the call graph for this function:

Here is the caller graph for this function:

suppressTargetLost

- (void) suppressTargetLost

implementation

Reimplemented in PlayerEntity.

Definition at line 12913 of file ShipEntity.m.

{
    
}

References suppressTargetLost.

Referenced by scoopUpProcess:processEvents:processMessages:, and suppressTargetLost.

Here is the call graph for this function:

Here is the caller graph for this function:

SurfaceDistanceSqared

+ (static float) SurfaceDistanceSqared (Entity *) reference (Entity< OOStellarBody > *) stellar

implementation

Definition at line 7613 of file ShipEntity.m.

{
    return SurfaceDistanceSqaredV([reference position], stellar);
}

References Entity::position, reference, and SurfaceDistanceSqaredV.

Referenced by findNearestStellarBody.

Here is the call graph for this function:

Here is the caller graph for this function:

SurfaceDistanceSqaredV

+ (static float) SurfaceDistanceSqaredV (HPVector) reference (Entity< OOStellarBody > *) stellar

implementation

Definition at line 7602 of file ShipEntity.m.

{
    float centerDistance = HPmagnitude2(HPvector_subtract([stellar position], reference));
    float r = [stellar radius];
    /*  1.35: empirical value used to help determine proximity when non-nested
            planets are close to each other
        */
    return centerDistance - 1.35 * r * r;
}

References Entity::position, and reference.

Referenced by ComparePlanetsBySurfaceDistance, findNearestPlanet, and SurfaceDistanceSqared.

Here is the caller graph for this function:

switchAITo:

- (void) switchAITo:

(NSString *)

aiString

Provided by category ShipEntity(AI).

Definition at line 307 of file ShipEntityAI.m.

                   :(NSString *)aiString
{
    [self setAITo:aiString];
    [[self getAI] clearStack];
}

Referenced by Universe::addShipAt:withRole:withinRadius:, StationEntity::launchDefenseShip, StationEntity::launchEscort, StationEntity::launchMiner, StationEntity::launchPatrol, ShipEntity(Private)::launchPodWithCrew:, StationEntity::launchPolice, StationEntity::launchScavenger, PlanetEntity::launchShuttle, StationEntity::launchShuttle, Universe::makeDemoShipWithRole:spinning:, Universe::makeSunSkimmer:andSetAI:, PlayerEntity(Scripting)::processSceneString:atOffset:, Universe::setupIntroFirstGo:, ShipEntity(Private)::setUpOneEscort:inGroup:withRole:atPosition:andCount:, ShipSwitchAI(), Universe::update:, and Universe::witchspaceShipWithPrimaryRole:.

Here is the caller graph for this function:

switchLightsOff

- (void) switchLightsOff

Definition at line 13650 of file ShipEntity.m.

{
    NSEnumerator    *subEnum = nil;
    OOFlasherEntity *se = nil;
    ShipEntity      *sub = nil;
    
    _lightsActive = NO;
    
    for (subEnum = [self flasherEnumerator]; (se = [subEnum nextObject]); )
    {
        [se setActive:NO];
    }
    for (subEnum = [self shipSubEntityEnumerator]; (sub = [subEnum nextObject]); )
    {
        [sub switchLightsOff];
    }
}

References _lightsActive, flasherEnumerator, nil, shipSubEntityEnumerator, and switchLightsOff.

Referenced by coordinates, StationEntity::launchPatrol, ShipSetProperty(), and switchLightsOff.

Here is the call graph for this function:

Here is the caller graph for this function:

switchLightsOn

- (void) switchLightsOn

Definition at line 13631 of file ShipEntity.m.

{
    NSEnumerator    *subEnum = nil;
    OOFlasherEntity *se = nil;
    ShipEntity      *sub = nil;
    
    _lightsActive = YES;
    
    for (subEnum = [self flasherEnumerator]; (se = [subEnum nextObject]); )
    {
        [se setActive:YES];
    }
    for (subEnum = [self shipSubEntityEnumerator]; (sub = [subEnum nextObject]); )
    {
        [sub switchLightsOn];
    }
}

References _lightsActive, flasherEnumerator, nil, shipSubEntityEnumerator, and switchLightsOn.

Referenced by coordinates, ShipSetProperty(), and switchLightsOn.

Here is the call graph for this function:

Here is the caller graph for this function:

takeEnergyDamage:from:becauseOf:weaponIdentifier:

- (void) takeEnergyDamage: (double) amount from: (Entity *) ent becauseOf: (Entity *) other weaponIdentifier: (NSString *) weaponIdentifier

implementation

Reimplemented from Entity.

Reimplemented in DockEntity, PlayerEntity, and StationEntity.

Definition at line 13126 of file ShipEntity.m.

                         :(double)amount from:(Entity *)ent becauseOf:(Entity *)other weaponIdentifier:(NSString *)weaponIdentifier
{
    if ([self status] == STATUS_DEAD)  return;
    if (amount <= 0.0)  return;
    
    BOOL energyMine = [ent isCascadeWeapon];
    BOOL cascade = NO;
    if (energyMine)
    {
        cascade = [self cascadeIfAppropriateWithDamageAmount:amount cascadeOwner:[ent owner]];
    }
    
    energy -= amount;
    /* Heat increase from energy impacts will never directly cause
     * overheating - too easy for missile hits to cause an uncredited
     * death by overheating - CIM */
    if (ship_temperature < SHIP_MAX_CABIN_TEMP)
    {
        ship_temperature += amount * SHIP_ENERGY_DAMAGE_TO_HEAT_FACTOR / [self heatInsulation];
        if (ship_temperature > SHIP_MAX_CABIN_TEMP)
        {
            ship_temperature = SHIP_MAX_CABIN_TEMP;
        }
    }
 
 
    being_mined = NO;
    ShipEntity *hunter = nil;
    
    hunter = [other rootShipEntity];
    if (hunter == nil && [other isShip]) hunter = (ShipEntity *)other;
    
    // must check for this before potentially deleting 'other' for cloaking
    if ((other)&&([other isShip]))
    {
        being_mined = [(ShipEntity *)other isMining];
    }
 
    if (hunter !=nil && [self owner] != hunter) // our owner could be the same entity as the one responsible for our taking damage in the case of submunitions
    {
        if ([hunter isCloaked])
        {
            [self doScriptEvent:OOJSID("shipBeingAttackedByCloaked") andReactToAIMessage:@"ATTACKED_BY_CLOAKED"];
            
            // lose it!
            other = nil;
            hunter = nil;
        }
    }
    else
    {
        hunter = nil;
    }
    
    // if the other entity is a ship note it as an aggressor
    if (hunter != nil)
    {
        BOOL iAmTheLaw = [self isPolice];
        BOOL uAreTheLaw = [hunter isPolice];
        
        DESTROY(_lastEscortTarget); // we're being attacked, escorts can scramble!
        
        [self setPrimaryAggressor:hunter];
        [self setFoundTarget:hunter];
 
        // firing on an innocent ship is an offence
        [self broadcastHitByLaserFrom: hunter];
 
        // tell ourselves we've been attacked
        if (energy > 0)
        {
            [self respondToAttackFrom:ent becauseOf:hunter];
        }
 
        OOShipGroup *group = [self group];
        // JSAIs manage group notifications themselves
        if (![self hasNewAI])
        {
            // additionally, tell our group we've been attacked
            if (group != nil && group != [hunter group] && !(iAmTheLaw || uAreTheLaw))
            {
                if ([self isTrader] || [self isEscort])
                {
                    ShipEntity *groupLeader = [group leader];
                    if (groupLeader != self)
                    {
                        [groupLeader setFoundTarget:hunter];
                        [groupLeader setPrimaryAggressor:hunter];
                        [groupLeader respondToAttackFrom:ent becauseOf:hunter];
                        //unsetting group leader for carriers can break stuff
                    }
                }
                if ([self isPirate])
                {
                    NSEnumerator        *groupEnum = nil;
                    ShipEntity          *otherPirate = nil;
                
                    for (groupEnum = [group mutationSafeEnumerator]; (otherPirate = [groupEnum nextObject]); )
                    {
                        if (otherPirate != self && randf() < 0.5)  // 50% chance they'll help
                        {
                            [otherPirate setFoundTarget:hunter];
                            [otherPirate setPrimaryAggressor:hunter];
                            [otherPirate respondToAttackFrom:ent becauseOf:hunter];
                        }
                    }
                }
                else if (iAmTheLaw)
                {
                    NSEnumerator        *groupEnum = nil;
                    ShipEntity          *otherPolice = nil;
                
                    for (groupEnum = [group mutationSafeEnumerator]; (otherPolice = [groupEnum nextObject]); )
                    {
                        if (otherPolice != self)
                        {
                            [otherPolice setFoundTarget:hunter];
                            [otherPolice setPrimaryAggressor:hunter];
                            [otherPolice respondToAttackFrom:ent becauseOf:hunter];
                        }
                    }
                }
            }
        }
 
        // if I'm a copper and you're not, then mark the other as an offender!
        if (iAmTheLaw && !uAreTheLaw)
        {
            // JSAI's can choose not to do this for friendly fire purposes
            if (![self hasNewAI]) 
            {
                [hunter markAsOffender:64 withReason:kOOLegalStatusReasonAttackedPolice];
            }
        }
 
        if ((group != nil && [hunter group] == group) || (iAmTheLaw && uAreTheLaw))
        {
            // avoid shooting each other
            if ([hunter behaviour] == BEHAVIOUR_ATTACK_FLY_TO_TARGET)  // avoid me please!
            {
                [hunter setBehaviour:BEHAVIOUR_ATTACK_FLY_FROM_TARGET];
                [hunter setDesiredSpeed:[hunter maxFlightSpeed]];
            }
        }
 
    }
    
    OOShipDamageType damageType = kOODamageTypeEnergy;
    if (suppressExplosion)  damageType = kOODamageTypeRemoved;
    else if (energyMine)  damageType = kOODamageTypeCascadeWeapon;
    
    if (!suppressExplosion)
    {
        [self noteTakingDamage:amount from:other type:damageType];
        if (cascade) energy = 0.0; // explicit set energy to zero in case an oxp raised the energy in previous line.
    }
 
    // die if I'm out of energy
    if (energy <= 0.0)
    {
        // backup check just in case scripts have reduced energy
        if (self != [UNIVERSE station]) 
        {
            if (hunter != nil)  [hunter noteTargetDestroyed:self];
            [self getDestroyedBy:other damageType:damageType];
        }
    }
    else
    {
        // warn if I'm low on energy
        if (energy < maxEnergy * 0.25)
        {
            [self doScriptEvent:OOJSID("shipEnergyIsLow") andReactToAIMessage:@"ENERGY_LOW"];
        }
        if ((energy < maxEnergy *0.125 || (energy < 64 && energy < amount*2)) && [self hasEscapePod] && (ranrot_rand() & 3) == 0)  // 25% chance he gets to an escape pod
        {
            [self abandonShip];
        }
    }
}

References _lastEscortTarget, abandonShip, behaviour, being_mined, broadcastHitByLaserFrom:, cascadeIfAppropriateWithDamageAmount:cascadeOwner:, DESTROY, doScriptEvent:andReactToAIMessage:, Entity::energy, getDestroyedBy:damageType:, group, hasEscapePod, hasNewAI, heatInsulation, Entity::isCascadeWeapon, isCloaked, isEscort, isMining, isPirate, isPolice, Entity::isShip, isTrader, OOShipGroup::leader, markAsOffender:withReason:, Entity::maxEnergy, maxFlightSpeed, nil, noteTakingDamage:from:type:, noteTargetDestroyed:, Entity::owner, randf(), ranrot_rand, respondToAttackFrom:becauseOf:, Entity::rootShipEntity, setBehaviour:, setDesiredSpeed:, setFoundTarget:, setPrimaryAggressor:, SHIP_ENERGY_DAMAGE_TO_HEAT_FACTOR, SHIP_MAX_CABIN_TEMP, ship_temperature, Entity::status, suppressExplosion, and UNIVERSE.

Referenced by deserializeShipSubEntitiesFrom:, fireDirectLaserShotAt:, fireLaserShotInDirection:weaponIdentifier:, fireSubentityLaserShot:, DockEntity::takeEnergyDamage:from:becauseOf:weaponIdentifier:, and StationEntity::takeEnergyDamage:from:becauseOf:weaponIdentifier:.

Here is the call graph for this function:

Here is the caller graph for this function:

takeHeatDamage:

- (void) takeHeatDamage:

(double)

amount

Reimplemented in PlayerEntity, and StationEntity.

Definition at line 13424 of file ShipEntity.m.

                       :(double)amount
{
    if ([self status] == STATUS_DEAD)  return;
 
    if ([self isSubEntity])
    {
        ShipEntity* owner = [self owner];
        if (![owner isFrangible]) 
        {
            return;
        }
    }
    
    energy -= amount;
    throw_sparks = YES;
    
    [self noteTakingDamage:amount from:nil type:kOODamageTypeHeat];
    
    // oops we're burning up!
    if (energy <= 0.0)
    {
        [self getDestroyedBy:nil damageType:kOODamageTypeHeat];
    }
    else
    {
        // warn if I'm low on energy
        if (energy < maxEnergy * 0.25)
        {
            [self doScriptEvent:OOJSID("shipEnergyIsLow") andReactToAIMessage:@"ENERGY_LOW"];
        }
    }
}

References doScriptEvent:andReactToAIMessage:, Entity::energy, getDestroyedBy:damageType:, isFrangible, Entity::isSubEntity, Entity::maxEnergy, noteTakingDamage:from:type:, Entity::owner, Entity::status, and Entity::throw_sparks.

Referenced by PlayerEntity::takeHeatDamage:, StationEntity::takeHeatDamage:, and update:.

Here is the call graph for this function:

Here is the caller graph for this function:

takeScrapeDamage:from:

- (void) takeScrapeDamage:		(double)	amount
from:		(Entity *)	ent

Reimplemented in PlayerEntity, and StationEntity.

Definition at line 13380 of file ShipEntity.m.

                         :(double) amount from:(Entity *)ent
{
    if ([self status] == STATUS_DEAD)  return;
 
    if ([self status] == STATUS_LAUNCHING|| [ent status] == STATUS_LAUNCHING)
    {
        // no collisions during launches please
        return;
    }
    
    energy -= amount;
    [self noteTakingDamage:amount from:ent type:kOODamageTypeScrape];
    
    // oops we hit too hard!!!
    if (energy <= 0.0)
    {
        float frag_chance = [ent mass]*10/[self mass];
        /* impacts from heavier entities produce fragments
         * impacts from lighter entities might do but not always
         * asteroid-asteroid impacts likely to fragment
         * ship-asteroid impacts might, or might just vaporise it
         * projectile weapons just get the default chance
         */
        if (randf() < frag_chance)
        {
            being_mined = YES;  // same as using a mining laser
        }
        if ([ent isShip])
        {
            [(ShipEntity *)ent noteTargetDestroyed:self];
        }
        [self getDestroyedBy:ent damageType:kOODamageTypeScrape];
    }
    else
    {
        // warn if I'm low on energy
        if (energy < maxEnergy * 0.25)
        {
            [self doScriptEvent:OOJSID("shipEnergyIsLow") andReactToAIMessage:@"ENERGY_LOW"];
        }
    }
}

References being_mined, doScriptEvent:andReactToAIMessage:, Entity::energy, getDestroyedBy:damageType:, Entity::isShip, Entity::mass, Entity::maxEnergy, noteTakingDamage:from:type:, noteTargetDestroyed:, randf(), and Entity::status.

Referenced by collideWithShip:, DockEntity::shipIsInDockingCorridor:, PlayerEntity::takeScrapeDamage:from:, and StationEntity::takeScrapeDamage:from:.

Here is the call graph for this function:

Here is the caller graph for this function:

targetFirstBeaconWithCode:

- (void) targetFirstBeaconWithCode: (NSString *) code

implementation

Provided by category ShipEntity(PureAI).

Definition at line 2660 of file ShipEntityAI.m.

                                  :(NSString*) code
{
    NSArray         *all_beacons = [UNIVERSE listBeaconsWithCode: code];
    if ([all_beacons count])
    {
        [self addTarget:(ShipEntity*)[all_beacons objectAtIndex:0]];
        [shipAI message:@"TARGET_FOUND"];
    }
    else
        [shipAI message:@"NOTHING_FOUND"];
}

targetNextBeaconWithCode:

- (void) targetNextBeaconWithCode: (NSString *) code

implementation

Provided by category ShipEntity(PureAI).

Definition at line 2673 of file ShipEntityAI.m.

                                 :(NSString*) code
{
    NSArray         *all_beacons = [UNIVERSE listBeaconsWithCode: code];
    ShipEntity      *current_beacon = [self primaryTarget];
    
    if ((!current_beacon)||(![current_beacon isBeacon]))
    {
        [shipAI message:@"NO_CURRENT_BEACON"];
        [shipAI message:@"NOTHING_FOUND"];
        return;
    }
    
    // find the current beacon in the list..
    NSUInteger i = [all_beacons indexOfObject:current_beacon];
    
    if (i == NSNotFound)
    {
        [shipAI message:@"NOTHING_FOUND"];
        return;
    }
    
    i++;    // next index
    
    if (i < [all_beacons count])
    {
        // locate current target in list
        [self addTarget:(ShipEntity*)[all_beacons objectAtIndex:i]];
        [shipAI message:@"TARGET_FOUND"];
    }
    else
    {
        [shipAI message:@"LAST_BEACON"];
        [shipAI message:@"NOTHING_FOUND"];
    }
}

targetStation

- (StationEntity *) targetStation

Definition at line 10013 of file ShipEntity.m.

{
    StationEntity *result = [_targetStation weakRefUnderlyingObject];
    if (result == nil || ![self isValidTarget:result])
    {
        DESTROY(_targetStation);
        return nil;
    }
    return result;
}

References _targetStation, DESTROY, nil, targetStation, and OOWeakReference::weakRefUnderlyingObject.

Referenced by behaviour_fly_to_destination:, PlayerEntity::cancelDockingRequest:, ShipEntity(Private)::drawDebugStuff, PlayerEntity::engageAutopilotToStation:, maxFlightSpeed, PlayerEntity::performDockingRequest:, ShipEntity(AI)::requestDockingCoordinates, ShipEntity(PureAI)::setDestinationToDockingAbort, ShipEntity(PureAI)::setTargetToLastStation, targetStation, and trackDestination:delta_t:.

Here is the call graph for this function:

Here is the caller graph for this function:

temperature

- (GLfloat) temperature

Definition at line 8784 of file ShipEntity.m.

{
    return ship_temperature;
}

References ship_temperature, and temperature.

Referenced by PlayerEntity::createDoppelganger, maxFlightSpeed, randomEjectaTemperatureWithMaxFactor:, temperature, and update:.

Here is the call graph for this function:

Here is the caller graph for this function:

thankedShip

- (Entity *) thankedShip

Definition at line 9975 of file ShipEntity.m.

{
    Entity *result = [_thankedShip weakRefUnderlyingObject];
    if (result == nil || ![self isValidTarget:result])
    {
        DESTROY(_thankedShip);
        return nil;
    }
    return result;
}

References _thankedShip, DESTROY, nil, thankedShip, and OOWeakReference::weakRefUnderlyingObject.

Referenced by interpretAIMessage:, maxFlightSpeed, and thankedShip.

Here is the call graph for this function:

Here is the caller graph for this function:

thargonCheckMother

- (void) thargonCheckMother

implementation

Provided by category ShipEntity(PureAI).

Definition at line 1722 of file ShipEntityAI.m.

{
    ShipEntity   *mother = [self owner];
    if (mother == nil && [self group])  mother = [[self group] leader];
    
    double  maxRange2 = scannerRange * scannerRange;
    
    if (mother && mother != self && HPdistance2(mother->position, position) < maxRange2)
    {
        [shipAI message:@"TARGET_FOUND"]; // no need for scanning, we still have our mother.
    }
    else
    {
        // we lost the old mother, search for a new one
        [self scanForNearestShipHavingRole:@"thargoid-mothership"]; // the scan will send further AI messages.
        if ([self foundTarget] != nil)
        {
            mother = (ShipEntity*)[self foundTarget];
            [self setOwner:mother];
            if ([mother group] != [mother escortGroup]) // avoid adding thargon to an escort group.
            {
                [self setGroup:[mother group]];
            }
        };
    }
}

throwSparks

- (void) throwSparks

implementation

Reimplemented from Entity.

Definition at line 12098 of file ShipEntity.m.

{
    Vector offset =
    {
        randf() * (boundingBox.max.x - boundingBox.min.x) + boundingBox.min.x,
        randf() * (boundingBox.max.y - boundingBox.min.y) + boundingBox.min.y,
        randf() * boundingBox.max.z + boundingBox.min.z  // rear section only
    };
    HPVector origin = HPvector_add(position, vectorToHPVector(quaternion_rotate_vector([self normalOrientation], offset)));
 
    float   w = boundingBox.max.x - boundingBox.min.x;
    float   h = boundingBox.max.y - boundingBox.min.y;
    float   m = (w < h) ? 0.25 * w: 0.25 * h;
    
    float   sz = m * (1 + randf() + randf()); // half minimum dimension on average
    
    Vector vel = vector_multiply_scalar(HPVectorToVector(HPvector_subtract(origin, position)), 2.0);
    
    OOColor *color = [OOColor colorWithHue:0.08 + 0.17 * randf() saturation:1.0 brightness:1.0 alpha:1.0];
    
    OOSparkEntity *spark = [[OOSparkEntity alloc] initWithPosition:origin
                                                          velocity:vel
                                                          duration:2.0 + 3.0 * randf()
                                                              size:sz
                                                             color:color];
    
    [spark setOwner:self];
    [UNIVERSE addEntity:spark];
    [spark release];
 
    next_spark_time = randf();
}

References Entity::boundingBox, OOColor::colorWithHue:saturation:brightness:alpha:, next_spark_time, Entity::normalOrientation, Entity::position, quaternion_rotate_vector(), randf(), Entity::setOwner:, and throwSparks.

Referenced by throwSparks, and update:.

Here is the call graph for this function:

Here is the caller graph for this function:

thrust

- (float) thrust

References reactionTime.

thrustVector

- (Vector) thrustVector

Definition at line 12831 of file ShipEntity.m.

{
    return vector_multiply_scalar(v_forward, flightSpeed);
}

References flightSpeed, thrustVector, and v_forward.

Referenced by cruiseSpeed, setTotalVelocity:, thrustVector, and velocity.

Here is the call graph for this function:

Here is the caller graph for this function:

totalBoundingBox

- (BoundingBox) totalBoundingBox

References forwardVector, rightVector, subEntities, and upVector.

Here is the call graph for this function:

trackCloseContacts

- (BOOL) trackCloseContacts

References isHulk.

trackDestination:delta_t:

- (double) trackDestination:		(double)
delta_t:		(BOOL)	retreat

Definition at line 10930 of file ShipEntity.m.

                           :(double) delta_t :(BOOL) retreat
{
    Vector  relPos;
    GLfloat  d_forward, d_up, d_right;
 
    BOOL    we_are_docking = (nil != dockingInstructions);
 
    stick_roll = 0.0; //desired roll and pitch
    stick_pitch = 0.0;
    stick_yaw = 0.0;
 
    double reverse = 1.0;
    double reversePlayer = 1.0;
 
    double min_d = 0.004;
    double max_cos = MAX_COS;  // should match default value of max_cos in behaviour_fly_to_destination!
    double precision = we_are_docking ? 0.25 : 0.9025; // lower values force a direction closer to the target. (resp. 50% and 95% within range)
 
    if (retreat)
        reverse = -reverse;
 
    if (isPlayer)
    {
        reverse = -reverse;
        reversePlayer = -1;
    }
 
    relPos = HPVectorToVector(HPvector_subtract(_destination, position));
    double range2 = magnitude2(relPos);
    double desired_range2 = desired_range*desired_range;
    
    /*  2009-7-18 Eric: We need to aim well inide the desired_range sphere round the target and not at the surface of the sphere. 
        Because of the framerate most ships normally overshoot the target and they end up flying clearly on a path
        through the sphere. Those ships give no problems, but ships with a very low turnrate will aim close to the surface and will than
        have large trouble with reaching their destination. When those ships enter the slowdown range, they have almost no speed vector
        in the direction of the target. I now used 95% of desired_range to aim at, but a smaller value might even be better. 
    */
    if (range2 > desired_range2) 
    {
        max_cos = sqrt(1 - precision * desired_range2/range2);  // Head for a point within 95% of desired_range.
        if (max_cos >= 0.99999)
        {
            max_cos = 0.99999;
        }
    }
 
    if (!vector_equal(relPos, kZeroVector))  relPos = vector_normal(relPos);
    else  relPos.z = 1.0;
 
    d_right     =   dot_product(relPos, v_right);
    d_up        =   dot_product(relPos, v_up);
    d_forward   =   dot_product(relPos, v_forward);    // == cos of angle between v_forward and vector to target
 
    // begin rule-of-thumb manoeuvres
    stick_pitch = 0.0;
    stick_roll = 0.0;
    
    // pitching_over is currently only set in behaviour_formation_form_up, for escorts and in avoidCollision.
    // This allows for immediate pitch corrections instead of first waiting untill roll has completed.
    if (pitching_over)
    {
        if (reverse * d_up > 0) // pitch up
            stick_pitch = -max_flight_pitch;
        else
            stick_pitch = max_flight_pitch;
        pitching_over = (reverse * d_forward < 0.707);
    }
 
    // check if we are flying toward (or away from) the destination..
    if ((d_forward < max_cos)||(retreat))   // not on course so we must adjust controls..
    {
 
        if (d_forward <= -max_cos || (retreat && d_forward >= max_cos))  // hack to avoid just flying away from the destination
        {
            d_up = min_d * 2.0;
        } 
 
        if (d_up > min_d)
        {
            int factor = sqrt(fabs(d_right) / fabs(min_d));
            if (factor > 8)
                factor = 8;
            if (d_right > min_d)
                stick_roll = - max_flight_roll * reversePlayer * 0.125 * factor;  // only reverse sign for the player;
            if (d_right < -min_d)
                stick_roll = + max_flight_roll * reversePlayer * 0.125 * factor;
            if (fabs(d_right) < fabs(stick_roll) * delta_t) 
                stick_roll = fabs(d_right) / delta_t * (stick_roll<0 ? -1 : 1); // don't overshoot heading
        }
 
        if (d_up < -min_d)
        {
            int factor = sqrt(fabs(d_right) / fabs(min_d));
            if (factor > 8)
                factor = 8;
            if (d_right > min_d)
                stick_roll = + max_flight_roll * reversePlayer * 0.125 * factor;  // only reverse sign for the player;
            if (d_right < -min_d)
                stick_roll = - max_flight_roll * reversePlayer * 0.125 * factor;
            if (fabs(d_right) < fabs(stick_roll) * delta_t) 
                stick_roll = fabs(d_right) / delta_t * (stick_roll<0 ? -1 : 1); // don't overshoot heading
        }
 
        if (stick_roll == 0.0)
        {
            int factor = sqrt(fabs(d_up) / fabs(min_d));
            if (factor > 8)
                factor = 8;
            if (d_up > min_d)
                stick_pitch = - max_flight_pitch * reverse * 0.125 * factor;  //pitch_pitch * reverse;
            if (d_up < -min_d)
                stick_pitch = + max_flight_pitch * reverse * 0.125 * factor;
            if (fabs(d_up) < fabs(stick_pitch) * delta_t) 
                stick_pitch = fabs(d_up) / delta_t * (stick_pitch<0 ? -1 : 1); // don't overshoot heading
        }
 
        if (stick_pitch == 0.0)
        {
            // not sufficiently on course yet, but min_d is too high
            // turn anyway slightly to adjust
            stick_pitch = 0.01;
        }
    }
 
    if (we_are_docking && docking_match_rotation && (d_forward > max_cos))
    {
        /* we are docking and need to consider the rotation/orientation of the docking port */
        StationEntity* station_for_docking = (StationEntity*)[self targetStation];
 
        if ((station_for_docking)&&(station_for_docking->isStation))
        {
            stick_roll = [self rollToMatchUp:[station_for_docking portUpVectorForShip:self] rotating:[station_for_docking flightRoll]];
        }
    }
 
    // end rule-of-thumb manoeuvres
 
    [self applySticks:delta_t];
 
    if (retreat)
        d_forward *= d_forward; // make positive AND decrease granularity
 
    if (d_forward < 0.0)
        return 0.0;
 
    if ((!flightRoll)&&(!flightPitch)) // no correction
        return 1.0;
 
    return d_forward;
}

References _destination, applySticks:, desired_range, docking_match_rotation, dockingInstructions, flightPitch, flightRoll, Entity::isPlayer, Entity::isStation, kZeroVector, MAX_COS, max_flight_pitch, max_flight_roll, nil, pitching_over, StationEntity::portUpVectorForShip:, Entity::position, rollToMatchUp:rotating:, stick_pitch, stick_roll, stick_yaw, targetStation, v_forward, v_right, and v_up.

Referenced by behaviour_avoid_collision:, behaviour_face_destination:, behaviour_fly_from_destination:, behaviour_fly_thru_navpoints:, behaviour_fly_to_destination:, behaviour_fly_to_target_six:, behaviour_formation_form_up:, behaviour_intercept_target:, and behaviour_land_on_planet:.

Here is the call graph for this function:

Here is the caller graph for this function:

trackOntoTarget:withDForward:

- (void) trackOntoTarget:		(double)	delta_t
withDForward:		(GLfloat)	dp

Definition at line 10292 of file ShipEntity.m.

                        :(double) delta_t withDForward: (GLfloat) dp
{
    Vector vector_to_target;
    Quaternion q_minarc;
    //
    Entity* target = [self primaryTarget];
    //
    if (!target)
        return;
 
    vector_to_target = [self vectorTo:target];
    //
    GLfloat range2 =        magnitude2(vector_to_target);
    GLfloat targetRadius =  0.75 * target->collision_radius;
    GLfloat max_cos =       sqrt(1 - targetRadius*targetRadius/range2);
    
    if (dp > max_cos)
        return; // ON TARGET!
    
    if (vector_to_target.x||vector_to_target.y||vector_to_target.z)
        vector_to_target = vector_normal(vector_to_target);
    else
        vector_to_target.z = 1.0;
    
    q_minarc = quaternion_rotation_between(v_forward, vector_to_target);
    
    orientation = quaternion_multiply(q_minarc, orientation);
    [self orientationChanged];
    
    flightRoll = 0.0;
    flightPitch = 0.0;
    flightYaw = 0.0;
    stick_roll = 0.0;
    stick_pitch = 0.0;
    stick_yaw = 0.0;
}

References Entity::collision_radius, flightPitch, flightRoll, flightYaw, Entity::orientation, orientationChanged, primaryTarget, quaternion_multiply(), quaternion_rotation_between(), stick_pitch, stick_roll, stick_yaw, v_forward, and Entity::vectorTo:.

Here is the call graph for this function:

trackPrimaryTarget:delta_t:

- (double) trackPrimaryTarget:		(double)
delta_t:		(BOOL)	retreat

Definition at line 10477 of file ShipEntity.m.

                             :(double) delta_t :(BOOL) retreat
{
    Entity* target = [self primaryTarget];
 
    if (!target)   // leave now!
    {
        [self noteLostTargetAndGoIdle]; // NOTE: was AI message: rather than reactToMessage:
        return 0.0;
    }
 
    if (![self canStillTrackPrimaryTarget])
    {
        [self noteLostTargetAndGoIdle]; // NOTE: was AI message: rather than reactToMessage:
        return 0.0;
    }
 
    /* 1.81 change: do the above check first: if a missile can't be
     * fired outside scanner range it should self-destruct if the
     * target gets far enough away (it's going to miss anyway) -
     * CIM */
    if (scanClass == CLASS_MISSILE)
        return [self missileTrackPrimaryTarget: delta_t];
 
    GLfloat  d_forward, d_up, d_right;
    
    Vector  relPos = HPVectorToVector(HPvector_subtract([self calculateTargetPosition], position));
    
    double  range2 = HPmagnitude2(HPvector_subtract([target position], position));
 
    //jink if retreating
    if (retreat) // calculate jink position when flying away from target.
    {
        Vector vx, vy, vz;
        if (target->isShip)
        {
            ShipEntity* targetShip = (ShipEntity*)target;
            vx = targetShip->v_right;
            vy = targetShip->v_up;
            vz = targetShip->v_forward;
        }
        else
        {
            Quaternion q = target->orientation;
            vx = vector_right_from_quaternion(q);
            vy = vector_up_from_quaternion(q);
            vz = vector_forward_from_quaternion(q);
        }
        
        BOOL avoidCollision = NO;
        if (range2 < collision_radius * target->collision_radius * 100.0) // Check direction within 10 * collision radius.
        {
            Vector targetDirection = kBasisZVector;
            if (!vector_equal(relPos, kZeroVector))  targetDirection = vector_normal(relPos);
            avoidCollision  =  (dot_product(targetDirection, v_forward) > -0.1); // is flying toward target or only slightly outward.
        }
        
        GLfloat dist_adjust_factor = 1.0;
        if (accuracy >= COMBAT_AI_FLEES_BETTER)
        {
            double  range = magnitude(relPos);
            if (range > 2000.0)
            {
                dist_adjust_factor = range / 2000.0;
                if (accuracy >= COMBAT_AI_FLEES_BETTER_2)
                {
                    dist_adjust_factor *= 3;
                }
            }
            if (jink.x == 0.0 && behaviour != BEHAVIOUR_RUNNING_DEFENSE)
            { // test for zero jink and correct
                [self setEvasiveJink:400.0];
            }
        }
 
        if (!avoidCollision)  // it is safe to jink
        {
            relPos.x += (jink.x * vx.x + jink.y * vy.x + jink.z * vz.x) * dist_adjust_factor;
            relPos.y += (jink.x * vx.y + jink.y * vy.y + jink.z * vz.y) * dist_adjust_factor;
            relPos.z += (jink.x * vx.z + jink.y * vy.z + jink.z * vz.z);
        }
 
    }
 
    if (!vector_equal(relPos, kZeroVector))  relPos = vector_normal(relPos);
    else  relPos.z = 1.0;
 
    double  max_cos = [self currentAimTolerance];
 
    stick_roll = 0.0; //desired roll and pitch
    stick_pitch = 0.0;
 
    double reverse = (retreat)? -1.0: 1.0;
 
    double min_d = 0.004; // ~= 40m at 10km
    int max_factor = 8;
    double r_max_factor = 0.125;
    if (!retreat)
    {   
        if (accuracy >= COMBAT_AI_TRACKS_CLOSER)
        { 
            // much greater precision in combat
            if (max_flight_pitch > 1.0)
            {
                max_factor = floor(max_flight_pitch/0.125);
                r_max_factor = 1.0/max_factor;
            }
            min_d = 0.0004; // 10 times more precision ~= 4m at 10km
            max_factor *= 3;
            r_max_factor /= 3.0;
        }
        else if (accuracy >= COMBAT_AI_ISNT_AWFUL)
        {
            // slowly improve precision to target, but only if missing
            min_d -= 0.0001 * [self missedShots];
            if (min_d < 0.001)
            {
                min_d = 0.001;
                max_factor *= 2;
                r_max_factor /= 2.0;
            }
        }
    }
 
    d_right     =   dot_product(relPos, v_right);
    d_up        =   dot_product(relPos, v_up);
    d_forward   =   dot_product(relPos, v_forward);    // == cos of angle between v_forward and vector to target
 
    if (d_forward * reverse > max_cos)  // on_target!
    {
        return d_forward;
    }
 
    // begin rule-of-thumb manoeuvres
    stick_pitch = 0.0;
    stick_roll = 0.0;
 
 
    if ((reverse * d_forward < -0.5) && !pitching_over) // we're going the wrong way!
        pitching_over = YES;
 
    if (pitching_over)
    {
        if (reverse * d_up > 0) // pitch up
            stick_pitch = -max_flight_pitch;
        else
            stick_pitch = max_flight_pitch;
        pitching_over = (reverse * d_forward < 0.707);
    }
 
    // check if we are flying toward the destination..
    if ((d_forward < max_cos)||(retreat))   // not on course so we must adjust controls..
    {
        if (d_forward < -max_cos)  // hack to avoid just flying away from the destination
        {
            d_up = min_d * 2.0;
        }
 
        if (d_up > min_d)
        {
            int factor = sqrt(fabs(d_right) / fabs(min_d));
            if (factor > max_factor)
                factor = max_factor;
            if (d_right > min_d)
                stick_roll = - max_flight_roll * r_max_factor * factor; // note#
            if (d_right < -min_d)
                stick_roll = + max_flight_roll * r_max_factor * factor; // note#
        }
        if (d_up < -min_d)
        {
            int factor = sqrt(fabs(d_right) / fabs(min_d));
            if (factor > max_factor)
                factor = max_factor;
            if (d_right > min_d)
                stick_roll = + max_flight_roll * r_max_factor * factor; // note#
            if (d_right < -min_d)
                stick_roll = - max_flight_roll * r_max_factor * factor; // note#
        }
 
        if (stick_roll == 0.0)
        {
            int factor = sqrt(fabs(d_up) / fabs(min_d));
            if (factor > max_factor)
                factor = max_factor;
            if (d_up > min_d)
                stick_pitch = - max_flight_pitch * reverse * r_max_factor * factor;
            if (d_up < -min_d)
                stick_pitch = + max_flight_pitch * reverse * r_max_factor * factor;
        }
 
        if (accuracy >= COMBAT_AI_ISNT_AWFUL)
        {
            // don't overshoot target (helps accuracy at low frame rates)
            if (fabs(d_right) < fabs(stick_roll) * delta_t) 
            {
                stick_roll = fabs(d_right) / delta_t * (stick_roll<0 ? -1 : 1);
            }
            if (fabs(d_up) < fabs(stick_pitch) * delta_t) 
            {
                stick_pitch = fabs(d_up) / delta_t * (stick_pitch<0 ? -0.9 : 0.9);
            }
        }
 
    }
    /*  #  note
        Eric 9-9-2010: Removed the "reverse" variable from the stick_roll calculation. This was mathematical wrong and
        made the ship roll in the wrong direction, preventing the ship to fly away in a straight line from the target.
        This means all the places were a jink was set, this jink never worked correctly. The main reason a ship still
        managed to turn at close range was probably by the fail-safe mechanisme with the "pitching_over" variable.
        The jink was programmed to do nothing within 500 meters of the ship and just fly away in direct line from the target
        in that range. Because of the bug the ships always rolled to the wrong side needed to fly away in direct line
        resulting in making it a difficult target.
        After fixing the bug, the ship realy flew away in direct line during the first 500 meters, making it a easy target
        for the player. All jink settings are retested and changed to give a turning behaviour that felt like the old
        situation, but now more deliberately set.
     */
 
    // end rule-of-thumb manoeuvres
    stick_yaw = 0.0;
    
    [self applySticks:delta_t];
 
    if (retreat)
        d_forward *= d_forward; // make positive AND decrease granularity
 
    if (d_forward < 0.0)
        return 0.0;
 
    if ((!flightRoll)&&(!flightPitch)) // no correction
        return 1.0;
 
    return d_forward;
}

References accuracy, applySticks:, avoidCollision, behaviour, calculateTargetPosition, canStillTrackPrimaryTarget, Entity::collision_radius, COMBAT_AI_FLEES_BETTER, COMBAT_AI_FLEES_BETTER_2, COMBAT_AI_ISNT_AWFUL, COMBAT_AI_TRACKS_CLOSER, currentAimTolerance, flightPitch, flightRoll, Entity::isShip, jink, kBasisZVector, kZeroVector, max_flight_pitch, max_flight_roll, missedShots, missileTrackPrimaryTarget:, noteLostTargetAndGoIdle, Entity::orientation, pitching_over, Entity::position, primaryTarget, scanClass, setEvasiveJink:, stick_pitch, stick_roll, stick_yaw, v_forward, v_right, v_up, vector_forward_from_quaternion(), vector_right_from_quaternion(), and vector_up_from_quaternion().

Referenced by behaviour_attack_break_off_target:, behaviour_attack_fly_from_target:, behaviour_attack_fly_to_target:, behaviour_attack_mining_target:, behaviour_attack_slow_dogfight:, behaviour_attack_sniper:, behaviour_flee_target:, behaviour_intercept_target:, behaviour_running_defense:, and behaviour_track_target:.

Here is the call graph for this function:

Here is the caller graph for this function:

trackSideTarget:delta_t:

- (double) trackSideTarget:		(double)
delta_t:		(BOOL)	leftside

Definition at line 10711 of file ShipEntity.m.

                          :(double) delta_t :(BOOL) leftside
{
    Entity* target = [self primaryTarget];
 
    if (!target)   // leave now!
    {
        [self noteLostTargetAndGoIdle]; // NOTE: was AI message: rather than reactToMessage:
        return 0.0;
    }
 
    if (![self canStillTrackPrimaryTarget])
    {
        [self noteLostTargetAndGoIdle]; // NOTE: was AI message: rather than reactToMessage:
        return 0.0;
    }
 
 
    if (scanClass == CLASS_MISSILE) // never?
        return [self missileTrackPrimaryTarget: delta_t];
 
    GLfloat  d_forward, d_up, d_right;
    
    Vector  relPos = HPVectorToVector(HPvector_subtract([self calculateTargetPosition], position));
 
 
    if (!vector_equal(relPos, kZeroVector))  relPos = vector_normal(relPos);
    else  relPos.z = 1.0;
 
// worse shots with side lasers than fore/aft, in general
 
    double  max_cos = [self currentAimTolerance];
 
    stick_roll = 0.0; //desired roll and pitch
    stick_pitch = 0.0;
    stick_yaw = 0.0;
 
    double reverse = (leftside)? -1.0: 1.0;
 
    double min_d = 0.004;
    if (accuracy >= COMBAT_AI_TRACKS_CLOSER) 
    {
        min_d = 0.002;
    }
    int max_factor = 8;
    double r_max_factor = 0.125;
 
    d_right     =   dot_product(relPos, v_right);
    d_up        =   dot_product(relPos, v_up);
    d_forward   =   dot_product(relPos, v_forward);    // == cos of angle between v_forward and vector to target
 
    if (d_right * reverse > max_cos)    // on_target!
    {
        return d_right * reverse;
    }
 
    // begin rule-of-thumb manoeuvres
    stick_pitch = 0.0;
    stick_roll = 0.0;
    stick_yaw = 0.0;
 
    // check if we are flying toward the destination..
    if ((d_right * reverse < max_cos))  // not on course so we must adjust controls..
    {
        if (d_right < -max_cos)  // hack to avoid just pointing away from the destination
        {
            d_forward = min_d * 2.0;
        }
 
        if (d_forward > min_d)
        {
            int factor = sqrt(fabs(d_up) / fabs(min_d));
            if (factor > max_factor)
                factor = max_factor;
            if (d_up > min_d)
                stick_pitch = + max_flight_pitch * r_max_factor * factor; // note#
            if (d_up < -min_d)
                stick_pitch = - max_flight_pitch * r_max_factor * factor; // note#
        }
        if (d_forward < -min_d)
        {
            int factor = sqrt(fabs(d_up) / fabs(min_d));
            if (factor > max_factor)
                factor = max_factor;
            if (d_up > min_d)
                stick_pitch = + max_flight_pitch * r_max_factor * factor; // note#
            if (d_up < -min_d)
                stick_pitch = - max_flight_pitch * r_max_factor * factor; // note#
        }
 
        if (fabs(stick_pitch) == 0.0 || fabs(d_forward) > 0.5)
        {
            stick_pitch = 0.0;
            int factor = sqrt(fabs(d_forward) / fabs(min_d));
            if (factor > max_factor)
                factor = max_factor;
            if (d_forward > min_d)
                stick_yaw = - max_flight_yaw * reverse * r_max_factor * factor;
            if (d_forward < -min_d)
            {
                if (factor < max_factor/2.0) // compensate for forward thrust
                    factor *= 2.0;
                stick_yaw = + max_flight_yaw * reverse * r_max_factor * factor;
            }
        }
    }
 
 
    // end rule-of-thumb manoeuvres
 
    [self applySticks:delta_t];
 
    if ((!flightPitch)&&(!flightYaw))   // no correction
        return 1.0;
 
    return d_right * reverse;
}

References accuracy, applySticks:, calculateTargetPosition, canStillTrackPrimaryTarget, COMBAT_AI_TRACKS_CLOSER, currentAimTolerance, flightPitch, flightYaw, kZeroVector, max_flight_pitch, max_flight_yaw, missileTrackPrimaryTarget:, noteLostTargetAndGoIdle, Entity::position, primaryTarget, scanClass, stick_pitch, stick_roll, stick_yaw, v_forward, v_right, and v_up.

Referenced by behaviour_attack_broadside_target:leftside:.

Here is the call graph for this function:

Here is the caller graph for this function:

transitionToAegisNone

- (void) transitionToAegisNone

Definition at line 7574 of file ShipEntity.m.

{
    if (!suppressAegisMessages && aegis_status != AEGIS_NONE)
    {
        Entity<OOStellarBody> *lastAegisLock = [self lastAegisLock];
        if (lastAegisLock != nil)
        {
            [self doScriptEvent:OOJSID("shipExitedPlanetaryVicinity") withArgument:lastAegisLock];
            
            if (lastAegisLock == [UNIVERSE sun])
            {
                [shipAI message:@"AWAY_FROM_SUN"];
            }
            else
            {
                [shipAI message:@"AWAY_FROM_PLANET"];
            }
        }
 
        if (aegis_status != AEGIS_CLOSE_TO_ANY_PLANET)
        {
            [shipAI message:@"AEGIS_NONE"];
        }
    }
    aegis_status = AEGIS_NONE;
}

References AEGIS_CLOSE_TO_ANY_PLANET, AEGIS_NONE, aegis_status, doScriptEvent:withArgument:, lastAegisLock, AI::message:, nil, suppressAegisMessages, transitionToAegisNone, and UNIVERSE.

Referenced by checkForAegis, reportAIMessages, transitionToAegisNone, and PlayerEntity(OOPrivate)::witchStart.

Here is the call graph for this function:

Here is the caller graph for this function:

turretCount

- (NSUInteger) turretCount

Definition at line 7028 of file ShipEntity.m.

{
    NSUInteger count = 0;
    NSEnumerator *subEnum = [self shipSubEntityEnumerator];
    ShipEntity *se = nil;
    while ((se = [subEnum nextObject]))
    {
        if ([se isTurret])
        {
            count ++; 
        }
    }
    return count;
}

References count, isTurret, nil, shipSubEntityEnumerator, and turretCount.

Referenced by messageTime, OOShipLibraryTurrets(), and turretCount.

Here is the call graph for this function:

Here is the caller graph for this function:

update:

- (void) update: (OOTimeDelta) delta_t

implementation

Reimplemented from Entity.

Reimplemented in DockEntity, PlayerEntity, and StationEntity.

Definition at line 2319 of file ShipEntity.m.

               :(OOTimeDelta)delta_t
{
    if (shipinfoDictionary == nil)
    {
        OOLog(@"shipEntity.notDict", @"Ship %@ was not set up from dictionary.", self);
        [UNIVERSE removeEntity:self];
        return;
    }
    
    if (!isfinite(maxFlightSpeed))
    {
        OOLog(@"ship.sanityCheck.failed", @"Ship %@ %@ infinite top speed, clamped to 300.", self, @"had");
        maxFlightSpeed = 300;
    }
 
    bool isSubEnt = [self isSubEntity];
 
    if (isDemoShip)
    {
        if (demoRate > 0)
        {
            OOScalar cos1 = cos(M_PI * ([UNIVERSE getTime] - demoStartTime) * demoRate / 11);
            OOScalar sin1 = sin(M_PI * ([UNIVERSE getTime] - demoStartTime) * demoRate / 11);
            OOScalar cos2 = cos(-M_PI * ([UNIVERSE getTime] - demoStartTime) * demoRate / 15);
            OOScalar sin2 = sin(-M_PI * ([UNIVERSE getTime] - demoStartTime) * demoRate / 15);
            Quaternion q1 = make_quaternion(cos1, sin1*sqrt(3)/2, sin1/2, 0);
            Quaternion q2 = make_quaternion(cos2, -sin2*sqrt(4)/sqrt(5), 0, sin2*sqrt(1)/sqrt(5));
            [self setOrientation: quaternion_multiply(q2, quaternion_multiply(q1, demoStartOrientation))];
        }
 
        [super update:delta_t];
        if ([self subEntityCount] > 0)
        {
            // only copy the subent array if there are subentities
            ShipEntity *se = nil;
            foreach (se, [self subEntities])
            {
                [se update:delta_t];
                if ([se isShip])
                {
                    BoundingBox sebb = [se findSubentityBoundingBox];
                    bounding_box_add_vector(&totalBoundingBox, sebb.max);
                    bounding_box_add_vector(&totalBoundingBox, sebb.min);
                }
            }
        }
        return;
    }
 
 
    if (!isSubEnt)
    {
        if (scanClass == CLASS_NOT_SET)
        {
            scanClass = CLASS_NEUTRAL;
            OOLog(@"ship.sanityCheck.failed", @"Ship %@ %@ with scanClass CLASS_NOT_SET; forced to CLASS_NEUTRAL.", self, [self primaryRole]);
        }
 
        [self updateTrackingCurve];
 
        //
        // deal with collisions
        //
        [self manageCollisions];
 
    // subentity collisions managed via parent entity
    
        //
        // reset any inadvertant legal mishaps
        //
        if (scanClass == CLASS_POLICE)
        {
            if (bounty > 0)
            {
                [self setBounty:0 withReason:kOOLegalStatusReasonPoliceAreClean];
            }
            ShipEntity* target = [self primaryTarget];
            if ((target)&&([target scanClass] == CLASS_POLICE))
            {
                [self noteLostTarget];
            }
        }
        
        if (trackCloseContacts)
        {
            // in checkCloseCollisionWith: we check if some thing has come within touch range (origin within our collision_radius)
            // here we check if it has gone outside that range
            NSString *other_key = nil;
 
            // create a temp copy to iterate over, since we may want to
            // change the original
            NSDictionary *closeContactsTemp = [[NSDictionary alloc] initWithDictionary:closeContactsInfo];
            foreachkey (other_key, closeContactsTemp)
            {
                ShipEntity* other = [UNIVERSE entityForUniversalID:[other_key intValue]];
                if ((other != nil) && (other->isShip))
                {
                    if (HPdistance2(position, other->position) > collision_radius * collision_radius)   // moved beyond our sphere!
                    {
                        // calculate position with respect to our own position and orientation
                        Vector  dpos = HPVectorToVector(HPvector_between(position, other->position));
                        Vector  pos1 = make_vector(dot_product(dpos, v_right), dot_product(dpos, v_up), dot_product(dpos, v_forward));
                        Vector  pos0 = {0, 0, 0};
                        ScanVectorFromString([closeContactsInfo objectForKey: other_key], &pos0);
                        // send AI messages about the contact
                        OOWeakReference *temp = _primaryTarget;
                        _primaryTarget = [other weakRetain];
                        if ((pos0.x < 0.0)&&(pos1.x > 0.0))
                        {
                            [self doScriptEvent:OOJSID("shipTraversePositiveX") withArgument:other andReactToAIMessage:@"POSITIVE X TRAVERSE"];
                        }
                        if ((pos0.x > 0.0)&&(pos1.x < 0.0))
                        {
                            [self doScriptEvent:OOJSID("shipTraverseNegativeX") withArgument:other andReactToAIMessage:@"NEGATIVE X TRAVERSE"];
                        }
                        if ((pos0.y < 0.0)&&(pos1.y > 0.0))
                        {
                            [self doScriptEvent:OOJSID("shipTraversePositiveY") withArgument:other andReactToAIMessage:@"POSITIVE Y TRAVERSE"];
                        }
                        if ((pos0.y > 0.0)&&(pos1.y < 0.0))
                        {
                            [self doScriptEvent:OOJSID("shipTraverseNegativeY") withArgument:other andReactToAIMessage:@"NEGATIVE Y TRAVERSE"];
                        }
                        if ((pos0.z < 0.0)&&(pos1.z > 0.0))
                        {
                            [self doScriptEvent:OOJSID("shipTraversePositiveZ") withArgument:other andReactToAIMessage:@"POSITIVE Z TRAVERSE"];
                        }
                        if ((pos0.z > 0.0)&&(pos1.z < 0.0))
                        {
                            [self doScriptEvent:OOJSID("shipTraverseNegativeZ") withArgument:other andReactToAIMessage:@"NEGATIVE Z TRAVERSE"];
                        }
                        _primaryTarget = temp;
                        [closeContactsInfo removeObjectForKey: other_key];
                    }
                }
                else
                {
                    [closeContactsInfo removeObjectForKey: other_key];
                }
            }
            [closeContactsTemp release];
        } // end if trackCloseContacts
 
    } // end if !isSubEntity
 
 
#ifndef NDEBUG
    // DEBUGGING
    if (reportAIMessages && (debugLastBehaviour != behaviour))
    {
        OOLog(kOOLogEntityBehaviourChanged, @"%@ behaviour is now %@", self, OOStringFromBehaviour(behaviour));
        debugLastBehaviour = behaviour;
    }
#endif
    
    // cool all weapons.
    weapon_temp = fmaxf(weapon_temp - (float)(WEAPON_COOLING_FACTOR * delta_t), 0.0f);
    forward_weapon_temp = fmaxf(forward_weapon_temp - (float)(WEAPON_COOLING_FACTOR * delta_t), 0.0f);
    aft_weapon_temp = fmaxf(aft_weapon_temp - (float)(WEAPON_COOLING_FACTOR * delta_t), 0.0f);
    port_weapon_temp = fmaxf(port_weapon_temp - (float)(WEAPON_COOLING_FACTOR * delta_t), 0.0f);
    starboard_weapon_temp = fmaxf(starboard_weapon_temp - (float)(WEAPON_COOLING_FACTOR * delta_t), 0.0f);
    
    // update time between shots
    shot_time += delta_t;
 
    // handle radio message effects
    if (messageTime > 0.0)
    {
        messageTime -= delta_t;
        if (messageTime < 0.0)  messageTime = 0.0;
    }
    
    // temperature factors
    if(!isSubEnt)
    {
        double external_temp = 0.0;
        OOSunEntity *sun = [UNIVERSE sun];
        if (sun != nil)
        {
            // set the ambient temperature here
            double  sun_zd = HPdistance2(position, [sun position]); // square of distance
            double  sun_cr = sun->collision_radius;
            double  alt1 = sun_cr * sun_cr / sun_zd;
            external_temp = SUN_TEMPERATURE * alt1;
            if ([sun goneNova])  external_temp *= 100;
 
            if ([self hasFuelScoop] && alt1 > 0.75 && [self fuel] < [self fuelCapacity])
            {
                fuel_accumulator += (float)(delta_t * flightSpeed * 0.010 / [self fuelChargeRate]);
            // are we fast enough to collect any fuel?
                while (fuel_accumulator > 1.0f)
                {
                    [self setFuel:[self fuel] + 1];
                    fuel_accumulator -= 1.0f;
                    [self doScriptEvent:OOJSID("shipScoopedFuel")];
                }
            }
        }
 
        // work on the ship temperature
        //
        float heatThreshold = [self heatInsulation] * 100.0f;
        if (external_temp > heatThreshold &&  external_temp > ship_temperature)
            ship_temperature += (external_temp - ship_temperature) * delta_t * SHIP_INSULATION_FACTOR / [self heatInsulation];
        else
        {
            if (ship_temperature > SHIP_MIN_CABIN_TEMP)
            {
                ship_temperature += (external_temp - heatThreshold - ship_temperature) * delta_t * SHIP_COOLING_FACTOR / [self heatInsulation];
                if (ship_temperature < SHIP_MIN_CABIN_TEMP) ship_temperature = SHIP_MIN_CABIN_TEMP;
            }
        }
    }
    else //subents
    {
        ship_temperature = [[self owner] temperature];
    }
 
    if (ship_temperature > SHIP_MAX_CABIN_TEMP)
        [self takeHeatDamage: delta_t * ship_temperature];
 
    // are we burning due to low energy
    if ((energy < maxEnergy * 0.20)&&_showDamage) // prevents asteroid etc. from burning
        throw_sparks = YES;
    
    // burning effects
    if (throw_sparks)
    {
        next_spark_time -= delta_t;
        if (next_spark_time < 0.0)
        {
            [self throwSparks];
            throw_sparks = NO;  // until triggered again
        }
    }
    
    if (!isSubEnt)
    {
 
        // cloaking device
        if ([self hasCloakingDevice])
        {
            if (cloaking_device_active)
            {
                energy -= delta_t * CLOAKING_DEVICE_ENERGY_RATE;
                if (energy < CLOAKING_DEVICE_MIN_ENERGY)
                {  
                    [self deactivateCloakingDevice];
                    if (energy < 0) energy = 0;
                }
            }
        }
 
        // military_jammer
        if ([self hasMilitaryJammer])
        {
            if (military_jammer_active)
            {
                energy -= delta_t * MILITARY_JAMMER_ENERGY_RATE;
                if (energy < MILITARY_JAMMER_MIN_ENERGY)
                {
                    military_jammer_active = NO;
                    if (energy < 0) energy = 0;
                }
            }
            else
            {
                if (energy > 1.5 * MILITARY_JAMMER_MIN_ENERGY)
                    military_jammer_active = YES;
            }
        }
 
    // check outside factors
        /* aegis checks are expensive, so only do them once every km or so of flight
         * unlikely to be important otherwise. (every 100m if already close to
         * planet, to watch for surface)
 
         * if have non-zero inertial velocity, need to check every frame,
         * as distanceTravelled does not include this component - CIM */
        if (_nextAegisCheck < distanceTravelled || !vector_equal([super velocity],kZeroVector))
        {
            aegis_status = [self checkForAegis];   // is a station or something nearby??
            if (aegis_status == AEGIS_NONE)
            {
                // in open space: check every km
                _nextAegisCheck = distanceTravelled + 1000.0;
            }
            else
            {
                // near planets: check every 100m
                _nextAegisCheck = distanceTravelled + 100.0;
            }
        }
    } // end if !isSubEntity
 
    // scripting
    if (!haveExecutedSpawnAction)
    {
        // When crashing into a boulder, STATUS_LAUNCHING is sometimes skipped on scooping the resulting splinters.
        OOEntityStatus status = [self status];
        if (script != nil && (status == STATUS_IN_FLIGHT ||
                              status == STATUS_LAUNCHING ||
                              status == STATUS_BEING_SCOOPED ||
                              (status == STATUS_ACTIVE && self == [UNIVERSE station])
                              ))
        {
            [PLAYER setScriptTarget:self];
            [self doScriptEvent:OOJSID("shipSpawned")];
            if ([self status] != STATUS_DEAD)  [PLAYER doScriptEvent:OOJSID("shipSpawned") withArgument:self];
        }
        haveExecutedSpawnAction = YES;
    }
    /* No point in starting the AI if still launching */
    if (!haveStartedJSAI && [self status] != STATUS_LAUNCHING)
    {
        haveStartedJSAI = YES;
        [self doScriptEvent:OOJSID("aiStarted")];
    }
 
    // behaviours according to status and behaviour
    //
    if ([self status] == STATUS_LAUNCHING)
    {
        if ([UNIVERSE getTime] > launch_time + launch_delay)     // move for while before thinking
        {
            StationEntity *stationLaunchedFrom = [UNIVERSE nearestEntityMatchingPredicate:IsStationPredicate parameter:NULL relativeToEntity:self];
            [self setStatus:STATUS_IN_FLIGHT];
            // awaken JS-based AIs
            haveStartedJSAI = YES;
            [self doScriptEvent:OOJSID("aiStarted")];
            [self doScriptEvent:OOJSID("shipLaunchedFromStation") withArgument:stationLaunchedFrom];
            [shipAI reactToMessage:@"LAUNCHED OKAY" context:@"launched"];
        }
        else
        {
            // ignore behaviour just keep moving...
            flightYaw = 0.0;
            [self applyAttitudeChanges:delta_t];
            [self applyThrust:delta_t];
            if (energy < maxEnergy)
            {
                energy += energy_recharge_rate * delta_t;
                if (energy > maxEnergy)
                {
                    energy = maxEnergy;
                    [self doScriptEvent:OOJSID("shipEnergyBecameFull")];
                    [shipAI message:@"ENERGY_FULL"];
                }
            }
            
            if ([self subEntityCount] > 0)
            {
                // only copy the subent array if there are subentities
                ShipEntity *se = nil;
                foreach (se, [self subEntities])
                {
                    [se update:delta_t];
                }
            }
            // super update
            [super update:delta_t];
 
            return;
        }
    }
    //
    // double check scooped behaviour
    //
    if ([self status] == STATUS_BEING_SCOOPED)
    {
        //if we are being tractored, but we have no owner, then we have a problem
        if (behaviour != BEHAVIOUR_TRACTORED  || [self owner] == nil || [self owner] == self || [self owner] == NO_TARGET)
        {
            // escaped tractor beam
            [self setStatus:STATUS_IN_FLIGHT];  // should correct 'uncollidable objects' bug
            behaviour = BEHAVIOUR_IDLE;
            frustration = 0.0;
            [self setOwner:self];
            [shipAI exitStateMachineWithMessage:nil];  // Escapepods and others should continue their old AI here.
        }
    }
    
    if ([self status] == STATUS_COCKPIT_DISPLAY)
    {
        flightYaw = 0.0;
        [self applyAttitudeChanges:delta_t];
        GLfloat range2 = 0.1 * HPdistance2(position, _destination) / (collision_radius * collision_radius);
        if ((range2 > 1.0)||(velocity.z > 0.0)) range2 = 1.0;
        position = HPvector_add(position, vectorToHPVector(vector_multiply_scalar(velocity, range2 * delta_t)));
    }
    else
    {
        [self processBehaviour:delta_t];
 
        // manage energy
        if (energy < maxEnergy)
        {
            energy += energy_recharge_rate * delta_t;
            if (energy > maxEnergy)
            {
                energy = maxEnergy;
                [self doScriptEvent:OOJSID("shipEnergyBecameFull")];
                [shipAI message:@"ENERGY_FULL"];
            }
        }
        
        if (!isSubEnt)
        {
        // update destination position for escorts
            [self refreshEscortPositions];
            if ([self hasEscorts])
            {
                ShipEntity  *escort = nil;
                unsigned    i = 0;
                // Note: works on escortArray rather than escortEnumerator because escorts may be mutated.
                foreach(escort, [self escortArray])
                {
                    [escort setEscortDestination:[self coordinatesForEscortPosition:i++]];
                }
            
                ShipEntity *leader = [[self escortGroup] leader];
                if (leader != nil && ([leader scanClass] != [self scanClass])) {
                    OOLog(@"ship.sanityCheck.failed", @"Ship %@ escorting %@ with wrong scanclass!", self, leader);
                    [[self escortGroup] removeShip:self];
                    [self setEscortGroup:nil];
                }
            }
        }
    }
    
    // rotational velocity
    if (!quaternion_equal(subentityRotationalVelocity, kIdentityQuaternion) &&
        !quaternion_equal(subentityRotationalVelocity, kZeroQuaternion))
    {
        Quaternion qf = subentityRotationalVelocity;
        qf.w *= (1.0 - delta_t);
        qf.x *= delta_t;
        qf.y *= delta_t;
        qf.z *= delta_t;
        [self setOrientation:quaternion_multiply(qf, orientation)];
    }
    
    //  reset totalBoundingBox
    totalBoundingBox = boundingBox;
    
    // super update
    [super update:delta_t];
 
    // update subentities
 
    if ([self subEntityCount] > 0)
    {
        // only copy the subent array if there are subentities
        ShipEntity *se = nil;
        foreach (se, [self subEntities])
        {
            [se update:delta_t];
            if ([se isShip])
            {
                BoundingBox sebb = [se findSubentityBoundingBox];
                bounding_box_add_vector(&totalBoundingBox, sebb.max);
                bounding_box_add_vector(&totalBoundingBox, sebb.min);
            }
        }
    }
    
    if (aiScriptWakeTime > 0 && [PLAYER clockTimeAdjusted] > aiScriptWakeTime)
    {
        aiScriptWakeTime = 0;
        [self doScriptEvent:OOJSID("aiAwoken")];
    }
}

References _destination, _nextAegisCheck, _primaryTarget, _showDamage, AEGIS_NONE, aegis_status, aft_weapon_temp, aiScriptWakeTime, applyAttitudeChanges:, applyThrust:, behaviour, Entity::boundingBox, bounty, checkForAegis, cloaking_device_active, CLOAKING_DEVICE_ENERGY_RATE, CLOAKING_DEVICE_MIN_ENERGY, closeContactsInfo, Entity::collision_radius, coordinatesForEscortPosition:, deactivateCloakingDevice, debugLastBehaviour, demoRate, demoStartTime, Entity::distanceTravelled, doScriptEvent:, doScriptEvent:withArgument:, doScriptEvent:withArgument:andReactToAIMessage:, Entity::energy, energy_recharge_rate, escortArray, escortGroup, AI::exitStateMachineWithMessage:, findSubentityBoundingBox, flightSpeed, flightYaw, foreachkey, forward_weapon_temp, frustration, fuel, fuel_accumulator, fuelCapacity, fuelChargeRate, hasCloakingDevice, hasEscorts, hasFuelScoop, hasMilitaryJammer, haveExecutedSpawnAction, haveStartedJSAI, heatInsulation, isDemoShip, Entity::isShip, Entity::isSubEntity, kIdentityQuaternion, kOOLogEntityBehaviourChanged, kZeroQuaternion, kZeroVector, launch_delay, launch_time, OOShipGroup::leader, M_PI, manageCollisions, Entity::maxEnergy, maxFlightSpeed, AI::message:, messageTime, military_jammer_active, MILITARY_JAMMER_ENERGY_RATE, MILITARY_JAMMER_MIN_ENERGY, next_spark_time, nil, NO_TARGET, noteLostTarget, OOLog, OOStringFromBehaviour(), Entity::owner, PLAYER, port_weapon_temp, Entity::position, primaryRole, primaryTarget, processBehaviour:, AI::reactToMessage:context:, refreshEscortPositions, OOShipGroup::removeShip:, reportAIMessages, scanClass, ScanVectorFromString(), script, setBounty:withReason:, setEscortDestination:, setEscortGroup:, setFuel:, Entity::setOrientation:, setOwner:, setStatus:, SHIP_COOLING_FACTOR, SHIP_INSULATION_FACTOR, SHIP_MAX_CABIN_TEMP, SHIP_MIN_CABIN_TEMP, ship_temperature, shipinfoDictionary, shot_time, starboard_weapon_temp, Entity::status, subEntities, subEntityCount, subentityRotationalVelocity, SUN_TEMPERATURE, takeHeatDamage:, temperature, Entity::throw_sparks, throwSparks, totalBoundingBox, trackCloseContacts, UNIVERSE, Entity::update:, update:, updateTrackingCurve, v_forward, v_right, v_up, velocity, OOWeakRefObject::weakRetain, WEAPON_COOLING_FACTOR, and weapon_temp.

Referenced by DockEntity::clearDockingCorridor, WormholeEntity::disgorgeShips, PlayerEntity::doBookkeeping:, DockEntity::update:, update:, and StationEntity::update:.

Here is the call graph for this function:

Here is the caller graph for this function:

updateEscortFormation

- (void) updateEscortFormation

Definition at line 13779 of file ShipEntity.m.

{
    _escortPositionsValid = NO;
}

References _escortPositionsValid, and updateEscortFormation.

Referenced by deployEscorts, findBoundingBoxRelativeToPosition:InVectors:i:j:, setEscortGroup:, setGroup:, setUpEscorts, and updateEscortFormation.

Here is the call graph for this function:

Here is the caller graph for this function:

updateTrackingCurve

- (void) updateTrackingCurve

Definition at line 6336 of file ShipEntity.m.

{
    Entity *target = [self primaryTarget];
    OOTimeAbsolute now = [UNIVERSE getTime];
    if (target == nil || reactionTime <= 0.0 || trackingCurveTimes[0] + reactionTime/3.0 > now) return;
    trackingCurvePositions[3] = trackingCurvePositions[2];
    trackingCurvePositions[2] = trackingCurvePositions[1];
    trackingCurvePositions[1] = trackingCurvePositions[0];
    if (EXPECT_NOT([target isShip] && [(ShipEntity *)target isCloaked]))
    {
        // if target is cloaked, introduce some more inaccuracy
        // 0.02 seems to be enough to give them slight difficulty on
        // a straight-line target and real trouble on anything better
        trackingCurvePositions[0] = HPvector_add([target position],OOHPVectorRandomSpatial([(ShipEntity *)target flightSpeed]*reactionTime*0.02));
    }
    else
    {
        trackingCurvePositions[0] = [target position];
    }
    trackingCurveTimes[3] = trackingCurveTimes[2];
    trackingCurveTimes[2] = trackingCurveTimes[1];
    trackingCurveTimes[1] = trackingCurveTimes[0];
    trackingCurveTimes[0] = now;
    [self calculateTrackingCurve];
    return;
}

References calculateTrackingCurve, EXPECT_NOT, flightSpeed, isCloaked, Entity::isShip, nil, OOHPVectorRandomSpatial(), Entity::position, primaryTarget, reactionTime, trackingCurvePositions, trackingCurveTimes, and updateTrackingCurve.

Referenced by reactionTime, update:, and updateTrackingCurve.

Here is the call graph for this function:

Here is the caller graph for this function:

upVector

- (Vector) upVector

Definition at line 1277 of file ShipEntity.m.

{
    return v_up;
}

References upVector, and v_up.

Referenced by behaviour_fly_to_destination:, OOExhaustPlumeEntity(Private)::saveToLastFrame, totalBoundingBox, OOExhaustPlumeEntity::update:, and upVector.

Here is the call graph for this function:

Here is the caller graph for this function:

validateDefenseTargets

- (void) validateDefenseTargets

Definition at line 11199 of file ShipEntity.m.

{
    if (_defenseTargets == nil)
    {
        return;
    }
    // get enumerator from array as we'll be modifying original during enumeration
    NSEnumerator *defTargets = [[self allDefenseTargets] objectEnumerator];
    Entity *target = nil;
    while ((target = [[defTargets nextObject] weakRefUnderlyingObject]))
    {
        if ([target status] == STATUS_DEAD)
        {
            [self removeDefenseTarget:target];
        }
    }
}

References _defenseTargets, allDefenseTargets, nil, removeDefenseTarget:, Entity::status, and validateDefenseTargets.

Referenced by isMissile, ShipGetProperty(), and validateDefenseTargets.

Here is the call graph for this function:

Here is the caller graph for this function:

validForAddToUniverse

- (BOOL) validForAddToUniverse

implementation

Reimplemented from Entity.

Reimplemented in PlayerEntity.

Definition at line 2308 of file ShipEntity.m.

{
    if (shipinfoDictionary == nil)
    {
        OOLog(@"shipEntity.notDict", @"Ship %@ was not set up from dictionary.", self);
        return NO;
    }
    return [super validForAddToUniverse];
}

References nil, OOLog, shipinfoDictionary, Entity::validForAddToUniverse, and validForAddToUniverse.

Referenced by validForAddToUniverse.

Here is the call graph for this function:

Here is the caller graph for this function:

velocity

- (Vector) velocity

implementation

Reimplemented from Entity.

Definition at line 12837 of file ShipEntity.m.

{
    return vector_add([super velocity], [self thrustVector]);
}

References thrustVector, and velocity.

Referenced by addImpactMoment:fraction:, Universe::addLaserHitEffectsAt:against:damage:color:, Universe::addWreckageFrom:withRole:at:scale:lifetime:, adjustVelocity:, applyThrust:, becomeExplosion, behaviour_attack_target:, behaviour_land_on_planet:, behaviour_tractored:, collideWithShip:, PlayerEntity::createDoppelganger, dealEnergyDamage:atRange:withBias:, StationEntity::dockingInstructionsForShip:, dumpItem:, PlayerEntity::engageAutopilotToStation:, PlayerEntity::getDestroyedBy:damageType:, PlayerEntity::launchEscapeCapsule, PlayerEntity::launchMine:, DockEntity::launchShip:, PlayerEntity::leaveDock:, PlayerEntity::leaveWitchspace, releaseCargoPodsDebris, PlayerEntity::setUpAndConfirmOK:saveGame:, update:, velocity, and witchspaceLeavingEffects.

Here is the call graph for this function:

Here is the caller graph for this function:

verifiedMissileTypeFromRole:

- (OOEquipmentType *) verifiedMissileTypeFromRole: (NSString *) role

implementation

Definition at line 3747 of file ShipEntity.m.

                                                 :(NSString *)role
{
    NSString            *eqRole = nil;
    NSString            *shipKey = nil;
    ShipEntity          *missile = nil;
    OOEquipmentType     *missileType = nil;
    BOOL                isRandomMissile = [role isEqualToString:@"missile"];
    
    if (isRandomMissile)
    {
        while (!shipKey)
        {
            shipKey = [UNIVERSE randomShipKeyForRoleRespectingConditions:role];
            if (!shipKey) 
            {
                OOLogWARN(@"ship.setUp.missiles", @"%@ \"%@\" used in ship \"%@\" needs a valid %@.plist entry.%@", @"random missile", shipKey, [self name], @"shipdata",  @"Trying another missile.");
            }
        }
    }
    else
    {
        shipKey = [UNIVERSE randomShipKeyForRoleRespectingConditions:role];
        if (!shipKey) 
        {
            OOLogWARN(@"ship.setUp.missiles", @"%@ \"%@\" used in ship \"%@\" needs a valid %@.plist entry.%@", @"missile_role", role, [self name], @"shipdata", @" Using defaults instead.");
            return nil;
        }
    }
    
    eqRole = [OOEquipmentType getMissileRegistryRoleForShip:shipKey];   // eqRole != role for generic missiles.
    
    if (eqRole == nil)
    {
        missile = [UNIVERSE newShipWithName:shipKey];
        if (!missile)
        {
            if (isRandomMissile)
                OOLogWARN(@"ship.setUp.missiles", @"%@ \"%@\" used in ship \"%@\" needs a valid %@.plist entry.%@", @"random missile", shipKey, [self name], @"shipdata",  @"Trying another missile.");
            else
                OOLogWARN(@"ship.setUp.missiles", @"%@ \"%@\" used in ship \"%@\" needs a valid %@.plist entry.%@", @"missile_role", role, [self name], @"shipdata", @" Using defaults instead.");
                
            [OOEquipmentType setMissileRegistryRole:@"" forShip:shipKey];   // no valid role for this shipKey
            if (isRandomMissile) return [self verifiedMissileTypeFromRole:role];
            else return nil;
        }
        
        if(isRandomMissile)
        {
            id              value;
            NSEnumerator    *enumerator = [[[missile roleSet] roles] objectEnumerator];
            
            while ((value = [enumerator nextObject]))
            {
                role = (NSString *)value;
                missileType = [OOEquipmentType equipmentTypeWithIdentifier:role];
                // ensure that we have a missile or mine
                if ([missileType isMissileOrMine]) break;
            }
        
            if (![missileType isMissileOrMine])
            {
                role = shipKey; // unique identifier to use in lieu of a valid equipment type if none are defined inside the generic missile roleset.
            }
        }
        
        missileType = [OOEquipmentType equipmentTypeWithIdentifier:role];
        
        if (!missileType)
        {
            OOLogWARN(@"ship.setUp.missiles", @"%@ \"%@\" used in ship \"%@\" needs a valid %@.plist entry.%@", (isRandomMissile ? @"random missile" : @"missile_role"), role, [self name], @"equipment", @" Enabling compatibility mode.");
            missileType = [self generateMissileEquipmentTypeFrom:role];
        }
        
        [OOEquipmentType setMissileRegistryRole:role forShip:shipKey];
        [missile release];
    }
    else
    {
        if ([eqRole isEqualToString:@""])
        {
            // wrong ship definition, already written to the log in a previous call.
            if (isRandomMissile) return [self verifiedMissileTypeFromRole:role];    // try and find a valid missile with role 'missile'.
            return nil;
        }
        missileType = [OOEquipmentType equipmentTypeWithIdentifier:eqRole];
    }
 
    return missileType;
}

References OOEquipmentType::equipmentTypeWithIdentifier:, generateMissileEquipmentTypeFrom:, OOEquipmentType::getMissileRegistryRoleForShip:, name, nil, OOLogWARN, OORoleSet::roles, roleSet, OOEquipmentType::setMissileRegistryRole:forShip:, and verifiedMissileTypeFromRole:.

Referenced by selectMissile, and verifiedMissileTypeFromRole:.

Here is the call graph for this function:

Here is the caller graph for this function:

volume

- (float) volume

Definition at line 1436 of file ShipEntity.m.

{
    return [octree volume];
}

References Octree::volume, and volume.

Referenced by clearSubEntities, octree, PlayerEntity::setGuiToGameOptionsScreen, and volume.

Here is the call graph for this function:

Here is the caller graph for this function:

wasAddedToUniverse

- (void) wasAddedToUniverse

implementation

Reimplemented from Entity.

Definition at line 1503 of file ShipEntity.m.

{
    [super wasAddedToUniverse];
    
    // if we have a universal id then we can proceed to set up any
    // stuff that happens when we get added to the UNIVERSE
    if (universalID != NO_TARGET)
    {
        // set up escorts
        if (([self status] == STATUS_IN_FLIGHT || [self status] == STATUS_LAUNCHING) && _pendingEscortCount != 0)    // just popped into existence
        {
            [self setUpEscorts];
        }
        else
        {
            /*  Earlier there was a silly log message here because I thought
                this would never happen, but wasn't entirely sure. Turns out
                it did!
                -- Ahruman 2009-09-13
            */
            _pendingEscortCount = 0;
        }
    }
 
    //  Tell subentities, too
    [subEntities makeObjectsPerformSelector:@selector(wasAddedToUniverse)];
    
    [self resetExhaustPlumes];
}

References _pendingEscortCount, NO_TARGET, resetExhaustPlumes, setUpEscorts, Entity::status, Entity::universalID, Entity::wasAddedToUniverse, and wasAddedToUniverse.

Referenced by PlayerEntity::showShipModelWithKey:shipData:personality:factorX:factorY:factorZ:inContext:, and wasAddedToUniverse.

Here is the call graph for this function:

Here is the caller graph for this function:

wasRemovedFromUniverse

- (void) wasRemovedFromUniverse

implementation

Reimplemented from Entity.

Definition at line 1534 of file ShipEntity.m.

{
    [subEntities makeObjectsPerformSelector:@selector(wasRemovedFromUniverse)];
}

References wasRemovedFromUniverse.

Referenced by wasRemovedFromUniverse.

Here is the call graph for this function:

Here is the caller graph for this function:

weaponFacings

- (OOWeaponFacingSet) weaponFacings

Definition at line 3247 of file ShipEntity.m.

{
    return weapon_facings;
}

References weapon_facings, and weaponFacings.

Referenced by PlayerEntity::availableFacings, isFrangible, OOShipLibraryWeapons(), PlayerEntity::setCommanderDataFromDictionary:, PlayerEntity::setGuiToEquipShipScreen:selectingFacingFor:, PlayerEntity::setWeaponMount:toWeapon:inContext:, and weaponFacings.

Here is the call graph for this function:

Here is the caller graph for this function:

weaponRange

- (GLfloat) weaponRange

References currentWeaponFacing, energyRechargeRate, and weaponRechargeRate.

Here is the call graph for this function:

weaponRechargeRate

- (float) weaponRechargeRate

Definition at line 7514 of file ShipEntity.m.

{
    return weapon_recharge_rate;
}

References weapon_recharge_rate, and weaponRechargeRate.

Referenced by weaponRange, and weaponRechargeRate.

Here is the call graph for this function:

Here is the caller graph for this function:

weaponRecoveryTime

- (GLfloat) weaponRecoveryTime

Definition at line 9703 of file ShipEntity.m.

{
    float result = (weapon_recharge_rate - [self shotTime]) / weapon_recharge_rate;
    return OOClamp_0_1_f(result);
}

References shotTime, weapon_recharge_rate, and weaponRecoveryTime.

Referenced by maxFlightSpeed, and weaponRecoveryTime.

Here is the call graph for this function:

Here is the caller graph for this function:

weaponTypeForFacing:strict:

- (OOEquipmentType *) weaponTypeForFacing:		(OOWeaponFacing)	facing
strict:		(BOOL)	strict

Reimplemented in PlayerEntity.

Definition at line 3294 of file ShipEntity.m.

                                         :(OOWeaponFacing)facing strict:(BOOL)strict
{
//  OOWeaponType weaponType = [self weaponTypeIDForFacing:facing strict:strict];
//  return [OOEquipmentType equipmentTypeWithIdentifier:OOEquipmentIdentifierFromWeaponType(weaponType)];
    return [self weaponTypeIDForFacing:facing strict:strict];
}

References weaponTypeIDForFacing:strict:.

Referenced by fireDirectLaserShotAt:, fireSubentityLaserShot:, and ShipGetProperty().

Here is the call graph for this function:

Here is the caller graph for this function:

weaponTypeIDForFacing:strict:

- (OOWeaponType) weaponTypeIDForFacing:		(OOWeaponFacing)	facing
strict:		(BOOL)	strict

Definition at line 3253 of file ShipEntity.m.

                                      :(OOWeaponFacing)facing strict:(BOOL)strict
{
    OOWeaponType weaponType = nil;
 
    if (facing & weapon_facings)
    {
        switch (facing)
        {
            case WEAPON_FACING_FORWARD:
                weaponType = forward_weapon_type;
                // if no forward weapon, and not carrying out a strict check, see if subentities have forward weapons, return the first one found.
                if (isWeaponNone(weaponType) && !strict)
                {
                    NSEnumerator    *subEntEnum = [self shipSubEntityEnumerator];
                    ShipEntity      *subEntity = nil;
                    while (isWeaponNone(weaponType) && (subEntity = [subEntEnum nextObject]))
                    {
                        weaponType = subEntity->forward_weapon_type;
                    }
                }
                break;
                
            case WEAPON_FACING_AFT:
                weaponType = aft_weapon_type;
                break;
                
            case WEAPON_FACING_PORT:
                weaponType = port_weapon_type;
                break;
                
            case WEAPON_FACING_STARBOARD:
                weaponType = starboard_weapon_type;
                break;
                
            case WEAPON_FACING_NONE:
                break;
        }
    }
    return weaponType;
}

References aft_weapon_type, forward_weapon_type, isWeaponNone(), nil, port_weapon_type, shipSubEntityEnumerator, starboard_weapon_type, WEAPON_FACING_AFT, WEAPON_FACING_FORWARD, WEAPON_FACING_NONE, WEAPON_FACING_PORT, WEAPON_FACING_STARBOARD, and weapon_facings.

Referenced by weaponTypeForFacing:strict:.

Here is the call graph for this function:

Here is the caller graph for this function:

witchspaceLeavingEffects

- (BOOL) witchspaceLeavingEffects

Definition at line 13563 of file ShipEntity.m.

{
    // all ships exiting witchspace will share the same orientation.
    orientation = [UNIVERSE getWitchspaceExitRotation];
    flightRoll = 0.0;
    stick_roll = 0.0;
    flightPitch = 0.0;
    stick_pitch = 0.0;
    flightYaw = 0.0;
    stick_yaw = 0.0;
    flightSpeed = 50.0; // constant speed same for all ships
// was a quarter of max speed, so the Anaconda speeds up and most
// others slow down - CIM
// will be overridden if left witchspace via a genuine wormhole
    velocity = kZeroVector;
    if (![UNIVERSE addEntity:self]) // AI and status get initialised here
    {
        return NO;
    }
    [self setStatus:STATUS_EXITING_WITCHSPACE];
    [shipAI message:@"EXITED_WITCHSPACE"];
    
    [UNIVERSE addWitchspaceJumpEffectForShip:self];
    [self setStatus:STATUS_IN_FLIGHT];
    return YES;
}

References flightPitch, flightRoll, flightSpeed, flightYaw, kZeroVector, AI::message:, Entity::orientation, setStatus:, stick_pitch, stick_roll, stick_yaw, UNIVERSE, velocity, and witchspaceLeavingEffects.

Referenced by Universe::addShipAt:withRole:withinRadius:, coordinates, WormholeEntity::disgorgeShips, leaveWitchspace, and witchspaceLeavingEffects.

Here is the call graph for this function:

Here is the caller graph for this function:

withinStationAegis

- (BOOL) withinStationAegis

Definition at line 7879 of file ShipEntity.m.

{
    return aegis_status == AEGIS_IN_DOCKING_RANGE;
}

References AEGIS_IN_DOCKING_RANGE, aegis_status, and withinStationAegis.

Referenced by AuthorityPredicate, reportAIMessages, and withinStationAegis.

Here is the call graph for this function:

Here is the caller graph for this function:

wormholeEntireGroup

- (void) wormholeEntireGroup

Provided by category ShipEntity(AI).

Definition at line 713 of file ShipEntityAI.m.

{
    [self wormholeGroup];
    [self wormholeEscorts];
}

wormholeEscorts

- (void) wormholeEscorts

Provided by category ShipEntity(AI).

Definition at line 684 of file ShipEntityAI.m.

{
    NSEnumerator        *shipEnum = nil;
    ShipEntity          *ship = nil;
    NSString            *context = nil;
    WormholeEntity      *whole = nil;
    
    whole = [self primaryTarget];
    if (![whole isWormhole])  return;
    
#ifndef NDEBUG
    context = [NSString stringWithFormat:@"%@ wormholeEscorts", [self shortDescription]];
#endif
    
    for (shipEnum = [self escortEnumerator]; (ship = [shipEnum nextObject]); )
    {
        [ship addTarget:whole];
        [ship reactToAIMessage:@"ENTER WORMHOLE" context:context];
        [ship doScriptEvent:OOJSID("wormholeSuggested") withArgument:whole];
    }
    
    // We now have no escorts..
 
    [_escortGroup release];
    _escortGroup = nil;
 
}

Referenced by enterWormhole:replacing:, and ShipEntity(AI)::wormholeEntireGroup.

Here is the caller graph for this function:

wormholeGroup

- (void) wormholeGroup

implementation

Provided by category ShipEntity(PureAI).

Definition at line 1647 of file ShipEntityAI.m.

{
    NSEnumerator        *shipEnum = nil;
    ShipEntity          *ship = nil;
    WormholeEntity      *whole = nil;
    
    whole = [self primaryTarget];
    if (![whole isWormhole])  return;
    
    for (shipEnum = [[self group] mutationSafeEnumerator]; (ship = [shipEnum nextObject]); )
    {
        [ship addTarget:whole];
        [ship reactToAIMessage:@"ENTER WORMHOLE" context:@"wormholeGroup"];
        [ship doScriptEvent:OOJSID("wormholeSuggested") withArgument:whole];
    }
}

Referenced by ShipEntity(AI)::wormholeEntireGroup.

Here is the caller graph for this function:

Member Data Documentation

_beaconCode

- (NSString*) _beaconCode

private

Definition at line 484 of file ShipEntity.h.

Referenced by beaconCode, dealloc, and setBeaconCode:.

_beaconDrawable

- (id<OOHUDBeaconIcon>) _beaconDrawable

private

Definition at line 488 of file ShipEntity.h.

Referenced by beaconDrawable, dealloc, and setBeaconCode:.

_beaconLabel

- (NSString*) _beaconLabel

private

Definition at line 485 of file ShipEntity.h.

Referenced by beaconLabel, dealloc, setBeaconCode:, and setBeaconLabel:.

_collisionExceptions

- (OOWeakSet*) _collisionExceptions

private

Definition at line 477 of file ShipEntity.h.

Referenced by addCollisionException:, collisionExceptedFor:, collisionExceptions, dealloc, and removeCollisionException:.

_defenseTargets

- (OOWeakSet*) _defenseTargets

private

Definition at line 474 of file ShipEntity.h.

Referenced by addDefenseTarget:, dealloc, and validateDefenseTargets.

_destination

- (HPVector) _destination

Definition at line 203 of file ShipEntity.h.

Referenced by avoidCollision, behaviour_avoid_collision:, behaviour_fly_thru_navpoints:, behaviour_fly_to_target_six:, behaviour_intercept_target:, behaviour_tractored:, destination, dumpSelfState, rangeToDestination, resumePostProximityAlert, setDestination:, setEscortDestination:, trackDestination:delta_t:, and update:.

_equipment

- (NSMutableArray*) _equipment

private

Definition at line 461 of file ShipEntity.h.

Referenced by addEquipmentItem:withValidation:inContext:, countEquipmentItem:, equipmentItemProviding:, hasAllEquipment:includeWeapons:whileLoading:, hasEquipmentItemProviding:, hasOneEquipmentItem:includeMissiles:whileLoading:, hasOneEquipmentItem:includeWeapons:whileLoading:, removeAllEquipment, and removeEquipmentItem:.

_escortGroup

- (OOShipGroup*) _escortGroup

private

Definition at line 467 of file ShipEntity.h.

Referenced by abandonShip, dealloc, deployEscorts, dockEscorts, escortArray, escortCount, escortEnumerator, escortGroup, hasEscorts, realAlertCondition, setEscortGroup:, and setGroup:.

_escortPositions

- (Vector _escortPositions[MAX_ESCORTS])

private

Definition at line 471 of file ShipEntity.h.

_escortPositionsValid

- (BOOL) _escortPositionsValid

private

Definition at line 472 of file ShipEntity.h.

Referenced by updateEscortFormation.

_explicitlyUnpiloted

- (unsigned) _explicitlyUnpiloted

protected

Definition at line 274 of file ShipEntity.h.

Referenced by isExplicitlyUnpiloted, and setUpShipFromDictionary:.

_foundTarget

- (OOWeakReference*) _foundTarget

protected

Definition at line 440 of file ShipEntity.h.

Referenced by foundTarget, PlayerEntity::setFoundTarget:, and setFoundTarget:.

_group

- (OOShipGroup*) _group

private

Definition at line 466 of file ShipEntity.h.

Referenced by dealloc, fireMissileWithIdentifier:andTarget:, group, realAlertCondition, setGroup:, and stationGroup.

_heatInsulation

- (float) _heatInsulation

private

Definition at line 462 of file ShipEntity.h.

Referenced by heatInsulation, and setHeatInsulation:.

_lastAegisLock

- (OOWeakReference*) _lastAegisLock

private

Definition at line 464 of file ShipEntity.h.

Referenced by dealloc, and setLastAegisLock:.

_lastEscortTarget

- (OOWeakReference*) _lastEscortTarget

protected

Definition at line 441 of file ShipEntity.h.

Referenced by lastEscortTarget, setLastEscortTarget:, and takeEnergyDamage:from:becauseOf:weaponIdentifier:.

_lightsActive

- (unsigned) _lightsActive

protected

Definition at line 282 of file ShipEntity.h.

Referenced by lightsActive, setUpFromDictionary:, switchLightsOff, and switchLightsOn.

_maxEscortCount

- (uint8_t) _maxEscortCount

private

Definition at line 468 of file ShipEntity.h.

Referenced by acceptAsEscort:, maxEscortCount, setMaxEscortCount:, setPendingEscortCount:, setUpEscorts, and setUpShipFromDictionary:.

_maxShipSubIdx

- (NSUInteger) _maxShipSubIdx

protected

Definition at line 343 of file ShipEntity.h.

Referenced by maxShipSubEntities, setUpOneStandardSubentity:asTurret:, and setUpSubEntities.

_missed_shots

- (int) _missed_shots

protected

Definition at line 376 of file ShipEntity.h.

Referenced by adjustMissedShots:, missedShots, and setUpShipFromDictionary:.

_missileRole

- (NSString*) _missileRole

protected

Definition at line 321 of file ShipEntity.h.

Referenced by selectMissile, and setUpShipFromDictionary:.

_multiplyWeapons

- (BOOL) _multiplyWeapons

protected

Definition at line 391 of file ShipEntity.h.

Referenced by fireLaserShotInDirection:weaponIdentifier:, PlayerEntity::fireMainWeapon, fireWeapon:direction:range:, and PlayerEntity::setGuiToEquipShipScreen:selectingFacingFor:.

_nextAegisCheck

- (double) _nextAegisCheck

private

Definition at line 490 of file ShipEntity.h.

Referenced by forceAegisCheck, initWithKey:definition:, and update:.

_nextBeacon

- (OOWeakReference*) _nextBeacon

private

Definition at line 487 of file ShipEntity.h.

Referenced by setNextBeacon:.

_pendingEscortCount

- (uint8_t) _pendingEscortCount

private

Definition at line 469 of file ShipEntity.h.

Referenced by pendingEscortCount, setPendingEscortCount:, setUpEscorts, setUpShipFromDictionary:, and wasAddedToUniverse.

_prevBeacon

- (OOWeakReference*) _prevBeacon

private

Definition at line 486 of file ShipEntity.h.

Referenced by setPrevBeacon:.

_primaryAggressor

- (OOWeakReference*) _primaryAggressor

protected

Definition at line 438 of file ShipEntity.h.

Referenced by noteLostTarget, primaryAggressor, and setPrimaryAggressor:.

_primaryTarget

- (OOWeakReference*) _primaryTarget

protected

Definition at line 437 of file ShipEntity.h.

Referenced by addTarget:, checkCloseCollisionWith:, PlayerEntity::disengageAutopilot, PlayerEntity::engageAutopilotToStation:, PlayerEntity::enterDock:, PlayerEntity::interpretAIMessage:, noteLostTarget, primaryTarget, primaryTargetWithoutValidityCheck, removeTarget:, resumePostProximityAlert, PlayerEntity::selectNextMissile, setTargetToSystemStation, PlayerEntity::setUpShipFromDictionary:, and update:.

_profileRadius

- (GLfloat) _profileRadius

private

Definition at line 479 of file ShipEntity.h.

Referenced by clearSubEntities, frustumRadius, and setUpSubEntities.

_proximityAlert

- (OOWeakReference*) _proximityAlert

protected

Definition at line 444 of file ShipEntity.h.

Referenced by proximityAlert, resumePostProximityAlert, and setProximityAlert:.

_rememberedShip

- (OOWeakReference*) _rememberedShip

protected

Definition at line 443 of file ShipEntity.h.

Referenced by rememberedShip, and setRememberedShip:.

_scaleFactor

- (GLfloat) _scaleFactor

protected

Definition at line 388 of file ShipEntity.h.

Referenced by getWeaponOffsetFrom:withKey:inMode:, missileLaunchPosition, PlayerEntity::setCustomViewDataFromDictionary:withScaling:, setUpOneStandardSubentity:asTurret:, and PlayerEntity::setUpShipFromDictionary:.

_scriptedMisjumpRange

- (GLfloat) _scriptedMisjumpRange

protected

Definition at line 284 of file ShipEntity.h.

Referenced by scriptedMisjumpRange, setScriptedMisjumpRange:, PlayerEntity::setUpAndConfirmOK:saveGame:, and setUpFromDictionary:.

_shipHitByLaser

- (OOWeakReference*) _shipHitByLaser

private

Definition at line 481 of file ShipEntity.h.

_shipKey

- (NSString*) _shipKey

private

Definition at line 459 of file ShipEntity.h.

Referenced by dealloc, initWithKey:definition:, setShipDataKey:, and shipDataKey.

_showDamage

- (unsigned) _showDamage

protected

Definition at line 270 of file ShipEntity.h.

Referenced by showDamage, and update:.

_subEntityTakingDamage

- (OOWeakReference*) _subEntityTakingDamage

private

Definition at line 457 of file ShipEntity.h.

Referenced by setSubEntityTakingDamage:.

_subIdx

- (NSUInteger) _subIdx

protected

Definition at line 342 of file ShipEntity.h.

Referenced by setSubIdx:, and subIdx.

_targetStation

- (OOWeakReference*) _targetStation

protected

Definition at line 439 of file ShipEntity.h.

Referenced by setTargetStation:, and targetStation.

_thankedShip

- (OOWeakReference*) _thankedShip

protected

Definition at line 442 of file ShipEntity.h.

Referenced by setThankedShip:, and thankedShip.

accuracy

- (GLfloat) accuracy

protected

Definition at line 1217 of file ShipEntity.m.

{
    return accuracy;
}

Referenced by applySticks:, behaviour_attack_break_off_target:, behaviour_attack_fly_from_target:, behaviour_attack_fly_to_target:, behaviour_attack_sniper:, behaviour_attack_target:, behaviour_flee_target:, behaviour_fly_to_target_six:, behaviour_running_defense:, currentAimTolerance, dumpSelfState, fireDirectLaserShot:, fireDirectLaserShotAt:, fireWeapon:direction:range:, frustration, missileTrackPrimaryTarget:, noteTakingDamage:from:type:, noticeECM, setAccuracy:, setEvasiveJink:, setUpShipFromDictionary:, trackPrimaryTarget:delta_t:, and trackSideTarget:delta_t:.

aegis_status

- (OOAegisStatus) aegis_status

protected

Definition at line 378 of file ShipEntity.h.

Referenced by checkForAegis, transitionToAegisNone, update:, StationEntity::update:, and withinStationAegis.

aft_weapon_temp

- (GLfloat) aft_weapon_temp

protected

Definition at line 315 of file ShipEntity.h.

Referenced by behaviour_attack_target:, PlayerEntity::doBookkeeping:, PlayerEntity::fireMainWeapon, fireWeapon:direction:range:, initWithKey:definition:, PlayerEntity::laserHeatLevelAft, laserHeatLevelAft, PlayerEntity::leaveDock:, PlayerEntity::setUpAndConfirmOK:saveGame:, setUpShipFromDictionary:, and update:.

aft_weapon_type

- (OOWeaponType) aft_weapon_type

protected

Definition at line 306 of file ShipEntity.h.

Referenced by behaviour_attack_fly_to_target:, behaviour_attack_target:, PlayerEntity::commanderDataDictionary, PlayerEntity::equipmentList, PlayerEntity::hasPrimaryWeapon:, hasPrimaryWeapon:, PlayerEntity::setCommanderDataFromDictionary:, PlayerEntity::setGuiToEquipShipScreen:selectingFacingFor:, PlayerEntity::setUpAndConfirmOK:saveGame:, setWeaponMount:toWeapon:, PlayerEntity::setWeaponMount:toWeapon:inContext:, PlayerEntity::weaponForFacing:, PlayerEntity::weaponTypeForFacing:strict:, and weaponTypeIDForFacing:strict:.

afterburner_rate

- (GLfloat) afterburner_rate

protected

Definition at line 291 of file ShipEntity.h.

Referenced by afterburnerRate, applyThrust:, PlayerEntity::doBookkeeping:, and setAfterburnerRate:.

afterburner_speed_factor

- (GLfloat) afterburner_speed_factor

protected

Definition at line 292 of file ShipEntity.h.

Referenced by afterburnerFactor, and setAfterburnerFactor:.

aftWeaponOffset

- (NSArray *) aftWeaponOffset

protected

Definition at line 2027 of file ShipEntity.m.

{
    return aftWeaponOffset;
}

Referenced by dealloc, findBoundingBoxRelativeToPosition:InVectors:i:j:, Universe::firstEntityTargetedByPlayerPrecisely, laserPortOffset:, and ShipGetProperty().

aim_tolerance

- (GLfloat) aim_tolerance

protected

Definition at line 375 of file ShipEntity.h.

Referenced by behaviour_attack_fly_to_target:, behaviour_attack_target:, currentAimTolerance, and setAccuracy:.

aiScript

- (OOJSScript*) aiScript

protected

Definition at line 223 of file ShipEntity.h.

Referenced by dealloc, and shipAIScript.

aiScriptWakeTime

- (OOTimeAbsolute) aiScriptWakeTime

protected

Definition at line 224 of file ShipEntity.h.

Referenced by behaviour_land_on_planet:, initWithKey:definition:, setAIScriptWakeTime:, shipAIScriptWakeTime, and update:.

behaviour

- (OOBehaviour) behaviour

Definition at line 10244 of file ShipEntity.m.

{
    return behaviour;
}

Referenced by abandonShip, applyThrust:, avoidCollision, behaviour_attack_break_off_target:, behaviour_attack_broadside:, behaviour_attack_broadside_target:leftside:, behaviour_attack_fly_from_target:, behaviour_attack_fly_to_target:, behaviour_attack_slow_dogfight:, behaviour_attack_sniper:, behaviour_attack_target:, behaviour_close_to_broadside_range:, behaviour_close_with_target:, behaviour_evasive_action:, behaviour_face_destination:, behaviour_fly_from_destination:, behaviour_fly_range_from_destination:, behaviour_fly_thru_navpoints:, behaviour_fly_to_destination:, behaviour_fly_to_target_six:, behaviour_intercept_target:, behaviour_land_on_planet:, behaviour_running_defense:, behaviour_scripted_ai:, behaviour_tractored:, descriptionComponents, PlayerEntity::disengageAutopilot, dumpSelfState, fireMainWeapon:, getTractoredBy:, hasHostileTarget, IsBehaviourHostile, isMining, isTurret, maxFlightSpeed, noteLostTargetAndGoIdle, noteTakingDamage:from:type:, processBehaviour:, resumePostProximityAlert, setBehaviour:, setProximityAlert:, takeEnergyDamage:from:becauseOf:weaponIdentifier:, trackPrimaryTarget:delta_t:, OOAIDebugInspectorModule::update, and update:.

being_fined

- (unsigned) being_fined

protected

Definition at line 259 of file ShipEntity.h.

Referenced by PlayerEntity::docked, dumpSelfState, PlayerEntity::leaveWitchspace, markedForFines, markForFines, and setUpFromDictionary:.

being_mined

- (unsigned) being_mined

protected

Definition at line 257 of file ShipEntity.h.

Referenced by becomeExplosion, StationEntity::becomeExplosion, dumpSelfState, takeEnergyDamage:from:becauseOf:weaponIdentifier:, and takeScrapeDamage:from:.

bounty

- (OOCreditsQuantity) bounty

protected

Definition at line 8299 of file ShipEntity.m.

{
    if ([self isSubEntity]) 
    {
        return [[self parentEntity] bounty];
    }
    else 
    {       
        return bounty;
    }
}

Referenced by StationEntity::acceptDockingClearanceRequestFrom:, broadcastHitByLaserFrom:, canAcceptEscort:, PlayerEntity::collectBountyFor:, WormholeEntity::disgorgeShips, fuel, interpretAIMessage:, legalStatus, markAsOffender:withReason:, respondToAttackFrom:becauseOf:, setBounty:withReasonAsString:, StationEntity::takeEnergyDamage:from:becauseOf:weaponIdentifier:, and update:.

canFragment

- (unsigned) canFragment

protected

Definition at line 268 of file ShipEntity.h.

Referenced by becomeExplosion, and dumpSelfState.

cargo

- (NSMutableArray *) cargo

protected

Definition at line 8405 of file ShipEntity.m.

{
    return cargo;
}

Referenced by addCargo:, bounty, canScoop:, PlayerEntity::cargoQuantityForType:, PlayerEntity::cargoQuantityOnBoard, cargoQuantityOnBoard, dealloc, PlayerEntity::dialFuelScoopStatus, dumpCargoItem:, PlayerEntity::loadCargoPodsForType:amount:, removeCargo:amount:, PlayerEntity::rotateCargo, scoopUpProcess:processEvents:processMessages:, PlayerEntity::setUpShipFromDictionary:, setUpShipFromDictionary:, PlayerEntity::takeInternalDamage, PlayerEntity::unloadCargoPods, and OOTrumble::updateTrumble:.

cargo_dump_time

- (OOTimeAbsolute) cargo_dump_time

protected

Definition at line 358 of file ShipEntity.h.

Referenced by dumpCargoItem:, dumpItem:, and PlayerEntity::loadCargoPods.

cargo_flag

- (OOCargoFlag) cargo_flag

protected

Definition at line 299 of file ShipEntity.h.

Referenced by cargoFlag, scoopUpProcess:processEvents:processMessages:, setCargoFlag:, and setUpShipFromDictionary:.

cargo_type

- (OOCargoType) cargo_type

protected

Definition at line 298 of file ShipEntity.h.

Referenced by cargoType, setUpCargoType:, and setUpShipFromDictionary:.

cloakAutomatic

- (unsigned) cloakAutomatic

protected

Definition at line 267 of file ShipEntity.h.

Referenced by behaviour_attack_break_off_target:, behaviour_attack_broadside:, behaviour_attack_broadside_target:leftside:, behaviour_attack_fly_from_target:, behaviour_attack_fly_to_target:, behaviour_attack_slow_dogfight:, behaviour_attack_sniper:, behaviour_attack_target:, behaviour_evasive_action:, behaviour_flee_target:, behaviour_fly_to_target_six:, behaviour_running_defense:, hasAutoCloak, and setAutoCloak:.

cloaking_device_active

- (unsigned) cloaking_device_active

protected

Definition at line 265 of file ShipEntity.h.

Referenced by activateCloakingDevice, deactivateCloakingDevice, PlayerEntity::doBookkeeping:, drawImmediate:translucent:, dumpSelfState, PlayerEntity::enterDock:, PlayerEntity::fireMainWeapon, PlayerEntity::fireMissile, fireMissileWithIdentifier:andTarget:, fireWeapon:direction:range:, isCloaked, launchCascadeMine, scanClass, PlayerEntity::setUpAndConfirmOK:saveGame:, and update:.

cloakPassive

- (BOOL) cloakPassive

protected

Provided by category ShipEntity(Private).

Definition at line 6676 of file ShipEntity.m.

{
    return cloakPassive;
}

References OOLog.

Referenced by PlayerEntity::fireMainWeapon, PlayerEntity::fireMissile, fireMissileWithIdentifier:andTarget:, fireTurretCannon:, fireWeapon:direction:range:, and launchCascadeMine.

closeContactsInfo

- (NSMutableDictionary*) closeContactsInfo

protected

Definition at line 402 of file ShipEntity.h.

Referenced by checkCloseCollisionWith:, setTrackCloseContacts:, and update:.

collision_vector

- (Vector) collision_vector

protected

Definition at line 386 of file ShipEntity.h.

commodity_amount

- (OOCargoQuantity) commodity_amount

protected

Definition at line 364 of file ShipEntity.h.

Referenced by commodityAmount, setCommodity:andAmount:, setCommodityForPod:andAmount:, setUpCargoType:, and setUpShipFromDictionary:.

commodity_type

- (OOCommodityType) commodity_type

protected

Definition at line 363 of file ShipEntity.h.

Referenced by commodityType, dealloc, setCommodity:andAmount:, setCommodityForPod:andAmount:, setUpCargoType:, and setUpShipFromDictionary:.

coordinates

- (HPVector) coordinates

protected

Definition at line 10265 of file ShipEntity.m.

{
    return coordinates;
}

Referenced by behaviour, dumpSelfState, and setCoordinate:.

crew

- (NSArray *) crew

protected

Definition at line 7945 of file ShipEntity.m.

{
    return crew;
}

Referenced by broadcastMessage:withUnpilotedOverride:, crewForScripting, dealloc, dumpItem:, StationEntity::launchDefenseShip, launchEscapeCapsule, StationEntity::launchEscort, StationEntity::launchIndependentShip:, StationEntity::launchMiner, StationEntity::launchPatrol, StationEntity::launchPirateShip, StationEntity::launchPolice, StationEntity::launchScavenger, StationEntity::launchShipWithRole:, StationEntity::launchShuttle, PlayerEntity(Contracts)::processEscapePods, reportAIMessages, scoopUpProcess:processEvents:processMessages:, sendExpandedMessage:toShip:, sendMessage:toShip:withUnpilotedOverride:, setCrew:, setProximityAlert:, and StationEntity::setUpShipFromDictionary:.

cruiseSpeed

- (double) cruiseSpeed

protected

Definition at line 8608 of file ShipEntity.m.

{
    return cruiseSpeed;
}

Referenced by acceptAsEscort:, and cargo.

currentWeaponFacing

- (OOWeaponFacing) currentWeaponFacing

protected

Definition at line 7532 of file ShipEntity.m.

{
    return currentWeaponFacing;
}

Referenced by currentAimTolerance, PlayerEntity::doBookkeeping:, fireAftWeapon:, PlayerEntity::fireMainWeapon, fireMainWeapon:, firePortWeapon:, fireStarboardWeapon:, initWithKey:definition:, PlayerEntity::leaveDock:, lookingAtSunWithThresholdAngleCos:, PlayerShipGetProperty(), PlayerShipSetProperty(), PlayerEntity::setCustomViewDataFromDictionary:withScaling:, PlayerEntity::setUpAndConfirmOK:saveGame:, ShipGetProperty(), ShipSetProperty(), weaponRange, and PlayerEntity::weaponViewOffset.

debugLastBehaviour

- (OOBehaviour) debugLastBehaviour

protected

Definition at line 427 of file ShipEntity.h.

Referenced by update:.

default_laser_color

- (OOColor*) default_laser_color

protected

Definition at line 230 of file ShipEntity.h.

Referenced by dealloc, and setWeaponDataFromType:.

demoRate

- (OOScalar) demoRate

private

Definition at line 494 of file ShipEntity.h.

Referenced by setDemoShip:, and update:.

demoStartOrientation

- (Quaternion) demoStartOrientation

private

Definition at line 496 of file ShipEntity.h.

Referenced by setDemoShip:.

demoStartTime

- (OOTimeAbsolute) demoStartTime

private

Definition at line 495 of file ShipEntity.h.

Referenced by getDemoStartTime, setDemoStartTime:, and update:.

desired_range

- (GLfloat) desired_range

Definition at line 205 of file ShipEntity.h.

Referenced by avoidCollision, becomeExplosion, behaviour_avoid_collision:, behaviour_face_destination:, behaviour_flee_target:, behaviour_fly_from_destination:, behaviour_fly_range_from_destination:, behaviour_fly_thru_navpoints:, behaviour_fly_to_destination:, behaviour_formation_form_up:, behaviour_intercept_target:, behaviour_tractored:, dealEnergyDamageWithinDesiredRange, dealMomentumWithinDesiredRange:, desiredRange, resumePostProximityAlert, setDesiredRange:, and trackDestination:delta_t:.

desired_speed

- (GLfloat) desired_speed

Definition at line 206 of file ShipEntity.h.

Referenced by abandonShip, applyThrust:, behaviour_attack_break_off_target:, behaviour_attack_broadside:, behaviour_attack_broadside_target:leftside:, behaviour_attack_fly_from_target:, behaviour_attack_fly_to_target:, behaviour_attack_mining_target:, behaviour_attack_slow_dogfight:, behaviour_attack_sniper:, behaviour_avoid_collision:, behaviour_evasive_action:, behaviour_face_destination:, behaviour_flee_target:, behaviour_fly_from_destination:, behaviour_fly_range_from_destination:, behaviour_fly_thru_navpoints:, behaviour_fly_to_destination:, behaviour_fly_to_target_six:, behaviour_formation_form_up:, behaviour_intercept_target:, behaviour_land_on_planet:, behaviour_running_defense:, behaviour_scripted_ai:, behaviour_tractored:, desiredSpeed, dumpSelfState, getTractoredBy:, increase_flight_speed:, noteTakingDamage:from:type:, resumePostProximityAlert, and setDesiredSpeed:.

destination_system

- (OOSystemID) destination_system

protected

Definition at line 380 of file ShipEntity.h.

Referenced by destinationSystem, setDestinationSystem:, and setUpShipFromDictionary:.

displayName

- (NSString *) displayName

protected

Definition at line 7127 of file ShipEntity.m.

{
    if (displayName == nil || [displayName length] == 0)  
    {
        if ([shipUniqueName length] == 0)
        {
            if (shipClassName == nil)
            {
                return name;
            }
            else 
            {
                return shipClassName;
            }
        }
        else
        {
            if (shipClassName == nil)
            {
                return [NSString stringWithFormat:@"%@: %@",name,shipUniqueName];
            }
            else
            {
                return [NSString stringWithFormat:@"%@: %@",shipClassName,shipUniqueName];
            }
        }
    }
    return displayName;
}

Referenced by StationEntity::acceptDockingClearanceRequestFrom:, PlayerEntity(Scripting)::commanderShipDisplayName_string, dealloc, PlayerEntity(ScriptMethods)::dockedStationDisplayName, dumpSelfState, StationEntity::dumpSelfState, StationEntity::fitsInDock:andLogNoFit:, PlayerEntity(OOControlsPrivate)::handleAutopilotOn:, identFromShip:, ShipEntity(OOEntityInspectorExtensions)::inspDescription, PlayerEntity(OOEntityInspectorExtensions)::inspSecondaryIdentityLine, ShipEntity(OOEntityInspectorExtensions)::inspSecondaryIdentityLine, StationEntity::launchDefenseShip, StationEntity::launchEscort, StationEntity::launchIndependentShip:, StationEntity::launchMiner, StationEntity::launchPatrol, StationEntity::launchPirateShip, StationEntity::launchPolice, StationEntity::launchScavenger, StationEntity::launchShipWithRole:, StationEntity::launchShuttle, PlayerEntity::marketScreenTitle, PlayerEntity::receiveCommsMessage:from:, sendExpandedMessage:toShip:, setDisplayName:, PlayerEntity::setGuiToInterfacesScreen:, PlayerEntity::setGuiToStatusScreen, setShipScript:, StationEntity::setUpSubEntities, shipClassName, ShipGetProperty(), PlayerEntity(Contracts)::showTradeInInformationFooter, and StationEntity::update:.

distance2_scanned_ships

- (GLfloat distance2_scanned_ships[MAX_SCAN_NUMBER+1])

protected

Definition at line 414 of file ShipEntity.h.

Referenced by checkScanner, and checkScannerIgnoringUnpowered.

docking_match_rotation

- (unsigned) docking_match_rotation

protected

Definition at line 251 of file ShipEntity.h.

Referenced by behaviour_face_destination:, behaviour_fly_to_destination:, dumpSelfState, and trackDestination:delta_t:.

dockingInstructions

- (NSDictionary *) dockingInstructions

protected

Definition at line 14057 of file ShipEntity.m.

{
    return dockingInstructions;
}

Referenced by behaviour_fly_to_destination:, canAcceptEscort:, coordinates, dealloc, enterDock:, setProximityAlert:, ShipGetProperty(), and trackDestination:delta_t:.

energy_recharge_rate

- (GLfloat) energy_recharge_rate

protected

Definition at line 302 of file ShipEntity.h.

Referenced by addEquipmentItem:withValidation:inContext:, energyRechargeRate, removeEquipmentItem:, setEnergyRechargeRate:, and update:.

entity_personality

- (uint16_t) entity_personality

protected

Definition at line 430 of file ShipEntity.h.

Referenced by behaviour_fly_to_target_six:, entityPersonality, entityPersonalityInt, initWithKey:definition:, randomSeedForShaders, PlayerEntity::setCommanderDataFromDictionary:, setEntityPersonalityInt:, and PlayerEntity::setUpAndConfirmOK:saveGame:.

equipment_weight

- (OOCargoQuantity) equipment_weight

protected

Definition at line 297 of file ShipEntity.h.

Referenced by addEquipmentItem:withValidation:inContext:, availableCargoSpace, maxAvailableCargoSpace, removeEquipmentItem:, and setMaxAvailableCargoSpace:.

exhaust_emissive_color

- (OOColor*) exhaust_emissive_color

protected

Definition at line 231 of file ShipEntity.h.

Referenced by dealloc, and setExhaustEmissiveColor:.

explosionType

- (NSArray*) explosionType

protected

Definition at line 335 of file ShipEntity.h.

Referenced by becomeExplosion, and dealloc.

extra_cargo

- (OOCargoQuantity) extra_cargo

protected

Definition at line 296 of file ShipEntity.h.

Referenced by addEquipmentItem:withValidation:inContext:, extraCargo, removeEquipmentItem:, and PlayerEntity::setCommanderDataFromDictionary:.

flightPitch

- (GLfloat) flightPitch

protected

Definition at line 8711 of file ShipEntity.m.

{
    return flightPitch;
}

Referenced by applySticks:, behaviour_face_destination:, behaviour_idle:, decrease_flight_pitch:, PlayerEntity::dialPitch, PlayerEntity::docked, StationEntity::dockingInstructionsForShip:, PlayerEntity::enterWitchspace, PlayerEntity::enterWormhole:, evasiveAction:, flightRoll, PlayerEntity::getDestroyedBy:damageType:, increase_flight_pitch:, PlayerEntity::launchEscapeCapsule, PlayerEntity::leaveWitchspace, missileTrackPrimaryTarget:, PlayerShipSetProperty(), setPitch:, PlayerEntity::setUpAndConfirmOK:saveGame:, trackDestination:delta_t:, trackOntoTarget:withDForward:, trackPrimaryTarget:delta_t:, trackSideTarget:delta_t:, and witchspaceLeavingEffects.

flightRoll

- (GLfloat) flightRoll

protected

Definition at line 8705 of file ShipEntity.m.

{
    return flightRoll;
}

Referenced by applySticks:, behaviour_idle:, cruiseSpeed, decrease_flight_roll:, PlayerEntity::dialRoll, PlayerEntity::docked, StationEntity::dockingInstructionsForShip:, evasiveAction:, PlayerEntity::getDestroyedBy:damageType:, increase_flight_roll:, PlayerEntity::launchEscapeCapsule, DockEntity::launchShip:, PlayerEntity::leaveDock:, PlayerEntity::leaveWitchspace, missileTrackPrimaryTarget:, PlayerShipSetProperty(), setRawRoll:, setRoll:, PlayerEntity::setUpAndConfirmOK:saveGame:, trackDestination:delta_t:, trackOntoTarget:withDForward:, trackPrimaryTarget:delta_t:, and witchspaceLeavingEffects.

flightSpeed

- (GLfloat) flightSpeed

protected

Definition at line 8723 of file ShipEntity.m.

{
    return flightSpeed;
}

Referenced by applyThrust:, behaviour_attack_broadside_target:leftside:, behaviour_attack_fly_from_target:, behaviour_attack_fly_to_target:, behaviour_face_destination:, behaviour_fly_thru_navpoints:, behaviour_fly_to_destination:, behaviour_fly_to_target_six:, behaviour_formation_form_up:, behaviour_intercept_target:, behaviour_land_on_planet:, PlayerEntity::createDoppelganger, decrease_flight_speed:, PlayerEntity::dialHyperSpeed, PlayerEntity::dialSpeed, PlayerEntity::doBookkeeping:, PlayerEntity::docked, PlayerEntity::dumpCargo, dumpItem:, fireDirectLaserShotAt:, fireLaserShotInDirection:weaponIdentifier:, fireMissileWithIdentifier:andTarget:, flightYaw, PlayerEntity::getDestroyedBy:damageType:, increase_flight_speed:, launchCascadeMine, PlayerEntity::launchEscapeCapsule, DockEntity::launchShip:, PlayerEntity::leaveWitchspace, setProximityAlert:, setSpeed:, setThrustForDemo:, DockEntity::shipIsInDockingCorridor:, speedFactor, thrustVector, OOExhaustPlumeEntity::update:, update:, updateTrackingCurve, and witchspaceLeavingEffects.

flightYaw

- (GLfloat) flightYaw

protected

Definition at line 8717 of file ShipEntity.m.

{
    return flightYaw;
}

Referenced by applySticks:, behaviour_attack_break_off_target:, behaviour_evasive_action:, behaviour_tractored:, decrease_flight_yaw:, PlayerEntity::dialYaw, PlayerEntity::docked, StationEntity::dockingInstructionsForShip:, flightPitch, PlayerEntity::getDestroyedBy:damageType:, increase_flight_yaw:, PlayerEntity::launchEscapeCapsule, PlayerEntity::leaveWitchspace, PlayerShipSetProperty(), PlayerEntity::setUpAndConfirmOK:saveGame:, setYaw:, trackOntoTarget:withDForward:, trackSideTarget:delta_t:, update:, and witchspaceLeavingEffects.

forward_weapon_temp

- (GLfloat) forward_weapon_temp

protected

Definition at line 315 of file ShipEntity.h.

Referenced by behaviour_attack_break_off_target:, behaviour_attack_target:, PlayerEntity::doBookkeeping:, PlayerEntity::fireMainWeapon, fireMainWeapon:, fireSubentityLaserShot:, fireWeapon:direction:range:, initWithKey:definition:, PlayerEntity::laserHeatLevelForward, laserHeatLevelForward, PlayerEntity::leaveDock:, PlayerEntity::setUpAndConfirmOK:saveGame:, setUpShipFromDictionary:, and update:.

forward_weapon_type

- (OOWeaponType) forward_weapon_type

protected

Definition at line 305 of file ShipEntity.h.

Referenced by behaviour_attack_target:, behaviour_flee_target:, behaviour_fly_to_target_six:, behaviour_running_defense:, PlayerEntity::commanderDataDictionary, PlayerEntity::equipmentList, fireMainWeapon:, fireSubentityLaserShot:, PlayerEntity::hasPrimaryWeapon:, hasPrimaryWeapon:, isMining, laserHeatLevelForward, PlayerEntity::setCommanderDataFromDictionary:, PlayerEntity::setGuiToEquipShipScreen:selectingFacingFor:, PlayerEntity::setUpAndConfirmOK:saveGame:, setWeaponMount:toWeapon:, PlayerEntity::setWeaponMount:toWeapon:inContext:, PlayerEntity::weaponForFacing:, PlayerEntity::weaponTypeForFacing:strict:, and weaponTypeIDForFacing:strict:.

forwardWeaponOffset

- (NSArray *) forwardWeaponOffset

protected

Definition at line 2033 of file ShipEntity.m.

{
    return forwardWeaponOffset;
}

Referenced by aftWeaponOffset, dealloc, Universe::firstEntityTargetedByPlayerPrecisely, laserPortOffset:, and ShipGetProperty().

frustration

- (double) frustration

protected

Definition at line 8098 of file ShipEntity.m.

{
    return frustration;
}

Referenced by abandonShip, behaviour_attack_break_off_target:, behaviour_attack_broadside:, behaviour_attack_broadside_target:leftside:, behaviour_attack_fly_from_target:, behaviour_attack_fly_to_target:, behaviour_attack_slow_dogfight:, behaviour_attack_sniper:, behaviour_attack_target:, behaviour_close_with_target:, behaviour_evasive_action:, behaviour_face_destination:, behaviour_flee_target:, behaviour_fly_from_destination:, behaviour_fly_range_from_destination:, behaviour_fly_thru_navpoints:, behaviour_fly_to_destination:, behaviour_fly_to_target_six:, behaviour_formation_form_up:, behaviour_intercept_target:, behaviour_running_defense:, behaviour_tractored:, PlayerEntity::disengageAutopilot, dumpSelfState, launchCascadeMine, noteLostTargetAndGoIdle, noteTakingDamage:from:type:, resumePostProximityAlert, setBehaviour:, setDestination:, OOAIDebugInspectorModule::update, and update:.

fuel

- (OOFuelQuantity) fuel

protected

Definition at line 8104 of file ShipEntity.m.

{
    return fuel;
}

Referenced by ShipEntity(PureAI)::addFuel:, applyThrust:, PlayerEntity(Scripting)::awardFuel:, behaviour_attack_break_off_target:, behaviour_attack_broadside:, behaviour_attack_broadside_target:leftside:, behaviour_attack_fly_from_target:, behaviour_attack_fly_to_target:, behaviour_attack_sniper:, behaviour_evasive_action:, behaviour_flee_target:, behaviour_fly_to_target_six:, cascadeIfAppropriateWithDamageAmount:cascadeOwner:, PlayerEntity::commanderDataDictionary, crew, PlayerEntity::dialFuel, PlayerEntity::doBookkeeping:, dumpSelfState, PlayerEntity::enterWitchspace, equipmentValidToAdd:whileLoading:inContext:, PlayerEntity::hasSufficientFuelForJump, increase_flight_speed:, StationEntity::launchIndependentShip:, PlayerEntity::setCommanderDataFromDictionary:, setFuel:, PlayerEntity::setGuiToEquipShipScreen:selectingFacingFor:, PlayerEntity::setUpAndConfirmOK:saveGame:, setUpShipFromDictionary:, WormholeEntity::suckInShip:, PlayerEntity(OOPrivate)::tryBuyingItem:, OOShipDebugInspectorModule::update, and update:.

fuel_accumulator

- (GLfloat) fuel_accumulator

protected

Definition at line 289 of file ShipEntity.h.

Referenced by applyThrust:, PlayerEntity::doBookkeeping:, dumpSelfState, PlayerEntity::setUpAndConfirmOK:saveGame:, setUpShipFromDictionary:, and update:.

hasScoopMessage

- (unsigned) hasScoopMessage

protected

Definition at line 275 of file ShipEntity.h.

Referenced by setUpShipFromDictionary:, and showScoopMessage.

haveExecutedSpawnAction

- (unsigned) haveExecutedSpawnAction

protected

Definition at line 279 of file ShipEntity.h.

Referenced by setUpFromDictionary:, and update:.

haveStartedJSAI

- (unsigned) haveStartedJSAI

protected

Definition at line 280 of file ShipEntity.h.

Referenced by setUpFromDictionary:, and update:.

home_system

- (OOSystemID) home_system

protected

Definition at line 379 of file ShipEntity.h.

Referenced by homeSystem, setHomeSystem:, and setUpShipFromDictionary:.

hyperspaceMotorSpinTime

- (float) hyperspaceMotorSpinTime

protected

Definition at line 247 of file ShipEntity.h.

Referenced by hasHyperspaceMotor, hyperspaceSpinTime, and setHyperspaceSpinTime:.

isDemoShip

- (BOOL) isDemoShip

private

Definition at line 14615 of file ShipEntity.m.

{
    return isDemoShip;
}

Referenced by scriptInfo, setDemoShip:, and update:.

isFrangible

- (BOOL) isFrangible

protected

Definition at line 2051 of file ShipEntity.m.

{
    return isFrangible;
}

Referenced by collideWithShip:, dumpSelfState, fireDirectLaserShotAt:, fireLaserShotInDirection:weaponIdentifier:, fireSubentityLaserShot:, starboardWeaponOffset, and takeHeatDamage:.

isHulk

- (BOOL) isHulk

protected

Definition at line 8960 of file ShipEntity.m.

{
    return isHulk;
}

Referenced by PlayerEntity::addRoleForAggression:, PlayerEntity::collectBountyFor:, dumpSelfState, isUnpiloted, StationEntity::isUnpiloted, setHulk:, and trackCloseContacts.

isMissile

- (BOOL) isMissile

protected

Definition at line 7357 of file ShipEntity.m.

{
    return ([[self primaryRole] hasSuffix:@"MISSILE"] || [self hasPrimaryRole:@"missile"]);
}

Referenced by PlayerEntity::addTarget:, canCollide, fireMissileWithIdentifier:andTarget:, hasHostileTarget, isMissileFlagSet, isWeapon, PlayerEntity::moveTargetMemoryBy:, primaryRole, PlayerEntity::selectNextMissile, setIsMissileFlag:, and setUpFromDictionary:.

isNearPlanetSurface

- (unsigned) isNearPlanetSurface

protected

Definition at line 263 of file ShipEntity.h.

Referenced by checkForAegis, dumpSelfState, and setUpFromDictionary:.

isWreckage

- (unsigned) isWreckage

protected

Definition at line 269 of file ShipEntity.h.

Referenced by becomeExplosion, canCollide, and setIsWreckage:.

jink

- (Vector) jink

protected

Definition at line 338 of file ShipEntity.h.

Referenced by behaviour_attack_broadside:, behaviour_attack_fly_from_target:, behaviour_attack_target:, behaviour_running_defense:, dumpSelfState, setEvasiveJink:, and trackPrimaryTarget:delta_t:.

laser_color

- (OOColor*) laser_color

protected

Definition at line 229 of file ShipEntity.h.

Referenced by dealloc, and setLaserColor:.

last_shot_time

- (OOTimeAbsolute) last_shot_time

protected

Definition at line 359 of file ShipEntity.h.

Referenced by fireLaserShotInDirection:weaponIdentifier:.

lastRadioMessage

- (NSString*) lastRadioMessage

protected

Definition at line 404 of file ShipEntity.h.

Referenced by dealloc, and sendExpandedMessage:toShip:.

launch_delay

- (double) launch_delay

protected

Definition at line 345 of file ShipEntity.h.

Referenced by setLaunchDelay:, and update:.

launch_time

- (double) launch_time

protected

Definition at line 344 of file ShipEntity.h.

Referenced by setStatus:, and update:.

likely_cargo

- (OOCargoQuantity) likely_cargo

protected

Definition at line 294 of file ShipEntity.h.

Referenced by becomeExplosion, setCargoFlag:, and setUpShipFromDictionary:.

max_cargo

- (OOCargoQuantity) max_cargo

protected

Definition at line 295 of file ShipEntity.h.

Referenced by addEquipmentItem:withValidation:inContext:, availableCargoSpace, PlayerEntity::changePassengerBerths:, PlayerEntity::commanderDataDictionary, maxAvailableCargoSpace, removeEquipmentItem:, scoopUpProcess:processEvents:processMessages:, PlayerEntity::setCommanderDataFromDictionary:, setMaxAvailableCargoSpace:, and PlayerEntity::setUpAndConfirmOK:saveGame:.

max_flight_pitch

- (GLfloat) max_flight_pitch

protected

Definition at line 241 of file ShipEntity.h.

Referenced by behaviour_attack_fly_from_target:, behaviour_face_destination:, behaviour_fly_to_destination:, behaviour_formation_form_up:, behaviour_intercept_target:, behaviour_scripted_ai:, decrease_flight_pitch:, PlayerEntity::dialPitch, PlayerEntity::enterWitchspace, PlayerEntity::enterWormhole:, evasiveAction:, increase_flight_pitch:, maxFlightPitch, missileTrackPrimaryTarget:, PlayerEntity::setMaxFlightPitch:, setMaxFlightPitch:, PlayerEntity::setUpShipFromDictionary:, trackDestination:delta_t:, trackPrimaryTarget:delta_t:, and trackSideTarget:delta_t:.

max_flight_roll

- (GLfloat) max_flight_roll

protected

Definition at line 240 of file ShipEntity.h.

Referenced by behaviour_attack_break_off_target:, behaviour_fly_to_destination:, behaviour_formation_form_up:, behaviour_intercept_target:, behaviour_scripted_ai:, decrease_flight_roll:, PlayerEntity::dialRoll, evasiveAction:, increase_flight_roll:, maxFlightRoll, missileTrackPrimaryTarget:, rollToMatchUp:rotating:, PlayerEntity::setMaxFlightRoll:, setMaxFlightRoll:, PlayerEntity::setUpShipFromDictionary:, trackDestination:delta_t:, and trackPrimaryTarget:delta_t:.

max_flight_yaw

- (GLfloat) max_flight_yaw

protected

Definition at line 242 of file ShipEntity.h.

Referenced by behaviour_scripted_ai:, decrease_flight_yaw:, PlayerEntity::dialYaw, increase_flight_yaw:, maxFlightYaw, PlayerEntity::setMaxFlightYaw:, setMaxFlightYaw:, PlayerEntity::setUpShipFromDictionary:, and trackSideTarget:delta_t:.

max_missiles

- (unsigned) max_missiles

protected

Definition at line 320 of file ShipEntity.h.

Referenced by addEquipmentItem:withValidation:inContext:, PlayerEntity::assignToActivePylon:, canAddEquipment:inContext:, PlayerEntity::commanderDataDictionary, PlayerEntity::countMissiles, PlayerEntity::dialMaxMissiles, PlayerEntity::hasOneEquipmentItem:includeMissiles:, missileCapacity, PlayerEntity::missileForPylon:, PlayerEntity::mountMissile:, PlayerEntity::removeExternalStore:, PlayerEntity::removeFromPylon:, PlayerEntity::removeMissiles, PlayerEntity::safeAllMissiles, PlayerEntity::selectNextMissile, PlayerEntity::setCommanderDataFromDictionary:, PlayerEntity::setUpAndConfirmOK:saveGame:, and PlayerEntity::setUpShipFromDictionary:.

max_thrust

- (GLfloat) max_thrust

protected

Definition at line 245 of file ShipEntity.h.

Referenced by PlayerEntity::doBookkeeping:, maxThrust, and setMaxThrust:.

maxFlightSpeed

- (GLfloat) maxFlightSpeed

protected

Definition at line 8735 of file ShipEntity.m.

{
    return maxFlightSpeed;
}

Referenced by acceptAsEscort:, applyThrust:, becomeExplosion, behaviour_attack_break_off_target:, behaviour_attack_broadside:, behaviour_attack_broadside_target:leftside:, behaviour_attack_fly_from_target:, behaviour_attack_fly_to_target:, behaviour_attack_mining_target:, behaviour_attack_slow_dogfight:, behaviour_attack_sniper:, behaviour_avoid_collision:, behaviour_evasive_action:, behaviour_flee_target:, behaviour_fly_range_from_destination:, behaviour_fly_to_destination:, behaviour_fly_to_target_six:, behaviour_formation_form_up:, behaviour_intercept_target:, behaviour_running_defense:, behaviour_scripted_ai:, ShipEntity(PureAI)::checkHeatInsulation, decrease_flight_speed:, PlayerEntity::dialHyperSpeed, PlayerEntity::dialSpeed, WormholeEntity::disgorgeShips, PlayerEntity::doBookkeeping:, DockEntity::dockingInstructionsForShip:, PlayerEntity::dumpCargo, flightSpeed, increase_flight_speed:, initWithKey:definition:, PlayerEntity::launchEscapeCapsule, DockEntity::launchShip:, PlayerEntity::leaveWitchspace, Universe::makeSunSkimmer:andSetAI:, noteTakingDamage:from:type:, OOShipLibrarySpeed(), setMaxFlightSpeed:, setProximityAlert:, setThrustForDemo:, ShipEntity(Private)::setUpOneEscort:inGroup:withRole:atPosition:andCount:, speedFactor, WormholeEntity::suckInShip:, takeEnergyDamage:from:becauseOf:weaponIdentifier:, and update:.

messageTime

- (double) messageTime

protected

Definition at line 6896 of file ShipEntity.m.

{
    return messageTime;
}

Referenced by broadcastMessage:withUnpilotedOverride:, HeadUpDisplay(Private)::drawScanner:, reactionTime, sendExpandedMessage:toShip:, sendMessage:toShip:withUnpilotedOverride:, setMessageTime:, and update:.

military_jammer_active

- (unsigned) military_jammer_active

protected

Definition at line 249 of file ShipEntity.h.

Referenced by PlayerEntity::doBookkeeping:, dumpSelfState, isJammingScanning, and update:.

missile_launch_time

- (OOTimeAbsolute) missile_launch_time

protected

Definition at line 323 of file ShipEntity.h.

Referenced by fireMissileWithIdentifier:andTarget:, and noticeECM.

missile_list

- (OOEquipmentType* missile_list[SHIPENTITY_MAX_MISSILES])

protected

Definition at line 434 of file ShipEntity.h.

Referenced by addEquipmentItem:withValidation:inContext:, PlayerEntity::assignToActivePylon:, fireMissileWithIdentifier:andTarget:, hasOneEquipmentItem:includeMissiles:whileLoading:, missilesList, PlayerEntity::mountMissile:, noticeECM, removeExternalStore:, PlayerEntity::setCommanderDataFromDictionary:, PlayerEntity::setUpShipFromDictionary:, setUpShipFromDictionary:, and PlayerEntity::tidyMissilePylons.

missile_load_time

- (OOTimeDelta) missile_load_time

protected

Definition at line 322 of file ShipEntity.h.

Referenced by fireMissileWithIdentifier:andTarget:, missileLoadTime, noticeECM, setAccuracy:, and setMissileLoadTime:.

missiles

- (unsigned) missiles

protected

Definition at line 319 of file ShipEntity.h.

Referenced by addEquipmentItem:withValidation:inContext:, behaviour_attack_broadside_target:leftside:, behaviour_attack_fly_from_target:, behaviour_attack_fly_to_target:, behaviour_attack_slow_dogfight:, behaviour_attack_sniper:, behaviour_flee_target:, behaviour_fly_to_target_six:, canAddEquipment:inContext:, PlayerEntity::commanderDataDictionary, considerFiringMissile:, dumpSelfState, fireMissileWithIdentifier:andTarget:, hasOneEquipmentItem:includeMissiles:whileLoading:, missileCount, PlayerEntity::mountMissile:, noticeECM, removeExternalStore:, PlayerEntity::removeFromPylon:, PlayerEntity::removeMissiles, removeMissiles, PlayerEntity::setCommanderDataFromDictionary:, PlayerEntity::setGuiToEquipShipScreen:selectingFacingFor:, PlayerEntity::setUpAndConfirmOK:saveGame:, PlayerEntity::setUpShipFromDictionary:, setUpShipFromDictionary:, and PlayerEntity::tidyMissilePylons.

n_scanned_ships

- (unsigned) n_scanned_ships

protected

Definition at line 415 of file ShipEntity.h.

Referenced by broadcastAIMessage:, broadcastMessage:withUnpilotedOverride:, checkScanner, checkScannerIgnoringUnpowered, dumpCargoItem:, getTractoredBy:, numberOfScannedShips, and scoopUpProcess:processEvents:processMessages:.

name

- (NSString *) name

protected

Definition at line 7109 of file ShipEntity.m.

{
    return name;
}

Referenced by ShipEntity(PureAI)::ai_debugMessage:, PlayerEntity(Scripting)::commanderShip_string, dealloc, deployEscorts, descriptionComponents, PlayerEntity(ScriptMethods)::dockedStationName, dumpSelfState, messageTime, AI(OOPrivate)::refreshOwnerDesc, PlayerEntity::resetAutopilotAI, selectMissile, PlayerEntity::setCommanderDataFromDictionary:, PlayerEntity::setExtraGuiScreenKeys:definition:, setName:, ShipGetProperty(), ShipRunLegacyScriptActions(), shortDescriptionComponents, PlayerEntity::showShipModelWithKey:shipData:personality:factorX:factorY:factorZ:inContext:, verifiedMissileTypeFromRole:, and PlayerEntity::witchJumpChecklist:.

navpoints

- (HPVector navpoints[32])

protected

Definition at line 418 of file ShipEntity.h.

Referenced by behaviour_fly_thru_navpoints:.

next_navpoint_index

- (unsigned) next_navpoint_index

protected

Definition at line 419 of file ShipEntity.h.

Referenced by behaviour_fly_thru_navpoints:.

next_spark_time

- (double) next_spark_time

protected

Definition at line 384 of file ShipEntity.h.

Referenced by throwSparks, and update:.

noRocks

- (unsigned) noRocks

protected

Definition at line 281 of file ShipEntity.h.

Referenced by becomeExplosion, isMinable, and setUpShipFromDictionary:.

number_of_navpoints

- (unsigned) number_of_navpoints

protected

Definition at line 420 of file ShipEntity.h.

Referenced by behaviour_fly_thru_navpoints:, and dumpSelfState.

octree

- (Octree *) octree

protected

Definition at line 1430 of file ShipEntity.m.

{
    return octree;
}

Referenced by clearSubEntities, dealloc, doOctreesCollide, setMesh:, and subEntities.

patrol_counter

- (int) patrol_counter

protected

Definition at line 351 of file ShipEntity.h.

pitch_tolerance

- (GLfloat) pitch_tolerance

protected

Definition at line 374 of file ShipEntity.h.

Referenced by missileTrackPrimaryTarget:, and setAccuracy:.

pitching_over

- (unsigned) pitching_over

protected

Definition at line 253 of file ShipEntity.h.

Referenced by avoidCollision, behaviour_attack_target:, behaviour_fly_to_target_six:, behaviour_formation_form_up:, dumpSelfState, missileTrackPrimaryTarget:, trackDestination:delta_t:, and trackPrimaryTarget:delta_t:.

planetForLanding

- (OOUniversalID) planetForLanding

protected

Definition at line 346 of file ShipEntity.h.

port_weapon_temp

- (GLfloat) port_weapon_temp

protected

Definition at line 315 of file ShipEntity.h.

Referenced by behaviour_attack_broadside:, behaviour_attack_target:, PlayerEntity::doBookkeeping:, PlayerEntity::fireMainWeapon, fireWeapon:direction:range:, initWithKey:definition:, PlayerEntity::laserHeatLevelPort, laserHeatLevelPort, PlayerEntity::leaveDock:, PlayerEntity::setUpAndConfirmOK:saveGame:, setUpShipFromDictionary:, and update:.

port_weapon_type

- (OOWeaponType) port_weapon_type

protected

Definition at line 307 of file ShipEntity.h.

Referenced by behaviour_attack_broadside:, behaviour_attack_broadside_target:leftside:, behaviour_attack_fly_to_target:, behaviour_attack_target:, behaviour_close_to_broadside_range:, PlayerEntity::commanderDataDictionary, PlayerEntity::equipmentList, PlayerEntity::hasPrimaryWeapon:, hasPrimaryWeapon:, PlayerEntity::setCommanderDataFromDictionary:, PlayerEntity::setGuiToEquipShipScreen:selectingFacingFor:, PlayerEntity::setUpAndConfirmOK:saveGame:, setWeaponMount:toWeapon:, PlayerEntity::setWeaponMount:toWeapon:inContext:, PlayerEntity::weaponForFacing:, PlayerEntity::weaponTypeForFacing:strict:, and weaponTypeIDForFacing:strict:.

portWeaponOffset

- (NSArray *) portWeaponOffset

protected

Definition at line 2039 of file ShipEntity.m.

{
    return portWeaponOffset;
}

Referenced by dealloc, Universe::firstEntityTargetedByPlayerPrecisely, forwardWeaponOffset, laserPortOffset:, and ShipGetProperty().

previousCondition

- (NSMutableDictionary*) previousCondition

protected

Definition at line 353 of file ShipEntity.h.

Referenced by avoidCollision, dealloc, hasHostileTarget, and resumePostProximityAlert.

primaryRole

- (NSString *) primaryRole

protected

Definition at line 7302 of file ShipEntity.m.

{
    if (primaryRole == nil)
    {
        primaryRole = [roleSet anyRole];
        if (primaryRole == nil)  primaryRole = @"trader";
        [primaryRole retain];
        OOLog(@"ship.noPrimaryRole", @"%@ had no primary role, randomly selected \"%@\".", [self name], primaryRole);
    }
    
    return primaryRole;
}

Referenced by PlayerEntity::addRoleForAggression:, PlayerEntity::commanderDataDictionary, dealEnergyDamage:atRange:withBias:, dealEnergyDamageWithinDesiredRange, dealloc, dumpSelfState, StationEntity::dumpSelfState, enterWitchspace, PlayerEntity::fireMissile, StationEntity::fitsInDock:andLogNoFit:, hasPrimaryRole:, HasPrimaryRoleInSetPredicate(), isEscort, isMine, isPirate, isPirateVictim, isShuttle, isTemplateCargoPod, isTrader, PlayerEntity::mountMissile:, PlayerEntity::removeFromPylon:, roleSet, ShipEntity(LoadRestore)::savedShipDictionaryWithContext:, Universe::setDockingClearanceProtocolActive:, setPrimaryRole:, setUpShipFromDictionary:, ShipGetProperty(), PlayerEntity::tidyMissilePylons, OOShipDebugInspectorModule::update, and update:.

reactionTime

- (float) reactionTime

protected

Definition at line 6287 of file ShipEntity.m.

{
    return reactionTime;
}

Referenced by calculateTargetPosition, calculateTrackingCurve, setReactionTime:, setUpShipFromDictionary:, startTrackingCurve, thrust, and updateTrackingCurve.

reference

- (Vector) reference

protected

Definition at line 7550 of file ShipEntity.m.

{
    return reference;
}

Referenced by ballTrackLeadingTarget:atTarget:, scannerRange, setReference:, setUpShipFromDictionary:, SurfaceDistanceSqared, and SurfaceDistanceSqaredV.

reportAIMessages

- (BOOL) reportAIMessages

protected

Definition at line 7562 of file ShipEntity.m.

{
    return reportAIMessages;
}

Referenced by dumpSelfState, landOnPlanet:, reference, setReportAIMessages:, AI::takeAction:, OOShipDebugInspectorModule::update, and update:.

roleSet

- (OORoleSet *) roleSet

protected

Definition at line 7259 of file ShipEntity.m.

{
    if (roleSet == nil)  roleSet = [[OORoleSet alloc] initWithRoleString:primaryRole];
    return [[roleSet roleSetWithAddedRoleIfNotSet:primaryRole probability:1.0] roleSetWithAddedRoleIfNotSet:[self shipDataKeyAutoRole] probability:1.0];
}

Referenced by addRole:withProbability:, becomeExplosion, dealloc, displayName, dumpSelfState, HasRoleInSetPredicate(), removeRole:, ShipEntity(LoadRestore)::savedShipDictionaryWithContext:, PlayerEntity::setUpShipFromDictionary:, setUpShipFromDictionary:, ShipGetProperty(), OOShipDebugInspectorModule::update, and verifiedMissileTypeFromRole:.

rolling_over

- (unsigned) rolling_over

protected

Definition at line 254 of file ShipEntity.h.

scan_description

- (NSString*) scan_description

protected

Definition at line 331 of file ShipEntity.h.

Referenced by dealloc, scanDescription, scanDescriptionForScripting, setScanDescription:, and setUpShipFromDictionary:.

scanned_ships

- (ShipEntity* scanned_ships[MAX_SCAN_NUMBER+1])

protected

Definition at line 413 of file ShipEntity.h.

Referenced by broadcastAIMessage:, broadcastMessage:withUnpilotedOverride:, checkScanner, checkScannerIgnoringUnpowered, dumpCargoItem:, getTractoredBy:, scannedShips, and scoopUpProcess:processEvents:processMessages:.

scanner_display_color1

- (OOColor*) scanner_display_color1

protected

Definition at line 232 of file ShipEntity.h.

Referenced by dealloc, and setScannerDisplayColor1:.

scanner_display_color2

- (OOColor*) scanner_display_color2

protected

Definition at line 233 of file ShipEntity.h.

Referenced by dealloc, and setScannerDisplayColor2:.

scanner_display_color_hostile1

- (OOColor*) scanner_display_color_hostile1

protected

Definition at line 234 of file ShipEntity.h.

Referenced by dealloc, and setScannerDisplayColorHostile1:.

scanner_display_color_hostile2

- (OOColor*) scanner_display_color_hostile2

protected

Definition at line 235 of file ShipEntity.h.

Referenced by dealloc, and setScannerDisplayColorHostile2:.

scannerRange

- (GLfloat) scannerRange

protected

Definition at line 7538 of file ShipEntity.m.

{
    return scannerRange;
}

Referenced by behaviour_attack_fly_from_target:, behaviour_attack_sniper:, behaviour_formation_form_up:, behaviour_running_defense:, behaviour_track_as_turret:, canStillTrackPrimaryTarget, checkScanner, checkScannerIgnoringUnpowered, currentWeaponFacing, fireDirectLaserDefensiveShot, fireMissileWithIdentifier:andTarget:, realAlertCondition, sendExpandedMessage:toShip:, sendMessage:toShip:withUnpilotedOverride:, setScannerRange:, PlayerEntity::setUpAndConfirmOK:saveGame:, PlayerEntity::setUpShipFromDictionary:, and setUpShipFromDictionary:.

script

- (OOJSScript *) script

protected

Definition at line 14576 of file ShipEntity.m.

{
    return script;
}

Referenced by StationEntity::acceptDockingClearanceRequestFrom:, DockEntity::allowsLaunchingOf:, behaviour_scripted_ai:, DockEntity::canAcceptShipForDocking:, dealloc, StationEntity::dockingInstructionsForShip:, dumpSelfState, isHulk, removeScript, setShipScript:, PlayerEntity::setUpShipFromDictionary:, shipScript, OOShipDebugInspectorModule::update, and update:.

scripted_misjump

- (unsigned) scripted_misjump

protected

Definition at line 278 of file ShipEntity.h.

Referenced by scriptedMisjump, setScriptedMisjump:, PlayerEntity::setUpAndConfirmOK:saveGame:, and setUpFromDictionary:.

scriptInfo

- (NSDictionary *) scriptInfo

protected

Definition at line 14582 of file ShipEntity.m.

{
    return (scriptInfo != nil) ? scriptInfo : (NSDictionary *)[NSDictionary dictionary];
}

Referenced by overrideScriptInfo:, script, and ShipGetProperty().

ship_temperature

- (float) ship_temperature

protected

Definition at line 410 of file ShipEntity.h.

Referenced by PlayerEntity::doBookkeeping:, PlayerEntity::docked, dumpSelfState, hullHeatLevel, initWithKey:definition:, setTemperature:, PlayerEntity::setUpAndConfirmOK:saveGame:, PlayerEntity::takeEnergyDamage:from:becauseOf:weaponIdentifier:, takeEnergyDamage:from:becauseOf:weaponIdentifier:, temperature, and update:.

shipAI

- (AI*) shipAI

protected

Definition at line 325 of file ShipEntity.h.

Referenced by acceptAsEscort:, dealloc, dumpSelfState, getAI, setAI:, PlayerEntity::setUpAndConfirmOK:saveGame:, and setUpShipFromDictionary:.

shipClassName

- (NSString *) shipClassName

protected

Definition at line 7121 of file ShipEntity.m.

{
    return shipClassName;
}

Referenced by PlayerEntity::commanderDataDictionary, dealloc, setShipClassName:, ShipGetProperty(), and shipUniqueName.

shipinfoDictionary

- (NSDictionary*) shipinfoDictionary

protected

Definition at line 217 of file ShipEntity.h.

Referenced by dealloc, StationEntity::isRotatingStation, setUpEscorts, setUpFromDictionary:, shipInfoDictionary, update:, and validForAddToUniverse.

shipUniqueName

- (NSString *) shipUniqueName

protected

Definition at line 7115 of file ShipEntity.m.

{
    return shipUniqueName;
}

Referenced by PlayerEntity::commanderDataDictionary, dealloc, name, setShipUniqueName:, and ShipGetProperty().

shot_counter

- (int) shot_counter

protected

Definition at line 357 of file ShipEntity.h.

Referenced by dumpSelfState.

shot_time

- (OOTimeDelta) shot_time

Definition at line 197 of file ShipEntity.h.

Referenced by PlayerEntity::doBookkeeping:, initWithKey:definition:, resetShotTime, PlayerEntity::setUpAndConfirmOK:saveGame:, shotTime, and update:.

starboard_weapon_temp

- (GLfloat) starboard_weapon_temp

protected

Definition at line 315 of file ShipEntity.h.

Referenced by behaviour_attack_broadside:, behaviour_attack_target:, PlayerEntity::doBookkeeping:, PlayerEntity::fireMainWeapon, fireWeapon:direction:range:, initWithKey:definition:, PlayerEntity::laserHeatLevelStarboard, laserHeatLevelStarboard, PlayerEntity::leaveDock:, PlayerEntity::setUpAndConfirmOK:saveGame:, setUpShipFromDictionary:, and update:.

starboard_weapon_type

- (OOWeaponType) starboard_weapon_type

protected

Definition at line 308 of file ShipEntity.h.

Referenced by behaviour_attack_broadside:, behaviour_attack_broadside_target:leftside:, behaviour_attack_fly_to_target:, behaviour_attack_target:, PlayerEntity::commanderDataDictionary, PlayerEntity::equipmentList, PlayerEntity::hasPrimaryWeapon:, hasPrimaryWeapon:, PlayerEntity::setCommanderDataFromDictionary:, PlayerEntity::setGuiToEquipShipScreen:selectingFacingFor:, PlayerEntity::setUpAndConfirmOK:saveGame:, setWeaponMount:toWeapon:, PlayerEntity::setWeaponMount:toWeapon:inContext:, PlayerEntity::weaponForFacing:, PlayerEntity::weaponTypeForFacing:strict:, and weaponTypeIDForFacing:strict:.

starboardWeaponOffset

- (NSArray *) starboardWeaponOffset

protected

Definition at line 2045 of file ShipEntity.m.

{
    return starboardWeaponOffset;
}

Referenced by dealloc, Universe::firstEntityTargetedByPlayerPrecisely, laserPortOffset:, portWeaponOffset, and ShipGetProperty().

stick_pitch

- (GLfloat) stick_pitch

Definition at line 209 of file ShipEntity.h.

Referenced by applySticks:, behaviour_idle:, behaviour_scripted_ai:, behaviour_stop_still:, evasiveAction:, missileTrackPrimaryTarget:, trackDestination:delta_t:, trackOntoTarget:withDForward:, trackPrimaryTarget:delta_t:, trackSideTarget:delta_t:, and witchspaceLeavingEffects.

stick_roll

- (GLfloat) stick_roll

Definition at line 208 of file ShipEntity.h.

Referenced by applySticks:, behaviour_idle:, behaviour_scripted_ai:, behaviour_stop_still:, evasiveAction:, missileTrackPrimaryTarget:, trackDestination:delta_t:, trackOntoTarget:withDForward:, trackPrimaryTarget:delta_t:, trackSideTarget:delta_t:, and witchspaceLeavingEffects.

stick_yaw

- (GLfloat) stick_yaw

Definition at line 210 of file ShipEntity.h.

Referenced by applySticks:, behaviour_idle:, behaviour_scripted_ai:, behaviour_stop_still:, missileTrackPrimaryTarget:, trackDestination:delta_t:, trackOntoTarget:withDForward:, trackPrimaryTarget:delta_t:, trackSideTarget:delta_t:, and witchspaceLeavingEffects.

subEntities

- (NSArray *) subEntities

protected

Definition at line 1313 of file ShipEntity.m.

{
    return [[subEntities copy] autorelease];
}

Referenced by clearSubEntities, PlayerEntity::doBookkeeping:, StationEntity::dockSubEntityEnumerator, doOctreesCollide, drawImmediate:translucent:, exhaustEnumerator, flasherEnumerator, shipSubEntityEnumerator, subEntityEnumerator, totalBoundingBox, and update:.

subentityRotationalVelocity

- (Quaternion) subentityRotationalVelocity

protected

Definition at line 219 of file ShipEntity.h.

Referenced by setSubEntityRotationalVelocity:, subEntityRotationalVelocity, and update:.

success_factor

- (GLfloat) success_factor

protected

Definition at line 349 of file ShipEntity.h.

Referenced by behaviour_attack_broadside_target:leftside:, behaviour_attack_fly_from_target:, behaviour_attack_fly_to_target:, behaviour_attack_sniper:, behaviour_flee_target:, behaviour_fly_thru_navpoints:, behaviour_fly_to_destination:, behaviour_fly_to_target_six:, behaviour_formation_form_up:, behaviour_intercept_target:, and dumpSelfState.

sunGlareFilter

- (GLfloat) sunGlareFilter

protected

Definition at line 1205 of file ShipEntity.m.

{
    return sunGlareFilter;
}

Referenced by currentAimTolerance, dockingInstructions, and setSunGlareFilter:.

suppressAegisMessages

- (unsigned) suppressAegisMessages

protected

Definition at line 272 of file ShipEntity.h.

Referenced by checkForAegis, PlayerEntity::leaveDock:, setUpFromDictionary:, suppressFlightNotifications, and transitionToAegisNone.

suppressExplosion

- (unsigned) suppressExplosion

protected

Definition at line 271 of file ShipEntity.h.

Referenced by becomeExplosion, setSuppressExplosion:, setUpFromDictionary:, and takeEnergyDamage:from:becauseOf:weaponIdentifier:.

thrust

- (float) thrust

protected

Definition at line 4131 of file ShipEntity.m.

{
    return thrust;
}

Referenced by abandonShip, applyThrust:, ballTrackLeadingTarget:atTarget:, behaviour_fly_to_destination:, behaviour_formation_form_up:, behaviour_intercept_target:, behaviour_land_on_planet:, behaviour_tractored:, PlayerEntity::doBookkeeping:, dumpSelfState, isFrangible, PlayerEntity::launchEscapeCapsule, and setThrust:.

totalBoundingBox

- (BoundingBox) totalBoundingBox

Definition at line 1265 of file ShipEntity.m.

{
    return totalBoundingBox;
}

Referenced by accuracy, DockEntity::allowsLaunchingOf:, DockEntity::canAcceptShipForDocking:, PlayerEntity::doBookkeeping:, drawImmediate:translucent:, HeadUpDisplay(Private)::drawScanner:, OOShipLibrarySize(), setUpOneStandardSubentity:asTurret:, setUpSubEntities, CollisionRegion::shadowAtPointOcclusionToValue, ShipGetProperty(), and update:.

trackCloseContacts

- (BOOL) trackCloseContacts

protected

Definition at line 14386 of file ShipEntity.m.

{
    return trackCloseContacts;
}

Referenced by checkCloseCollisionWith:, dumpSelfState, setTrackCloseContacts:, sunGlareFilter, and update:.

trackingCurveCoeffs

- (HPVector trackingCurveCoeffs[3])

protected

Definition at line 452 of file ShipEntity.h.

Referenced by calculateTargetPosition, and calculateTrackingCurve.

trackingCurvePositions

- (HPVector trackingCurvePositions[4])

protected

Definition at line 450 of file ShipEntity.h.

Referenced by calculateTrackingCurve, startTrackingCurve, and updateTrackingCurve.

trackingCurveTimes

- (OOTimeAbsolute trackingCurveTimes[4])

protected

Definition at line 451 of file ShipEntity.h.

Referenced by calculateTargetPosition, calculateTrackingCurve, startTrackingCurve, and updateTrackingCurve.

tractor_position

- (Vector) tractor_position

protected

Definition at line 407 of file ShipEntity.h.

Referenced by absoluteTractorPosition.

v_forward

- (Vector) v_forward

Definition at line 200 of file ShipEntity.h.

Referenced by approachAspectToPrimaryTarget, canScoop:, checkCloseCollisionWith:, distance_six:, doesHitLine:v0:, PlayerEntity::doesHitLine:v0:v1:, doesHitLine:v0:v1:, HeadUpDisplay(Private)::drawScanner:, dumpItem:, fireDirectLaserShotAt:, fireLaserShotInDirection:weaponIdentifier:, fireMissileWithIdentifier:andTarget:, forwardVector, launchCascadeMine, PlayerEntity::launchEscapeCapsule, PlayerEntity::launchMine:, PlayerEntity::lookingAtSunWithThresholdAngleCos:, lookingAtSunWithThresholdAngleCos:, missileTrackPrimaryTarget:, onTarget:withWeapon:, PlayerEntity::orientationChanged, orientationChanged, setProximityAlert:, ShipEntity(PureAI)::setRacepointsFromTarget, setUpShipFromDictionary:, PlayerEntity::takeEnergyDamage:from:becauseOf:weaponIdentifier:, PlayerEntity::takeScrapeDamage:from:, thrustVector, trackDestination:delta_t:, trackOntoTarget:withDForward:, trackPrimaryTarget:delta_t:, trackSideTarget:delta_t:, and update:.

v_right

- (Vector) v_right

Definition at line 200 of file ShipEntity.h.

Referenced by checkCloseCollisionWith:, distance_twelve:withOffset:, doesHitLine:v0:, PlayerEntity::doesHitLine:v0:v1:, doesHitLine:v0:v1:, HeadUpDisplay(Private)::drawScanner:, evasiveAction:, launchCascadeMine, PlayerEntity::lookingAtSunWithThresholdAngleCos:, lookingAtSunWithThresholdAngleCos:, missileTrackPrimaryTarget:, onTarget:withWeapon:, PlayerEntity::orientationChanged, orientationChanged, rightVector, rollToMatchUp:rotating:, setProximityAlert:, setUpShipFromDictionary:, PlayerEntity::takeEnergyDamage:from:becauseOf:weaponIdentifier:, PlayerEntity::takeScrapeDamage:from:, trackDestination:delta_t:, trackPrimaryTarget:delta_t:, trackSideTarget:delta_t:, and update:.

v_up

- (Vector) v_up

Definition at line 200 of file ShipEntity.h.

Referenced by canScoop:, checkCloseCollisionWith:, distance_twelve:withOffset:, doesHitLine:v0:, PlayerEntity::doesHitLine:v0:v1:, doesHitLine:v0:v1:, HeadUpDisplay(Private)::drawScanner:, launchCascadeMine, PlayerEntity::launchEscapeCapsule, missileTrackPrimaryTarget:, PlayerEntity::orientationChanged, orientationChanged, rollToMatchUp:rotating:, setProximityAlert:, setUpShipFromDictionary:, PlayerEntity::takeEnergyDamage:from:becauseOf:weaponIdentifier:, PlayerEntity::takeScrapeDamage:from:, trackDestination:delta_t:, trackPrimaryTarget:delta_t:, trackSideTarget:delta_t:, update:, and upVector.

weapon_damage

- (GLfloat) weapon_damage

protected

Definition at line 309 of file ShipEntity.h.

Referenced by behaviour_attack_broadside:, dealEnergyDamageWithinDesiredRange, fireLaserShotInDirection:weaponIdentifier:, setUpShipFromDictionary:, setWeaponDataFromType:, and setWeaponEnergy:.

weapon_damage_override

- (GLfloat) weapon_damage_override

protected

Definition at line 310 of file ShipEntity.h.

Referenced by setUpShipFromDictionary:.

weapon_energy_use

- (GLfloat) weapon_energy_use

protected

Definition at line 314 of file ShipEntity.h.

Referenced by PlayerEntity::fireMainWeapon, fireSubentityLaserShot:, fireWeapon:direction:range:, and setWeaponDataFromType:.

weapon_facings

- (OOWeaponFacingSet) weapon_facings

protected

Definition at line 304 of file ShipEntity.h.

Referenced by setWeaponMount:toWeapon:, weaponFacings, and weaponTypeIDForFacing:strict:.

weapon_recharge_rate

- (float) weapon_recharge_rate

protected

Definition at line 356 of file ShipEntity.h.

Referenced by fireSubentityLaserShot:, fireTurretCannon:, fireWeapon:direction:range:, initWithKey:definition:, setWeaponDataFromType:, setWeaponRechargeRate:, weaponRechargeRate, and weaponRecoveryTime.

weapon_shot_temperature

- (GLfloat) weapon_shot_temperature

protected

Definition at line 314 of file ShipEntity.h.

Referenced by PlayerEntity::fireMainWeapon, fireSubentityLaserShot:, fireWeapon:direction:range:, and setWeaponDataFromType:.

weapon_temp

- (GLfloat) weapon_temp

protected

Definition at line 314 of file ShipEntity.h.

Referenced by behaviour_attack_broadside_target:leftside:, behaviour_attack_fly_to_target:, behaviour_attack_sniper:, behaviour_fly_to_target_six:, behaviour_running_defense:, PlayerEntity::doBookkeeping:, PlayerEntity::docked, PlayerEntity::fireMainWeapon, fireMainWeapon:, fireWeapon:direction:range:, initWithKey:definition:, PlayerEntity::laserHeatLevel, laserHeatLevel, PlayerEntity::setUpAndConfirmOK:saveGame:, setUpShipFromDictionary:, and update:.

weaponRange

- (GLfloat) weaponRange

protected

Definition at line 7470 of file ShipEntity.m.

{
    return weaponRange;
}

Referenced by ballTrackLeadingTarget:atTarget:, behaviour_attack_break_off_target:, behaviour_attack_broadside:, behaviour_attack_fly_from_target:, behaviour_attack_fly_to_target:, behaviour_attack_slow_dogfight:, behaviour_attack_sniper:, behaviour_attack_target:, behaviour_close_to_broadside_range:, behaviour_fly_to_target_six:, behaviour_running_defense:, behaviour_track_as_turret:, fireDirectLaserDefensiveShot, fireDirectLaserShot:, fireDirectLaserShotAt:, fireLaserShotInDirection:weaponIdentifier:, fireMainWeapon:, fireSubentityLaserShot:, fireTurretCannon:, fireWeapon:direction:range:, Universe::firstShipHitByLaserFromShip:inDirection:offset:gettingRangeFound:, OOLaserShotEntity::initLaserFromShip:direction:offset:, isMissile, setWeaponDataFromType:, and setWeaponRange:.

---

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

• src/Core/Entities/ShipEntity.h
• src/Core/Entities/ShipEntity.m