Universe Class Reference

#include <Universe.h>

Inheritance diagram for Universe:

Collaboration diagram for Universe:

Instance Methods
(BOOL)	- bloom
(void)	- setBloom:
(int)	- currentPostFX
(void)	- setCurrentPostFX:
(id)	- initWithGameView:
(NSUInteger)	- sessionID
(BOOL)	- doProcedurallyTexturedPlanets
(void)	- setDoProcedurallyTexturedPlanets:
(NSString *)	- useAddOns
(BOOL)	- setUseAddOns:fromSaveGame:
(BOOL)	- setUseAddOns:fromSaveGame:forceReinit:
(void)	- setUpSettings
(BOOL)	- reinitAndShowDemo:
(BOOL)	- doingStartUp
(NSUInteger)	- entityCount
(void)	- debugDumpEntities
(NSArray *)	- entityList
(void)	- pauseGame
(void)	- carryPlayerOn:inWormhole:
(void)	- setUpUniverseFromStation
(void)	- setUpUniverseFromWitchspace
(void)	- setUpUniverseFromMisjump
(void)	- setUpWitchspace
(void)	- setUpWitchspaceBetweenSystem:andSystem:
(void)	- setUpSpace
(void)	- populateNormalSpace
(void)	- clearSystemPopulator
(BOOL)	- deterministicPopulation
(void)	- populateSystemFromDictionariesWithSun:andPlanet:
(NSDictionary *)	- getPopulatorSettings
(void)	- setPopulatorSetting:to:
(HPVector)	- locationByCode:withSun:andPlanet:
(void)	- setAmbientLightLevel:
(float)	- ambientLightLevel
(void)	- setLighting
(void)	- forceLightSwitch
(void)	- setMainLightPosition:
(OOPlanetEntity *)	- setUpPlanet
(void)	- makeSunSkimmer:andSetAI:
(void)	- addShipWithRole:nearRouteOneAt:
(HPVector)	- coordinatesForPosition:withCoordinateSystem:returningScalar:
(NSString *)	- expressPosition:inCoordinateSystem:
(HPVector)	- legacyPositionFrom:asCoordinateSystem:
(HPVector)	- coordinatesFromCoordinateSystemString:
(BOOL)	- addShipWithRole:nearPosition:withCoordinateSystem:
(BOOL)	- addShips:withRole:atPosition:withCoordinateSystem:
(BOOL)	- addShips:withRole:nearPosition:withCoordinateSystem:
(BOOL)	- addShips:withRole:nearPosition:withCoordinateSystem:withinRadius:
(BOOL)	- addShips:withRole:intoBoundingBox:
(BOOL)	- spawnShip:
(void)	- witchspaceShipWithPrimaryRole:
(ShipEntity *)	- spawnShipWithRole:near:
(OOVisualEffectEntity *)	- addVisualEffectAt:withKey:
(ShipEntity *)	- addShipAt:withRole:withinRadius:
(NSArray *)	- addShipsAt:withRole:quantity:withinRadius:asGroup:
(NSArray *)	- addShipsToRoute:withRole:quantity:routeFraction:asGroup:
(BOOL)	- roleIsPirateVictim:
(BOOL)	- role:isInCategory:
(void)	- forceWitchspaceEntries
(void)	- addWitchspaceJumpEffectForShip:
(GLfloat)	- safeWitchspaceExitDistance
(void)	- setUpBreakPattern:orientation:forDocking:
(BOOL)	- witchspaceBreakPattern
(void)	- setWitchspaceBreakPattern:
(BOOL)	- dockingClearanceProtocolActive
(void)	- setDockingClearanceProtocolActive:
(void)	- handleGameOver
(void)	- setupIntroFirstGo:
(void)	- selectIntro2Previous
(void)	- selectIntro2Next
(void)	- selectIntro2PreviousCategory
(void)	- selectIntro2NextCategory
(StationEntity *)	- station
(OOPlanetEntity *)	- planet
(OOSunEntity *)	- sun
(NSArray *)	- planets
(NSArray *)	- stations
(NSArray *)	- wormholes
(StationEntity *)	- stationWithRole:andPosition:
(void)	- unMagicMainStation
(StationEntity *)	- stationFriendlyTo:
(void)	- resetBeacons
(Entity< OOBeaconEntity > *)	- firstBeacon
(Entity< OOBeaconEntity > *)	- lastBeacon
(void)	- setNextBeacon:
(void)	- clearBeacon:
(NSDictionary *)	- currentWaypoints
(void)	- defineWaypoint:forKey:
(GLfloat *)	- skyClearColor
(void)	- setSkyColorRed:green:blue:alpha:
(BOOL)	- breakPatternOver
(BOOL)	- breakPatternHide
(NSString *)	- randomShipKeyForRoleRespectingConditions:
(ShipEntity *)	- newShipWithRole:
(ShipEntity *)	- newShipWithName:
(ShipEntity *)	- newSubentityWithName:andScaleFactor:
(OOVisualEffectEntity *)	- newVisualEffectWithName:
(DockEntity *)	- newDockWithName:andScaleFactor:
(ShipEntity *)	- newShipWithName:usePlayerProxy:
(ShipEntity *)	- newShipWithName:usePlayerProxy:isSubentity:
(ShipEntity *)	- newShipWithName:usePlayerProxy:isSubentity:andScaleFactor:
(Class)	- shipClassForShipDictionary:
(NSString *)	- defaultAIForRole:
(OOCargoQuantity)	- maxCargoForShip:
(OOCreditsQuantity)	- getEquipmentPriceForKey:
(OOCommodities *)	- commodities
(ShipEntity *)	- reifyCargoPod:
(ShipEntity *)	- cargoPodFromTemplate:
(NSArray *)	- getContainersOfGoods:scarce:legal:
(NSArray *)	- getContainersOfCommodity:commodity_name:
(void)	- fillCargopodWithRandomCargo:
(NSString *)	- getRandomCommodity
(OOCargoQuantity)	- getRandomAmountOfCommodity:
(NSDictionary *)	- commodityDataForType:
(NSString *)	- displayNameForCommodity:
(NSString *)	- describeCommodity:amount:
(void)	- setGameView:
(MyOpenGLView *)	- gameView
(GameController *)	- gameController
(NSDictionary *)	- gameSettings
(void)	- useGUILightSource:
(void)	- drawUniverse
(void)	- defineFrustum
(BOOL)	- viewFrustumIntersectsSphereAt:withRadius:
(void)	- drawMessage
(void)	- drawWatermarkString:
(OOMatrix)	- viewMatrix
(id)	- entityForUniversalID:
(BOOL)	- addEntity:
(BOOL)	- removeEntity:
(void)	- ensureEntityReallyRemoved:
(void)	- removeAllEntitiesExceptPlayer
(void)	- removeDemoShips
(ShipEntity *)	- makeDemoShipWithRole:spinning:
(BOOL)	- isVectorClearFromEntity:toDistance:fromPoint:
(Entity *)	- hazardOnRouteFromEntity:toDistance:fromPoint:
(HPVector)	- getSafeVectorFromEntity:toDistance:fromPoint:
(ShipEntity *)	- addWreckageFrom:withRole:at:scale:lifetime:
(void)	- addLaserHitEffectsAt:against:damage:color:
(ShipEntity *)	- firstShipHitByLaserFromShip:inDirection:offset:gettingRangeFound:
(Entity *)	- firstEntityTargetedByPlayer
(Entity *)	- firstEntityTargetedByPlayerPrecisely
(NSArray *)	- entitiesWithinRange:ofEntity:
(unsigned)	- countShipsWithRole:inRange:ofEntity:
(unsigned)	- countShipsWithRole:
(unsigned)	- countShipsWithPrimaryRole:inRange:ofEntity:
(unsigned)	- countShipsWithPrimaryRole:
(unsigned)	- countShipsWithScanClass:inRange:ofEntity:
(unsigned)	- countEntitiesMatchingPredicate:parameter:inRange:ofEntity:
(unsigned)	- countShipsMatchingPredicate:parameter:inRange:ofEntity:
(NSMutableArray *)	- findEntitiesMatchingPredicate:parameter:inRange:ofEntity:
(id)	- findOneEntityMatchingPredicate:parameter:
(NSMutableArray *)	- findShipsMatchingPredicate:parameter:inRange:ofEntity:
(NSMutableArray *)	- findVisualEffectsMatchingPredicate:parameter:inRange:ofEntity:
(id)	- nearestEntityMatchingPredicate:parameter:relativeToEntity:
(id)	- nearestShipMatchingPredicate:parameter:relativeToEntity:
(OOTimeAbsolute)	- getTime
(OOTimeDelta)	- getTimeDelta
(void)	- findCollisionsAndShadows
(NSString *)	- collisionDescription
(void)	- dumpCollisions
(OOViewID)	- viewDirection
(void)	- setViewDirection:
(void)	- enterGUIViewModeWithMouseInteraction:
(NSString *)	- soundNameForCustomSoundKey:
(NSDictionary *)	- screenTextureDescriptorForKey:
(void)	- setScreenTextureDescriptorForKey:descriptor:
(void)	- clearPreviousMessage
(void)	- setMessageGuiBackgroundColor:
(void)	- displayMessage:forCount:
(void)	- displayCountdownMessage:forCount:
(void)	- addDelayedMessage:forCount:afterDelay:
(void)	- addDelayedMessage:
(void)	- addMessage:forCount:
(void)	- addMessage:forCount:forceDisplay:
(void)	- addCommsMessage:forCount:
(void)	- addCommsMessage:forCount:andShowComms:logOnly:
(void)	- showCommsLog:
(void)	- showGUIMessage:withScroll:andColor:overDuration:
(void)	- update:
(double)	- timeAccelerationFactor
(void)	- setTimeAccelerationFactor:
(void)	- filterSortedLists
(void)	- setGalaxyTo:
(void)	- setGalaxyTo:andReinit:
(void)	- setSystemTo:
(OOSystemID)	- currentSystemID
(NSDictionary *)	- descriptions
(NSDictionary *)	- characters
(NSDictionary *)	- missiontext
(NSArray *)	- scenarios
(NSDictionary *)	- explosionSetting:
(OOSystemDescriptionManager *)	- systemManager
(NSString *)	- descriptionForKey:
(NSString *)	- descriptionForArrayKey:index:
(BOOL)	- descriptionBooleanForKey:
(NSString *)	- keyForPlanetOverridesForSystem:inGalaxy:
(NSString *)	- keyForInterstellarOverridesForSystems:s1:inGalaxy:
(NSDictionary *)	- generateSystemData:
(NSDictionary *)	- generateSystemData:useCache:
(NSDictionary *)	- currentSystemData
(BOOL)	- inInterstellarSpace
(void)	- setSystemDataKey:value:fromManifest:
(void)	- setSystemDataForGalaxy:planet:key:value:fromManifest:forLayer:
(id)	- systemDataForGalaxy:planet:key:
(NSArray *)	- systemDataKeysForGalaxy:planet:
(NSString *)	- getSystemName:
(NSString *)	- getSystemName:forGalaxy:
(OOGovernmentID)	- getSystemGovernment:
(NSString *)	- getSystemInhabitants:
(NSString *)	- getSystemInhabitants:plural:
(NSPoint)	- coordinatesForSystem:
(OOSystemID)	- findSystemFromName:
(NSMutableArray *)	- nearbyDestinationsWithinRange:
(OOSystemID)	- findNeighbouringSystemToCoords:withGalaxy:
(OOSystemID)	- findConnectedSystemAtCoords:withGalaxy:
(OOSystemID)	- findSystemAtCoords:withGalaxy:
(OOSystemID)	- findSystemNumberAtCoords:withGalaxy:includingHidden:
(NSPoint)	- findSystemCoordinatesWithPrefix:
(NSPoint)	- findSystemCoordinatesWithPrefix:exactMatch:
(BOOL *)	- systemsFound
(NSString *)	- systemNameIndex:
(NSDictionary *)	- routeFromSystem:toSystem:optimizedBy:
(NSArray *)	- neighboursToSystem:
(void)	- preloadPlanetTexturesForSystem:
(void)	- preloadSounds
(NSDictionary *)	- globalSettings
(NSArray *)	- equipmentData
(NSArray *)	- equipmentDataOutfitting
(OOCommodityMarket *)	- commodityMarket
(Random_Seed)	- marketSeed
(NSString *)	- timeDescription:
(NSString *)	- shortTimeDescription:
(void)	- loadStationMarkets:
(NSArray *)	- getStationMarkets
(NSArray *)	- shipsForSaleForSystem:withTL:atTime:
(OOCreditsQuantity)	- tradeInValueForCommanderDictionary:
(NSString *)	- brochureDescriptionWithDictionary:standardEquipment:optionalEquipment:
(HPVector)	- getWitchspaceExitPosition
(Quaternion)	- getWitchspaceExitRotation
(HPVector)	- getSunSkimStartPositionForShip:
(HPVector)	- getSunSkimEndPositionForShip:
(NSArray *)	- listBeaconsWithCode:
(void)	- allShipsDoScriptEvent:andReactToAIMessage:
(void)	- clearGUIs
(GuiDisplayGen *)	- gui
(GuiDisplayGen *)	- commLogGUI
(GuiDisplayGen *)	- messageGUI
(void)	- resetCommsLogColor
(void)	- setDisplayText:
(BOOL)	- displayGUI
(void)	- setDisplayFPS:
(BOOL)	- displayFPS
(void)	- setAutoSave:
(BOOL)	- autoSave
(void)	- setWireframeGraphics:
(BOOL)	- wireframeGraphics
(BOOL)	- reducedDetail
(void)	- setDetailLevel:
(OOGraphicsDetail)	- detailLevel
(BOOL)	- useShaders
(void)	- handleOoliteException:
(GLfloat)	- airResistanceFactor
(void)	- setAirResistanceFactor:
(void)	- startSpeakingString:
(void)	- stopSpeaking
(BOOL)	- isSpeaking
(int)	- nextColorblindMode:
(int)	- prevColorblindMode:
(int)	- colorblindMode
(void)	- setAutoSaveNow:
(BOOL)	- autoSaveNow
(int)	- framesDoneThisUpdate
(void)	- resetFramesDoneThisUpdate
(BOOL)	- pauseMessageVisible
(void)	- setPauseMessageVisible:
(BOOL)	- permanentCommLog
(void)	- setPermanentCommLog:
(void)	- setAutoCommLog:
(BOOL)	- permanentMessageLog
(void)	- setPermanentMessageLog:
(BOOL)	- autoMessageLogBg
(void)	- setAutoMessageLogBg:
(BOOL)	- blockJSPlayerShipProps
(void)	- setBlockJSPlayerShipProps:
(void)	- loadConditionScripts
(void)	- addConditionScripts:
(OOJSScript *)	- getConditionScript:
(void)	- initTargetFramebufferWithViewSize: [implementation]
(void)	- deleteOpenGLObjects [implementation]
(void)	- resizeTargetFramebufferWithViewSize: [implementation]
(void)	- drawTargetTextureIntoDefaultFramebuffer [implementation]
(void)	- dealloc [implementation]
(ShipEntity *)	- addShipWithRole:launchPos:rfactor: [implementation]
(NSDictionary *)	- demoShipData [implementation]
(void)	- setLibraryTextForDemoShip [implementation]
(void)	- setFirstBeacon: [implementation]
(void)	- setLastBeacon: [implementation]
(BOOL)	- canInstantiateShip: [implementation]
(void)	- lightForEntity: [implementation]
(void)	- getActiveViewMatrix:forwardVector:upVector: [implementation]
(OOMatrix)	- activeViewMatrix [implementation]
(void)	- prepareToRenderIntoDefaultFramebuffer [implementation]
(OOINLINE BOOL)	- EntityInRange [implementation]
(void)	- speakWithSubstitutions: [implementation]
(void)	- repopulateSystem [implementation]
(void)	- verifyDescriptions [implementation]
(void)	- loadDescriptions [implementation]
(void)	- loadScenarios [implementation]
(NSDictionary *)	- generateSystemDataForGalaxy:planet: [implementation]
(void)	- setDetailLevelDirectly: [implementation]
(void)	- setUpCargoPods [implementation]
(void)	- verifyEntitySessionIDs [implementation]
(void)	- setUpInitialUniverse [implementation]
(float)	- randomDistanceWithinScanner [implementation]
(Vector)	- randomPlaceWithinScannerFrom:alongRoute:withOffset: [implementation]
(HPVector)	- fractionalPositionFrom:to:withFraction: [implementation]
(BOOL)	- doRemoveEntity: [implementation]
(void)	- populateSpaceFromActiveWormholes [implementation]
(NSString *)	- chooseStringForKey:inDictionary: [implementation]
(void)	- addNumericRefsInString:toGraphViz:fromNode:nodeCount: [implementation]
(void)	- runLocalizationTools [implementation]
(void)	- setShaderEffectsLevelDirectly: [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)	+ IsCandidateMainStationPredicate [implementation]
(static BOOL)	+ IsFriendlyStationPredicate [implementation]
(static BOOL)	+ MaintainLinkedLists [implementation]
(static void)	+ VerifyDesc [implementation]
(static void)	+ VerifyDescString [implementation]
(static void)	+ VerifyDescArray [implementation]
(static OOComparisonResult)	+ compareName [implementation]
(static OOComparisonResult)	+ comparePrice [implementation]
(static void)	+ PreloadOneSound [implementation]

Public Attributes
Entity *	sortedEntities [UNIVERSE_MAX_ENTITIES+1]
unsigned	n_entities
int	cursor_row
Entity *	x_list_start
Entity *	y_list_start
Entity *	z_list_start
GLfloat	stars_ambient [4]

Private Attributes
NSUInteger	_sessionID
GLfloat	sun_diffuse [4]
GLfloat	sun_specular [4]
OOViewID	viewDirection
OOMatrix	viewMatrix
GLfloat	airResistanceFactor
MyOpenGLView *	gameView
int	next_universal_id
Entity *	entity_for_uid [MAX_ENTITY_UID]
NSMutableArray *	entities
OOWeakReference *	_firstBeacon
OOWeakReference *	_lastBeacon
NSMutableDictionary *	waypoints
GLfloat	skyClearColor [4]
NSString *	currentMessage
OOTimeAbsolute	messageRepeatTime
OOTimeAbsolute	countdown_messageRepeatTime
GuiDisplayGen *	gui
GuiDisplayGen *	message_gui
GuiDisplayGen *	comm_log_gui
BOOL	displayGUI
BOOL	wasDisplayGUI
BOOL	autoSaveNow
BOOL	autoSave
BOOL	wireframeGraphics
OOGraphicsDetail	detailLevel
BOOL	displayFPS
OOTimeAbsolute	universal_time
OOTimeDelta	time_delta
OOTimeAbsolute	demo_stage_time
OOTimeAbsolute	demo_start_time
GLfloat	demo_start_z
int	demo_stage
NSUInteger	demo_ship_index
NSUInteger	demo_ship_subindex
NSArray *	demo_ships
GLfloat	main_light_position [4]
BOOL	dumpCollisionInfo
OOCommodities *	commodities
OOCommodityMarket *	commodityMarket
NSDictionary *	_descriptions
NSDictionary *	customSounds
NSDictionary *	characters
NSArray *	_scenarios
NSDictionary *	globalSettings
OOSystemDescriptionManager *	systemManager
NSDictionary *	missiontext
NSArray *	equipmentData
NSArray *	equipmentDataOutfitting
NSDictionary *	roleCategories
NSDictionary *	autoAIMap
NSDictionary *	screenBackgrounds
NSDictionary *	explosionSettings
NSDictionary *	cargoPods
OOGalaxyID	galaxyID
OOSystemID	systemID
OOSystemID	targetSystemID
NSString *	system_names [256]
BOOL	system_found [256]
int	breakPatternCounter
ShipEntity *	demo_ship
StationEntity *	cachedStation
OOPlanetEntity *	cachedPlanet
OOSunEntity *	cachedSun
NSMutableArray *	allPlanets
NSMutableSet *	allStations
float	ambientLightLevel
NSMutableDictionary *	populatorSettings
OOTimeDelta	next_repopulation
NSString *	system_repopulator
BOOL	deterministic_population
NSArray *	closeSystems
NSString *	useAddOns
BOOL	no_update
double	timeAccelerationFactor
NSMutableArray *	activeWormholes
NSMutableArray *	characterPool
CollisionRegion *	universeRegion
BOOL	doLinkedListMaintenanceThisUpdate
NSMutableSet *	entitiesDeadThisUpdate
int	framesDoneThisUpdate
NSSpeechSynthesizer *	speechSynthesizer
NSArray *	speechArray
BOOL	doProcedurallyTexturedPlanets
GLfloat	frustum [6][4]
NSMutableDictionary *	conditionScripts
BOOL	_pauseMessage
BOOL	_autoCommLog
BOOL	_permanentCommLog
BOOL	_autoMessageLogBg
BOOL	_permanentMessageLog
BOOL	_witchspaceBreakPattern
BOOL	_dockingClearanceProtocolActive
BOOL	_doingStartUp
GLuint	msaaTextureID
GLuint	targetTextureID
GLuint	passthroughTextureID [2]
NSSize	targetFramebufferSize
GLuint	msaaFramebufferID
GLuint	msaaDepthBufferID
GLuint	targetDepthBufferID
GLuint	targetFramebufferID
GLuint	passthroughFramebufferID
OOShaderProgram *	textureProgram
OOShaderProgram *	blurProgram
OOShaderProgram *	finalProgram
GLuint	quadTextureVBO
GLuint	quadTextureVAO
GLuint	quadTextureEBO
GLint	defaultDrawFBO
GLuint	pingpongFBO [2]
GLuint	pingpongColorbuffers [2]
BOOL	_bloom
int	_currentPostFX
int	_colorblindMode

Additional Inherited Members
Protected Attributes inherited from OOWeakRefObject
OOWeakReference *	weakSelf

Detailed Description

Definition at line 186 of file Universe.h.

Method Documentation

activeViewMatrix

- (OOMatrix) activeViewMatrix

implementation

Definition at line 4630 of file Universe.m.

{
    OOMatrix            m;
    Vector              f, u;
    
    [self getActiveViewMatrix:&m forwardVector:&f upVector:&u];
    return m;
}

addCommsMessage:forCount:

- (void) addCommsMessage:		(NSString *)	text
forCount:		(OOTimeDelta)	count

Definition at line 6447 of file Universe.m.

                        :(NSString *)text forCount:(OOTimeDelta)count
{
    [self addCommsMessage:text forCount:count andShowComms:_autoCommLog logOnly:NO];
}

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

addCommsMessage:forCount:andShowComms:logOnly:

- (void) addCommsMessage:		(NSString *)	text
forCount:		(OOTimeDelta)	count
andShowComms:		(BOOL)	showComms
logOnly:		(BOOL)	logOnly

Definition at line 6447 of file Universe.m.

                        :(NSString *)text forCount:(OOTimeDelta)count andShowComms:(BOOL)showComms logOnly:(BOOL)logOnly
{
    if ([PLAYER showDemoShips]) return;
    
    NSString *expandedMessage = OOExpand(text);
    
    if (![currentMessage isEqualToString:expandedMessage] || universal_time >= messageRepeatTime)
    {
        PlayerEntity* player = PLAYER;
        
        if (!logOnly)
        {
            if ([player isSpeechOn] >= OOSPEECHSETTINGS_COMMS)
            {
                // EMMSTRAN: should say "Incoming message from ..." when prefixed with sender name.
                NSString *format = OOExpandKey(@"speech-synthesis-incoming-message-@");
                [self speakWithSubstitutions:[NSString stringWithFormat:format, expandedMessage]];
            }
            
            [self showGUIMessage:expandedMessage withScroll:YES andColor:[message_gui textCommsColor] overDuration:count];
            
            [currentMessage release];
            currentMessage = [expandedMessage retain];
            messageRepeatTime=universal_time + 6.0;
        }
        
        [comm_log_gui printLongText:expandedMessage align:GUI_ALIGN_LEFT color:nil fadeTime:0.0 key:nil addToArray:[player commLog]];
        
        if (showComms)  [self showCommsLog:6.0];
    }
}

addConditionScripts:

- (void) addConditionScripts:

(NSEnumerator *)

scripts

Definition at line 10697 of file Universe.m.

                            :(NSEnumerator *)scripts
{
    NSString *scriptname = nil;
    while ((scriptname = [scripts nextObject]))
    {
        if ([conditionScripts objectForKey:scriptname] == nil)
        {
            OOJSScript *script = [OOScript jsScriptFromFileNamed:scriptname properties:nil];
            if (script != nil)
            {
                [conditionScripts setObject:script forKey:scriptname];
            }
        }
    }
}

References ResourceManager::ooSoundNamed:inFolder:.

Here is the call graph for this function:

addDelayedMessage:

- (void) addDelayedMessage:

(NSDictionary *)

textdict

Definition at line 6447 of file Universe.m.

                          :(NSDictionary *) textdict
{
    NSString        *msg = nil;
    OOTimeDelta     msg_duration;
    
    msg = [textdict oo_stringForKey:@"message"];
    if (msg == nil)  return;
    msg_duration = [textdict oo_nonNegativeDoubleForKey:@"duration" defaultValue:3.0];
    
    [self addMessage:msg forCount:msg_duration];
}

addDelayedMessage:forCount:afterDelay:

- (void) addDelayedMessage:		(NSString *)	text
forCount:		(OOTimeDelta)	count
afterDelay:		(OOTimeDelta)	delay

Definition at line 6447 of file Universe.m.

                          :(NSString *)text forCount:(OOTimeDelta)count afterDelay:(double)delay
{
    NSMutableDictionary *msgDict = [NSMutableDictionary dictionaryWithCapacity:2];
    [msgDict setObject:text forKey:@"message"];
    [msgDict setObject:[NSNumber numberWithDouble:count] forKey:@"duration"];
    [self performSelector:@selector(addDelayedMessage:) withObject:msgDict afterDelay:delay];
}

addEntity:

- (BOOL) addEntity:

(Entity *)

entity

Definition at line 5364 of file Universe.m.

                  :(Entity *) entity
{
    if (entity)
    {
        ShipEntity *se = nil;
        OOVisualEffectEntity *ve = nil;
        OOWaypointEntity *wp = nil;
        
        if (![entity validForAddToUniverse])  return NO;
        
        // don't add things twice!
        if ([entities containsObject:entity])
            return YES;
        
        if (n_entities >= UNIVERSE_MAX_ENTITIES - 1)
        {
            // throw an exception here...
            OOLog(@"universe.addEntity.failed", @"***** Universe cannot addEntity:%@ -- Universe is full (%d entities out of %d)", entity, n_entities, UNIVERSE_MAX_ENTITIES);
#ifndef NDEBUG
            if (OOLogWillDisplayMessagesInClass(@"universe.maxEntitiesDump")) [self debugDumpEntities];
#endif
            return NO;
        }
        
        if (![entity isEffect])
        {
            unsigned limiter = UNIVERSE_MAX_ENTITIES;
            while (entity_for_uid[next_universal_id] != nil)    // skip allocated numbers
            {
                next_universal_id++;                        // increment keeps idkeys unique
                if (next_universal_id >= MAX_ENTITY_UID)
                {
                    next_universal_id = MIN_ENTITY_UID;
                }
                if (limiter-- == 0)
                {
                    // Every slot has been tried! This should not happen due to previous test, but there was a problem here in 1.70.
                    OOLog(@"universe.addEntity.failed", @"***** Universe cannot addEntity:%@ -- Could not find free slot for entity.", entity);
                    return NO;
                }
            }
            [entity setUniversalID:next_universal_id];
            entity_for_uid[next_universal_id] = entity;
            if ([entity isShip])
            {
                se = (ShipEntity *)entity;
                if ([se isBeacon])
                {
                    [self setNextBeacon:se];
                }
                if ([se isStation])
                {
                    // check if it is a proper rotating station (ie. roles contains the word "station")
                    if ([(StationEntity*)se isRotatingStation])
                    {
                        double stationRoll = 0.0;
                        // check for station_roll override
                        id definedRoll = [[se shipInfoDictionary] objectForKey:@"station_roll"];
                        
                        if (definedRoll != nil)
                        {
                            stationRoll = OODoubleFromObject(definedRoll, stationRoll);
                        }
                        else
                        {
                            stationRoll = [[self currentSystemData] oo_doubleForKey:@"station_roll" defaultValue:STANDARD_STATION_ROLL];
                        }
                        
                        [se setRoll: stationRoll];
                    }
                    else
                    {
                        [se setRoll: 0.0];
                    }
                    [(StationEntity *)se setPlanet:[self planet]];
                    if ([se maxFlightSpeed] > 0) se->isExplicitlyNotMainStation = YES; // we never want carriers to become main stations.
                }
                // stations used to have STATUS_ACTIVE, they're all STATUS_IN_FLIGHT now.
                if ([se status] != STATUS_COCKPIT_DISPLAY)
                {
                    [se setStatus:STATUS_IN_FLIGHT];
                }
            }
        }
        else
        {
            [entity setUniversalID:NO_TARGET];
            if ([entity isVisualEffect])
            {
                ve = (OOVisualEffectEntity *)entity;
                if ([ve isBeacon])
                {
                    [self setNextBeacon:ve];
                }
            }
            else if ([entity isWaypoint])
            {
                wp = (OOWaypointEntity *)entity;
                if ([wp isBeacon])
                {
                    [self setNextBeacon:wp];
                }
            }
        }
        
        // lighting considerations
        entity->isSunlit = YES;
        entity->shadingEntityID = NO_TARGET;
        
        // add it to the universe
        [entities addObject:entity];
        [entity wasAddedToUniverse];
        
        // maintain sorted list (and for the scanner relative position)
        HPVector entity_pos = entity->position;
        HPVector delta = HPvector_between(entity_pos, PLAYER->position);
        double z_distance = HPmagnitude2(delta);
        entity->zero_distance = z_distance;
        unsigned index = n_entities;
        sortedEntities[index] = entity;
        entity->zero_index = index;
        while ((index > 0)&&(z_distance < sortedEntities[index - 1]->zero_distance))    // bubble into place
        {
            sortedEntities[index] = sortedEntities[index - 1];
            sortedEntities[index]->zero_index = index;
            index--;
            sortedEntities[index] = entity;
            entity->zero_index = index;
        }
        
        // increase n_entities...
        n_entities++;
        
        // add entity to linked lists
        [entity addToLinkedLists];  // position and universe have been set - so we can do this
        if ([entity canCollide])    // filter only collidables disappearing
        {
            doLinkedListMaintenanceThisUpdate = YES;
        }
        
        if ([entity isWormhole])
        {
            [activeWormholes addObject:entity];
        }
        else if ([entity isPlanet])
        {
            [allPlanets addObject:entity];
        }
        else if ([entity isShip])
        {
            [[se getAI] setOwner:se];
            [[se getAI] setState:@"GLOBAL"];
            if ([entity isStation])
            {
                [allStations addObject:entity];
            }
        }
        
        return YES;
    }
    return NO;
}

References Entity::addToLinkedLists, entities, kOOLogEntityVerificationError, kOOLogEntityVerificationRebuild, n_entities, nil, OOExtraLog, x_list_start, Entity::x_next, Entity::x_previous, y_list_start, Entity::y_next, Entity::y_previous, z_list_start, Entity::z_next, and Entity::z_previous.

Here is the call graph for this function:

addLaserHitEffectsAt:against:damage:color:

- (void) addLaserHitEffectsAt:		(HPVector)	pos
against:		(ShipEntity *)	target
damage:		(float)	damage
color:		(OOColor *)	color

Definition at line 5364 of file Universe.m.

                             :(HPVector)pos against:(ShipEntity *)target damage:(float)damage color:(OOColor *)color
{
    // low energy, start getting small surface explosions
    if ([target showDamage] && [target energy] < [target maxEnergy]/2)
    {
        NSString *key = (randf() < 0.5) ? @"oolite-hull-spark" : @"oolite-hull-spark-b";
        NSDictionary *settings = [UNIVERSE explosionSetting:key];
        OOExplosionCloudEntity* burst = [OOExplosionCloudEntity explosionCloudFromEntity:target withSettings:settings];
        [burst setPosition:pos];
        [self addEntity: burst];
        if ([target energy] * randf() < damage)
        {
            ShipEntity *wreck = [self addWreckageFrom:target withRole:@"oolite-wreckage-chunk" at:pos scale:0.05 lifetime:(125.0+(randf()*200.0))];
            if (wreck)
            {
                Vector direction = HPVectorToVector(HPvector_normal(HPvector_subtract(pos,[target position])));
                [wreck setVelocity:vector_add([wreck velocity],vector_multiply_scalar(direction,10+20*randf()))];
            }
        }
    }
    else
    {
        [self addEntity:[OOFlashEffectEntity laserFlashWithPosition:pos velocity:[target velocity] color:color]];
    }
}

addMessage:forCount:

- (void) addMessage:		(NSString *)	text
forCount:		(OOTimeDelta)	count

Definition at line 6447 of file Universe.m.

                   :(NSString *)text forCount:(OOTimeDelta)count
{
    [self addMessage:text forCount:count forceDisplay:NO];
}

addMessage:forCount:forceDisplay:

- (void) addMessage:		(NSString *)	text
forCount:		(OOTimeDelta)	count
forceDisplay:		(BOOL)	forceDisplay

Definition at line 6447 of file Universe.m.

                   :(NSString *) text forCount:(OOTimeDelta) count forceDisplay:(BOOL) forceDisplay
{
    if (![currentMessage isEqual:text] || forceDisplay || universal_time >= messageRepeatTime)
    {
        if ([PLAYER isSpeechOn] == OOSPEECHSETTINGS_ALL)
        {
            [self speakWithSubstitutions:text];
        }
        
        [self showGUIMessage:text withScroll:YES andColor:[message_gui textColor] overDuration:count];
 
        [PLAYER doScriptEvent:OOJSID("consoleMessageReceived") withArgument:text];
                
        [currentMessage release];
        currentMessage = [text retain];
        messageRepeatTime=universal_time + 6.0;
    }
}

addNumericRefsInString:toGraphViz:fromNode:nodeCount:

- (void) addNumericRefsInString: (NSString *) string toGraphViz: (NSMutableString *) graphViz fromNode: (NSString *) fromNode nodeCount: (NSUInteger) nodeCount

implementation

Provided by category Universe(OOPrivate).

Definition at line 10697 of file Universe.m.

                               :(NSString *)string toGraphViz:(NSMutableString *)graphViz fromNode:(NSString *)fromNode nodeCount:(NSUInteger)nodeCount
{
    NSString                    *index = nil;
    NSInteger                   start, end;
    NSRange                     remaining, subRange;
    unsigned                    i;
    
    remaining = NSMakeRange(0, [string length]);
    
    for (;;)
    {
        subRange = [string rangeOfString:@"[" options:NSLiteralSearch range:remaining];
        if (subRange.location == NSNotFound)  break;
        start = subRange.location + subRange.length;
        remaining.length -= start - remaining.location;
        remaining.location = start;
        
        subRange = [string rangeOfString:@"]" options:NSLiteralSearch range:remaining];
        if (subRange.location == NSNotFound)  break;
        end = subRange.location;
        remaining.length -= end - remaining.location;
        remaining.location = end;
        
        index = [string substringWithRange:NSMakeRange(start, end - start)];
        i = [index intValue];
        
        // Each node gets a colour for its incoming edges. The multiplication and mod shuffle them to avoid adjacent nodes having similar colours.
        [graphViz appendFormat:@"\t%@ -> n%u_0 [color=\"%f,0.75,0.8\" lhead=cluster_%u]\n", fromNode, i, ((float)(i * 511 % nodeCount)) / ((float)nodeCount), i];
    }
    
    if ([string rangeOfString:@"%I"].location != NSNotFound)
    {
        [graphViz appendFormat:@"\t%@ -> percent_I [color=\"0,0,0.25\"]\n", fromNode];
    }
    if ([string rangeOfString:@"%H"].location != NSNotFound)
    {
        [graphViz appendFormat:@"\t%@ -> percent_H [color=\"0,0,0.45\"]\n", fromNode];
    }
    if ([string rangeOfString:@"%R"].location != NSNotFound || [string rangeOfString:@"%N"].location != NSNotFound)
    {
        [graphViz appendFormat:@"\t%@ -> percent_RN [color=\"0,0,0.65\"]\n", fromNode];
    }
    
    // TODO: test graphViz output for @"%Jxxx" and @"%Gxxxxxx"
    if ([string rangeOfString:@"%J"].location != NSNotFound)
    {
        [graphViz appendFormat:@"\t%@ -> percent_J [color=\"0,0,0.75\"]\n", fromNode];
    }
    
    if ([string rangeOfString:@"%G"].location != NSNotFound)
    {
        [graphViz appendFormat:@"\t%@ -> percent_G [color=\"0,0,0.85\"]\n", fromNode];
    }
}

addShipAt:withRole:withinRadius:

- (ShipEntity *) addShipAt:		(HPVector)	pos
withRole:		(NSString *)	role
withinRadius:		(GLfloat)	radius

Definition at line 273 of file Universe.m.

                          :(HPVector)pos withRole:(NSString *)role withinRadius:(GLfloat)radius
{
    OOJS_PROFILE_ENTER
    
    // minimise the time between creating ship & assigning position.
    if (radius == NSNotFound)
    {
        GLfloat scalar = 1.0;
        [self coordinatesForPosition:pos withCoordinateSystem:@"abs" returningScalar:&scalar];
        //  randomise
        GLfloat rfactor = scalar;
        if (rfactor > SCANNER_MAX_RANGE)
            rfactor = SCANNER_MAX_RANGE;
        if (rfactor < 1000)
            rfactor = 1000;
        pos.x += rfactor*(randf() - randf());
        pos.y += rfactor*(randf() - randf());
        pos.z += rfactor*(randf() - randf());
    }
    else
    {
        pos = HPvector_add(pos, OOHPVectorRandomSpatial(radius));
    }
    
    ShipEntity          *ship = [self newShipWithRole:role]; // is retained
    BOOL                success = NO;
    
    if (ship != nil)
    {
        [ship setPosition:pos];
        if ([ship hasRole:@"cargopod"]) [self fillCargopodWithRandomCargo:ship];
        OOScanClass scanClass = [ship scanClass];
        if (scanClass == CLASS_NOT_SET)
        {
            scanClass = CLASS_NEUTRAL;
            [ship setScanClass:scanClass];
        }
        
        if ([ship crew] == nil && ![ship isUnpiloted])
        {
            [ship setCrew:[NSArray arrayWithObject:
                [OOCharacter randomCharacterWithRole:role
                andOriginalSystem:Ranrot() & 255]]];
        }
        
        [ship setOrientation:OORandomQuaternion()];
        
        BOOL trader = [role isEqualToString:@"trader"];
        if (trader)
        {
            // half of traders created anywhere will now have cargo. 
            if (randf() > 0.5f)
            {
                [ship setCargoFlag:(randf() < 0.66f ? CARGO_FLAG_FULL_PLENTIFUL : CARGO_FLAG_FULL_SCARCE)]; // most of them will carry the cargo produced in-system.
            }
            
            uint8_t pendingEscortCount = [ship pendingEscortCount];
            if (pendingEscortCount > 0)
            {
                OOGovernmentID government = [[self currentSystemData] oo_unsignedCharForKey:KEY_GOVERNMENT];
                if ((Ranrot() % 7) < government)    // remove escorts if we feel safe
                {
                    int nx = pendingEscortCount - 2 * (1 + (Ranrot() & 3)); // remove 2,4,6, or 8 escorts
                    [ship setPendingEscortCount:(nx > 0) ? nx : 0];
                }
            }
        }
        
        if (HPdistance([self getWitchspaceExitPosition], pos) > SCANNER_MAX_RANGE)
        {
            // nothing extra to do
            success = [self addEntity:ship];    // STATUS_IN_FLIGHT, AI state GLOBAL - ship is retained globally            
        }
        else    // witchspace incoming traders & pirates need extra settings.
        {
            if (trader)
            {
                [ship setCargoFlag:CARGO_FLAG_FULL_SCARCE];
                if ([ship hasRole:@"sunskim-trader"] && randf() < 0.25) 
                {
                    [ship setCargoFlag:CARGO_FLAG_FULL_PLENTIFUL];
                    [self makeSunSkimmer:ship andSetAI:YES];
                }
                else
                {
                    [ship switchAITo:@"oolite-traderAI.js"];
                }
            }
            else if ([role isEqual:@"pirate"])
            {
                [ship setBounty:(Ranrot() & 7) + (Ranrot() & 7) + ((randf() < 0.05)? 63 : 23) withReason:kOOLegalStatusReasonSetup];    // they already have a price on their heads
            }
            
            // Status changes inside the following call: AI state GLOBAL, then STATUS_EXITING_WITCHSPACE, 
            // with the EXITED_WITCHSPACE message sent to the AI. At last we set STATUS_IN_FLIGHT.
            // Includes addEntity, so ship is retained globally.
            success = [ship witchspaceLeavingEffects];
        }
        
        [ship release];
    }
    return success ? ship : (ShipEntity *)nil;
    
    OOJS_PROFILE_EXIT
}

References DOCKED_ILLUM_LEVEL.

addShips:withRole:atPosition:withCoordinateSystem:

- (BOOL) addShips:		(int)	howMany
withRole:		(NSString *)	desc
atPosition:		(HPVector)	pos
withCoordinateSystem:		(NSString *)	system

Definition at line 273 of file Universe.m.

                 :(int) howMany withRole:(NSString *) desc atPosition:(HPVector) pos withCoordinateSystem:(NSString *) system
{
    // initial bounding box
    GLfloat scalar = 1.0;
    HPVector launchPos = [self coordinatesForPosition:pos withCoordinateSystem:system returningScalar:&scalar];
    GLfloat distance_from_center = 0.0;
    HPVector v_from_center, ship_pos;
    HPVector ship_positions[howMany];
    int i = 0;
    int scale_up_after = 0;
    int current_shell = 0;
    GLfloat walk_factor = 2.0;
    while (i < howMany)
    {
        ShipEntity  *ship = [self addShipWithRole:desc launchPos:launchPos rfactor:0.0];
        if (ship == nil) return NO;
        OOScanClass scanClass = [ship scanClass];
        [ship setScanClass:CLASS_NO_DRAW];  // avoid lollipop flash
        
        GLfloat     safe_distance2 = ship->collision_radius * ship->collision_radius * SAFE_ADDITION_FACTOR2;
        BOOL        safe;
        int         limit_count = 8;
        
        v_from_center = kZeroHPVector;
        do
        {
            do
            {
                v_from_center.x += walk_factor * (randf() - 0.5);
                v_from_center.y += walk_factor * (randf() - 0.5);
                v_from_center.z += walk_factor * (randf() - 0.5);   // drunkards walk
            } while ((v_from_center.x == 0.0)&&(v_from_center.y == 0.0)&&(v_from_center.z == 0.0));
            v_from_center = HPvector_normal(v_from_center); // guaranteed non-zero
            
            ship_pos = make_HPvector(   launchPos.x + distance_from_center * v_from_center.x,
                                    launchPos.y + distance_from_center * v_from_center.y,
                                    launchPos.z + distance_from_center * v_from_center.z);
            
            // check this position against previous ship positions in this shell
            safe = YES;
            int j = i - 1;
            while (safe && (j >= current_shell))
            {
                safe = (safe && (HPdistance2(ship_pos, ship_positions[j]) > safe_distance2));
                j--;
            }
            if (!safe)
            {
                limit_count--;
                if (!limit_count)   // give up and expand the shell
                {
                    limit_count = 8;
                    distance_from_center += sqrt(safe_distance2);   // expand to the next distance
                }
            }
            
        } while (!safe);
        
        [ship setPosition:ship_pos];
        [ship setScanClass:scanClass == CLASS_NOT_SET ? CLASS_NEUTRAL : scanClass];
        
        Quaternion qr;
        quaternion_set_random(&qr);
        [ship setOrientation:qr];
        
        // [self addEntity:ship];   // STATUS_IN_FLIGHT, AI state GLOBAL
        
        ship_positions[i] = ship_pos;
        i++;
        if (i > scale_up_after)
        {
            current_shell = i;
            scale_up_after += 1 + 2 * i;
            distance_from_center += sqrt(safe_distance2);   // fill the next shell
        }
    }
    return YES;
}

addShips:withRole:intoBoundingBox:

- (BOOL) addShips:		(int)	howMany
withRole:		(NSString *)	desc
intoBoundingBox:		(BoundingBox)	bbox

Definition at line 273 of file Universe.m.

                 :(int) howMany withRole:(NSString *) desc intoBoundingBox:(BoundingBox) bbox
{
    if (howMany < 1)
        return YES;
    if (howMany > 1)
    {
        // divide the number of ships in two
        int h0 = howMany / 2;
        int h1 = howMany - h0;
        // split the bounding box into two along its longest dimension
        GLfloat lx = bbox.max.x - bbox.min.x;
        GLfloat ly = bbox.max.y - bbox.min.y;
        GLfloat lz = bbox.max.z - bbox.min.z;
        BoundingBox bbox0 = bbox;
        BoundingBox bbox1 = bbox;
        if ((lx > lz)&&(lx > ly))   // longest dimension is x
        {
            bbox0.min.x += 0.5 * lx;
            bbox1.max.x -= 0.5 * lx;
        }
        else
        {
            if (ly > lz)    // longest dimension is y
            {
                bbox0.min.y += 0.5 * ly;
                bbox1.max.y -= 0.5 * ly;
            }
            else            // longest dimension is z
            {
                bbox0.min.z += 0.5 * lz;
                bbox1.max.z -= 0.5 * lz;
            }
        }
        // place half the ships into each bounding box
        return ([self addShips: h0 withRole: desc intoBoundingBox: bbox0] && [self addShips: h1 withRole: desc intoBoundingBox: bbox1]);
    }
    
    //  randomise within the bounding box (biased towards the center of the box)
    HPVector pos = make_HPvector(bbox.min.x, bbox.min.y, bbox.min.z);
    pos.x += 0.5 * (randf() + randf()) * (bbox.max.x - bbox.min.x);
    pos.y += 0.5 * (randf() + randf()) * (bbox.max.y - bbox.min.y);
    pos.z += 0.5 * (randf() + randf()) * (bbox.max.z - bbox.min.z);
    
    return ([self addShipWithRole:desc launchPos:pos rfactor:0.0] != nil);
}

addShips:withRole:nearPosition:withCoordinateSystem:

- (BOOL) addShips:		(int)	howMany
withRole:		(NSString *)	desc
nearPosition:		(HPVector)	pos
withCoordinateSystem:		(NSString *)	system

Definition at line 273 of file Universe.m.

                 :(int) howMany withRole:(NSString *) desc nearPosition:(HPVector) pos withCoordinateSystem:(NSString *) system
{
    // initial bounding box
    GLfloat scalar = 1.0;
    HPVector launchPos = [self coordinatesForPosition:pos withCoordinateSystem:system returningScalar:&scalar];
    GLfloat rfactor = scalar;
    if (rfactor > SCANNER_MAX_RANGE)
        rfactor = SCANNER_MAX_RANGE;
    if (rfactor < 1000)
        rfactor = 1000;
    BoundingBox launch_bbox;
    bounding_box_reset_to_vector(&launch_bbox, make_vector(launchPos.x - rfactor, launchPos.y - rfactor, launchPos.z - rfactor));
    bounding_box_add_xyz(&launch_bbox, launchPos.x + rfactor, launchPos.y + rfactor, launchPos.z + rfactor);
    
    return [self addShips: howMany withRole: desc intoBoundingBox: launch_bbox];
}

addShips:withRole:nearPosition:withCoordinateSystem:withinRadius:

- (BOOL) addShips:		(int)	howMany
withRole:		(NSString *)	desc
nearPosition:		(HPVector)	pos
withCoordinateSystem:		(NSString *)	system
withinRadius:		(GLfloat)	radius

Definition at line 273 of file Universe.m.

                 :(int) howMany withRole:(NSString *) desc nearPosition:(HPVector) pos withCoordinateSystem:(NSString *) system withinRadius:(GLfloat) radius
{
    // initial bounding box
    GLfloat scalar = 1.0;
    HPVector launchPos = [self coordinatesForPosition:pos withCoordinateSystem:system returningScalar:&scalar];
    GLfloat rfactor = radius;
    if (rfactor < 1000)
        rfactor = 1000;
    BoundingBox launch_bbox;
    bounding_box_reset_to_vector(&launch_bbox, make_vector(launchPos.x - rfactor, launchPos.y - rfactor, launchPos.z - rfactor));
    bounding_box_add_xyz(&launch_bbox, launchPos.x + rfactor, launchPos.y + rfactor, launchPos.z + rfactor);
    
    return [self addShips: howMany withRole: desc intoBoundingBox: launch_bbox];
}

addShipsAt:withRole:quantity:withinRadius:asGroup:

- (NSArray *) addShipsAt:		(HPVector)	pos
withRole:		(NSString *)	role
quantity:		(unsigned)	count
withinRadius:		(GLfloat)	radius
asGroup:		(BOOL)	isGroup

Definition at line 273 of file Universe.m.

                        :(HPVector)pos withRole:(NSString *)role quantity:(unsigned)count withinRadius:(GLfloat)radius asGroup:(BOOL)isGroup
{
    OOJS_PROFILE_ENTER
    
    NSMutableArray      *ships = [NSMutableArray arrayWithCapacity:count];
    ShipEntity          *ship = nil;
    OOShipGroup         *group = nil;
    
    if (isGroup)
    {
        group = [OOShipGroup groupWithName:[NSString stringWithFormat:@"%@ group", role]];
    }
    
    while (count--)
    {
        ship = [self addShipAt:pos withRole:role withinRadius:radius];
        if (ship != nil)
        {
            // TODO: avoid collisions!!!
            if (isGroup) [ship setGroup:group];
            [ships addObject:ship];
        }
    }
    
    if ([ships count] == 0) return nil;
    
    return [[ships copy] autorelease];
    
    OOJS_PROFILE_EXIT
}

addShipsToRoute:withRole:quantity:routeFraction:asGroup:

- (NSArray *) addShipsToRoute:		(NSString *)	route
withRole:		(NSString *)	role
quantity:		(unsigned)	count
routeFraction:		(double)	routeFraction
asGroup:		(BOOL)	isGroup

Definition at line 273 of file Universe.m.

                             :(NSString *)route withRole:(NSString *)role quantity:(unsigned)count routeFraction:(double)routeFraction asGroup:(BOOL)isGroup
{
    NSMutableArray          *ships = [NSMutableArray arrayWithCapacity:count];
    ShipEntity              *ship = nil;
    Entity<OOStellarBody>   *entity = nil;
    HPVector                    pos = kZeroHPVector, direction = kZeroHPVector, point0 = kZeroHPVector, point1 = kZeroHPVector;
    double                  radius = 0;
    
    if ([route isEqualToString:@"pw"] || [route isEqualToString:@"sw"] || [route isEqualToString:@"ps"])
    {
        routeFraction = 1.0f - routeFraction; 
    }
    
    // which route is it?
    if ([route isEqualTo:@"wp"] || [route isEqualTo:@"pw"])
    {
        point0 = [self getWitchspaceExitPosition];
        entity = [self planet];
        if (entity == nil)  return nil;
        point1 = [entity position];
        radius = [entity radius];
    }
    else if ([route isEqualTo:@"ws"] || [route isEqualTo:@"sw"])
    {
        point0 = [self getWitchspaceExitPosition];
        entity = [self sun];
        if (entity == nil)  return nil;
        point1 = [entity position];
        radius = [entity radius];
    }
    else if ([route isEqualTo:@"sp"] || [route isEqualTo:@"ps"])
    {
        entity = [self sun];
        if (entity == nil)  return nil;
        point0 = [entity position];
        double radius0 = [entity radius];
        
        entity = [self planet];
        if (entity == nil)  return nil;
        point1 = [entity position];
        radius = [entity radius];
        
        // shorten the route by scanner range & sun radius, otherwise ships could be created inside it.
        direction = HPvector_normal(HPvector_subtract(point0, point1));
        point0 = HPvector_subtract(point0, HPvector_multiply_scalar(direction, radius0 + SCANNER_MAX_RANGE * 1.1f));
    }
    else if ([route isEqualTo:@"st"])
    {
        point0 = [self getWitchspaceExitPosition];
        if ([self station] == nil)  return nil;
        point1 = [[self station] position];
        radius = [[self station] collisionRadius];
    }
    else return nil;    // no route specifier? We shouldn't be here!
    
    // shorten the route by scanner range & radius, otherwise ships could be created inside the route destination.
    direction = HPvector_normal(HPvector_subtract(point1, point0));
    point1 = HPvector_subtract(point1, HPvector_multiply_scalar(direction, radius + SCANNER_MAX_RANGE * 1.1f));
    
    pos = [self fractionalPositionFrom:point0 to:point1 withFraction:routeFraction];
    if(isGroup)
    {   
        return [self addShipsAt:pos withRole:role quantity:count withinRadius:(SCANNER_MAX_RANGE / 10.0f) asGroup:YES];
    }
    else
    {
        while (count--)
        {
            ship = [self addShipAt:pos withRole:role withinRadius:0]; // no radius because pos is already randomised with SCANNER_MAX_RANGE.
            if (ship != nil) [ships addObject:ship];
            if (count > 0) pos = [self fractionalPositionFrom:point0 to:point1 withFraction:routeFraction];
        }
        
        if ([ships count] == 0) return nil;
    }
    
    return [[ships copy] autorelease];
}

addShipWithRole:launchPos:rfactor:

- (ShipEntity *) addShipWithRole: (NSString *) desc launchPos: (HPVector) launchPos rfactor: (GLfloat) rfactor

implementation

Definition at line 273 of file Universe.m.

                                :(NSString *)desc launchPos:(HPVector)launchPos rfactor:(GLfloat)rfactor
{
    if (rfactor != 0.0)
    {
        // Calculate the position as soon as possible, to minimise 'lollipop flash'
        launchPos.x += 2 * rfactor * (randf() - 0.5);
        launchPos.y += 2 * rfactor * (randf() - 0.5);
        launchPos.z += 2 * rfactor * (randf() - 0.5);
    }
    
    ShipEntity  *ship = [self newShipWithRole:desc];   // retain count = 1
    
    if (ship)
    {
        [ship setPosition:launchPos];   // minimise 'lollipop flash'
        
        // Deal with scripted cargopods and ensure they are filled with something.
        if ([ship hasRole:@"cargopod"])  [self fillCargopodWithRandomCargo:ship];
        
        // Ensure piloted ships have pilots.
        if (![ship crew] && ![ship isUnpiloted])
            [ship setCrew:[NSArray arrayWithObject:
                           [OOCharacter randomCharacterWithRole:desc
                                              andOriginalSystem:Ranrot() & 255]]];
        
        if ([ship scanClass] == CLASS_NOT_SET)
        {
            [ship setScanClass: CLASS_NEUTRAL];
        }
        [self addEntity:ship];  // STATUS_IN_FLIGHT, AI state GLOBAL
        [ship release];
        return ship;
    }
    return nil;
}

addShipWithRole:nearPosition:withCoordinateSystem:

- (BOOL) addShipWithRole:		(NSString *)	desc
nearPosition:		(HPVector)	pos
withCoordinateSystem:		(NSString *)	system

Definition at line 273 of file Universe.m.

                        :(NSString *) desc nearPosition:(HPVector) pos withCoordinateSystem:(NSString *) system
{
    // initial position
    GLfloat scalar = 1.0;
    HPVector launchPos = [self coordinatesForPosition:pos withCoordinateSystem:system returningScalar:&scalar];
    //  randomise
    GLfloat rfactor = scalar;
    if (rfactor > SCANNER_MAX_RANGE)
        rfactor = SCANNER_MAX_RANGE;
    if (rfactor < 1000)
        rfactor = 1000;
    
    return ([self addShipWithRole:desc launchPos:launchPos rfactor:rfactor] != nil);
}

addShipWithRole:nearRouteOneAt:

- (void) addShipWithRole:		(NSString *)	desc
nearRouteOneAt:		(double)	route_fraction

Definition at line 273 of file Universe.m.

                        :(NSString *) desc nearRouteOneAt:(double) route_fraction
{
    // adds a ship within scanner range of a point on route 1
    
    Entity  *theStation = [self station];
    if (!theStation)
    {
        return;
    }
    
    HPVector    launchPos = OOHPVectorInterpolate([self getWitchspaceExitPosition], [theStation position], route_fraction);
    
    [self addShipWithRole:desc launchPos:launchPos rfactor:SCANNER_MAX_RANGE];
}

addVisualEffectAt:withKey:

- (OOVisualEffectEntity *) addVisualEffectAt:		(HPVector)	pos
withKey:		(NSString *)	key

Definition at line 273 of file Universe.m.

                                            :(HPVector)pos withKey:(NSString *)key
{
    OOJS_PROFILE_ENTER
    
    // minimise the time between creating ship & assigning position.
    
    OOVisualEffectEntity        *vis = [self newVisualEffectWithName:key]; // is retained
    BOOL                success = NO;
    if (vis != nil)
    {
        [vis setPosition:pos];
        [vis setOrientation:OORandomQuaternion()];
        
        success = [self addEntity:vis]; // retained globally now
        
        [vis release];
    }
    return success ? vis : (OOVisualEffectEntity *)nil;
    
    OOJS_PROFILE_EXIT
}

addWitchspaceJumpEffectForShip:

- (void) addWitchspaceJumpEffectForShip:

(ShipEntity *)

ship

Definition at line 273 of file Universe.m.

                                       :(ShipEntity *)ship
{
    // don't add rings when system is being populated
    if ([PLAYER status] != STATUS_ENTERING_WITCHSPACE && [PLAYER status] != STATUS_EXITING_WITCHSPACE)
    {
        [self addEntity:[OORingEffectEntity ringFromEntity:ship]];
        [self addEntity:[OORingEffectEntity shrinkingRingFromEntity:ship]];
    }
}

addWreckageFrom:withRole:at:scale:lifetime:

- (ShipEntity *) addWreckageFrom:		(ShipEntity *)	ship
withRole:		(NSString *)	wreckRole
at:		(HPVector)	rpos
scale:		(GLfloat)	scale
lifetime:		(GLfloat)	lifetime

Definition at line 5364 of file Universe.m.

                               :(ShipEntity *)ship withRole:(NSString *)wreckRole at:(HPVector)rpos scale:(GLfloat)scale lifetime:(GLfloat)lifetime
{
    ShipEntity* wreck = [UNIVERSE newShipWithRole:wreckRole];   // retain count = 1
    Quaternion q;
    if (wreck)
    {
        GLfloat expected_mass = 0.1f * [ship mass] * (0.75 + 0.5 * randf());
        GLfloat wreck_mass = [wreck mass];
        GLfloat scale_factor = powf(expected_mass / wreck_mass, 0.33333333f) * scale;   // cube root of volume ratio
        [wreck rescaleBy:scale_factor writeToCache:NO];
 
        [wreck setPosition:rpos];
 
        [wreck setVelocity:[ship velocity]];
 
        quaternion_set_random(&q);
        [wreck setOrientation:q];
                            
        [wreck setTemperature: 1000.0];     // take 1000e heat damage per second
        [wreck setHeatInsulation: 1.0e7];   // very large! so it won't cool down
        [wreck setEnergy: lifetime];
                            
        [wreck setIsWreckage:YES];
 
        [UNIVERSE addEntity:wreck]; // STATUS_IN_FLIGHT, AI state GLOBAL
        [wreck performTumble];
        //  [wreck rescaleBy: 1.0/scale_factor];
        [wreck release];
    }
    return wreck;
}

airResistanceFactor

- (GLfloat) airResistanceFactor

allShipsDoScriptEvent:andReactToAIMessage:

- (void) allShipsDoScriptEvent:		(jsid)	event
andReactToAIMessage:		(NSString *)	message

Definition at line 9471 of file Universe.m.

                              :(jsid)event andReactToAIMessage:(NSString *)message
{
    int i;
    int ent_count = n_entities;
    int ship_count = 0;
    ShipEntity* my_ships[ent_count];
    for (i = 0; i < ent_count; i++)
    {
        if (sortedEntities[i]->isShip)
        {
            my_ships[ship_count++] = [(ShipEntity *)sortedEntities[i] retain];  // retained
        }
    }
    
    for (i = 0; i < ship_count; i++)
    {
        ShipEntity* se = my_ships[i];
        [se doScriptEvent:event];
        if (message != nil)  [[se getAI] reactToMessage:message context:@"global message"];
        [se release]; //    released
    }
}

ambientLightLevel

- (float) ambientLightLevel

autoMessageLogBg

- (BOOL) autoMessageLogBg

Definition at line 9471 of file Universe.m.

{
    return _autoMessageLogBg;
}

autoSave

- (BOOL) autoSave

autoSaveNow

- (BOOL) autoSaveNow

blockJSPlayerShipProps

- (BOOL) blockJSPlayerShipProps

Definition at line 9471 of file Universe.m.

{
    return gOOJSPlayerIfStale != nil;
}

bloom

- (BOOL) bloom

Definition at line 273 of file Universe.m.

{
    return _bloom && [self detailLevel] >= DETAIL_LEVEL_EXTRAS;
}

breakPatternHide

- (BOOL) breakPatternHide

Definition at line 3616 of file Universe.m.

{
    Entity* player = PLAYER;
    return ((breakPatternCounter > 5)||(!player)||([player status] == STATUS_DOCKING));
}

References Entity::isStation.

breakPatternOver

- (BOOL) breakPatternOver

Definition at line 3616 of file Universe.m.

{
    return (breakPatternCounter == 0);
}

brochureDescriptionWithDictionary:standardEquipment:optionalEquipment:

- (NSString *) brochureDescriptionWithDictionary:		(NSDictionary*)	dict
standardEquipment:		(NSArray*)	extras
optionalEquipment:		(NSArray*)	options

Definition at line 9471 of file Universe.m.

                                                :(NSDictionary *)dict standardEquipment:(NSArray *)extras optionalEquipment:(NSArray *)options
{
    NSMutableArray  *mut_extras = [NSMutableArray arrayWithArray:extras];
    NSString        *allOptions = [options componentsJoinedByString:@" "];
    
    NSMutableString *desc = [NSMutableString stringWithFormat:@"The %@.", [dict oo_stringForKey: KEY_NAME]];
    
    // cargo capacity and expansion
    OOCargoQuantity max_cargo = [dict oo_unsignedIntForKey:@"max_cargo"];
    if (max_cargo)
    {
        OOCargoQuantity extra_cargo = [dict oo_unsignedIntForKey:@"extra_cargo" defaultValue:15];
        [desc appendFormat:@" Cargo capacity %dt", max_cargo];
        BOOL canExpand = ([allOptions rangeOfString:@"EQ_CARGO_BAY"].location != NSNotFound);
        if (canExpand)
            [desc appendFormat:@" (expandable to %dt at most starports)", max_cargo + extra_cargo];
        [desc appendString:@"."];
    }
    
    // speed
    float top_speed = [dict oo_intForKey:@"max_flight_speed"];
    [desc appendFormat:@" Top speed %.3fLS.", 0.001 * top_speed];
    
    // passenger berths
    if ([mut_extras count])
    {
        unsigned n_berths = 0;
        unsigned i;
        for (i = 0; i < [mut_extras count]; i++)
        {
            NSString* item_key = [mut_extras oo_stringAtIndex:i];
            if ([item_key isEqual:@"EQ_PASSENGER_BERTH"])
            {
                n_berths++;
                [mut_extras removeObjectAtIndex:i--];
            }
        }
        if (n_berths)
        {
            if (n_berths == 1)
                [desc appendString:@" Includes luxury accomodation for a single passenger."];
            else
                [desc appendFormat:@" Includes luxury accomodation for %d passengers.", n_berths];
        }
    }
    
    // standard fittings
    if ([mut_extras count])
    {
        [desc appendString:@"\nComes with"];
        unsigned i, j;
        for (i = 0; i < [mut_extras count]; i++)
        {
            NSString* item_key = [mut_extras oo_stringAtIndex:i];
            NSString* item_desc = nil;
            for (j = 0; ((j < [equipmentData count])&&(!item_desc)) ; j++)
            {
                NSString *eq_type = [[equipmentData oo_arrayAtIndex:j] oo_stringAtIndex:EQUIPMENT_KEY_INDEX];
                if ([eq_type isEqual:item_key])
                    item_desc = [[equipmentData oo_arrayAtIndex:j] oo_stringAtIndex:EQUIPMENT_SHORT_DESC_INDEX];
            }
            if (item_desc)
            {
                switch ([mut_extras count] - i)
                {
                    case 1:
                        [desc appendFormat:@" %@ fitted as standard.", item_desc];
                        break;
                    case 2:
                        [desc appendFormat:@" %@ and", item_desc];
                        break;
                    default:
                        [desc appendFormat:@" %@,", item_desc];
                        break;
                }
            }
        }
    }
    
    // optional fittings
    if ([options count])
    {
        [desc appendString:@"\nCan additionally be outfitted with"];
        unsigned i, j;
        for (i = 0; i < [options count]; i++)
        {
            NSString* item_key = [options oo_stringAtIndex:i];
            NSString* item_desc = nil;
            for (j = 0; ((j < [equipmentData count])&&(!item_desc)) ; j++)
            {
                NSString *eq_type = [[equipmentData oo_arrayAtIndex:j] oo_stringAtIndex:EQUIPMENT_KEY_INDEX];
                if ([eq_type isEqual:item_key])
                    item_desc = [[equipmentData oo_arrayAtIndex:j] oo_stringAtIndex:EQUIPMENT_SHORT_DESC_INDEX];
            }
            if (item_desc)
            {
                switch ([options count] - i)
                {
                    case 1:
                        [desc appendFormat:@" %@ at suitably equipped starports.", item_desc];
                        break;
                    case 2:
                        [desc appendFormat:@" %@ and/or", item_desc];
                        break;
                    default:
                        [desc appendFormat:@" %@,", item_desc];
                        break;
                }
            }
        }
    }
    
    return desc;
}

canInstantiateShip:

- (BOOL) canInstantiateShip: (NSString *) shipKey

implementation

Definition at line 3616 of file Universe.m.

                           :(NSString *)shipKey
{
    NSDictionary            *shipInfo = nil;
    NSArray                 *conditions = nil;
    NSString  *condition_script = nil;
    shipInfo = [[OOShipRegistry sharedRegistry] shipInfoForKey:shipKey];
 
    condition_script = [shipInfo oo_stringForKey:@"condition_script"];
    if (condition_script != nil)
    {
        OOJSScript *condScript = [self getConditionScript:condition_script];
        if (condScript != nil) // should always be non-nil, but just in case
        {
            JSContext           *context = OOJSAcquireContext();
            BOOL OK;
            JSBool allow_instantiation;
            jsval result;
            jsval args[] = { OOJSValueFromNativeObject(context, shipKey) };
            
            OK = [condScript callMethod:OOJSID("allowSpawnShip")
                          inContext:context
                      withArguments:args count:sizeof args / sizeof *args
                             result:&result];
 
            if (OK) OK = JS_ValueToBoolean(context, result, &allow_instantiation);
            
            OOJSRelinquishContext(context);
 
            if (OK && !allow_instantiation)
            {
                /* if the script exists, the function exists, the function
                 * returns a bool, and that bool is false, block
                 * instantiation. Otherwise allow it as default */
                return NO;
            }
        }
    }
 
    conditions = [shipInfo oo_arrayForKey:@"conditions"];
    if (conditions == nil)  return YES;
    
    // Check conditions
    return [PLAYER scriptTestConditions:conditions];
}

cargoPodFromTemplate:

- (ShipEntity *) cargoPodFromTemplate:

(ShipEntity *)

cargoObj

Definition at line 3616 of file Universe.m.

                                     :(ShipEntity *)cargoObj
{
    ShipEntity *container = nil;
    // this is a template container, so we need to make a real one
    OOCommodityType co_type = [cargoObj commodityType];
    OOCargoQuantity co_amount = [UNIVERSE getRandomAmountOfCommodity:co_type];
    if (randf() < 0.5) // stops OXP monopolising pods for commodities
    {
        container = [UNIVERSE newShipWithRole:co_type]; // newShipWithRole returns retained object
    }
    if (container == nil)
    {
        container = [UNIVERSE newShipWithRole:@"cargopod"]; 
    }
    [container setCommodity:co_type andAmount:co_amount];
    return [container autorelease];
}

carryPlayerOn:inWormhole:

- (void) carryPlayerOn:		(StationEntity*)	carrier
inWormhole:		(WormholeEntity*)	wormhole

Definition at line 273 of file Universe.m.

                      :(StationEntity*)carrier inWormhole:(WormholeEntity*)wormhole
{
        PlayerEntity    *player = PLAYER;
        OOSystemID dest = [wormhole destination];
 
        [player setWormhole:wormhole];
        [player addScannedWormhole:wormhole];
        JSContext *context = OOJSAcquireContext();
        [player setJumpCause:@"carried"];
        [player setPreviousSystemID:[player systemID]];
        ShipScriptEvent(context, player, "shipWillEnterWitchspace", STRING_TO_JSVAL(JS_InternString(context, [[player jumpCause] UTF8String])), INT_TO_JSVAL(dest));
        OOJSRelinquishContext(context);
    
        [self allShipsDoScriptEvent:OOJSID("playerWillEnterWitchspace") andReactToAIMessage:@"PLAYER WITCHSPACE"];
 
        [player setRandom_factor:(ranrot_rand() & 255)];                        // random factor for market values is reset
 
// misjump on wormhole sets correct travel time if needed
        [player addToAdjustTime:[wormhole travelTime]];
// clear old entities
        [self removeAllEntitiesExceptPlayer];
 
// should we add wear-and-tear to the player ship if they're not doing
// the jump themselves? Left out for now. - CIM
 
        if (![wormhole withMisjump])
        {
            [player setSystemID:dest];
            [self setSystemTo: dest];
            
            [self setUpSpace];
            [self populateNormalSpace];
            [player setBounty:([player legalStatus]/2) withReason:kOOLegalStatusReasonNewSystem];
            if ([player random_factor] < 8) [player erodeReputation];       // every 32 systems or so, dro
        }
        else
        {
            [player setGalaxyCoordinates:[wormhole destinationCoordinates]];
 
            [self setUpWitchspaceBetweenSystem:[wormhole origin] andSystem:[wormhole destination]];
 
            if (randf() < 0.1) [player erodeReputation];        // once every 10 misjumps - should be much rarer than successful jumps!
        }
        // which will kick the ship out of the wormhole with the
        // player still aboard
        [wormhole disgorgeShips];
 
        //reset atmospherics in case carrier was in atmosphere
        [UNIVERSE setSkyColorRed:0.0f       // back to black
                                             green:0.0f
                                                blue:0.0f
                                             alpha:0.0f];
 
        [self setWitchspaceBreakPattern:YES];
        [player doScriptEvent:OOJSID("shipWillExitWitchspace") withArgument:[player jumpCause]];
        [player doScriptEvent:OOJSID("shipExitedWitchspace") withArgument:[player jumpCause]];
        [player setWormhole:nil];
 
}

characters

- (NSDictionary *) characters

chooseStringForKey:inDictionary:

- (NSString *) chooseStringForKey: (NSString *) key inDictionary: (NSDictionary *) dictionary

implementation

Provided by category Universe(OOPrivate).

Definition at line 10697 of file Universe.m.

                                :(NSString *)key inDictionary:(NSDictionary *)dictionary
{
    id object = [dictionary objectForKey:key];
    if ([object isKindOfClass:[NSString class]])  return object;
    else if ([object isKindOfClass:[NSArray class]] && [object count] > 0)  return [object oo_stringAtIndex:Ranrot() % [object count]];
    return nil;
}

clearBeacon:

- (void) clearBeacon:

(Entity <OOBeaconEntity> *)

beaconShip

Definition at line 3616 of file Universe.m.

                    :(Entity <OOBeaconEntity> *) beaconShip
{
    Entity <OOBeaconEntity>             *tmp = nil;
 
    if ([beaconShip isBeacon])
    {
        if ([self firstBeacon] == beaconShip)
        {
            tmp = [[beaconShip nextBeacon] nextBeacon];
            [self setFirstBeacon:[beaconShip nextBeacon]];
            [[beaconShip prevBeacon] setNextBeacon:tmp];
        }
        else if ([self lastBeacon] == beaconShip)
        {
            tmp = [[beaconShip prevBeacon] prevBeacon];
            [self setLastBeacon:[beaconShip prevBeacon]];
            [[beaconShip nextBeacon] setPrevBeacon:tmp];
        }
        else
        {
            [[beaconShip nextBeacon] setPrevBeacon:[beaconShip prevBeacon]];
            [[beaconShip prevBeacon] setNextBeacon:[beaconShip nextBeacon]];
        }
        [beaconShip setBeaconCode:nil];
    }
}

clearGUIs

- (void) clearGUIs

Definition at line 9471 of file Universe.m.

{
    [gui clear];
    [message_gui clear];
    [comm_log_gui clear];
    [comm_log_gui printLongText:DESC(@"communications-log-string")
                          align:GUI_ALIGN_CENTER color:[OOColor yellowColor] fadeTime:0 key:nil addToArray:nil];
}

clearPreviousMessage

- (void) clearPreviousMessage

Definition at line 6447 of file Universe.m.

{
    if (currentMessage) [currentMessage release];
    currentMessage = nil;
}

clearSystemPopulator

- (void) clearSystemPopulator

Definition at line 273 of file Universe.m.

{
    [populatorSettings release];
    populatorSettings = [[NSMutableDictionary alloc] initWithCapacity:128];
}

collisionDescription

- (NSString *) collisionDescription

Definition at line 6447 of file Universe.m.

{
    if (universeRegion != nil)  return [universeRegion collisionDescription];
    else  return @"-";
}

colorblindMode

- (int) colorblindMode

Definition at line 273 of file Universe.m.

{
    return _colorblindMode;
}

commLogGUI

- (GuiDisplayGen *) commLogGUI

Definition at line 9471 of file Universe.m.

{
    return comm_log_gui;
}

commodities

- (OOCommodities *) commodities

commodityDataForType:

- (NSDictionary *) commodityDataForType:

(OOCommodityType)

type

Definition at line 3616 of file Universe.m.

                                      :(OOCommodityType)type
{
    return [commodityMarket definitionForGood:type];
}

commodityMarket

- (OOCommodityMarket *) commodityMarket

compareName

+ (static OOComparisonResult) compareName (id) dict1 (id) dict2 (void *) context

implementation

Definition at line 9456 of file Universe.m.

{
    NSDictionary    *ship1 = [(NSDictionary *)dict1 oo_dictionaryForKey:SHIPYARD_KEY_SHIP];
    NSDictionary    *ship2 = [(NSDictionary *)dict2 oo_dictionaryForKey:SHIPYARD_KEY_SHIP];
    NSString        *name1 = [ship1 oo_stringForKey:KEY_NAME];
    NSString        *name2 = [ship2 oo_stringForKey:KEY_NAME];
    
    NSComparisonResult result = [[name1 lowercaseString] compare:[name2 lowercaseString]];
    if (result != NSOrderedSame)
        return result;
    else
        return comparePrice(dict1, dict2, context);
}

References comparePrice().

Here is the call graph for this function:

comparePrice

+ (static OOComparisonResult) comparePrice (id) dict1 (id) dict2 (void *) context

implementation

Definition at line 9471 of file Universe.m.

{
    NSNumber        *price1 = [(NSDictionary *)dict1 objectForKey:SHIPYARD_KEY_PRICE];
    NSNumber        *price2 = [(NSDictionary *)dict2 objectForKey:SHIPYARD_KEY_PRICE];
    
    return [price1 compare:price2];
}

coordinatesForPosition:withCoordinateSystem:returningScalar:

- (HPVector) coordinatesForPosition:		(HPVector)	pos
withCoordinateSystem:		(NSString *)	system
returningScalar:		(GLfloat*)	my_scalar

Definition at line 273 of file Universe.m.

                                   :(HPVector) pos withCoordinateSystem:(NSString *) system returningScalar:(GLfloat*) my_scalar
{
    /*  the point is described using a system selected by a string
        consisting of a three letter code.
        
        The first letter indicates the feature that is the origin of the coordinate system.
            w => witchpoint
            s => sun
            p => planet
            
        The next letter indicates the feature on the 'z' axis of the coordinate system.
            w => witchpoint
            s => sun
            p => planet
            
        Then the 'y' axis of the system is normal to the plane formed by the planet, sun and witchpoint.
        And the 'x' axis of the system is normal to the y and z axes.
        So:
            ps:     z axis = (planet -> sun)        y axis = normal to (planet - sun - witchpoint)  x axis = normal to y and z axes
            pw:     z axis = (planet -> witchpoint) y axis = normal to (planet - witchpoint - sun)  x axis = normal to y and z axes
            sp:     z axis = (sun -> planet)        y axis = normal to (sun - planet - witchpoint)  x axis = normal to y and z axes
            sw:     z axis = (sun -> witchpoint)    y axis = normal to (sun - witchpoint - planet)  x axis = normal to y and z axes
            wp:     z axis = (witchpoint -> planet) y axis = normal to (witchpoint - planet - sun)  x axis = normal to y and z axes
            ws:     z axis = (witchpoint -> sun)    y axis = normal to (witchpoint - sun - planet)  x axis = normal to y and z axes
            
        The third letter denotes the units used:
            m:      meters
            p:      planetary radii
            s:      solar radii
            u:      distance between first two features indicated (eg. spu means that u = distance from sun to the planet)
        
        in interstellar space (== no sun) coordinates are absolute irrespective of the system used.
        
        [1.71] The position code "abs" can also be used for absolute coordinates.
        
    */
    
    NSString* l_sys = [system lowercaseString];
    if ([l_sys length] != 3)
        return kZeroHPVector;
    OOPlanetEntity* the_planet = [self planet];
    OOSunEntity* the_sun = [self sun];
    if (the_planet == nil || the_sun == nil || [l_sys isEqualToString:@"abs"])
    {
        if (my_scalar)  *my_scalar = 1.0;
        return pos;
    }
    HPVector  w_pos = [self getWitchspaceExitPosition]; // don't reset PRNG
    HPVector  p_pos = the_planet->position;
    HPVector  s_pos = the_sun->position;
    
    const char* c_sys = [l_sys UTF8String];
    HPVector p0, p1, p2;
    
    switch (c_sys[0])
    {
        case 'w':
            p0 = w_pos;
            switch (c_sys[1])
            {
                case 'p':
                    p1 = p_pos; p2 = s_pos; break;
                case 's':
                    p1 = s_pos; p2 = p_pos; break;
                default:
                    return kZeroHPVector;
            }
            break;
        case 'p':       
            p0 = p_pos;
            switch (c_sys[1])
            {
                case 'w':
                    p1 = w_pos; p2 = s_pos; break;
                case 's':
                    p1 = s_pos; p2 = w_pos; break;
                default:
                    return kZeroHPVector;
            }
            break;
        case 's':
            p0 = s_pos;
            switch (c_sys[1])
            {
                case 'w':
                    p1 = w_pos; p2 = p_pos; break;
                case 'p':
                    p1 = p_pos; p2 = w_pos; break;
                default:
                    return kZeroHPVector;
            }
            break;
        default:
            return kZeroHPVector;
    }
    HPVector k = HPvector_normal_or_zbasis(HPvector_subtract(p1, p0));  // 'forward'
    HPVector v = HPvector_normal_or_xbasis(HPvector_subtract(p2, p0));  // temporary vector in plane of 'forward' and 'right'
    
    HPVector j = HPcross_product(k, v); // 'up'
    HPVector i = HPcross_product(j, k); // 'right'
    
    GLfloat scale = 1.0;
    switch (c_sys[2])
    {
        case 'p':
            scale = [the_planet radius];
            break;
            
        case 's':
            scale = [the_sun radius];
            break;
            
        case 'u':
            scale = HPmagnitude(HPvector_subtract(p1, p0));
            break;
            
        case 'm':
            scale = 1.0f;
            break;
            
        default:
            return kZeroHPVector;
    }
    if (my_scalar)
        *my_scalar = scale;
    
    // result = p0 + ijk
    HPVector result = p0;   // origin
    result.x += scale * (pos.x * i.x + pos.y * j.x + pos.z * k.x);
    result.y += scale * (pos.x * i.y + pos.y * j.y + pos.z * k.y);
    result.z += scale * (pos.x * i.z + pos.y * j.z + pos.z * k.z);
    
    return result;
}

coordinatesForSystem:

- (NSPoint) coordinatesForSystem:

(OOSystemID)

s

Definition at line 7996 of file Universe.m.

                                :(OOSystemID)s
{
    return [systemManager getCoordinatesForSystem:s inGalaxy:galaxyID];
}

References OOLogERR.

coordinatesFromCoordinateSystemString:

- (HPVector) coordinatesFromCoordinateSystemString:

(NSString *)

system_x_y_z

Definition at line 273 of file Universe.m.

                                                  :(NSString *) system_x_y_z
{
    NSArray* tokens = ScanTokensFromString(system_x_y_z);
    if ([tokens count] != 4)
    {
        // Not necessarily an error.
        return make_HPvector(0,0,0);
    }
    GLfloat dummy;
    return [self coordinatesForPosition:make_HPvector([tokens oo_floatAtIndex:1], [tokens oo_floatAtIndex:2], [tokens oo_floatAtIndex:3]) withCoordinateSystem:[tokens oo_stringAtIndex:0] returningScalar:&dummy];
}

countEntitiesMatchingPredicate:parameter:inRange:ofEntity:

- (unsigned) countEntitiesMatchingPredicate:		(EntityFilterPredicate)	predicate
parameter:		(void *)	parameter
inRange:		(double)	range
ofEntity:		(Entity *)	entity

Definition at line 5364 of file Universe.m.

                                           :(EntityFilterPredicate)predicate
                                  parameter:(void *)parameter
                                    inRange:(double)range
                                   ofEntity:(Entity *)e1
{
    unsigned        i, found = 0;
    HPVector            p1;
    double          distance, cr;
    
    if (predicate == NULL)  predicate = YESPredicate;
    
    if (e1 != nil)  p1 = e1->position;
    else  p1 = kZeroHPVector;
    
    for (i = 0; i < n_entities; i++)
    {
        Entity *e2 = sortedEntities[i];
        if (e2 != e1 && predicate(e2, parameter))
        {
            if (range < 0)  distance = -1;  // Negative range means infinity
            else
            {
                cr = range + e2->collision_radius;
                distance = HPdistance2(e2->position, p1) - cr * cr;
            }
            if (distance < 0)
            {
                found++;
            }
        }
    }
    
    return found;
}

countShipsMatchingPredicate:parameter:inRange:ofEntity:

- (unsigned) countShipsMatchingPredicate:		(EntityFilterPredicate)	predicate
parameter:		(void *)	parameter
inRange:		(double)	range
ofEntity:		(Entity *)	entity

Definition at line 5364 of file Universe.m.

                                        :(EntityFilterPredicate)predicate
                               parameter:(void *)parameter
                                 inRange:(double)range
                                ofEntity:(Entity *)entity
{
    if (predicate != NULL)
    {
        BinaryOperationPredicateParameter param =
        {
            IsShipPredicate, NULL,
            predicate, parameter
        };
        
        return [self countEntitiesMatchingPredicate:ANDPredicate
                                          parameter:&param
                                            inRange:range
                                           ofEntity:entity];
    }
    else
    {
        return [self countEntitiesMatchingPredicate:IsShipPredicate
                                          parameter:NULL
                                            inRange:range
                                           ofEntity:entity];
    }
}

countShipsWithPrimaryRole:

- (unsigned) countShipsWithPrimaryRole:

(NSString *)

role

Definition at line 5364 of file Universe.m.

                                      :(NSString *)role
{
    return [self countShipsWithPrimaryRole:role inRange:-1 ofEntity:nil];
}

countShipsWithPrimaryRole:inRange:ofEntity:

- (unsigned) countShipsWithPrimaryRole:		(NSString *)	role
inRange:		(double)	range
ofEntity:		(Entity *)	entity

Definition at line 5364 of file Universe.m.

                                      :(NSString *)role inRange:(double)range ofEntity:(Entity *)entity
{
    return [self countShipsMatchingPredicate:HasPrimaryRolePredicate
                               parameter:role
                                 inRange:range
                                ofEntity:entity];
}

countShipsWithRole:

- (unsigned) countShipsWithRole:

(NSString *)

role

Definition at line 5364 of file Universe.m.

                               :(NSString *)role
{
    return [self countShipsWithRole:role inRange:-1 ofEntity:nil];
}

countShipsWithRole:inRange:ofEntity:

- (unsigned) countShipsWithRole:		(NSString *)	role
inRange:		(double)	range
ofEntity:		(Entity *)	entity

Definition at line 5364 of file Universe.m.

                               :(NSString *)role inRange:(double)range ofEntity:(Entity *)entity
{
    return [self countShipsMatchingPredicate:HasRolePredicate
                               parameter:role
                                 inRange:range
                                ofEntity:entity];
}

countShipsWithScanClass:inRange:ofEntity:

- (unsigned) countShipsWithScanClass:		(OOScanClass)	scanClass
inRange:		(double)	range
ofEntity:		(Entity *)	entity

Definition at line 5364 of file Universe.m.

                                    :(OOScanClass)scanClass inRange:(double)range ofEntity:(Entity *)entity
{
    return [self countShipsMatchingPredicate:HasScanClassPredicate
                               parameter:[NSNumber numberWithInt:scanClass]
                                 inRange:range
                                ofEntity:entity];
}

currentPostFX

- (int) currentPostFX

Definition at line 273 of file Universe.m.

{
    return _currentPostFX;
}

currentSystemData

- (NSDictionary *) currentSystemData

Definition at line 7996 of file Universe.m.

{
    OOJS_PROFILE_ENTER
    
    if (![self inInterstellarSpace])
    {
        return [self generateSystemData:systemID];
    }
    else
    {
        static NSDictionary *interstellarDict = nil;
        if (interstellarDict == nil)
        {
            NSString *interstellarName = DESC(@"interstellar-space");
            NSString *notApplicable = DESC(@"not-applicable");
            NSNumber *minusOne = [NSNumber numberWithInt:-1];
            NSNumber *zero = [NSNumber numberWithInt:0];
            interstellarDict = [[NSDictionary alloc] initWithObjectsAndKeys:
                                interstellarName, KEY_NAME,
                                minusOne, KEY_GOVERNMENT,
                                minusOne, KEY_ECONOMY,
                                minusOne, KEY_TECHLEVEL,
                                zero, KEY_POPULATION,
                                zero, KEY_PRODUCTIVITY,
                                zero, KEY_RADIUS,
                                notApplicable, KEY_INHABITANTS,
                                notApplicable, KEY_DESCRIPTION,
                                nil];
        }
        
        return interstellarDict;
    }
    
    OOJS_PROFILE_EXIT
}

currentSystemID

- (OOSystemID) currentSystemID

Definition at line 6447 of file Universe.m.

{
    return systemID;
}

currentWaypoints

- (NSDictionary *) currentWaypoints

Definition at line 3616 of file Universe.m.

{
    return waypoints;
}

dealloc

- (void) dealloc

implementation

Reimplemented from OOWeakRefObject.

Definition at line 273 of file Universe.m.

{
    gSharedUniverse = nil;
    
    [currentMessage release];
    
    [gui release];
    [message_gui release];
    [comm_log_gui release];
    
    [entities release];
    
    [commodities release];
    
    [_descriptions release];
    [characters release];
    [customSounds release];
    [globalSettings release];
    [systemManager release];
    [missiontext release];
    [equipmentData release];
    [equipmentDataOutfitting release];
    [demo_ships release];
    [autoAIMap release];
    [screenBackgrounds release];
    [gameView release];
    [populatorSettings release];
    [system_repopulator release];
    [allPlanets release];
    [allStations release];
    [explosionSettings release];
    
    [activeWormholes release];              
    [characterPool release];
    [universeRegion release];
    [cargoPods release];
 
    DESTROY(_firstBeacon);
    DESTROY(_lastBeacon);
    DESTROY(waypoints);
    
    unsigned i;
    for (i = 0; i < 256; i++)  [system_names[i] release];
    
    [entitiesDeadThisUpdate release];
    
    [[OOCacheManager sharedCache] flush];
    
#if OOLITE_SPEECH_SYNTH
    [speechArray release];
#if OOLITE_MAC_OS_X
    [speechSynthesizer release];
#elif OOLITE_ESPEAK
    espeak_Cancel();
#endif
#endif
    [conditionScripts release];
 
    [self deleteOpenGLObjects];
    
    [super dealloc];
}

debugDumpEntities

- (void) debugDumpEntities

Definition at line 273 of file Universe.m.

{
    int             i;
    int             show_count = n_entities;
    
    if (!OOLogWillDisplayMessagesInClass(@"universe.objectDump"))  return;
    
    OOLog(@"universe.objectDump", @"DEBUG: Entity Dump - [entities count] = %lu,\tn_entities = %u", [entities count], n_entities);
    
    OOLogIndent();
    for (i = 0; i < show_count; i++)
    {
        OOLog(@"universe.objectDump", @"Ent:%4u  %@", i, [sortedEntities[i] descriptionForObjDump]);
    }
    OOLogOutdent();
    
    if ([entities count] != n_entities)
    {
        OOLog(@"universe.objectDump", @"entities = %@", [entities description]);
    }
}

defaultAIForRole:

- (NSString *) defaultAIForRole:

(NSString *)

role

Definition at line 3616 of file Universe.m.

                              :(NSString *)role
{
    return [autoAIMap oo_stringForKey:role];
}

defineFrustum

- (void) defineFrustum

Definition at line 4630 of file Universe.m.

{
    OOMatrix clip;
    GLfloat   rt;
    
    clip = OOGLGetModelViewProjection();
    
    /* Extract the numbers for the RIGHT plane */
    frustum[0][0] = clip.m[0][3] - clip.m[0][0];
    frustum[0][1] = clip.m[1][3] - clip.m[1][0];
    frustum[0][2] = clip.m[2][3] - clip.m[2][0];
    frustum[0][3] = clip.m[3][3] - clip.m[3][0];
    
    /* Normalize the result */
    rt = 1.0f / sqrt(frustum[0][0] * frustum[0][0] + frustum[0][1] * frustum[0][1] + frustum[0][2] * frustum[0][2]);
    frustum[0][0] *= rt;
    frustum[0][1] *= rt;
    frustum[0][2] *= rt;
    frustum[0][3] *= rt;
    
    /* Extract the numbers for the LEFT plane */
    frustum[1][0] = clip.m[0][3] + clip.m[0][0];
    frustum[1][1] = clip.m[1][3] + clip.m[1][0];
    frustum[1][2] = clip.m[2][3] + clip.m[2][0];
    frustum[1][3] = clip.m[3][3] + clip.m[3][0];
    
    /* Normalize the result */
    rt = 1.0f / sqrt(frustum[1][0] * frustum[1][0] + frustum[1][1] * frustum[1][1] + frustum[1][2] * frustum[1][2]);
    frustum[1][0] *= rt;
    frustum[1][1] *= rt;
    frustum[1][2] *= rt;
    frustum[1][3] *= rt;
 
    /* Extract the BOTTOM plane */
    frustum[2][0] = clip.m[0][3] + clip.m[0][1];
    frustum[2][1] = clip.m[1][3] + clip.m[1][1];
    frustum[2][2] = clip.m[2][3] + clip.m[2][1];
    frustum[2][3] = clip.m[3][3] + clip.m[3][1];
 
    /* Normalize the result */
    rt = 1.0 / sqrt(frustum[2][0] * frustum[2][0] + frustum[2][1] * frustum[2][1] + frustum[2][2] * frustum[2][2]);
    frustum[2][0] *= rt;
    frustum[2][1] *= rt;
    frustum[2][2] *= rt;
    frustum[2][3] *= rt;
 
    /* Extract the TOP plane */
    frustum[3][0] = clip.m[0][3] - clip.m[0][1];
    frustum[3][1] = clip.m[1][3] - clip.m[1][1];
    frustum[3][2] = clip.m[2][3] - clip.m[2][1];
    frustum[3][3] = clip.m[3][3] - clip.m[3][1];
 
    /* Normalize the result */
    rt = 1.0 / sqrt(frustum[3][0] * frustum[3][0] + frustum[3][1] * frustum[3][1] + frustum[3][2] * frustum[3][2]);
    frustum[3][0] *= rt;
    frustum[3][1] *= rt;
    frustum[3][2] *= rt;
    frustum[3][3] *= rt;
 
    /* Extract the FAR plane */
    frustum[4][0] = clip.m[0][3] - clip.m[0][2];
    frustum[4][1] = clip.m[1][3] - clip.m[1][2];
    frustum[4][2] = clip.m[2][3] - clip.m[2][2];
    frustum[4][3] = clip.m[3][3] - clip.m[3][2];
 
    /* Normalize the result */
    rt = sqrt(frustum[4][0] * frustum[4][0] + frustum[4][1] * frustum[4][1] + frustum[4][2] * frustum[4][2]);
    frustum[4][0] *= rt;
    frustum[4][1] *= rt;
    frustum[4][2] *= rt;
    frustum[4][3] *= rt;
 
    /* Extract the NEAR plane */
    frustum[5][0] = clip.m[0][3] + clip.m[0][2];
    frustum[5][1] = clip.m[1][3] + clip.m[1][2];
    frustum[5][2] = clip.m[2][3] + clip.m[2][2];
    frustum[5][3] = clip.m[3][3] + clip.m[3][2];
 
    /* Normalize the result */
    rt = sqrt(frustum[5][0] * frustum[5][0] + frustum[5][1] * frustum[5][1] + frustum[5][2] * frustum[5][2]);
    frustum[5][0] *= rt;
    frustum[5][1] *= rt;
    frustum[5][2] *= rt;
    frustum[5][3] *= rt;
}

defineWaypoint:forKey:

- (void) defineWaypoint:		(NSDictionary *)	definition
forKey:		(NSString *)	key

Definition at line 3616 of file Universe.m.

                       :(NSDictionary *)definition forKey:(NSString *)key
{
    OOWaypointEntity *waypoint = nil;
    BOOL preserveCompass = NO;
    waypoint = [waypoints objectForKey:key];
    if (waypoint != nil)
    {
        if ([PLAYER compassTarget] == waypoint) 
        {
            preserveCompass = YES;
        }
        [self removeEntity:waypoint];
        [waypoints removeObjectForKey:key];
    }
    if (definition != nil)
    {
        waypoint = [OOWaypointEntity waypointWithDictionary:definition];
        if (waypoint != nil)
        {
            [self addEntity:waypoint];
            [waypoints setObject:waypoint forKey:key];
            if (preserveCompass)
            {
                [PLAYER setCompassTarget:waypoint];
                [PLAYER setNextBeacon:waypoint];
            }
        }
    }
}

deleteOpenGLObjects

- (void) deleteOpenGLObjects

implementation

Provided by category Universe(OOPrivate).

Definition at line 273 of file Universe.m.

{
    OOGL(glDeleteTextures(1, &msaaTextureID));
    OOGL(glDeleteTextures(1, &targetTextureID));
    OOGL(glDeleteTextures(2, passthroughTextureID));
    OOGL(glDeleteTextures(2, pingpongColorbuffers));
    OOGL(glDeleteRenderbuffers(1, &msaaDepthBufferID));
    OOGL(glDeleteRenderbuffers(1, &targetDepthBufferID));
    OOGL(glDeleteFramebuffers(1, &msaaFramebufferID));
    OOGL(glDeleteFramebuffers(1, &targetFramebufferID));
    OOGL(glDeleteFramebuffers(2, pingpongFBO));
    OOGL(glDeleteFramebuffers(1, &passthroughFramebufferID));
    OOGL(glDeleteVertexArrays(1, &quadTextureVAO));
    OOGL(glDeleteBuffers(1, &quadTextureVBO));
    OOGL(glDeleteBuffers(1, &quadTextureEBO));
    [textureProgram release];
    [blurProgram release];
    [finalProgram release];
}

demoShipData

- (NSDictionary *) demoShipData

implementation

Provided by category Universe(OOPrivate).

Definition at line 273 of file Universe.m.

{
    return [[demo_ships oo_arrayAtIndex:demo_ship_index] oo_dictionaryAtIndex:demo_ship_subindex];
}

describeCommodity:amount:

- (NSString *) describeCommodity:		(OOCommodityType)	co_type
amount:		(OOCargoQuantity)	co_amount

Definition at line 3616 of file Universe.m.

                                :(OOCommodityType)co_type amount:(OOCargoQuantity)co_amount
{
    int             units;
    NSString        *unitDesc = nil, *typeDesc = nil;
    NSDictionary    *commodity = [self commodityDataForType:co_type];
    
    if (commodity == nil) return @"";
    
    units = [commodityMarket massUnitForGood:co_type];
    if (co_amount == 1)
    {
        switch (units)
        {
            case UNITS_KILOGRAMS :  // KILOGRAM
                unitDesc = DESC(@"cargo-kilogram");
                break;
            case UNITS_GRAMS :  // GRAM
                unitDesc = DESC(@"cargo-gram");
                break;
            case UNITS_TONS :   // TONNE
            default :
                unitDesc = DESC(@"cargo-ton");
                break;
        }
    }
    else
    {
        switch (units)
        {
            case UNITS_KILOGRAMS :  // KILOGRAMS
                unitDesc = DESC(@"cargo-kilograms");
                break;
            case UNITS_GRAMS :  // GRAMS
                unitDesc = DESC(@"cargo-grams");
                break;
            case UNITS_TONS :   // TONNES
            default :
                unitDesc = DESC(@"cargo-tons");
                break;
        }
    }
    
    typeDesc = [commodityMarket nameForGood:co_type];
    
    return [NSString stringWithFormat:@"%d %@ %@",co_amount, unitDesc, typeDesc];
}

descriptionBooleanForKey:

- (BOOL) descriptionBooleanForKey:

(NSString *)

key

Definition at line 7996 of file Universe.m.

                                 :(NSString *)key
{
    return [[self descriptions] oo_boolForKey:key];
}

descriptionForArrayKey:index:

- (NSString *) descriptionForArrayKey:		(NSString *)	key
index:		(unsigned)	index

Definition at line 7996 of file Universe.m.

                                    :(NSString *)key index:(unsigned)index
{
    NSArray *array = [[self descriptions] oo_arrayForKey:key];
    if ([array count] <= index)  return nil;    // Catches nil array
    return [array objectAtIndex:index];
}

descriptionForKey:

- (NSString *) descriptionForKey:

(NSString *)

key

Definition at line 7996 of file Universe.m.

                               :(NSString *)key
{
    return [self chooseStringForKey:key inDictionary:[self descriptions]];
}

descriptions

- (NSDictionary *) descriptions

Definition at line 6447 of file Universe.m.

{
    if (_descriptions == nil)
    {
        // Load internal descriptions.plist for use in early init, OXP verifier etc.
        // It will be replaced by merged version later if running the game normally.
        _descriptions = [NSDictionary dictionaryWithContentsOfFile:[[[ResourceManager builtInPath]
                                                                     stringByAppendingPathComponent:@"Config"]
                                                                    stringByAppendingPathComponent:@"descriptions.plist"]];
        
        [self verifyDescriptions];
    }
    return _descriptions;
}

detailLevel

- (OOGraphicsDetail) detailLevel

deterministicPopulation

- (BOOL) deterministicPopulation

Definition at line 273 of file Universe.m.

{
    return deterministic_population;
}

displayCountdownMessage:forCount:

- (void) displayCountdownMessage:		(NSString *)	text
forCount:		(OOTimeDelta)	count

Definition at line 6447 of file Universe.m.

                                :(NSString *) text forCount:(OOTimeDelta)count
{
    if (![currentMessage isEqual:text] && universal_time >= countdown_messageRepeatTime)
    {
        if (currentMessage) [currentMessage release];
        currentMessage = [text retain];
        countdown_messageRepeatTime=universal_time + count;
        [self showGUIMessage:text withScroll:NO andColor:[message_gui textColor] overDuration:count];
    }
}

displayFPS

- (BOOL) displayFPS

displayGUI

- (BOOL) displayGUI

displayMessage:forCount:

- (void) displayMessage:		(NSString *)	text
forCount:		(OOTimeDelta)	count

Definition at line 6447 of file Universe.m.

                       :(NSString *) text forCount:(OOTimeDelta)count
{
    if (![currentMessage isEqual:text] || universal_time >= messageRepeatTime)
    {
        if (currentMessage) [currentMessage release];
        currentMessage = [text retain];
        messageRepeatTime=universal_time + 6.0;
        [self showGUIMessage:text withScroll:YES andColor:[message_gui textColor] overDuration:count];
    }
}

displayNameForCommodity:

- (NSString *) displayNameForCommodity:

(OOCommodityType)

co_type

Definition at line 3616 of file Universe.m.

                                      :(OOCommodityType)co_type
{
    return [commodityMarket nameForGood:co_type];
}

dockingClearanceProtocolActive

- (BOOL) dockingClearanceProtocolActive

Definition at line 273 of file Universe.m.

{
    return _dockingClearanceProtocolActive;
}

doingStartUp

- (BOOL) doingStartUp

Definition at line 273 of file Universe.m.

{
    return _doingStartUp;
}

doProcedurallyTexturedPlanets

- (BOOL) doProcedurallyTexturedPlanets

doRemoveEntity:

- (BOOL) doRemoveEntity: (Entity *) entity

implementation

Provided by category Universe(OOPrivate).

Definition at line 9471 of file Universe.m.

                      :(Entity *)entity
{
    // remove reference to entity in linked lists
    if ([entity canCollide])    // filter only collidables disappearing
    {
        doLinkedListMaintenanceThisUpdate = YES;
    }
    
    [entity removeFromLinkedLists];
    
    // moved forward ^^
    // remove from the reference dictionary
    int old_id = [entity universalID];
    entity_for_uid[old_id] = nil;
    [entity setUniversalID:NO_TARGET];
    [entity wasRemovedFromUniverse];
    
    // maintain sorted lists
    int index = entity->zero_index;
    
    int n = 1;
    if (index >= 0)
    {
        if (sortedEntities[index] != entity)
        {
            OOLog(kOOLogInconsistentState, @"DEBUG: Universe removeEntity:%@ ENTITY IS NOT IN THE RIGHT PLACE IN THE ZERO_DISTANCE SORTED LIST -- FIXING...", entity);
            unsigned i;
            index = -1;
            for (i = 0; (i < n_entities)&&(index == -1); i++)
                if (sortedEntities[i] == entity)
                    index = i;
            if (index == -1)
                 OOLog(kOOLogInconsistentState, @"DEBUG: Universe removeEntity:%@ ENTITY IS NOT IN THE ZERO_DISTANCE SORTED LIST -- CONTINUING...", entity);
        }
        if (index != -1)
        {
            while ((unsigned)index < n_entities)
            {
                while (((unsigned)index + n < n_entities)&&(sortedEntities[index + n] == entity))
                {
                    n++;    // ie there's a duplicate entry for this entity
                }
                
                /*
                    BUG: when n_entities == UNIVERSE_MAX_ENTITIES, this read
                    off the end of the array and copied (Entity *)n_entities =
                    0x800 into the list. The subsequent update of zero_index
                    derferenced 0x800 and crashed.
                    FIX: add an extra unused slot to sortedEntities, which is
                    always nil.
                    EFFICIENCY CONCERNS: this could have been an alignment
                    issue since UNIVERSE_MAX_ENTITIES == 2048, but it isn't
                    really. sortedEntities is part of the object, not malloced,
                    it isn't aligned, and the end of it is only live in
                    degenerate cases.
                    -- Ahruman 2012-07-11
                */
                sortedEntities[index] = sortedEntities[index + n];  // copy entity[index + n] -> entity[index] (preserves sort order)
                if (sortedEntities[index])
                {
                    sortedEntities[index]->zero_index = index;              // give it its correct position
                }
                index++;
            }
            if (n > 1)
                 OOLog(kOOLogInconsistentState, @"DEBUG: Universe removeEntity: REMOVED %d EXTRA COPIES OF %@ FROM THE ZERO_DISTANCE SORTED LIST", n - 1, entity);
            while (n--)
            {
                n_entities--;
                sortedEntities[n_entities] = nil;
            }
        }
        entity->zero_index = -1;    // it's GONE!
    }
    
    // remove from the definitive list
    if ([entities containsObject:entity])
    {
        // FIXME: better approach needed for core break patterns - CIM
        if ([entity isBreakPattern] && ![entity isVisualEffect])
        {
            breakPatternCounter--;
        }
        
        if ([entity isShip])
        {
            ShipEntity *se = (ShipEntity*)entity;
            [self clearBeacon:se];
        }
        if ([entity isWaypoint])
        {
            OOWaypointEntity *wp = (OOWaypointEntity*)entity;
            [self clearBeacon:wp];
        }
        if ([entity isVisualEffect])
        {
            OOVisualEffectEntity *ve = (OOVisualEffectEntity*)entity;
            [self clearBeacon:ve];
        }
        
        if ([entity isWormhole])
        {
            [activeWormholes removeObject:entity];
        }
        else if ([entity isPlanet])
        {
            [allPlanets removeObject:entity];
        }
        
        [entities removeObject:entity];
        return YES;
    }
    
    return NO;
}

drawMessage

- (void) drawMessage

Definition at line 4630 of file Universe.m.

{
    OOSetOpenGLState(OPENGL_STATE_OVERLAY);
    
    OOGL(glDisable(GL_TEXTURE_2D)); // for background sheets
    
    float overallAlpha = [[PLAYER hud] overallAlpha];
    if (displayGUI)
    {
        if ([[self gameController] mouseInteractionMode] == MOUSE_MODE_UI_SCREEN_WITH_INTERACTION)
        {
            cursor_row = [gui drawGUI:1.0 drawCursor:YES];
        }
        else
        {
            [gui drawGUI:1.0 drawCursor:NO];
        }
    }
    
    [message_gui drawGUI:[message_gui alpha] * overallAlpha drawCursor:NO];
    [comm_log_gui drawGUI:[comm_log_gui alpha] * overallAlpha drawCursor:NO];
    
    OOVerifyOpenGLState();
}

drawTargetTextureIntoDefaultFramebuffer

- (void) drawTargetTextureIntoDefaultFramebuffer

implementation

Provided by category Universe(OOPrivate).

Definition at line 273 of file Universe.m.

{
    // save previous bindings state
    GLint previousFBO;
    OOGL(glGetIntegerv(GL_DRAW_FRAMEBUFFER_BINDING, &previousFBO));
    GLint previousProgramID;
    OOGL(glGetIntegerv(GL_CURRENT_PROGRAM, &previousProgramID));
    GLint previousTextureID;
    OOGL(glGetIntegerv(GL_TEXTURE_BINDING_2D, &previousTextureID));
    GLint previousVAO;
    OOGL(glGetIntegerv(GL_VERTEX_ARRAY_BINDING, &previousVAO));
    GLint previousActiveTexture;
    OOGL(glGetIntegerv(GL_ACTIVE_TEXTURE, &previousActiveTexture)); 
    
    OOGL(glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT));
    // fixes transparency issue for some reason
    OOGL(glDisable(GL_BLEND));
    
    GLhandleARB program = [textureProgram program];
    GLhandleARB blur = [blurProgram program];
    GLhandleARB final = [finalProgram program];
    NSSize viewSize = [gameView viewSize];
    float fboResolution[2] = {viewSize.width, viewSize.height};
 
    OOGL(glBindFramebuffer(GL_FRAMEBUFFER, passthroughFramebufferID));
    OOGL(glClear(GL_COLOR_BUFFER_BIT));
 
    OOGL(glUseProgram(program));
    OOGL(glBindTexture(GL_TEXTURE_2D, targetTextureID));
    OOGL(glUniform1i(glGetUniformLocation(program, "image"), 0));
    
    
    OOGL(glBindVertexArray(quadTextureVAO));
    OOGL(glDrawElements(GL_TRIANGLES, 6, GL_UNSIGNED_INT, 0));
    OOGL(glBindVertexArray(0));
    
    OOGL(glBindFramebuffer(GL_FRAMEBUFFER, defaultDrawFBO));
    
        
    BOOL horizontal = YES, firstIteration = YES;
    unsigned int amount = [self bloom] ? 10 : 0; // if not blooming, why bother with the heavy calculations?
    OOGL(glUseProgram(blur));
    for (unsigned int i = 0; i < amount; i++)
    {
        OOGL(glBindFramebuffer(GL_FRAMEBUFFER, pingpongFBO[horizontal]));
        OOGL(glUniform1i(glGetUniformLocation(blur, "horizontal"), horizontal));
        OOGL(glActiveTexture(GL_TEXTURE0));
        // bind texture of other framebuffer (or scene if first iteration)
        OOGL(glBindTexture(GL_TEXTURE_2D, firstIteration ? passthroughTextureID[1] : pingpongColorbuffers[!horizontal]));  
        OOGL(glUniform1i(glGetUniformLocation([blurProgram program], "imageIn"), 0));
        OOGL(glBindVertexArray(quadTextureVAO));
        OOGL(glDrawElements(GL_TRIANGLES, 6, GL_UNSIGNED_INT, 0));
        OOGL(glBindVertexArray(0));
        horizontal = !horizontal;
        firstIteration = NO;
    }
    OOGL(glBindFramebuffer(GL_FRAMEBUFFER, defaultDrawFBO));
    
    
    OOGL(glUseProgram(final));
 
    OOGL(glActiveTexture(GL_TEXTURE0));
    OOGL(glBindTexture(GL_TEXTURE_2D, passthroughTextureID[0]));
    OOGL(glUniform1i(glGetUniformLocation(final, "scene"), 0));
    OOGL(glUniform1i(glGetUniformLocation(final, "bloom"), [self bloom]));
    OOGL(glUniform1f(glGetUniformLocation(final, "uTime"), [self getTime]));
    OOGL(glUniform2fv(glGetUniformLocation(final, "uResolution"), 1, fboResolution));
    OOGL(glUniform1i(glGetUniformLocation(final, "uPostFX"), [self currentPostFX]));
#if OOLITE_WINDOWS
    if([gameView hdrOutput])
    {
        OOGL(glUniform1f(glGetUniformLocation(final, "uMaxBrightness"), [gameView hdrMaxBrightness]));
        OOGL(glUniform1f(glGetUniformLocation(final, "uPaperWhiteBrightness"), [gameView hdrPaperWhiteBrightness]));
    }
#endif
    
    OOGL(glActiveTexture(GL_TEXTURE1));
    OOGL(glBindTexture(GL_TEXTURE_2D, pingpongColorbuffers[!horizontal]));
    OOGL(glUniform1i(glGetUniformLocation(final, "bloomBlur"), 1));
    OOGL(glUniform1f(glGetUniformLocation(final, "uSaturation"), [gameView colorSaturation]));
    
    OOGL(glBindVertexArray(quadTextureVAO));
    OOGL(glDrawElements(GL_TRIANGLES, 6, GL_UNSIGNED_INT, 0));
    
    // restore GL_TEXTURE1 to 0, just in case we are returning from a
    // DETAIL_LEVEL_NORMAL to DETAIL_LEVEL_SHADERS
    OOGL(glBindTexture(GL_TEXTURE_2D, 0));
 
    // restore previous bindings
    OOGL(glBindFramebuffer(GL_FRAMEBUFFER, previousFBO));
    OOGL(glActiveTexture(previousActiveTexture));
    OOGL(glBindTexture(GL_TEXTURE_2D, previousTextureID));
    OOGL(glUseProgram(previousProgramID));
    OOGL(glBindVertexArray(previousVAO));
    OOGL(glEnable(GL_BLEND));
}

drawUniverse

- (void) drawUniverse

Definition at line 4630 of file Universe.m.

{
    int currentPostFX = [self currentPostFX];
    BOOL hudSeparateRenderPass =  [self useShaders] && (currentPostFX == OO_POSTFX_NONE || (currentPostFX == OO_POSTFX_CLOAK && [self colorblindMode] == OO_POSTFX_NONE));
    NSSize  viewSize = [gameView viewSize];
    OOLog(@"universe.profile.draw", @"%@", @"Begin draw");
    
    if (!no_update)
    {
        if ((int)targetFramebufferSize.width != (int)viewSize.width || (int)targetFramebufferSize.height != (int)viewSize.height)
        {
            [self resizeTargetFramebufferWithViewSize:viewSize];
        }
    
        if([self useShaders])
        {
            if ([gameView msaa])
            {
                OOGL(glBindFramebuffer(GL_FRAMEBUFFER, msaaFramebufferID));
            }
            else
            {
                OOGL(glBindFramebuffer(GL_FRAMEBUFFER, targetFramebufferID));
            }
        }
        @try
        {
            no_update = YES;    // block other attempts to draw
            
            int             i, v_status, vdist;
            Vector          view_dir, view_up;
            OOMatrix        view_matrix;
            int             ent_count = n_entities;
            Entity          *my_entities[ent_count];
            int             draw_count = 0;
            PlayerEntity    *player = PLAYER;
            Entity          *drawthing = nil;
            BOOL            demoShipMode = [player showDemoShips];
            
            float   aspect = viewSize.height/viewSize.width;
 
            if (!displayGUI && wasDisplayGUI)
            {
                // reset light1 position for the shaders
                if (cachedSun) [UNIVERSE setMainLightPosition:HPVectorToVector([cachedSun position])]; // the main light is the sun.
                else [UNIVERSE setMainLightPosition:kZeroVector];
            }
            wasDisplayGUI = displayGUI;
            // use a non-mutable copy so this can't be changed under us.
            for (i = 0; i < ent_count; i++)
            {
                /* BUG: this list is ordered nearest to furthest from
                 * the player, and we just assume that the camera is
                 * on/near the player. So long as everything uses
                 * depth tests, we'll get away with it; it'll just
                 * occasionally be inefficient. - CIM */
                Entity *e = sortedEntities[i]; // ordered NEAREST -> FURTHEST AWAY
                if ([e isVisible])
                {
                    my_entities[draw_count++] = [[e retain] autorelease];
                }
            }
            
            v_status = [player status];
            
            OOCheckOpenGLErrors(@"Universe before doing anything");
            
            OOSetOpenGLState(OPENGL_STATE_OPAQUE);  // FIXME: should be redundant.
            
            OOGL(glClear(GL_COLOR_BUFFER_BIT));
 
            if (!displayGUI)
            {
                OOGL(glClearColor(skyClearColor[0], skyClearColor[1], skyClearColor[2], skyClearColor[3]));
            }
            else
            {
                OOGL(glClearColor(0.0, 0.0, 0.0, 0.0));
                // If set, display background GUI image. Must be done before enabling lights to avoid dim backgrounds
                OOGLResetProjection();
                OOGLFrustum(-0.5, 0.5, -aspect*0.5, aspect*0.5, 1.0, MAX_CLEAR_DEPTH);
                [gui drawGUIBackground];
            
            }
 
            BOOL        fogging, bpHide = [self breakPatternHide];
            
            for (vdist=0;vdist<=1;vdist++)
            {
                float   nearPlane = vdist ? 1.0 : INTERMEDIATE_CLEAR_DEPTH;
                float   farPlane = vdist ? INTERMEDIATE_CLEAR_DEPTH : MAX_CLEAR_DEPTH;
                float   ratio = (displayGUI ? 0.5 : [gameView fov:YES]) * nearPlane; // 0.5 is field of view ratio for GUIs
                
                OOGLResetProjection();
                if ((displayGUI && 4*aspect >= 3) || (!displayGUI && 4*aspect <= 3))
                {
                    OOGLFrustum(-ratio, ratio, -aspect*ratio, aspect*ratio, nearPlane, farPlane);
                }
                else
                {
                    OOGLFrustum(-3*ratio/aspect/4, 3*ratio/aspect/4, -3*ratio/4, 3*ratio/4, nearPlane, farPlane);
                }
 
                [self getActiveViewMatrix:&view_matrix forwardVector:&view_dir upVector:&view_up];
 
                OOGLResetModelView();   // reset matrix
                OOGLLookAt(kZeroVector, kBasisZVector, kBasisYVector);
            
                // HACK BUSTED
                OOGLMultModelView(OOMatrixForScale(-1.0,1.0,1.0)); // flip left and right
                OOGLPushModelView(); // save this flat viewpoint
 
                /* OpenGL viewpoints: 
                 *
                 * Oolite used to transform the viewpoint by the inverse of the
                 * view position, and then transform the objects by the inverse
                 * of their position, to get the correct view. However, as
                 * OpenGL only uses single-precision floats, this causes
                 * noticeable display inaccuracies relatively close to the
                 * origin.
                 *
                 * Instead, we now calculate the difference between the view
                 * position and the object using high-precision vectors, convert
                 * the difference to a low-precision vector (since if you can
                 * see it, it's close enough for the loss of precision not to
                 * matter) and use that relative vector for the OpenGL transform
                 *
                 * Objects which reset the view matrix in their display need to be
                 * handled a little more carefully than before.
                 */
 
                OOSetOpenGLState(OPENGL_STATE_OPAQUE); 
                // clearing the depth buffer waits until we've set
                // STATE_OPAQUE so that depth writes are definitely
                // available.
                OOGL(glClear(GL_DEPTH_BUFFER_BIT));
        
 
                // Set up view transformation matrix
                OOMatrix flipMatrix = kIdentityMatrix;
                flipMatrix.m[2][2] = -1;
                view_matrix = OOMatrixMultiply(view_matrix, flipMatrix);
                Vector viewOffset = [player viewpointOffset];
            
                OOGLLookAt(view_dir, kZeroVector, view_up); 
 
                if (EXPECT(!displayGUI || demoShipMode))
                {
                    if (EXPECT(!demoShipMode))  // we're in flight
                    {
                        // rotate the view
                        OOGLMultModelView([player rotationMatrix]);
                        // translate the view
                        // HPVect: camera-relative position
                        OOGL(glLightModelfv(GL_LIGHT_MODEL_AMBIENT, stars_ambient));
                        // main light position, no shaders, in-flight / shaders, in-flight and docked.
                        if (cachedSun)
                        {
                            [self setMainLightPosition:[cachedSun cameraRelativePosition]];
                        }
                        else
                        {
                            // in witchspace
                            [self setMainLightPosition:HPVectorToVector(HPvector_flip([PLAYER viewpointPosition]))];
                        }
                        OOGL(glLightfv(GL_LIGHT1, GL_POSITION, main_light_position));                   
                    }
                    else
                    {
                        OOGL(glLightModelfv(GL_LIGHT_MODEL_AMBIENT, docked_light_ambient));
                        // main_light_position no shaders, docked/GUI.
                        OOGL(glLightfv(GL_LIGHT0, GL_POSITION, main_light_position));
                        // main light position, no shaders, in-flight / shaders, in-flight and docked.      
                        OOGL(glLightfv(GL_LIGHT1, GL_POSITION, main_light_position));
                    }
                
                
                    OOGL([self useGUILightSource:demoShipMode]);
                
                    // HACK: store view matrix for absolute drawing of active subentities (i.e., turrets, flashers).
                    viewMatrix = OOGLGetModelView();
 
                    int         furthest = draw_count - 1;
                    int         nearest = 0;
                    BOOL        inAtmosphere = airResistanceFactor > 0.01;
                    GLfloat     fogFactor = 0.5 / airResistanceFactor;
                    double      fog_scale, half_scale;
                    GLfloat     flat_ambdiff[4] = {1.0, 1.0, 1.0, 1.0};   // for alpha
                    GLfloat     mat_no[4]       = {0.0, 0.0, 0.0, 1.0};   // nothing
                    GLfloat     fog_blend;
                
                    OOGL(glHint(GL_FOG_HINT, [self reducedDetail] ? GL_FASTEST : GL_NICEST));
                
                    [self defineFrustum]; // camera is set up for this frame
                
                    OOVerifyOpenGLState();
                    OOCheckOpenGLErrors(@"Universe after setting up for opaque pass");
                    OOLog(@"universe.profile.draw", @"%@", @"Begin opaque pass");
 
                
                    //      DRAW ALL THE OPAQUE ENTITIES
                    for (i = furthest; i >= nearest; i--)
                    {
                        drawthing = my_entities[i];
                        OOEntityStatus d_status = [drawthing status];
                    
                        if (bpHide && !drawthing->isImmuneToBreakPatternHide)  continue;
                        if (vdist == 1 && [drawthing cameraRangeFront] > farPlane*1.5) continue;
                        if (vdist == 0 && [drawthing cameraRangeBack] < nearPlane) continue;
//                      if (vdist == 1 && [drawthing isPlanet]) continue;
 
                        if (!((d_status == STATUS_COCKPIT_DISPLAY) ^ demoShipMode)) // either demo ship mode or in flight
                        {
                            // reset material properties
                            // FIXME: should be part of SetState
                            OOGL(glMaterialfv(GL_FRONT_AND_BACK, GL_AMBIENT_AND_DIFFUSE, flat_ambdiff));
                            OOGL(glMaterialfv(GL_FRONT_AND_BACK, GL_EMISSION, mat_no));
                        
                            OOGLPushModelView();
                            if (EXPECT(drawthing != player))
                            {
                                //translate the object
                                // HPVect: camera relative
                                [drawthing updateCameraRelativePosition];
                                OOGLTranslateModelView([drawthing cameraRelativePosition]);
                                //rotate the object
                                OOGLMultModelView([drawthing drawRotationMatrix]);
                            }
                            else
                            {
                                // Load transformation matrix
                                OOGLLoadModelView(view_matrix);
                                //translate the object  from the viewpoint
                                OOGLTranslateModelView(vector_flip(viewOffset));
                            }
                        
                            // atmospheric fog
                            fogging = (inAtmosphere && ![drawthing isStellarObject]);
                        
                            if (fogging)
                            {
                                fog_scale = BILLBOARD_DEPTH * fogFactor;
                                half_scale = fog_scale * 0.50;
                                OOGL(glEnable(GL_FOG));
                                OOGL(glFogi(GL_FOG_MODE, GL_LINEAR));
                                OOGL(glFogfv(GL_FOG_COLOR, skyClearColor));
                                OOGL(glFogf(GL_FOG_START, half_scale));
                                OOGL(glFogf(GL_FOG_END, fog_scale));
                                fog_blend = OOClamp_0_1_f((magnitude([drawthing cameraRelativePosition]) - half_scale)/half_scale);
                                [drawthing setAtmosphereFogging: [OOColor colorWithRed: skyClearColor[0] green: skyClearColor[1] blue: skyClearColor[2] alpha: fog_blend]];
                            }
                        
                            [self lightForEntity:demoShipMode || drawthing->isSunlit];
                        
                            // draw the thing
                            [drawthing drawImmediate:false translucent:false];
                        
                            OOGLPopModelView();
 
                            // atmospheric fog
                            if (fogging)
                            {
                                [drawthing setAtmosphereFogging: [OOColor colorWithRed: 0.0 green: 0.0 blue: 0.0 alpha: 0.0]];
                                OOGL(glDisable(GL_FOG));
                            }
                        
                        }
                
                        if (!((d_status == STATUS_COCKPIT_DISPLAY) ^ demoShipMode)) // either in flight or in demo ship mode
                        {
                            OOGLPushModelView();
                            if (EXPECT(drawthing != player))
                            {
                                //translate the object
                                // HPVect: camera relative positions
                                [drawthing updateCameraRelativePosition];
                                OOGLTranslateModelView([drawthing cameraRelativePosition]);
                                //rotate the object
                                OOGLMultModelView([drawthing drawRotationMatrix]);
                            }
                            else
                            {
                                // Load transformation matrix
                                OOGLLoadModelView(view_matrix);
                                //translate the object  from the viewpoint
                                OOGLTranslateModelView(vector_flip(viewOffset));
                            }
                        
                            // experimental - atmospheric fog
                            fogging = (inAtmosphere && ![drawthing isStellarObject]);
                        
                            if (fogging)
                            {
                                fog_scale = BILLBOARD_DEPTH * fogFactor;
                                half_scale = fog_scale * 0.50;
                                OOGL(glEnable(GL_FOG));
                                OOGL(glFogi(GL_FOG_MODE, GL_LINEAR));
                                OOGL(glFogfv(GL_FOG_COLOR, skyClearColor));
                                OOGL(glFogf(GL_FOG_START, half_scale));
                                OOGL(glFogf(GL_FOG_END, fog_scale));
                                fog_blend = OOClamp_0_1_f((magnitude([drawthing cameraRelativePosition]) - half_scale)/half_scale);
                                [drawthing setAtmosphereFogging: [OOColor colorWithRed: skyClearColor[0] green: skyClearColor[1] blue: skyClearColor[2] alpha: fog_blend]];
                            }
                        
                            // draw the thing
                            [drawthing drawImmediate:false translucent:true];
                        
                            // atmospheric fog
                            if (fogging)
                            {
                                [drawthing setAtmosphereFogging: [OOColor colorWithRed: 0.0 green: 0.0 blue: 0.0 alpha: 0.0]];
                                OOGL(glDisable(GL_FOG));
                            }
                        
                            OOGLPopModelView();
                        }
                    }
                }
 
                OOGLPopModelView();
            }
            
            // glare effects covering the entire game window
            OOGLResetProjection();
            OOGLFrustum(-0.5, 0.5, -aspect*0.5, aspect*0.5, 1.0, MAX_CLEAR_DEPTH);
            OOSetOpenGLState(OPENGL_STATE_OVERLAY);  // FIXME: should be redundant.
            if (EXPECT(!displayGUI))
            {
                if (!bpHide && cachedSun)
                {
                    [cachedSun drawDirectVisionSunGlare];
                    [cachedSun drawStarGlare];
                }
            }
            
            // actions when the HUD should be rendered separately from the 3d universe
            if (hudSeparateRenderPass)
            {
                OOCheckOpenGLErrors(@"Universe after drawing entities");
                OOSetOpenGLState(OPENGL_STATE_OVERLAY);  // FIXME: should be redundant.
                
                [self prepareToRenderIntoDefaultFramebuffer];   
                OOGL(glBindFramebuffer(GL_FRAMEBUFFER, defaultDrawFBO));
                
                OOLog(@"universe.profile.secondPassDraw", @"%@", @"Begin second pass draw");
                [self drawTargetTextureIntoDefaultFramebuffer];
                OOCheckOpenGLErrors(@"Universe after drawing from custom framebuffer to screen framebuffer");
                OOLog(@"universe.profile.secondPassDraw", @"%@", @"End second pass drawing");
    
                OOLog(@"universe.profile.drawHUD", @"%@", @"Begin HUD drawing");
            }
            
            /* Reset for HUD drawing */
            OOCheckOpenGLErrors(@"Universe after drawing entities");
            OOLog(@"universe.profile.draw", @"%@", @"Begin HUD");
            
            GLfloat lineWidth = [gameView viewSize].width / 1024.0; // restore line size
            if (lineWidth < 1.0)  lineWidth = 1.0;
            if (lineWidth > 1.5)  lineWidth = 1.5; // don't overscale; think of ultra-wide screen setups
            OOGL(GLScaledLineWidth(lineWidth));
 
            HeadUpDisplay *theHUD = [player hud];
            
            // If the HUD has a non-nil deferred name string, it means that a HUD switch was requested while it was being rendered.
            // If so, execute the deferred HUD switch now - Nikos 20110628
            if ([theHUD deferredHudName] != nil)
            {
                NSString *deferredName = [[theHUD deferredHudName] retain];
                [player switchHudTo:deferredName];
                [deferredName release];
                theHUD = [player hud];  // HUD has been changed, so point to its new address
            }
            
            // Hiding HUD: has been a regular - non-debug - feature as of r2749, about 2 yrs ago! --Kaks 2011.10.14
            static float sPrevHudAlpha = -1.0f;
            if ([theHUD isHidden])
            {
                if (sPrevHudAlpha < 0.0f)
                {
                    sPrevHudAlpha = [theHUD overallAlpha];
                }
                [theHUD setOverallAlpha:0.0f];
            }
            else if (sPrevHudAlpha >= 0.0f)
            {
                [theHUD setOverallAlpha:sPrevHudAlpha];
                sPrevHudAlpha = -1.0f;
            }
            
            switch (v_status) {
            case STATUS_DEAD:
            case STATUS_ESCAPE_SEQUENCE:
            case STATUS_START_GAME:
                // no HUD rendering in these modes
                break;
            default:
                switch ([player guiScreen])
                {
                //case GUI_SCREEN_KEYBOARD:
                    // no HUD rendering on this screen
                    //break;
                default:
                    [theHUD setLineWidth:lineWidth];
                    [theHUD renderHUD];
                }
            }
 
            // should come after the HUD to avoid it being overlapped by it
            [self drawMessage];
            
#if (defined (SNAPSHOT_BUILD) && defined (OOLITE_SNAPSHOT_VERSION))
            [self drawWatermarkString:@"Development version " @OOLITE_SNAPSHOT_VERSION];
#endif
            
            OOLog(@"universe.profile.drawHUD", @"%@", @"End HUD drawing");
            OOCheckOpenGLErrors(@"Universe after drawing HUD");
            
            OOGL(glFlush());    // don't wait around for drawing to complete
            
            no_update = NO; // allow other attempts to draw
            
            // frame complete, when it is time to update the fps_counter, updateClocks:delta_t
            // in PlayerEntity.m will take care of resetting the processed frames number to 0.
            if (![[self gameController] isGamePaused])
            {
                framesDoneThisUpdate++;
            }
        }
        @catch (NSException *exception)
        {
            no_update = NO; // make sure we don't get stuck in all subsequent frames.
            
            if ([[exception name] hasPrefix:@"Oolite"])
            {
                [self handleOoliteException:exception];
            }
            else
            {
                OOLog(kOOLogException, @"***** Exception: %@ : %@ *****",[exception name], [exception reason]);
                @throw exception;
            }
        }
    }
    
    OOLog(@"universe.profile.draw", @"%@", @"End drawing");
    
    // actions when the HUD should be rendered together with the 3d universe
    if(!hudSeparateRenderPass)
    {
        if([self useShaders])
        {
            [self prepareToRenderIntoDefaultFramebuffer];
            OOGL(glBindFramebuffer(GL_FRAMEBUFFER, defaultDrawFBO));
            
            OOLog(@"universe.profile.secondPassDraw", @"%@", @"Begin second pass draw");
            [self drawTargetTextureIntoDefaultFramebuffer];
            OOLog(@"universe.profile.secondPassDraw", @"%@", @"End second pass drawing");
        }
    }
}

drawWatermarkString:

- (void) drawWatermarkString:

(NSString *)

watermarkString

Definition at line 4630 of file Universe.m.

                            :(NSString *) watermarkString
{
    NSSize watermarkStringSize = OORectFromString(watermarkString, 0.0f, 0.0f, NSMakeSize(10, 10)).size;
    
    OOGL(glColor4f(0.0, 1.0, 0.0, 1.0));
    // position the watermark string on the top right hand corner of the game window and right-align it
    OODrawString(watermarkString, MAIN_GUI_PIXEL_WIDTH / 2 - watermarkStringSize.width + 80,
                        MAIN_GUI_PIXEL_HEIGHT / 2 - watermarkStringSize.height, [gameView display_z], NSMakeSize(10,10));
}

dumpCollisions

- (void) dumpCollisions

Definition at line 6447 of file Universe.m.

{
    dumpCollisionInfo = YES;
}

ensureEntityReallyRemoved:

- (void) ensureEntityReallyRemoved:

(Entity *)

entity

Definition at line 5364 of file Universe.m.

                                  :(Entity *)entity
{
    if ([entity universalID] != NO_TARGET)
    {
        OOLog(@"universe.unremovedEntity", @"Entity %@ dealloced without being removed from universe! (This is an internal programming error, please report it.)", entity);
        [self doRemoveEntity:entity];
    }
}

enterGUIViewModeWithMouseInteraction:

- (void) enterGUIViewModeWithMouseInteraction:

(BOOL)

mouseInteraction

Definition at line 6447 of file Universe.m.

                                             :(BOOL)mouseInteraction
{
    [self setViewDirection:VIEW_GUI_DISPLAY];
    [[self gameController] setMouseInteractionModeForUIWithMouseInteraction:mouseInteraction];
}

entitiesWithinRange:ofEntity:

- (NSArray *) entitiesWithinRange:		(double)	range
ofEntity:		(Entity *)	entity

Definition at line 5364 of file Universe.m.

                                 :(double)range ofEntity:(Entity *)entity
{
    if (entity == nil)  return nil;
    
    return [self findShipsMatchingPredicate:YESPredicate
                                  parameter:NULL
                                    inRange:range
                                   ofEntity:entity];
}

entityCount

- (NSUInteger) entityCount

Definition at line 273 of file Universe.m.

{
    return [entities count];
}

entityForUniversalID:

- (id) entityForUniversalID:

(OOUniversalID)

u_id

Definition at line 4630 of file Universe.m.

                          :(OOUniversalID)u_id
{
    if (u_id == 100)
        return PLAYER;  // the player
    
    if (MAX_ENTITY_UID < u_id)
    {
        OOLog(@"universe.badUID", @"Attempt to retrieve entity for out-of-range UID %u. (This is an internal programming error, please report it.)", u_id);
        return nil;
    }
    
    if ((u_id == NO_TARGET)||(!entity_for_uid[u_id]))
        return nil;
    
    Entity *ent = entity_for_uid[u_id];
    if ([ent isEffect]) // effects SHOULD NOT HAVE U_IDs!
    {
        return nil;
    }
    
    if ([ent status] == STATUS_DEAD || [ent status] == STATUS_DOCKED)
    {
        return nil;
    }
    
    return ent;
}

EntityInRange

- (OOINLINE BOOL) EntityInRange (HPVector) p1 (Entity *) e2 (float) range

implementation

Definition at line 6447 of file Universe.m.

{
    if (range < 0)  return YES;
    float cr = range + e2->collision_radius;
    return HPdistance2(e2->position,p1) < cr * cr;
}

entityList

- (NSArray *) entityList

Definition at line 273 of file Universe.m.

{
    return [NSArray arrayWithArray:entities];
}

equipmentData

- (NSArray *) equipmentData

equipmentDataOutfitting

- (NSArray *) equipmentDataOutfitting

explosionSetting:

- (NSDictionary *) explosionSetting:

(NSString *)

explosion

Definition at line 7996 of file Universe.m.

                                   :(NSString *)explosion
{
    return [explosionSettings oo_dictionaryForKey:explosion defaultValue:nil];
}

expressPosition:inCoordinateSystem:

- (NSString *) expressPosition:		(HPVector)	pos
inCoordinateSystem:		(NSString *)	system

Definition at line 273 of file Universe.m.

                              :(HPVector) pos inCoordinateSystem:(NSString *) system
{
    HPVector result = [self legacyPositionFrom:pos asCoordinateSystem:system];
    return [NSString stringWithFormat:@"%@ %.2f %.2f %.2f", system, result.x, result.y, result.z];
}

fillCargopodWithRandomCargo:

- (void) fillCargopodWithRandomCargo:

(ShipEntity *)

cargopod

Definition at line 3616 of file Universe.m.

                                    :(ShipEntity *)cargopod
{
    if (cargopod == nil || ![cargopod hasRole:@"cargopod"] || [cargopod cargoType] == CARGO_SCRIPTED_ITEM)  return;
    
    if ([cargopod commodityType] == nil || ![cargopod commodityAmount])
    {
        NSString *aCommodity = [self getRandomCommodity];
        OOCargoQuantity aQuantity = [self getRandomAmountOfCommodity:aCommodity];
        [cargopod setCommodity:aCommodity andAmount:aQuantity];     
    }
}

filterSortedLists

- (void) filterSortedLists

Definition at line 6447 of file Universe.m.

{
    /*
    Eric, 17-10-2010: raised the area to be not filtered out, from the combined collision size to 2x this size.
    This allows this filtered list to be used also for proximity_alert and not only for collisions. Before the
    proximity_alert could only trigger when already very near a collision. To late for ships to react.
    This does raise the number of entities in the collision chain with as result that the number of pairs to compair
    becomes significant larger. However, almost all of these extra pairs are dealt with by a simple distance check.
    I currently see no noticeable negative effect while playing, but this change might still give some trouble I missed.
    */
    Entity  *e0, *next, *prev;
    OOHPScalar start, finish, next_start, next_finish, prev_start, prev_finish;
    
    // using the z_list - set or clear collisionTestFilter and clear collision_chain
    e0 = z_list_start;
    while (e0)
    {
        e0->collisionTestFilter = [e0 canCollide]?0:3;
        e0->collision_chain = nil;
        e0 = e0->z_next;
    }
    // done.
    
    /* We need to check the lists in both ascending and descending order
     * to catch some cases with interposition of entities. We set cTF =
     * 1 on the way up, and |= 2 on the way down. Therefore it's only 3
     * at the end of the list if it was caught both ways on the same
     * list. - CIM: 7/11/2012 */
 
    // start with the z_list
    e0 = z_list_start;
    while (e0)
    {
        // here we are either at the start of the list or just past a gap
        start = e0->position.z - 2.0f * e0->collision_radius;
        finish = start + 4.0f * e0->collision_radius;
        next = e0->z_next;
        while ((next)&&(next->collisionTestFilter == 3))    // next has been eliminated from the list of possible colliders - so skip it
            next = next->z_next;
        if (next)
        {
            next_start = next->position.z - 2.0f * next->collision_radius;
            if (next_start < finish)
            {
                // e0 and next overlap
                while ((next)&&(next_start < finish))
                {
                    // skip forward to the next gap or the end of the list
                    next_finish = next_start + 4.0f * next->collision_radius;
                    if (next_finish > finish)
                        finish = next_finish;
                    e0 = next;
                    next = e0->z_next;
                    while ((next)&&(next->collisionTestFilter==3))  // next has been eliminated - so skip it
                        next = next->z_next;
                    if (next)
                        next_start = next->position.z - 2.0f * next->collision_radius;
                }
                // now either (next == nil) or (next_start >= finish)-which would imply a gap!
            }
            else
            {
                // e0 is a singleton
                e0->collisionTestFilter = 1;
            }
        }
        else // (next == nil)
        {
            // at the end of the list so e0 is a singleton
            e0->collisionTestFilter = 1;
        }
        e0 = next;
    }
    // list filtered upwards, now filter downwards
    // e0 currently = end of z list
    while (e0)
    {
        // here we are either at the start of the list or just past a gap
        start = e0->position.z + 2.0f * e0->collision_radius;
        finish = start - 4.0f * e0->collision_radius;
        prev = e0->z_previous;
        while ((prev)&&(prev->collisionTestFilter == 3))    // next has been eliminated from the list of possible colliders - so skip it
            prev = prev->z_previous;
        if (prev)
        {
            prev_start = prev->position.z + 2.0f * prev->collision_radius;
            if (prev_start > finish)
            {
                // e0 and next overlap
                while ((prev)&&(prev_start > finish))
                {
                    // skip forward to the next gap or the end of the list
                    prev_finish = prev_start - 4.0f * prev->collision_radius;
                    if (prev_finish < finish)
                        finish = prev_finish;
                    e0 = prev;
                    prev = e0->z_previous;
                    while ((prev)&&(prev->collisionTestFilter==3))  // next has been eliminated - so skip it
                        prev = prev->z_previous;
                    if (prev)
                        prev_start = prev->position.z + 2.0f * prev->collision_radius;
                }
                // now either (prev == nil) or (prev_start <= finish)-which would imply a gap!
            }
            else
            {
                // e0 is a singleton
                e0->collisionTestFilter |= 2;
            }
        }
        else // (prev == nil)
        {
            // at the end of the list so e0 is a singleton
            e0->collisionTestFilter |= 2;
        }
        e0 = prev;
    }
    // done! list filtered
    
    // then with the y_list, z_list singletons now create more gaps..
    e0 = y_list_start;
    while (e0)
    {
        // here we are either at the start of the list or just past a gap
        start = e0->position.y - 2.0f * e0->collision_radius;
        finish = start + 4.0f * e0->collision_radius;
        next = e0->y_next;
        while ((next)&&(next->collisionTestFilter==3))  // next has been eliminated from the list of possible colliders - so skip it
            next = next->y_next;
        if (next)
        {
            
            next_start = next->position.y - 2.0f * next->collision_radius;
            if (next_start < finish)
            {
                // e0 and next overlap
                while ((next)&&(next_start < finish))
                {
                    // skip forward to the next gap or the end of the list
                    next_finish = next_start + 4.0f * next->collision_radius;
                    if (next_finish > finish)
                        finish = next_finish;
                    e0 = next;
                    next = e0->y_next;
                    while ((next)&&(next->collisionTestFilter==3))  // next has been eliminated - so skip it
                        next = next->y_next;
                    if (next)
                        next_start = next->position.y - 2.0f * next->collision_radius;
                }
                // now either (next == nil) or (next_start >= finish)-which would imply a gap!
            }
            else
            {
                // e0 is a singleton
                e0->collisionTestFilter = 1;
            }
        }
        else // (next == nil)
        {
            // at the end of the list so e0 is a singleton
            e0->collisionTestFilter = 1;
        }
        e0 = next;
    }
    // list filtered upwards, now filter downwards
    // e0 currently = end of y list
    while (e0)
    {
        // here we are either at the start of the list or just past a gap
        start = e0->position.y + 2.0f * e0->collision_radius;
        finish = start - 4.0f * e0->collision_radius;
        prev = e0->y_previous;
        while ((prev)&&(prev->collisionTestFilter == 3))    // next has been eliminated from the list of possible colliders - so skip it
            prev = prev->y_previous;
        if (prev)
        {
            prev_start = prev->position.y + 2.0f * prev->collision_radius;
            if (prev_start > finish)
            {
                // e0 and next overlap
                while ((prev)&&(prev_start > finish))
                {
                    // skip forward to the next gap or the end of the list
                    prev_finish = prev_start - 4.0f * prev->collision_radius;
                    if (prev_finish < finish)
                        finish = prev_finish;
                    e0 = prev;
                    prev = e0->y_previous;
                    while ((prev)&&(prev->collisionTestFilter==3))  // next has been eliminated - so skip it
                        prev = prev->y_previous;
                    if (prev)
                        prev_start = prev->position.y + 2.0f * prev->collision_radius;
                }
                // now either (prev == nil) or (prev_start <= finish)-which would imply a gap!
            }
            else
            {
                // e0 is a singleton
                e0->collisionTestFilter |= 2;
            }
        }
        else // (prev == nil)
        {
            // at the end of the list so e0 is a singleton
            e0->collisionTestFilter |= 2;
        }
        e0 = prev;
    }
    // done! list filtered
    
    // finish with the x_list
    e0 = x_list_start;
    while (e0)
    {
        // here we are either at the start of the list or just past a gap
        start = e0->position.x - 2.0f * e0->collision_radius;
        finish = start + 4.0f * e0->collision_radius;
        next = e0->x_next;
        while ((next)&&(next->collisionTestFilter==3))  // next has been eliminated from the list of possible colliders - so skip it
            next = next->x_next;
        if (next)
        {
            next_start = next->position.x - 2.0f * next->collision_radius;
            if (next_start < finish)
            {
                // e0 and next overlap
                while ((next)&&(next_start < finish))
                {
                    // skip forward to the next gap or the end of the list
                    next_finish = next_start + 4.0f * next->collision_radius;
                    if (next_finish > finish)
                        finish = next_finish;
                    e0 = next;
                    next = e0->x_next;
                    while ((next)&&(next->collisionTestFilter==3))  // next has been eliminated - so skip it
                        next = next->x_next;
                    if (next)
                        next_start = next->position.x - 2.0f * next->collision_radius;
                }
                // now either (next == nil) or (next_start >= finish)-which would imply a gap!
            }
            else
            {
                // e0 is a singleton
                e0->collisionTestFilter = 1;
            }
        }
        else // (next == nil)
        {
            // at the end of the list so e0 is a singleton
            e0->collisionTestFilter = 1;
        }
        e0 = next;
    }
    // list filtered upwards, now filter downwards
    // e0 currently = end of x list
    while (e0)
    {
        // here we are either at the start of the list or just past a gap
        start = e0->position.x + 2.0f * e0->collision_radius;
        finish = start - 4.0f * e0->collision_radius;
        prev = e0->x_previous;
        while ((prev)&&(prev->collisionTestFilter == 3))    // next has been eliminated from the list of possible colliders - so skip it
            prev = prev->x_previous;
        if (prev)
        {
            prev_start = prev->position.x + 2.0f * prev->collision_radius;
            if (prev_start > finish)
            {
                // e0 and next overlap
                while ((prev)&&(prev_start > finish))
                {
                    // skip forward to the next gap or the end of the list
                    prev_finish = prev_start - 4.0f * prev->collision_radius;
                    if (prev_finish < finish)
                        finish = prev_finish;
                    e0 = prev;
                    prev = e0->x_previous;
                    while ((prev)&&(prev->collisionTestFilter==3))  // next has been eliminated - so skip it
                        prev = prev->x_previous;
                    if (prev)
                        prev_start = prev->position.x + 2.0f * prev->collision_radius;
                }
                // now either (prev == nil) or (prev_start <= finish)-which would imply a gap!
            }
            else
            {
                // e0 is a singleton
                e0->collisionTestFilter |= 2;
            }
        }
        else // (prev == nil)
        {
            // at the end of the list so e0 is a singleton
            e0->collisionTestFilter |= 2;
        }
        e0 = prev;
    }
    // done! list filtered
    
    // repeat the y_list - so gaps from the x_list influence singletons
    e0 = y_list_start;
    while (e0)
    {
        // here we are either at the start of the list or just past a gap
        start = e0->position.y - 2.0f * e0->collision_radius;
        finish = start + 4.0f * e0->collision_radius;
        next = e0->y_next;
        while ((next)&&(next->collisionTestFilter==3))  // next has been eliminated from the list of possible colliders - so skip it
            next = next->y_next;
        if (next)
        {
            next_start = next->position.y - 2.0f * next->collision_radius;
            if (next_start < finish)
            {
                // e0 and next overlap
                while ((next)&&(next_start < finish))
                {
                    // skip forward to the next gap or the end of the list
                    next_finish = next_start + 4.0f * next->collision_radius;
                    if (next_finish > finish)
                        finish = next_finish;
                    e0 = next;
                    next = e0->y_next;
                    while ((next)&&(next->collisionTestFilter==3))  // next has been eliminated - so skip it
                        next = next->y_next;
                    if (next)
                        next_start = next->position.y - 2.0f * next->collision_radius;
                }
                // now either (next == nil) or (next_start >= finish)-which would imply a gap!
            }
            else
            {
                // e0 is a singleton
                e0->collisionTestFilter = 1;
            }
        }
        else // (next == nil)
        {
            // at the end of the list so e0 is a singleton
            e0->collisionTestFilter = 1;
        }
        e0 = next;
    }
    // e0 currently = end of y list
    while (e0)
    {
        // here we are either at the start of the list or just past a gap
        start = e0->position.y + 2.0f * e0->collision_radius;
        finish = start - 4.0f * e0->collision_radius;
        prev = e0->y_previous;
        while ((prev)&&(prev->collisionTestFilter == 3))    // next has been eliminated from the list of possible colliders - so skip it
            prev = prev->y_previous;
        if (prev)
        {
            prev_start = prev->position.y + 2.0f * prev->collision_radius;
            if (prev_start > finish)
            {
                // e0 and next overlap
                while ((prev)&&(prev_start > finish))
                {
                    // skip forward to the next gap or the end of the list
                    prev_finish = prev_start - 4.0f * prev->collision_radius;
                    if (prev_finish < finish)
                        finish = prev_finish;
                    e0 = prev;
                    prev = e0->y_previous;
                    while ((prev)&&(prev->collisionTestFilter==3))  // next has been eliminated - so skip it
                        prev = prev->y_previous;
                    if (prev)
                        prev_start = prev->position.y + 2.0f * prev->collision_radius;
                }
                // now either (prev == nil) or (prev_start <= finish)-which would imply a gap!
            }
            else
            {
                // e0 is a singleton
                e0->collisionTestFilter |= 2;
            }
        }
        else // (prev == nil)
        {
            // at the end of the list so e0 is a singleton
            e0->collisionTestFilter |= 2;
        }
        e0 = prev;
    }
    // done! list filtered
    
    // finally, repeat the z_list - this time building collision chains...
    e0 = z_list_start;
    while (e0)
    {
        // here we are either at the start of the list or just past a gap
        start = e0->position.z - 2.0f * e0->collision_radius;
        finish = start + 4.0f * e0->collision_radius;
        next = e0->z_next;
        while ((next)&&(next->collisionTestFilter==3))  // next has been eliminated from the list of possible colliders - so skip it
            next = next->z_next;
        if (next)
        {
            next_start = next->position.z - 2.0f * next->collision_radius;
            if (next_start < finish)
            {
                // e0 and next overlap
                while ((next)&&(next_start < finish))
                {
                    // chain e0 to next in collision
                    e0->collision_chain = next;
                    // skip forward to the next gap or the end of the list
                    next_finish = next_start + 4.0f * next->collision_radius;
                    if (next_finish > finish)
                        finish = next_finish;
                    e0 = next;
                    next = e0->z_next;
                    while ((next)&&(next->collisionTestFilter==3))  // next has been eliminated - so skip it
                        next = next->z_next;
                    if (next)
                        next_start = next->position.z - 2.0f * next->collision_radius;
                }
                // now either (next == nil) or (next_start >= finish)-which would imply a gap!
                e0->collision_chain = nil;  // end the collision chain
            }
            else
            {
                // e0 is a singleton
                e0->collisionTestFilter = 1;
            }
        }
        else // (next == nil)
        {
            // at the end of the list so e0 is a singleton
            e0->collisionTestFilter = 1;
        }
        e0 = next;
    }
    // e0 currently = end of z list
    while (e0)
    {
        // here we are either at the start of the list or just past a gap
        start = e0->position.z + 2.0f * e0->collision_radius;
        finish = start - 4.0f * e0->collision_radius;
        prev = e0->z_previous;
        while ((prev)&&(prev->collisionTestFilter == 3))    // next has been eliminated from the list of possible colliders - so skip it
            prev = prev->z_previous;
        if (prev)
        {
            prev_start = prev->position.z + 2.0f * prev->collision_radius;
            if (prev_start > finish)
            {
                // e0 and next overlap
                while ((prev)&&(prev_start > finish))
                {
                    // e0 probably already in collision chain at this point, but if it
                    // isn't we have to insert it
                    if (prev->collision_chain != e0)
                    {
                        if (prev->collision_chain == nil)
                        {
                            // easy, just add it onto the start of the chain
                            prev->collision_chain = e0;
                        }
                        else
                        {
                            /* not nil and not e0 shouldn't be possible, I think.
                             * if it is, that implies that e0->collision_chain is nil, though
                             * so: */
                            if (e0->collision_chain == nil)
                            {
                                e0->collision_chain = prev->collision_chain;
                                prev->collision_chain = e0;
                            }
                            else
                            {
                                /* This shouldn't happen... If it does, we accept
                                 * missing collision checks and move on */
                                OOLog(@"general.error.inconsistentState",@"Unexpected state in collision chain builder prev=%@, prev->c=%@, e0=%@, e0->c=%@",prev,prev->collision_chain,e0,e0->collision_chain);
                            }
                        }
                    }
                    // skip forward to the next gap or the end of the list
                    prev_finish = prev_start - 4.0f * prev->collision_radius;
                    if (prev_finish < finish)
                        finish = prev_finish;
                    e0 = prev;
                    prev = e0->z_previous;
                    while ((prev)&&(prev->collisionTestFilter==3))  // next has been eliminated - so skip it
                        prev = prev->z_previous;
                    if (prev)
                        prev_start = prev->position.z + 2.0f * prev->collision_radius;
                }
                // now either (prev == nil) or (prev_start <= finish)-which would imply a gap!
 
                // all the collision chains are already terminated somewhere
                // at this point so no need to set e0->collision_chain = nil
            }
            else
            {
                // e0 is a singleton
                e0->collisionTestFilter |= 2;
            }
        }
        else // (prev == nil)
        {
            // at the end of the list so e0 is a singleton
            e0->collisionTestFilter |= 2;
        }
        e0 = prev;
    }
    // done! list filtered
}

findCollisionsAndShadows

- (void) findCollisionsAndShadows

Definition at line 6447 of file Universe.m.

{
    unsigned i;
    
    [universeRegion clearEntityList];
    
    for (i = 0; i < n_entities; i++)
    {
        [universeRegion checkEntity:sortedEntities[i]]; // sorts out which region it's in
    }
    
    if (![[self gameController] isGamePaused])
    {
        [universeRegion findCollisions];
    }
    
    // do check for entities that can't see the sun!
    [universeRegion findShadowedEntities];
}

findConnectedSystemAtCoords:withGalaxy:

- (OOSystemID) findConnectedSystemAtCoords:		(NSPoint)	coords
withGalaxy:		(OOGalaxyID)	gal

Definition at line 7996 of file Universe.m.

                                          :(NSPoint) coords withGalaxy:(OOGalaxyID) g
{
 
    double distance;
    int n,i,j;
    double min_dist = 10000.0;
    
    // make list of connected systems
    BOOL connected[256];
    for (i = 0; i < 256; i++)
        connected[i] = NO;
    connected[0] = YES;         // system zero is always connected (true for galaxies 0..7)
    for (n = 0; n < 3; n++)     //repeat three times for surety
    {
        for (i = 0; i < 256; i++)   // flood fill out from system zero
        {
            NSPoint ipos = [systemManager getCoordinatesForSystem:i inGalaxy:g];
            for (j = 0; j < 256; j++)
            {
                NSPoint jpos = [systemManager getCoordinatesForSystem:j inGalaxy:g];
                double dist = distanceBetweenPlanetPositions(ipos.x,ipos.y,jpos.x,jpos.y);
                if (dist <= MAX_JUMP_RANGE)
                {
                    connected[j] |= connected[i];
                    connected[i] |= connected[j];
                }
            }
        }
    }
    OOSystemID system = 0;
    for (i = 0; i < 256; i++)
    {
        NSPoint ipos = [systemManager getCoordinatesForSystem:i inGalaxy:g];
        distance = distanceBetweenPlanetPositions((int)coords.x, (int)coords.y, ipos.x, ipos.y);
        if ((connected[i])&&(distance < min_dist))
        {
            min_dist = distance;
            system = i;
        }
    }
    
    return system;  
}

findEntitiesMatchingPredicate:parameter:inRange:ofEntity:

- (NSMutableArray *) findEntitiesMatchingPredicate:		(EntityFilterPredicate)	predicate
parameter:		(void *)	parameter
inRange:		(double)	range
ofEntity:		(Entity *)	entity

Definition at line 6447 of file Universe.m.

                                                  :(EntityFilterPredicate)predicate
                                  parameter:(void *)parameter
                                    inRange:(double)range
                                   ofEntity:(Entity *)e1
{
    OOJS_PROFILE_ENTER
    
    unsigned        i;
    HPVector            p1;
    NSMutableArray  *result = nil;
    
    OOJSPauseTimeLimiter();
    
    if (predicate == NULL)  predicate = YESPredicate;
    
    result = [NSMutableArray arrayWithCapacity:n_entities];
    
    if (e1 != nil)  p1 = [e1 position];
    else  p1 = kZeroHPVector;
    
    for (i = 0; i < n_entities; i++)
    {
        Entity *e2 = sortedEntities[i];
        
        if (e1 != e2 &&
            EntityInRange(p1, e2, range) &&
            predicate(e2, parameter))
        {
            [result addObject:e2];
        }
    }
    
    OOJSResumeTimeLimiter();
    
    return result;
    
    OOJS_PROFILE_EXIT
}

findNeighbouringSystemToCoords:withGalaxy:

- (OOSystemID) findNeighbouringSystemToCoords:		(NSPoint)	coords
withGalaxy:		(OOGalaxyID)	gal

Definition at line 7996 of file Universe.m.

                                             :(NSPoint) coords withGalaxy:(OOGalaxyID) g
{
 
    double distance;
    int n,i,j;
    double min_dist = 10000.0;
    
    // make list of connected systems
    BOOL connected[256];
    for (i = 0; i < 256; i++)
        connected[i] = NO;
    connected[0] = YES;         // system zero is always connected (true for galaxies 0..7)
    for (n = 0; n < 3; n++)     //repeat three times for surety
    {
        for (i = 0; i < 256; i++)   // flood fill out from system zero
        {
            NSPoint ipos = [systemManager getCoordinatesForSystem:i inGalaxy:g];
            for (j = 0; j < 256; j++)
            {
                NSPoint jpos = [systemManager getCoordinatesForSystem:j inGalaxy:g];
                double dist = distanceBetweenPlanetPositions(ipos.x,ipos.y,jpos.x,jpos.y);
                if (dist <= MAX_JUMP_RANGE)
                {
                    connected[j] |= connected[i];
                    connected[i] |= connected[j];
                }
            }
        }
    }
    OOSystemID system = 0;
    for (i = 0; i < 256; i++)
    {
        NSPoint ipos = [systemManager getCoordinatesForSystem:i inGalaxy:g];
        distance = distanceBetweenPlanetPositions((int)coords.x, (int)coords.y, ipos.x, ipos.y);
        if ((connected[i])&&(distance < min_dist)&&(distance != 0.0))
        {
            min_dist = distance;
            system = i;
        }
    }
    
    return system;
}

findOneEntityMatchingPredicate:parameter:

- (id) findOneEntityMatchingPredicate:		(EntityFilterPredicate)	predicate
parameter:		(void *)	parameter

Definition at line 6447 of file Universe.m.

                                     :(EntityFilterPredicate)predicate
                            parameter:(void *)parameter
{
    unsigned        i;
    Entity          *candidate = nil;
    
    OOJSPauseTimeLimiter();
    
    if (predicate == NULL)  predicate = YESPredicate;
    
    for (i = 0; i < n_entities; i++)
    {
        candidate = sortedEntities[i];
        if (predicate(candidate, parameter))  return candidate;
    }
    
    OOJSResumeTimeLimiter();
    
    return nil;
}

findShipsMatchingPredicate:parameter:inRange:ofEntity:

- (NSMutableArray *) findShipsMatchingPredicate:		(EntityFilterPredicate)	predicate
parameter:		(void *)	parameter
inRange:		(double)	range
ofEntity:		(Entity *)	entity

Definition at line 6447 of file Universe.m.

                                               :(EntityFilterPredicate)predicate
                                      parameter:(void *)parameter
                                        inRange:(double)range
                                       ofEntity:(Entity *)entity
{
    if (predicate != NULL)
    {
        BinaryOperationPredicateParameter param =
        {
            IsShipPredicate, NULL,
            predicate, parameter
        };
        
        return [self findEntitiesMatchingPredicate:ANDPredicate
                                         parameter:&param
                                           inRange:range
                                          ofEntity:entity];
    }
    else
    {
        return [self findEntitiesMatchingPredicate:IsShipPredicate
                                         parameter:NULL
                                           inRange:range
                                          ofEntity:entity];
    }
}

findSystemAtCoords:withGalaxy:

- (OOSystemID) findSystemAtCoords:		(NSPoint)	coords
withGalaxy:		(OOGalaxyID)	gal

Definition at line 7996 of file Universe.m.

                                 :(NSPoint) coords withGalaxy:(OOGalaxyID) g
{
    OOLog(@"deprecated.function", @"%@", @"findSystemAtCoords");
    return [self findSystemNumberAtCoords:coords withGalaxy:g includingHidden:YES];
}

findSystemCoordinatesWithPrefix:

- (NSPoint) findSystemCoordinatesWithPrefix:

(NSString *)

p_fix

Definition at line 7996 of file Universe.m.

                                           :(NSString *) p_fix
{
    return [self findSystemCoordinatesWithPrefix:p_fix exactMatch:NO];
}

findSystemCoordinatesWithPrefix:exactMatch:

- (NSPoint) findSystemCoordinatesWithPrefix:		(NSString *)	p_fix
exactMatch:		(BOOL)	exactMatch

Definition at line 7996 of file Universe.m.

                                           :(NSString *) p_fix exactMatch:(BOOL) exactMatch
{
    NSString    *system_name = nil;
    NSPoint     system_coords = NSMakePoint(-1.0,-1.0);
    int i;
    int result = -1;
    for (i = 0; i < 256; i++)
    {
        system_found[i] = NO;
        system_name = [system_names[i] lowercaseString];
        if ((exactMatch && [system_name isEqualToString:p_fix]) || (!exactMatch && [system_name hasPrefix:p_fix]))
        {
            /* Only used in player-based search routines */
            NSDictionary *systemInfo = [systemManager getPropertiesForSystem:i inGalaxy:galaxyID];
            NSInteger concealment = [systemInfo oo_intForKey:@"concealment" defaultValue:OO_SYSTEMCONCEALMENT_NONE];
            if (concealment >= OO_SYSTEMCONCEALMENT_NONAME) {
                // system is not known
                continue;
            }
            
            system_found[i] = YES;
            if (result < 0)
            {
                system_coords = [systemManager getCoordinatesForSystem:i inGalaxy:galaxyID];
                result = i;
            }
        }
    }
    return system_coords;
}

findSystemFromName:

- (OOSystemID) findSystemFromName:

(NSString *)

sysName

Definition at line 7996 of file Universe.m.

                                 :(NSString *) sysName
{
    if (sysName == nil) return -1;  // no match found!
    
    NSString    *system_name = nil;
    NSString    *match = [sysName lowercaseString];
    int i;
    for (i = 0; i < 256; i++)
    {
        system_name = [system_names[i] lowercaseString];
        if ([system_name isEqualToString:match])
        {
            return i;
        }
    }
    return -1;  // no match found!
}

findSystemNumberAtCoords:withGalaxy:includingHidden:

- (OOSystemID) findSystemNumberAtCoords:		(NSPoint)	coords
withGalaxy:		(OOGalaxyID)	gal
includingHidden:		(BOOL)	hidden

Definition at line 7996 of file Universe.m.

                                       :(NSPoint) coords withGalaxy:(OOGalaxyID)g includingHidden:(BOOL)hidden
{
    /*
        NOTE: this previously used NSNotFound as the default value, but
        returned an int, which would truncate on 64-bit systems. I assume
        no-one was using it in a context where the default value was returned.
        -- Ahruman 2012-08-25
    */
    OOSystemID  system = kOOMinimumSystemID;
    unsigned    distance, dx, dy;
    OOSystemID  i;
    unsigned    min_dist = 10000;
    
    for (i = 0; i < 256; i++)
    {
        if (!hidden) {
            NSDictionary *systemInfo = [systemManager getPropertiesForSystem:i inGalaxy:g];
            NSInteger concealment = [systemInfo oo_intForKey:@"concealment" defaultValue:OO_SYSTEMCONCEALMENT_NONE];
            if (concealment >= OO_SYSTEMCONCEALMENT_NOTHING) {
                // system is not known
                continue;
            }
        }
        NSPoint ipos = [systemManager getCoordinatesForSystem:i inGalaxy:g];
        dx = ABS(coords.x - ipos.x);
        dy = ABS(coords.y - ipos.y);
        
        if (dx > dy)    distance = (dx + dx + dy) / 2;
        else            distance = (dx + dy + dy) / 2;
        
        if (distance < min_dist)
        {
            min_dist = distance;
            system = i;
        }
        // with coincident systems choose only if ABOVE
        if ((distance == min_dist)&&(coords.y > ipos.y))
        {
            system = i;
        }
        // or if EQUAL but already selected
        else if ((distance == min_dist)&&(coords.y == ipos.y)&&(i==[PLAYER targetSystemID]))
        {
            system = i;
        }
    }
    return system;
}

findVisualEffectsMatchingPredicate:parameter:inRange:ofEntity:

- (NSMutableArray *) findVisualEffectsMatchingPredicate:		(EntityFilterPredicate)	predicate
parameter:		(void *)	parameter
inRange:		(double)	range
ofEntity:		(Entity *)	entity

Definition at line 6447 of file Universe.m.

                                                       :(EntityFilterPredicate)predicate
                                      parameter:(void *)parameter
                                        inRange:(double)range
                                       ofEntity:(Entity *)entity
{
    if (predicate != NULL)
    {
        BinaryOperationPredicateParameter param =
        {
            IsVisualEffectPredicate, NULL,
            predicate, parameter
        };
        
        return [self findEntitiesMatchingPredicate:ANDPredicate
                                         parameter:&param
                                           inRange:range
                                          ofEntity:entity];
    }
    else
    {
        return [self findEntitiesMatchingPredicate:IsVisualEffectPredicate
                                         parameter:NULL
                                           inRange:range
                                          ofEntity:entity];
    }
}

firstBeacon

- (Entity< OOBeaconEntity > *) firstBeacon

Definition at line 3616 of file Universe.m.

{
    return [_firstBeacon weakRefUnderlyingObject];
}

firstEntityTargetedByPlayer

- (Entity *) firstEntityTargetedByPlayer

Definition at line 5364 of file Universe.m.

{
    PlayerEntity    *player = PLAYER;
    Entity          *hit_entity = nil;
    OOScalar        nearest2 = SCANNER_MAX_RANGE - 100; // 100m shorter than range at which target is lost
    nearest2 *= nearest2;
    int             i;
    int             ent_count = n_entities;
    int             ship_count = 0;
    Entity          *my_entities[ent_count];
    
    for (i = 0; i < ent_count; i++)
    {
        if (([sortedEntities[i] isShip] && ![sortedEntities[i] isPlayer]) || [sortedEntities[i] isWormhole])
        {
            my_entities[ship_count++] = [sortedEntities[i] retain];
        }
    }
    
    Quaternion q1 = [player normalOrientation];
    Vector u1, f1, r1;
    basis_vectors_from_quaternion(q1, &r1, &u1, &f1);
    Vector offset = [player weaponViewOffset];
    
    HPVector p1 = HPvector_add([player position], vectorToHPVector(OOVectorMultiplyMatrix(offset, OOMatrixFromBasisVectors(r1, u1, f1))));
    
    // Note: deliberately tied to view direction, not weapon facing. All custom views count as forward for targeting.
    switch (viewDirection)
    {
        case VIEW_AFT :
            quaternion_rotate_about_axis(&q1, u1, M_PI);
            break;
        case VIEW_PORT :
            quaternion_rotate_about_axis(&q1, u1, 0.5 * M_PI);
            break;
        case VIEW_STARBOARD :
            quaternion_rotate_about_axis(&q1, u1, -0.5 * M_PI);
            break;
        default:
            break;
    }
    basis_vectors_from_quaternion(q1, &r1, NULL, &f1);
    
    for (i = 0; i < ship_count; i++)
    {
        Entity *e2 = my_entities[i];
        if ([e2 canCollide] && [e2 scanClass] != CLASS_NO_DRAW)
        {
            Vector rp = HPVectorToVector(HPvector_subtract([e2 position], p1));
            OOScalar dist2 = magnitude2(rp);
            if (dist2 < nearest2)
            {
                OOScalar df = dot_product(f1, rp);
                if (df > 0.0 && df * df < nearest2)
                {
                    OOScalar du = dot_product(u1, rp);
                    OOScalar dr = dot_product(r1, rp);
                    OOScalar cr = [e2 collisionRadius];
                    if (du * du + dr * dr < cr * cr)
                    {
                        hit_entity = e2;
                        nearest2 = dist2;
                    }
                }
            }
        }
    }
    // check for MASC'M
    if (hit_entity != nil && [hit_entity isShip])
    {
        ShipEntity* ship = (ShipEntity*)hit_entity;
        if ([ship isJammingScanning] && ![player hasMilitaryScannerFilter])
        {
            hit_entity = nil;
        }
    }
    
    for (i = 0; i < ship_count; i++)
    {
        [my_entities[i] release];
    }
    
    return hit_entity;
}

firstEntityTargetedByPlayerPrecisely

- (Entity *) firstEntityTargetedByPlayerPrecisely

Definition at line 5364 of file Universe.m.

{
    OOWeaponFacing targetFacing;
    Vector laserPortOffset = kZeroVector;
    PlayerEntity *player = PLAYER;
 
    switch (viewDirection)
    {
        case VIEW_FORWARD:
            targetFacing = WEAPON_FACING_FORWARD;
            laserPortOffset = [[player forwardWeaponOffset] oo_vectorAtIndex:0];
            break;
            
        case VIEW_AFT:
            targetFacing = WEAPON_FACING_AFT;
            laserPortOffset = [[player aftWeaponOffset] oo_vectorAtIndex:0];
            break;
            
        case VIEW_PORT:
            targetFacing = WEAPON_FACING_PORT;
            laserPortOffset = [[player portWeaponOffset] oo_vectorAtIndex:0];
            break;
            
        case VIEW_STARBOARD:
            targetFacing = WEAPON_FACING_STARBOARD;
            laserPortOffset = [[player starboardWeaponOffset] oo_vectorAtIndex:0];
            break;
            
        default:
            // Match behaviour of -firstEntityTargetedByPlayer.
            targetFacing = WEAPON_FACING_FORWARD;
            laserPortOffset = [[player forwardWeaponOffset] oo_vectorAtIndex:0];
    }
    
    return [self firstShipHitByLaserFromShip:PLAYER inDirection:targetFacing offset:laserPortOffset gettingRangeFound:NULL];
}

firstShipHitByLaserFromShip:inDirection:offset:gettingRangeFound:

- (ShipEntity *) firstShipHitByLaserFromShip:		(ShipEntity *)	srcEntity
inDirection:		(OOWeaponFacing)	direction
offset:		(Vector)	offset
gettingRangeFound:		(GLfloat*)	range_ptr

Definition at line 5364 of file Universe.m.

                                            :(ShipEntity *)srcEntity inDirection:(OOWeaponFacing)direction offset:(Vector)offset gettingRangeFound:(GLfloat *)range_ptr
{
    if (srcEntity == nil) return nil;
    
    ShipEntity      *hit_entity = nil;
    ShipEntity      *hit_subentity = nil;
    HPVector            p0 = [srcEntity position];
    Quaternion      q1 = [srcEntity normalOrientation];
    ShipEntity      *parent = [srcEntity parentEntity];
    
    if (parent)
    {
        // we're a subentity!
        BoundingBox bbox = [srcEntity boundingBox];
        HPVector midfrontplane = make_HPvector(0.5 * (bbox.max.x + bbox.min.x), 0.5 * (bbox.max.y + bbox.min.y), bbox.max.z);
        p0 = [srcEntity absolutePositionForSubentityOffset:midfrontplane];
        q1 = [parent orientation];
        if ([parent isPlayer])  q1.w = -q1.w;
    }
    
    double          nearest = [srcEntity weaponRange];
    int             i;
    int             ent_count = n_entities;
    int             ship_count = 0;
    ShipEntity      *my_entities[ent_count];
    
    for (i = 0; i < ent_count; i++)
    {
        Entity* ent = sortedEntities[i];
        if (ent != srcEntity && ent != parent && [ent isShip] && [ent canCollide])
        {
            my_entities[ship_count++] = [(ShipEntity *)ent retain];
        }
    }
    
    
    Vector u1, f1, r1;
    basis_vectors_from_quaternion(q1, &r1, &u1, &f1);
    p0 = HPvector_add(p0, vectorToHPVector(OOVectorMultiplyMatrix(offset, OOMatrixFromBasisVectors(r1, u1, f1))));
    
    switch (direction)
    {
        case WEAPON_FACING_FORWARD:
        case WEAPON_FACING_NONE:
            break;
            
        case WEAPON_FACING_AFT:
            quaternion_rotate_about_axis(&q1, u1, M_PI);
            break;
            
        case WEAPON_FACING_PORT:
            quaternion_rotate_about_axis(&q1, u1, M_PI/2.0);
            break;
            
        case WEAPON_FACING_STARBOARD:
            quaternion_rotate_about_axis(&q1, u1, -M_PI/2.0);
            break;
    }
    
    basis_vectors_from_quaternion(q1, &r1, NULL, &f1);
    HPVector p1 = HPvector_add(p0, vectorToHPVector(vector_multiply_scalar(f1, nearest)));  //endpoint
    
    for (i = 0; i < ship_count; i++)
    {
        ShipEntity *e2 = my_entities[i];
        
        // check outermost bounding sphere
        GLfloat cr = e2->collision_radius;
        Vector rpos = HPVectorToVector(HPvector_subtract(e2->position, p0));
        Vector v_off = make_vector(dot_product(rpos, r1), dot_product(rpos, u1), dot_product(rpos, f1));
        if (v_off.z > 0.0 && v_off.z < nearest + cr &&                              // ahead AND within range
            v_off.x < cr && v_off.x > -cr && v_off.y < cr && v_off.y > -cr &&       // AND not off to one side or another
            v_off.x * v_off.x + v_off.y * v_off.y < cr * cr)                        // AND not off to both sides
        {
            ShipEntity *entHit = nil;
            GLfloat hit = [(ShipEntity *)e2 doesHitLine:p0 :p1 :&entHit];   // octree detection
            
            if (hit > 0.0 && hit < nearest)
            {
                if ([entHit isSubEntity])
                {
                    hit_subentity = entHit;
                }
                hit_entity = e2;
                nearest = hit;
                p1 = HPvector_add(p0, vectorToHPVector(vector_multiply_scalar(f1, nearest)));
            }
        }
    }
    
    if (hit_entity)
    {
        // I think the above code does not guarantee that the closest hit_subentity belongs to the closest hit_entity.
        if (hit_subentity && [hit_subentity owner] == hit_entity)  [hit_entity setSubEntityTakingDamage:hit_subentity];
        
        if (range_ptr != NULL)
        {
            *range_ptr = nearest;
        }
    }
    
    for (i = 0; i < ship_count; i++)  [my_entities[i] release]; //  released
    
    return hit_entity;
}

forceLightSwitch

- (void) forceLightSwitch

Definition at line 273 of file Universe.m.

{
    demo_light_on = !demo_light_on;
}

forceWitchspaceEntries

- (void) forceWitchspaceEntries

Definition at line 273 of file Universe.m.

{
    unsigned i;
    for (i = 0; i < n_entities; i++)
    {
        if (sortedEntities[i]->isShip)
        {
            ShipEntity *my_ship = (ShipEntity*)sortedEntities[i];
            Entity* my_target = [my_ship primaryTarget];
            if ([my_target isWormhole])
            {
                [my_ship enterTargetWormhole];
            }
            else if ([[[my_ship getAI] state] isEqualToString:@"ENTER_WORMHOLE"])
            {
                [my_ship enterTargetWormhole];
            }
        }
    }
}

fractionalPositionFrom:to:withFraction:

- (HPVector) fractionalPositionFrom: (HPVector) point0 to: (HPVector) point1 withFraction: (double) routeFraction

implementation

Provided by category Universe(OOPrivate).

Definition at line 9471 of file Universe.m.

                                   :(HPVector)point0 to:(HPVector)point1 withFraction:(double)routeFraction
{
    if (routeFraction == NSNotFound) routeFraction = randf();
    
    point1 = OOHPVectorInterpolate(point0, point1, routeFraction);
    
    point1.x += 2 * SCANNER_MAX_RANGE * (randf() - 0.5);
    point1.y += 2 * SCANNER_MAX_RANGE * (randf() - 0.5);
    point1.z += 2 * SCANNER_MAX_RANGE * (randf() - 0.5);
    
    return point1;
}

framesDoneThisUpdate

- (int) framesDoneThisUpdate

gameController

- (GameController *) gameController

Definition at line 3616 of file Universe.m.

{
    return [[self gameView] gameController];
}

gameSettings

- (NSDictionary *) gameSettings

Definition at line 3616 of file Universe.m.

{
#if OOLITE_SDL
    NSMutableDictionary *result = [NSMutableDictionary dictionaryWithCapacity:11];
#else
    NSMutableDictionary *result = [NSMutableDictionary dictionaryWithCapacity:10];
#endif
    
    [result oo_setInteger:[PLAYER isSpeechOn] forKey:@"speechOn"];
    [result oo_setBool:autoSave forKey:@"autosave"];
    [result oo_setBool:wireframeGraphics forKey:@"wireframeGraphics"];
    [result oo_setBool:doProcedurallyTexturedPlanets forKey:@"procedurallyTexturedPlanets"];
#if OOLITE_SDL
    [result oo_setFloat:[gameView gammaValue] forKey:@"gammaValue"];
#endif
 
    [result oo_setFloat:[gameView fov:NO] forKey:@"fovValue"];
 
#if OOLITE_WINDOWS
    if ([gameView hdrOutput])
    {
        [result oo_setFloat:[gameView hdrMaxBrightness] forKey:@"hdr-max-brightness"];
        [result oo_setFloat:[gameView hdrPaperWhiteBrightness] forKey:@"hdr-paperwhite-brightness"];
    }
#endif
    
    [result setObject:OOStringFromGraphicsDetail([self detailLevel]) forKey:@"detailLevel"];
    
    NSString *desc = @"UNDEFINED";
    switch ([[OOMusicController sharedController] mode])
    {
        case kOOMusicOff:       desc = @"MUSIC_OFF"; break;
        case kOOMusicOn:        desc = @"MUSIC_ON"; break;
        case kOOMusicITunes:    desc = @"MUSIC_ITUNES"; break;
    }
    [result setObject:desc forKey:@"musicMode"];
    
    NSDictionary *gameWindow = [NSDictionary dictionaryWithObjectsAndKeys:
                        [NSNumber numberWithFloat:[gameView viewSize].width], @"width",
                        [NSNumber numberWithFloat:[gameView viewSize].height], @"height",
                        [NSNumber numberWithBool:[[self gameController] inFullScreenMode]], @"fullScreen",
                        nil];
    [result setObject:gameWindow forKey:@"gameWindow"];
    
    [result setObject:[PLAYER keyConfig] forKey:@"keyConfig"];
 
    return [[result copy] autorelease];
}

gameView

- (MyOpenGLView *) gameView

generateSystemData:

- (NSDictionary *) generateSystemData:

(OOSystemID)

s

Definition at line 7996 of file Universe.m.

                                     :(OOSystemID) s
{
    return [self generateSystemData:s useCache:YES];
}

generateSystemData:useCache:

- (NSDictionary *) generateSystemData:		(OOSystemID)	s
useCache:		(BOOL)	useCache

Definition at line 7996 of file Universe.m.

                                     :(OOSystemID) s useCache:(BOOL) useCache
{
    OOJS_PROFILE_ENTER
    
// TODO: At the moment this method is only called for systems in the
// same galaxy. At some point probably needs generalising to have a
// galaxynumber parameter.
    NSString *systemKey = [NSString stringWithFormat:@"%u %u",[PLAYER galaxyNumber],s];
 
    return [systemManager getPropertiesForSystemKey:systemKey];
    
    OOJS_PROFILE_EXIT
}

generateSystemDataForGalaxy:planet:

- (NSDictionary *) generateSystemDataForGalaxy: (OOGalaxyID) gnum planet: (OOSystemID) pnum

implementation

Definition at line 7996 of file Universe.m.

                                              :(OOGalaxyID)gnum planet:(OOSystemID)pnum
{
    NSString *systemKey = [self keyForPlanetOverridesForSystem:pnum inGalaxy:gnum];
    return [systemManager getPropertiesForSystemKey:systemKey];
}

getActiveViewMatrix:forwardVector:upVector:

- (void) getActiveViewMatrix: (OOMatrix *) outMatrix forwardVector: (Vector *) outForward upVector: (Vector *) outUp

implementation

Definition at line 4630 of file Universe.m.

                            :(OOMatrix *)outMatrix forwardVector:(Vector *)outForward upVector:(Vector *)outUp
{
    assert(outMatrix != NULL && outForward != NULL && outUp != NULL);
    
    PlayerEntity            *player = nil;
    
    switch (viewDirection)
    {
        case VIEW_AFT:
            *outMatrix = aft_matrix;
            *outForward = vector_flip(kBasisZVector);
            *outUp = kBasisYVector;
            return;
            
        case VIEW_PORT:
            *outMatrix = port_matrix;
            *outForward = vector_flip(kBasisXVector);
            *outUp = kBasisYVector;
            return;
            
        case VIEW_STARBOARD:
            *outMatrix = starboard_matrix;
            *outForward = kBasisXVector;
            *outUp = kBasisYVector;
            return;
            
        case VIEW_CUSTOM:
            player = PLAYER;
            *outMatrix = [player customViewMatrix];
            *outForward = [player customViewForwardVector];
            *outUp = [player customViewUpVector];
            return;
            
        case VIEW_FORWARD:
        case VIEW_NONE:
        case VIEW_GUI_DISPLAY:
        case VIEW_BREAK_PATTERN:
            ;
    }
    
    *outMatrix = fwd_matrix;
    *outForward = kBasisZVector;
    *outUp = kBasisYVector;
}

getConditionScript:

- (OOJSScript *) getConditionScript:

(NSString *)

scriptname

Definition at line 10697 of file Universe.m.

                                  :(NSString *)scriptname
{
    return [conditionScripts objectForKey:scriptname];
}

getContainersOfCommodity:commodity_name:

- (NSArray *) getContainersOfCommodity:		(OOCommodityType)
commodity_name:		(OOCargoQuantity)	how_many

Definition at line 3616 of file Universe.m.

                                      :(OOCommodityType)commodity_name :(OOCargoQuantity)how_much
{
    NSMutableArray  *accumulator = [NSMutableArray arrayWithCapacity:how_much];
    if (![commodities goodDefined:commodity_name])  
    {
        return [NSArray array]; // empty array
    }
    
    ShipEntity *container = [cargoPods objectForKey:commodity_name];
    while (how_much > 0)
    {
        if (container)
        {
            [accumulator addObject:container];
        }
        else
        {
            OOLog(@"universe.createContainer.failed", @"***** ERROR: failed to find a container to fill with %@", commodity_name);
        }
 
        how_much--;
    }
    return [NSArray arrayWithArray:accumulator];    
}

getContainersOfGoods:scarce:legal:

- (NSArray *) getContainersOfGoods:		(OOCargoQuantity)	how_many
scarce:		(BOOL)	scarce
legal:		(BOOL)	legal

Definition at line 3616 of file Universe.m.

                                  :(OOCargoQuantity)how_many scarce:(BOOL)scarce legal:(BOOL)legal
{
    /*  build list of goods allocating 0..100 for each based on how much of
        each quantity there is. Use a ratio of n x 100/64 for plentiful goods;
        reverse the probabilities for scarce goods.
    */
    NSMutableArray  *accumulator = [NSMutableArray arrayWithCapacity:how_many];
    NSUInteger      i=0, commodityCount = [commodityMarket count];
    OOCargoQuantity quantities[commodityCount];
    OOCargoQuantity total_quantity = 0;
 
    NSArray         *goodsKeys = [commodityMarket goods];
    NSString        *goodsKey = nil;
 
    foreach (goodsKey, goodsKeys)
    {
        OOCargoQuantity q = [commodityMarket quantityForGood:goodsKey];
        if (scarce)
        {
            if (q < 64)  q = 64 - q;
            else  q = 0;
        }
        // legal YES restricts (almost) only to legal goods
        // legal NO allows illegal goods, but not necessarily a full hold
        if (legal && [commodityMarket exportLegalityForGood:goodsKey] > 0)
        {
            q &= 1; // keep a very small chance, sometimes
        }
        if (q > 64) q = 64;
        q *= 100;   q/= 64;
        quantities[i++] = q;
        total_quantity += q;
    }
    // quantities is now used to determine which good get into the containers
    for (i = 0; i < how_many; i++)
    {
        NSUInteger co_type = 0;
        
        int qr=0;
        if(total_quantity)
        {
            qr = 1+(Ranrot() % total_quantity);
            co_type = 0;
            while (qr > 0)
            {
                NSAssert((NSUInteger)co_type < commodityCount, @"Commodity type index out of range.");
                qr -= quantities[co_type++];
            }
            co_type--;
        }
 
        ShipEntity *container = [cargoPods objectForKey:[goodsKeys oo_stringAtIndex:co_type]];
        
        if (container != nil)
        {
            [accumulator addObject:container];
        }
        else
        {
            OOLog(@"universe.createContainer.failed", @"***** ERROR: failed to find a container to fill with %@ (%ld).", [goodsKeys oo_stringAtIndex:co_type], co_type);
 
        }
    }
    return [NSArray arrayWithArray:accumulator];    
}

getEquipmentPriceForKey:

- (OOCreditsQuantity) getEquipmentPriceForKey:

(NSString *)

eq_key

Definition at line 3616 of file Universe.m.

                                             :(NSString *)eq_key
{
    NSArray *itemData;
    foreach (itemData, equipmentData)
    {
        NSString *itemType = [itemData oo_stringAtIndex:EQUIPMENT_KEY_INDEX];
        
        if ([itemType isEqual:eq_key])
        {
            return [itemData oo_unsignedLongLongAtIndex:EQUIPMENT_PRICE_INDEX];
        }
    }
    return 0;
}

getPopulatorSettings

- (NSDictionary *) getPopulatorSettings

Definition at line 273 of file Universe.m.

{
    return populatorSettings;
}

getRandomAmountOfCommodity:

- (OOCargoQuantity) getRandomAmountOfCommodity:

(OOCommodityType)

co_type

Definition at line 3616 of file Universe.m.

                                              :(OOCommodityType)co_type
{
    OOMassUnit      units;
    
    if (co_type == nil)  {
        return 0;
    }
    
    units = [commodities massUnitForGood:co_type];
    switch (units)
    {
        case 0 :    // TONNES
            return 1;
        case 1 :    // KILOGRAMS
            return 1 + (Ranrot() % 6) + (Ranrot() % 6) + (Ranrot() % 6);
        case 2 :    // GRAMS
            return 4 + (Ranrot() % 16) + (Ranrot() % 11) + (Ranrot() % 6);
    }
    OOLog(@"universe.commodityAmount.warning",@"Commodity %@ has an unrecognised mass unit, assuming tonnes",co_type);
    return 1;
}

getRandomCommodity

- (NSString *) getRandomCommodity

Definition at line 3616 of file Universe.m.

{
    return [commodities getRandomCommodity];
}

getSafeVectorFromEntity:toDistance:fromPoint:

- (HPVector) getSafeVectorFromEntity:		(Entity *)	e1
toDistance:		(double)	dist
fromPoint:		(HPVector)	p2

Definition at line 5364 of file Universe.m.

                                    :(Entity *) e1 toDistance:(double)dist fromPoint:(HPVector) p2
{
    // heuristic three
    
    if (!e1)
    {
        OOLog(kOOLogParameterError, @"%@", @"***** No entity set in Universe getSafeVectorFromEntity:toDistance:fromPoint:");
        return kZeroHPVector;
    }
    
    HPVector  f1;
    HPVector  result = p2;
    int i;
    int ent_count = n_entities;
    Entity* my_entities[ent_count];
    for (i = 0; i < ent_count; i++)
        my_entities[i] = [sortedEntities[i] retain];    // retained
    HPVector p1 = e1->position;
    HPVector v1 = p2;
    v1.x -= p1.x;   v1.y -= p1.y;   v1.z -= p1.z;   // vector from entity to p2
    
    double  nearest = sqrt(v1.x*v1.x + v1.y*v1.y + v1.z*v1.z) - dist;  // length of vector
    
    if (v1.x || v1.y || v1.z)
        f1 = HPvector_normal(v1);   // unit vector in direction of p2 from p1
    else
        f1 = make_HPvector(0, 0, 1);
    
    for (i = 0; i < ent_count; i++)
    {
        Entity *e2 = my_entities[i];
        if ((e2 != e1)&&([e2 canCollide]))
        {
            HPVector epos = e2->position;
            epos.x -= p1.x; epos.y -= p1.y; epos.z -= p1.z;
            double d_forward = HPdot_product(epos,f1);
            if ((d_forward > 0)&&(d_forward < nearest))
            {
                double cr = 1.20 * (e2->collision_radius + e1->collision_radius); //  20% safety margin
                
                HPVector p0 = e1->position;
                p0.x += d_forward * f1.x;   p0.y += d_forward * f1.y;   p0.z += d_forward * f1.z;
                // p0 holds nearest point on current course to center of incident object
                
                HPVector epos = e2->position;
                p0.x -= epos.x; p0.y -= epos.y; p0.z -= epos.z;
                // compare with center of incident object
                
                double  dist2 = p0.x * p0.x + p0.y * p0.y + p0.z * p0.z;
                
                if (dist2 < cr*cr)
                {
                    result = e2->position;          // center of incident object
                    nearest = d_forward;
                    
                    if (dist2 == 0.0)
                    {
                        // ie. we're on a line through the object's center !
                        // jitter the position somewhat!
                        result.x += ((int)(Ranrot() % 1024) - 512)/512.0; //   -1.0 .. +1.0
                        result.y += ((int)(Ranrot() % 1024) - 512)/512.0; //   -1.0 .. +1.0
                        result.z += ((int)(Ranrot() % 1024) - 512)/512.0; //   -1.0 .. +1.0
                    }
                    
                    HPVector  nearest_point = p1;
                    nearest_point.x += d_forward * f1.x;    nearest_point.y += d_forward * f1.y;    nearest_point.z += d_forward * f1.z;
                    // nearest point now holds nearest point on line to center of incident object
                    
                    HPVector outward = nearest_point;
                    outward.x -= result.x;  outward.y -= result.y;  outward.z -= result.z;
                    if (outward.x||outward.y||outward.z)
                        outward = HPvector_normal(outward);
                    else
                        outward.y = 1.0;
                    // outward holds unit vector through the nearest point on the line from the center of incident object
                    
                    HPVector backward = p1;
                    backward.x -= result.x; backward.y -= result.y; backward.z -= result.z;
                    if (backward.x||backward.y||backward.z)
                        backward = HPvector_normal(backward);
                    else
                        backward.z = -1.0;
                    // backward holds unit vector from center of the incident object to the center of the ship
                    
                    HPVector dd = result;
                    dd.x -= p1.x; dd.y -= p1.y; dd.z -= p1.z;
                    double current_distance = HPmagnitude(dd);
                    
                    // sanity check current_distance
                    if (current_distance < cr * 1.25)   // 25% safety margin
                        current_distance = cr * 1.25;
                    if (current_distance > cr * 5.0)    // up to 2 diameters away 
                        current_distance = cr * 5.0;
                    
                    // choose a point that's three parts backward and one part outward
                    
                    result.x += 0.25 * (outward.x * current_distance) + 0.75 * (backward.x * current_distance);     // push 'out' by this amount
                    result.y += 0.25 * (outward.y * current_distance) + 0.75 * (backward.y * current_distance);
                    result.z += 0.25 * (outward.z * current_distance) + 0.75 * (backward.z * current_distance);
                    
                }
            }
        }
    }
    for (i = 0; i < ent_count; i++)
        [my_entities[i] release]; //    released
    return result;
}

getStationMarkets

- (NSArray *) getStationMarkets

Definition at line 7996 of file Universe.m.

{
    NSMutableArray *markets = [[NSMutableArray alloc] init];
    NSArray *stations = [self stations];
 
    StationEntity *station = nil;
    NSMutableDictionary *savedMarket = nil;
 
    OOCommodityMarket *stationMarket = nil;
 
    foreach (station, stations)
    {
        // must be deterministic and secondary
        if ([station allowsSaving] && station != [UNIVERSE station])
        {
            stationMarket = [station localMarket];
            if (stationMarket != nil)
            {
                savedMarket = [NSMutableDictionary dictionaryWithCapacity:2];
                [savedMarket setObject:[stationMarket saveStationAmounts] forKey:@"market"];
                [savedMarket setObject:ArrayFromHPVector([station position]) forKey:@"position"];
                [markets addObject:savedMarket];
            }
        }
    }
 
    return [markets autorelease];
}

getSunSkimEndPositionForShip:

- (HPVector) getSunSkimEndPositionForShip:

(ShipEntity*)

ship

Definition at line 9471 of file Universe.m.

                                         :(ShipEntity*) ship
{
    OOSunEntity* the_sun = [self sun];
    if (!ship)
    {
        OOLog(kOOLogParameterError, @"%@", @"***** No ship set in Universe getSunSkimEndPositionForShip:");
        return kZeroHPVector;
    }
    // get vector from sun position to ship
    if (!the_sun)
    {
        OOLog(kOOLogInconsistentState, @"%@", @"***** No sun set in Universe getSunSkimEndPositionForShip:");
        return kZeroHPVector;
    }
    HPVector v0 = the_sun->position;
    HPVector v1 = ship->position;
    v1.x -= v0.x;   v1.y -= v0.y;   v1.z -= v0.z;
    if (v1.x||v1.y||v1.z)
        v1 = HPvector_normal(v1);
    else
        v1.z = 1.0;
    HPVector v2 = make_HPvector(randf()-0.5, randf()-0.5, randf()-0.5); // random vector
    if (v2.x||v2.y||v2.z)
        v2 = HPvector_normal(v2);
    else
        v2.x = 1.0;
    HPVector v3 = HPcross_product(v1, v2);  // random vector at 90 degrees to v1 and v2 (random Vector)
    if (v3.x||v3.y||v3.z)
        v3 = HPvector_normal(v3);
    else
        v3.y = 1.0;
    double radius = SUN_SKIM_RADIUS_FACTOR * the_sun->collision_radius - 250.0; // 250 m inside the skim radius
    v1.x *= radius; v1.y *= radius; v1.z *= radius;
    v1.x += v0.x;   v1.y += v0.y;   v1.z += v0.z;
    v1.x += 15000 * v3.x;   v1.y += 15000 * v3.y;   v1.z += 15000 * v3.z;   // point 15000m at a tangent to sun from v1
    v1.x -= v0.x;   v1.y -= v0.y;   v1.z -= v0.z;
    if (v1.x||v1.y||v1.z)
        v1 = HPvector_normal(v1);
    else
        v1.z = 1.0;
    v1.x *= radius; v1.y *= radius; v1.z *= radius;
    v1.x += v0.x;   v1.y += v0.y;   v1.z += v0.z;
    
    return v1;
}

getSunSkimStartPositionForShip:

- (HPVector) getSunSkimStartPositionForShip:

(ShipEntity*)

ship

Definition at line 9471 of file Universe.m.

                                           :(ShipEntity*) ship
{
    if (!ship)
    {
        OOLog(kOOLogParameterError, @"%@", @"***** No ship set in Universe getSunSkimStartPositionForShip:");
        return kZeroHPVector;
    }
    OOSunEntity* the_sun = [self sun];
    // get vector from sun position to ship
    if (!the_sun)
    {
        OOLog(kOOLogInconsistentState, @"%@", @"***** No sun set in Universe getSunSkimStartPositionForShip:");
        return kZeroHPVector;
    }
    HPVector v0 = the_sun->position;
    HPVector v1 = ship->position;
    v1.x -= v0.x;   v1.y -= v0.y;   v1.z -= v0.z;   // vector from sun to ship
    if (v1.x||v1.y||v1.z)
        v1 = HPvector_normal(v1);
    else
        v1.z = 1.0;
    double radius = SUN_SKIM_RADIUS_FACTOR * the_sun->collision_radius - 250.0; // 250 m inside the skim radius
    v1.x *= radius; v1.y *= radius; v1.z *= radius;
    v1.x += v0.x;   v1.y += v0.y;   v1.z += v0.z;
    
    return v1;
}

getSystemGovernment:

- (OOGovernmentID) getSystemGovernment:

(OOSystemID)

sys

Definition at line 7996 of file Universe.m.

                                      :(OOSystemID) sys
{
    return [[systemManager getProperty:@"government" forSystem:sys inGalaxy:galaxyID] unsignedCharValue];
}

getSystemInhabitants:

- (NSString *) getSystemInhabitants:

(OOSystemID)

sys

Definition at line 7996 of file Universe.m.

                                   :(OOSystemID) sys
{
    return [self getSystemInhabitants:sys plural:YES];
}

getSystemInhabitants:plural:

- (NSString *) getSystemInhabitants:		(OOSystemID)	sys
plural:		(BOOL)	plural

Definition at line 7996 of file Universe.m.

                                   :(OOSystemID) sys plural:(BOOL)plural
{   
    NSString *ret = nil;
    if (!plural)
    {
        ret = [systemManager getProperty:KEY_INHABITANT forSystem:sys inGalaxy:galaxyID];
    }
    if (ret != nil) // the singular form might be absent.
    {
        return ret;
    }
    else
    {
        return [systemManager getProperty:KEY_INHABITANTS forSystem:sys inGalaxy:galaxyID];
    }
}

getSystemName:

- (NSString *) getSystemName:

(OOSystemID)

sys

Definition at line 7996 of file Universe.m.

                            :(OOSystemID) sys
{
    return [self getSystemName:sys forGalaxy:galaxyID];
}

getSystemName:forGalaxy:

- (NSString *) getSystemName:		(OOSystemID)	sys
forGalaxy:		(OOGalaxyID)	gnum

Definition at line 7996 of file Universe.m.

                            :(OOSystemID) sys forGalaxy:(OOGalaxyID) gnum
{
    return [systemManager getProperty:@"name" forSystem:sys inGalaxy:gnum];
}

getTime

- (OOTimeAbsolute) getTime

Definition at line 6447 of file Universe.m.

{
    return universal_time;
}

getTimeDelta

- (OOTimeDelta) getTimeDelta

Definition at line 6447 of file Universe.m.

{
    return time_delta;
}

getWitchspaceExitPosition

- (HPVector) getWitchspaceExitPosition

Definition at line 9471 of file Universe.m.

{
    return kZeroHPVector;
}

getWitchspaceExitRotation

- (Quaternion) getWitchspaceExitRotation

Definition at line 9471 of file Universe.m.

{
    // this should be fairly close to {0,0,0,1}
    Quaternion q_result;
 
// CIM: seems to be no reason why this should be a per-system constant
//  - trying it without resetting the RNG for now
//  seed_RNG_only_for_planet_description(system_seed);
    
    q_result.x = (gen_rnd_number() - 128)/1024.0;
    q_result.y = (gen_rnd_number() - 128)/1024.0;
    q_result.z = (gen_rnd_number() - 128)/1024.0;
    q_result.w = 1.0;
    quaternion_normalize(&q_result);
    
    return q_result;
}

globalSettings

- (NSDictionary *) globalSettings

gui

- (GuiDisplayGen *) gui

handleGameOver

- (void) handleGameOver

Definition at line 273 of file Universe.m.

{
    if ([[self gameController] playerFileToLoad])
    {
        [[self gameController] loadPlayerIfRequired];
    }
    else
    {
        [self setUseAddOns:SCENARIO_OXP_DEFINITION_ALL fromSaveGame:NO forceReinit:YES]; // calls reinitAndShowDemo
    } 
}

handleOoliteException:

- (void) handleOoliteException:

(NSException *)

ooliteException

Definition at line 9471 of file Universe.m.

                              :(NSException *)exception
{
    if (exception != nil)
    {
        if ([[exception name] isEqual:OOLITE_EXCEPTION_FATAL])
        {
            PlayerEntity *player = PLAYER;
            [player setStatus:STATUS_HANDLING_ERROR];
            
            OOLog(kOOLogException, @"***** Handling Fatal : %@ : %@ *****",[exception name], [exception reason]);
            NSString* exception_msg = [NSString stringWithFormat:@"Exception : %@ : %@ Please take a screenshot and/or press esc or Q to quit.", [exception name], [exception reason]];
            [self addMessage:exception_msg forCount:30.0];
            [[self gameController] setGamePaused:YES];
        }
        else
        {
            OOLog(kOOLogException, @"***** Handling Non-fatal : %@ : %@ *****",[exception name], [exception reason]);
        }
    }
}

hazardOnRouteFromEntity:toDistance:fromPoint:

- (Entity *) hazardOnRouteFromEntity:		(Entity *)	e1
toDistance:		(double)	dist
fromPoint:		(HPVector)	p2

Definition at line 5364 of file Universe.m.

                                   :(Entity *) e1 toDistance:(double)dist fromPoint:(HPVector) p2
{
    if (!e1)
        return nil;
    
    HPVector f1;
    HPVector p1 = e1->position;
    HPVector v1 = p2;
    v1.x -= p1.x;   v1.y -= p1.y;   v1.z -= p1.z;   // vector from entity to p2
    
    double  nearest = HPmagnitude(v1) - dist;  // length of vector
    
    if (nearest < 0.0)
        return nil;         // within range already!
    
    Entity* result = nil;
    int i;
    int ent_count = n_entities;
    Entity* my_entities[ent_count];
    for (i = 0; i < ent_count; i++)
        my_entities[i] = [sortedEntities[i] retain]; // retained
    
    if (v1.x || v1.y || v1.z)
        f1 = HPvector_normal(v1);   // unit vector in direction of p2 from p1
    else
        f1 = make_HPvector(0, 0, 1);
    
    for (i = 0; (i < ent_count) && (!result) ; i++)
    {
        Entity *e2 = my_entities[i];
        if ((e2 != e1)&&([e2 canCollide]))
        {
            HPVector epos = e2->position;
            epos.x -= p1.x; epos.y -= p1.y; epos.z -= p1.z; // epos now holds vector from p1 to this entities position
            
            double d_forward = HPdot_product(epos,f1);  // distance along f1 which is nearest to e2's position
            
            if ((d_forward > 0)&&(d_forward < nearest))
            {
                double cr = 1.10 * (e2->collision_radius + e1->collision_radius); //  10% safety margin
                HPVector p0 = e1->position;
                p0.x += d_forward * f1.x;   p0.y += d_forward * f1.y;   p0.z += d_forward * f1.z;
                // p0 holds nearest point on current course to center of incident object
                HPVector epos = e2->position;
                p0.x -= epos.x; p0.y -= epos.y; p0.z -= epos.z;
                // compare with center of incident object
                double  dist2 = HPmagnitude2(p0);
                if (dist2 < cr*cr)
                    result = e2;
            }
        }
    }
    for (i = 0; i < ent_count; i++)
        [my_entities[i] release]; //    released
    return result;
}

inInterstellarSpace

- (BOOL) inInterstellarSpace

Definition at line 7996 of file Universe.m.

{
    return [self sun] == nil;
}

initTargetFramebufferWithViewSize:

- (void) initTargetFramebufferWithViewSize: (NSSize) viewSize

implementation

Provided by category Universe(OOPrivate).

Definition at line 273 of file Universe.m.

                                          :(NSSize)viewSize
{
    // liberate us from the 0.0 to 1.0 rgb range!
    OOGL(glClampColor(GL_CLAMP_VERTEX_COLOR, GL_FALSE));
    OOGL(glClampColor(GL_CLAMP_READ_COLOR, GL_FALSE));
    OOGL(glClampColor(GL_CLAMP_FRAGMENT_COLOR, GL_FALSE));
 
    // have to do this because on my machine the default framebuffer is not zero
    OOGL(glGetIntegerv(GL_DRAW_FRAMEBUFFER_BINDING, &defaultDrawFBO));
 
    GLint previousProgramID;
    OOGL(glGetIntegerv(GL_CURRENT_PROGRAM, &previousProgramID));
    GLint previousTextureID;
    OOGL(glGetIntegerv(GL_TEXTURE_BINDING_2D, &previousTextureID));
    GLint previousVAO;
    OOGL(glGetIntegerv(GL_VERTEX_ARRAY_BINDING, &previousVAO));
    GLint previousArrayBuffer;
    OOGL(glGetIntegerv(GL_ARRAY_BUFFER_BINDING, &previousArrayBuffer));
    GLint previousElementBuffer;
    OOGL(glGetIntegerv(GL_ELEMENT_ARRAY_BUFFER_BINDING, &previousElementBuffer));
 
    // create MSAA framebuffer and attach MSAA texture and depth buffer to framebuffer
    OOGL(glGenFramebuffers(1, &msaaFramebufferID));
    OOGL(glBindFramebuffer(GL_FRAMEBUFFER, msaaFramebufferID));
    
    // creating MSAA texture that should be rendered into
    OOGL(glGenTextures(1, &msaaTextureID));
    OOGL(glBindTexture(GL_TEXTURE_2D_MULTISAMPLE, msaaTextureID));
    OOGL(glTexImage2DMultisample(GL_TEXTURE_2D_MULTISAMPLE, 4, GL_RGBA16F, (GLsizei)viewSize.width, (GLsizei)viewSize.height, GL_TRUE));
    OOGL(glBindTexture(GL_TEXTURE_2D_MULTISAMPLE, 0));
    OOGL(glFramebufferTexture2D(GL_FRAMEBUFFER, GL_COLOR_ATTACHMENT0, GL_TEXTURE_2D_MULTISAMPLE, msaaTextureID, 0));
    
    // create necessary MSAA depth render buffer
    OOGL(glGenRenderbuffers(1, &msaaDepthBufferID));
    OOGL(glBindRenderbuffer(GL_RENDERBUFFER, msaaDepthBufferID));
    OOGL(glRenderbufferStorageMultisample(GL_RENDERBUFFER, 4, GL_DEPTH_COMPONENT32F, (GLsizei)viewSize.width, (GLsizei)viewSize.height));
    OOGL(glBindRenderbuffer(GL_RENDERBUFFER, 0));
    OOGL(glFramebufferRenderbuffer(GL_FRAMEBUFFER, GL_DEPTH_ATTACHMENT, GL_RENDERBUFFER, msaaDepthBufferID));
    
    if (glCheckFramebufferStatus(GL_FRAMEBUFFER) != GL_FRAMEBUFFER_COMPLETE)
    {
        OOLogERR(@"initTargetFramebufferWithViewSize.result", @"%@", @"***** Error: Multisample framebuffer not complete");
    }
    
    // create framebuffer and attach texture and depth buffer to framebuffer
    OOGL(glGenFramebuffers(1, &targetFramebufferID));
    OOGL(glBindFramebuffer(GL_FRAMEBUFFER, targetFramebufferID));
    
    // creating texture that should be rendered into
    OOGL(glGenTextures(1, &targetTextureID));
    OOGL(glBindTexture(GL_TEXTURE_2D, targetTextureID));
    OOGL(glTexImage2D(GL_TEXTURE_2D, 0, GL_RGBA16F, (GLsizei)viewSize.width, (GLsizei)viewSize.height, 0, GL_RGBA, GL_FLOAT, NULL));
    OOGL(glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_LINEAR));
    OOGL(glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_LINEAR));
    OOGL(glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_S, GL_CLAMP_TO_EDGE));
    OOGL(glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_T, GL_CLAMP_TO_EDGE));
    OOGL(glFramebufferTexture2D(GL_FRAMEBUFFER, GL_COLOR_ATTACHMENT0, GL_TEXTURE_2D, targetTextureID, 0));
    
    // create necessary depth render buffer
    OOGL(glGenRenderbuffers(1, &targetDepthBufferID));
    OOGL(glBindRenderbuffer(GL_RENDERBUFFER, targetDepthBufferID));
    OOGL(glRenderbufferStorage(GL_RENDERBUFFER, GL_DEPTH_COMPONENT32F, (GLsizei)viewSize.width, (GLsizei)viewSize.height));
    OOGL(glFramebufferRenderbuffer(GL_FRAMEBUFFER, GL_DEPTH_ATTACHMENT, GL_RENDERBUFFER, targetDepthBufferID));
    
    GLenum attachment[1] = { GL_COLOR_ATTACHMENT0 };
    OOGL(glDrawBuffers(1, attachment));
    
    if (glCheckFramebufferStatus(GL_FRAMEBUFFER) != GL_FRAMEBUFFER_COMPLETE)
    {
        OOLogERR(@"initTargetFramebufferWithViewSize.result", @"%@", @"***** Error: Framebuffer not complete");
    }
    
    OOGL(glBindFramebuffer(GL_FRAMEBUFFER, defaultDrawFBO));
    
    targetFramebufferSize = viewSize;
    
    // passthrough buffer
    // This is a framebuffer whose sole purpose is to pass on the texture rendered from the game to the blur and the final bloom
    // shaders. We need it in order to be able to use the OpenGL 3.3 layout (location = x) out vec4 outVector; construct, which allows
    // us to perform multiple render target operations needed for bloom. The alternative would be to not use this and change all our
    // shaders to be OpenGL 3.3 compatible, but given how Oolite synthesizes them and the work needed to port them over, well yeah no,
    // not doing it at this time - Nikos 20220814.
    OOGL(glGenFramebuffers(1, &passthroughFramebufferID));
    OOGL(glBindFramebuffer(GL_FRAMEBUFFER, passthroughFramebufferID));
    
    // creating textures that should be rendered into
    OOGL(glGenTextures(2, passthroughTextureID));
    for (unsigned int i = 0; i < 2; i++)
    {
        OOGL(glBindTexture(GL_TEXTURE_2D, passthroughTextureID[i]));
        OOGL(glTexImage2D(GL_TEXTURE_2D, 0, GL_RGBA16F, (GLsizei)viewSize.width, (GLsizei)viewSize.height, 0, GL_RGBA, GL_FLOAT, NULL));
        OOGL(glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_LINEAR));
        OOGL(glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_LINEAR));
        OOGL(glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_S, GL_CLAMP_TO_EDGE));
        OOGL(glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_T, GL_CLAMP_TO_EDGE));
        OOGL(glFramebufferTexture2D(GL_FRAMEBUFFER, GL_COLOR_ATTACHMENT0 + i, GL_TEXTURE_2D, passthroughTextureID[i], 0));
    }
    
    GLenum attachments[2] = { GL_COLOR_ATTACHMENT0, GL_COLOR_ATTACHMENT1 };
    OOGL(glDrawBuffers(2, attachments));
    
    if (glCheckFramebufferStatus(GL_FRAMEBUFFER) != GL_FRAMEBUFFER_COMPLETE)
    {
        OOLogERR(@"initTargetFramebufferWithViewSize.result", @"%@", @"***** Error: Passthrough framebuffer not complete");
    }
    OOGL(glBindFramebuffer(GL_FRAMEBUFFER, defaultDrawFBO));
    
    // ping-pong-framebuffer for blurring
    OOGL(glGenFramebuffers(2, pingpongFBO));
    OOGL(glGenTextures(2, pingpongColorbuffers));
    for (unsigned int i = 0; i < 2; i++)
    {
        OOGL(glBindFramebuffer(GL_FRAMEBUFFER, pingpongFBO[i]));
        OOGL(glBindTexture(GL_TEXTURE_2D, pingpongColorbuffers[i]));
        OOGL(glTexImage2D(GL_TEXTURE_2D, 0, GL_RGBA16F, (GLsizei)viewSize.width, (GLsizei)viewSize.height, 0, GL_RGBA, GL_FLOAT, NULL));
        OOGL(glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_LINEAR));
        OOGL(glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_LINEAR));
        OOGL(glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_S, GL_CLAMP_TO_EDGE)); // we clamp to the edge as the blur filter would otherwise sample repeated texture values!
        OOGL(glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_T, GL_CLAMP_TO_EDGE));
        OOGL(glFramebufferTexture2D(GL_FRAMEBUFFER, GL_COLOR_ATTACHMENT0, GL_TEXTURE_2D, pingpongColorbuffers[i], 0));
        // check if framebuffers are complete (no need for depth buffer)
        if (glCheckFramebufferStatus(GL_FRAMEBUFFER) != GL_FRAMEBUFFER_COMPLETE)
        {
            OOLogERR(@"initTargetFramebufferWithViewSize.result", @"%@", @"***** Error: Pingpong framebuffers not complete");
        }
    }
    OOGL(glBindFramebuffer(GL_FRAMEBUFFER, defaultDrawFBO));
    
    _bloom = [self detailLevel] >= DETAIL_LEVEL_EXTRAS;
    _currentPostFX = _colorblindMode = OO_POSTFX_NONE;
 
    /* TODO: in OOEnvironmentCubeMap.m call these bind functions not with 0 but with "previousXxxID"s:
      - OOGL(glBindTexture(GL_TEXTURE_CUBE_MAP, 0));
      - OOGL(glBindFramebufferEXT(GL_FRAMEBUFFER_EXT, 0));
      - OOGL(glBindRenderbufferEXT(GL_RENDERBUFFER_EXT, 0));
    */
    
    // shader for drawing a textured quad on the passthrough framebuffer and preparing it for bloom using MRT
    if (![[OOOpenGLExtensionManager sharedManager] shadersForceDisabled])
    {
        textureProgram = [[OOShaderProgram shaderProgramWithVertexShaderName:@"oolite-texture.vertex"
                                                    fragmentShaderName:@"oolite-texture.fragment"
                                                    prefix:@"#version 330\n"
                                                    attributeBindings:[NSDictionary dictionary]] retain];
        // shader for blurring the over-threshold brightness image generated from the previous step using Gaussian filter
        blurProgram = [[OOShaderProgram shaderProgramWithVertexShaderName:@"oolite-blur.vertex"
                                                    fragmentShaderName:@"oolite-blur.fragment"
                                                    prefix:@"#version 330\n"
                                                    attributeBindings:[NSDictionary dictionary]] retain];
        // shader for applying bloom and any necessary post-proc fx, tonemapping and gamma correction
        finalProgram = [[OOShaderProgram shaderProgramWithVertexShaderName:@"oolite-final.vertex"
#if OOLITE_WINDOWS
                                                    fragmentShaderName:[[UNIVERSE gameView] hdrOutput] ? @"oolite-final-hdr.fragment" : @"oolite-final.fragment"
#else
                                                    fragmentShaderName:@"oolite-final.fragment"
#endif
                                                    prefix:@"#version 330\n"
                                                    attributeBindings:[NSDictionary dictionary]] retain];
    }
    
    OOGL(glGenVertexArrays(1, &quadTextureVAO));
    OOGL(glGenBuffers(1, &quadTextureVBO));
    OOGL(glGenBuffers(1, &quadTextureEBO));
 
    OOGL(glBindVertexArray(quadTextureVAO));
 
    OOGL(glBindBuffer(GL_ARRAY_BUFFER, quadTextureVBO));
    OOGL(glBufferData(GL_ARRAY_BUFFER, sizeof(framebufferQuadVertices), framebufferQuadVertices, GL_STATIC_DRAW));
 
    OOGL(glBindBuffer(GL_ELEMENT_ARRAY_BUFFER, quadTextureEBO));
    OOGL(glBufferData(GL_ELEMENT_ARRAY_BUFFER, sizeof(framebufferQuadIndices), framebufferQuadIndices, GL_STATIC_DRAW));
 
    OOGL(glEnableVertexAttribArray(0));
    // position attribute
    OOGL(glVertexAttribPointer(0, 2, GL_FLOAT, GL_FALSE, 4 * sizeof(float), (void*)0));
    OOGL(glEnableVertexAttribArray(1));
    // texture coord attribute
    OOGL(glVertexAttribPointer(1, 2, GL_FLOAT, GL_FALSE, 4 * sizeof(float), (void*)(2 * sizeof(float))));
 
 
    // restoring previous bindings
    OOGL(glUseProgram(previousProgramID));
    OOGL(glBindTexture(GL_TEXTURE_2D, previousTextureID));
    OOGL(glBindVertexArray(previousVAO));
    OOGL(glBindBuffer(GL_ELEMENT_ARRAY_BUFFER, previousElementBuffer));
    OOGL(glBindBuffer(GL_ARRAY_BUFFER, previousArrayBuffer));
 
}

initWithGameView:

- (id) initWithGameView:

(MyOpenGLView *)

gameView

Definition at line 273 of file Universe.m.

                       :(MyOpenGLView *)inGameView
{
    if (gSharedUniverse != nil)
    {
        [self release];
        [NSException raise:NSInternalInconsistencyException format:@"%s: expected only one Universe to exist at a time.", __PRETTY_FUNCTION__];
    }
    
    OO_DEBUG_PROGRESS(@"%@", @"Universe initWithGameView:");
    
    self = [super init];
    if (self == nil)  return nil;
    
    _doingStartUp = YES;
 
    OOInitReallyRandom([NSDate timeIntervalSinceReferenceDate] * 1e9);
    
    NSUserDefaults *prefs = [NSUserDefaults standardUserDefaults];
    
    // prefs value no longer used - per save game but startup needs to
    // be non-strict
    useAddOns = [[NSString alloc] initWithString:SCENARIO_OXP_DEFINITION_ALL];
    
    [self setGameView:inGameView];
    gSharedUniverse = self;
    
    allPlanets = [[NSMutableArray alloc] init];
    allStations = [[NSMutableSet alloc] init];
    
    OOCPUInfoInit();
    [OOJoystickManager sharedStickHandler];
    
    // init OpenGL extension manager (must be done before any other threads might use it)
    [OOOpenGLExtensionManager sharedManager];
    [self setDetailLevelDirectly:[prefs oo_intForKey:@"detailLevel"
                                defaultValue:[[OOOpenGLExtensionManager sharedManager] defaultDetailLevel]]];
                                
    [self initTargetFramebufferWithViewSize:[gameView viewSize]];
    
    [OOMaterial setUp];
    
    // Preload cache
    [OOCacheManager sharedCache];
    
#if OOLITE_SPEECH_SYNTH
    OOLog(@"speech.synthesis", @"Spoken messages are %@.", ([prefs oo_boolForKey:@"speech_on" defaultValue:NO] ? @"on" :@"off"));
#endif
    
    // init the Resource Manager
    [ResourceManager setUseAddOns:useAddOns];   // also logs the paths if changed
    
    // Set up the internal game strings
    [self loadDescriptions];
    // DESC expansion is now possible!
    
    // load starting saves
    [self loadScenarios];
 
    autoSave = [prefs oo_boolForKey:@"autosave" defaultValue:NO];
    wireframeGraphics = [prefs oo_boolForKey:@"wireframe-graphics" defaultValue:NO];
    doProcedurallyTexturedPlanets = [prefs oo_boolForKey:@"procedurally-textured-planets" defaultValue:YES];
    [inGameView setGammaValue:[prefs oo_floatForKey:@"gamma-value" defaultValue:1.0f]];
    [inGameView setMsaa:[prefs oo_boolForKey:@"anti-aliasing" defaultValue:NO]];
    OOLog(@"MSAA.setup", @"Multisample anti-aliasing %@requested.", [inGameView msaa] ? @"" : @"not ");
    [inGameView setFov:OOClamp_0_max_f([prefs oo_floatForKey:@"fov-value" defaultValue:57.2f], MAX_FOV_DEG) fromFraction:NO];
    if ([inGameView fov:NO] < MIN_FOV_DEG)  [inGameView setFov:MIN_FOV_DEG fromFraction:NO];
    
    // Set up speech synthesizer.
#if OOLITE_SPEECH_SYNTH
#if OOLITE_MAC_OS_X
    dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_LOW, 0),
    ^{
        /*
            NSSpeechSynthesizer can take over a second on an SSD and several
            seconds on an HDD for a cold start, and a third of a second upward
            for a warm start. There are no particular thread safety consider-
            ations documented for NSSpeechSynthesizer, so I'm assuming the
            default one-thread-at-a-time access rule applies.
            -- Ahruman 2012-09-13
        */
        OOLog(@"speech.setup.begin", @"Starting to set up speech synthesizer.");
        NSSpeechSynthesizer *synth = [[NSSpeechSynthesizer alloc] init];
        OOLog(@"speech.setup.end", @"Finished setting up speech synthesizer.");
        speechSynthesizer = synth;
    });
#elif OOLITE_ESPEAK
    int volume = [OOSound masterVolume] * 100;
    espeak_Initialize(AUDIO_OUTPUT_PLAYBACK, 100, NULL, 0);
    espeak_SetParameter(espeakPUNCTUATION, espeakPUNCT_NONE, 0);
    espeak_SetParameter(espeakVOLUME, volume, 0);
    espeak_voices = espeak_ListVoices(NULL);
    for (espeak_voice_count = 0;
         espeak_voices[espeak_voice_count];
         ++espeak_voice_count)
        ;
#endif
#endif
    
    [[GameController sharedController] logProgress:DESC(@"loading-ships")];
    // Load ship data
    
    [OOShipRegistry sharedRegistry];
    
    entities = [[NSMutableArray arrayWithCapacity:MAX_NUMBER_OF_ENTITIES] retain];
    
    [[GameController sharedController] logProgress:OOExpandKeyRandomized(@"loading-miscellany")];
    
    // this MUST have the default no. of rows else the GUI_ROW macros in PlayerEntity.h need modification
    gui = [[GuiDisplayGen alloc] init]; // alloc retains
    comm_log_gui = [[GuiDisplayGen alloc] init]; // alloc retains
    
    missiontext = [[ResourceManager dictionaryFromFilesNamed:@"missiontext.plist" inFolder:@"Config" andMerge:YES] retain];
    
    waypoints = [[NSMutableDictionary alloc] init];
    
    [self setUpSettings];
    
    // can't do this here as it might lock an OXZ open
    // [self preloadSounds];    // Must be after setUpSettings.
    
    // Preload particle effect textures:
    [OOLightParticleEntity setUpTexture];
    [OOFlashEffectEntity setUpTexture];
 
    
    // set up cargopod templates
    [self setUpCargoPods];
 
    PlayerEntity *player = [PlayerEntity sharedPlayer];
    [player deferredInit];
    [self addEntity:player];
    
    [player setStatus:STATUS_START_GAME];
    [player setShowDemoShips: YES];
    
    [self setUpInitialUniverse];
    
    universeRegion = [[CollisionRegion alloc] initAsUniverse];
    entitiesDeadThisUpdate = [[NSMutableSet alloc] init];
    framesDoneThisUpdate = 0;
    
    [[GameController sharedController] logProgress:DESC(@"initializing-debug-support")];
    OOInitDebugSupport();
    
    [[GameController sharedController] logProgress:DESC(@"running-scripts")];
    [player completeSetUp];
    
    [[GameController sharedController] logProgress:DESC(@"populating-space")];
    [self populateNormalSpace];
    
    [[GameController sharedController] logProgress:OOExpandKeyRandomized(@"loading-miscellany")];
    
#if OO_LOCALIZATION_TOOLS
    [self runLocalizationTools];
#if DEBUG_GRAPHVIZ
    [self dumpDebugGraphViz];
#endif
#endif
    
    [player startUpComplete];
    _doingStartUp = NO;
    
    return self;
}

IsCandidateMainStationPredicate

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

implementation

Definition at line 3610 of file Universe.m.

{
    return [entity isStation] && !entity->isExplicitlyNotMainStation;
}

References Entity::isExplicitlyNotMainStation, and Entity::isStation.

IsFriendlyStationPredicate

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

implementation

Definition at line 3616 of file Universe.m.

{
    return [entity isStation] && ![(ShipEntity *)entity isHostileTo:parameter];
}

isSpeaking

- (BOOL) isSpeaking

Definition at line 9471 of file Universe.m.

{
    return [speechSynthesizer isSpeaking];
}

isVectorClearFromEntity:toDistance:fromPoint:

- (BOOL) isVectorClearFromEntity:		(Entity *)	e1
toDistance:		(double)	dist
fromPoint:		(HPVector)	p2

Definition at line 5364 of file Universe.m.

                                :(Entity *) e1 toDistance:(double)dist fromPoint:(HPVector) p2
{
    if (!e1)
        return NO;
    
    HPVector  f1;
    HPVector p1 = e1->position;
    HPVector v1 = p2;
    v1.x -= p1.x;   v1.y -= p1.y;   v1.z -= p1.z;   // vector from entity to p2
    
    double  nearest = sqrt(v1.x*v1.x + v1.y*v1.y + v1.z*v1.z) - dist;  // length of vector
    
    if (nearest < 0.0)
        return YES;         // within range already!
    
    int i;
    int ent_count = n_entities;
    Entity* my_entities[ent_count];
    for (i = 0; i < ent_count; i++)
        my_entities[i] = [sortedEntities[i] retain]; // retained
    
    if (v1.x || v1.y || v1.z)
        f1 = HPvector_normal(v1);   // unit vector in direction of p2 from p1
    else
        f1 = make_HPvector(0, 0, 1);
    
    for (i = 0; i < ent_count ; i++)
    {
        Entity *e2 = my_entities[i];
        if ((e2 != e1)&&([e2 canCollide]))
        {
            HPVector epos = e2->position;
            epos.x -= p1.x; epos.y -= p1.y; epos.z -= p1.z; // epos now holds vector from p1 to this entities position
            
            double d_forward = HPdot_product(epos,f1);  // distance along f1 which is nearest to e2's position
            
            if ((d_forward > 0)&&(d_forward < nearest))
            {
                double cr = 1.10 * (e2->collision_radius + e1->collision_radius); //  10% safety margin
                HPVector p0 = e1->position;
                p0.x += d_forward * f1.x;   p0.y += d_forward * f1.y;   p0.z += d_forward * f1.z;
                // p0 holds nearest point on current course to center of incident object
                HPVector epos = e2->position;
                p0.x -= epos.x; p0.y -= epos.y; p0.z -= epos.z;
                // compare with center of incident object
                double  dist2 = p0.x * p0.x + p0.y * p0.y + p0.z * p0.z;
                if (dist2 < cr*cr)
                {
                    for (i = 0; i < ent_count; i++)
                        [my_entities[i] release]; //    released
                    return NO;
                }
            }
        }
    }
    for (i = 0; i < ent_count; i++)
        [my_entities[i] release]; //    released
    return YES;
}

keyForInterstellarOverridesForSystems:s1:inGalaxy:

- (NSString *) keyForInterstellarOverridesForSystems:		(OOSystemID)
s1:		(OOSystemID)	s2
inGalaxy:		(OOGalaxyID)	g

Definition at line 7996 of file Universe.m.

                                                    :(OOSystemID) s1 :(OOSystemID) s2 inGalaxy:(OOGalaxyID) g
{
    return [NSString stringWithFormat:@"interstellar: %d %d %d", g, s1, s2];
}

keyForPlanetOverridesForSystem:inGalaxy:

- (NSString *) keyForPlanetOverridesForSystem:		(OOSystemID)	s
inGalaxy:		(OOGalaxyID)	g

Definition at line 7996 of file Universe.m.

                                             :(OOSystemID) s inGalaxy:(OOGalaxyID) g
{
    return [NSString stringWithFormat:@"%d %d", g, s];
}

lastBeacon

- (Entity< OOBeaconEntity > *) lastBeacon

Definition at line 3616 of file Universe.m.

{
    return [_lastBeacon weakRefUnderlyingObject];
}

legacyPositionFrom:asCoordinateSystem:

- (HPVector) legacyPositionFrom:		(HPVector)	pos
asCoordinateSystem:		(NSString *)	system

Definition at line 273 of file Universe.m.

                               :(HPVector) pos asCoordinateSystem:(NSString *) system
{
    NSString* l_sys = [system lowercaseString];
    if ([l_sys length] != 3)
        return kZeroHPVector;
    OOPlanetEntity* the_planet = [self planet];
    OOSunEntity* the_sun = [self sun];
    if (the_planet == nil || the_sun == nil || [l_sys isEqualToString:@"abs"])
    {
        return pos;
    }
    HPVector  w_pos = [self getWitchspaceExitPosition]; // don't reset PRNG
    HPVector  p_pos = the_planet->position;
    HPVector  s_pos = the_sun->position;
    
    const char* c_sys = [l_sys UTF8String];
    HPVector p0, p1, p2;
    
    switch (c_sys[0])
    {
        case 'w':
            p0 = w_pos;
            switch (c_sys[1])
            {
                case 'p':
                    p1 = p_pos; p2 = s_pos; break;
                case 's':
                    p1 = s_pos; p2 = p_pos; break;
                default:
                    return kZeroHPVector;
            }
            break;
        case 'p':       
            p0 = p_pos;
            switch (c_sys[1])
            {
                case 'w':
                    p1 = w_pos; p2 = s_pos; break;
                case 's':
                    p1 = s_pos; p2 = w_pos; break;
                default:
                    return kZeroHPVector;
            }
            break;
        case 's':
            p0 = s_pos;
            switch (c_sys[1])
            {
                case 'w':
                    p1 = w_pos; p2 = p_pos; break;
                case 'p':
                    p1 = p_pos; p2 = w_pos; break;
                default:
                    return kZeroHPVector;
            }
            break;
        default:
            return kZeroHPVector;
    }
    HPVector k = HPvector_normal_or_zbasis(HPvector_subtract(p1, p0));  // 'z' axis in m
    HPVector v = HPvector_normal_or_xbasis(HPvector_subtract(p2, p0));  // temporary vector in plane of 'forward' and 'right'
    
    HPVector j = HPcross_product(k, v); // 'y' axis in m
    HPVector i = HPcross_product(j, k); // 'x' axis in m
    
    GLfloat scale = 1.0;
    switch (c_sys[2])
    {
        case 'p':
        {
            scale = 1.0f / [the_planet radius];
            break;
        }
        case 's':
        {
            scale = 1.0f / [the_sun radius];
            break;
        }
            
        case 'u':
            scale = 1.0f / HPdistance(p1, p0);
            break;
            
        case 'm':
            scale = 1.0f;
            break;
            
        default:
            return kZeroHPVector;
    }
    
    // result = p0 + ijk
    HPVector r_pos = HPvector_subtract(pos, p0);
    HPVector result = make_HPvector(scale * (r_pos.x * i.x + r_pos.y * i.y + r_pos.z * i.z),
                                scale * (r_pos.x * j.x + r_pos.y * j.y + r_pos.z * j.z),
                                scale * (r_pos.x * k.x + r_pos.y * k.y + r_pos.z * k.z) ); // scale * dot_products
    
    return result;
}

lightForEntity:

- (void) lightForEntity: (BOOL) isLit

implementation

Definition at line 3616 of file Universe.m.

                       :(BOOL)isLit
{
    if (isLit != object_light_on)
    {
        if ([self useShaders])
        {
            if (isLit)
            {
                OOGL(glLightfv(GL_LIGHT1, GL_DIFFUSE, sun_diffuse));
                OOGL(glLightfv(GL_LIGHT1, GL_SPECULAR, sun_specular));
            }
            else
            {
                OOGL(glLightfv(GL_LIGHT1, GL_DIFFUSE, sun_off));
                OOGL(glLightfv(GL_LIGHT1, GL_SPECULAR, sun_off));
            }
        }
        else
        {
            if (!demo_light_on)
            {
                if (isLit) OOGL(glEnable(GL_LIGHT1));
                else OOGL(glDisable(GL_LIGHT1));
            }
            else
            {
                // If we're in demo/GUI mode we should always have a lit object.
                OOGL(glEnable(GL_LIGHT0));
                
                // Redundant, see above.
                //if (isLit)  OOGL(glEnable(GL_LIGHT0));
                //else  OOGL(glDisable(GL_LIGHT0));
            }
        }
        
        object_light_on = isLit;
    }
}

listBeaconsWithCode:

- (NSArray *) listBeaconsWithCode:

(NSString*)

code

Definition at line 9471 of file Universe.m.

                                 :(NSString *)code
{
    NSMutableArray  *result = [NSMutableArray array];
    Entity <OOBeaconEntity>     *beacon = [self firstBeacon];
    
    while (beacon != nil)
    {
        NSString *beaconCode = [beacon beaconCode];
        if ([beaconCode rangeOfString:code options: NSCaseInsensitiveSearch].location != NSNotFound)
        {
            [result addObject:beacon];
        }
        beacon = [beacon nextBeacon];
    }
    
    return [result sortedArrayUsingSelector:@selector(compareBeaconCodeWith:)];
}

loadConditionScripts

- (void) loadConditionScripts

Definition at line 10697 of file Universe.m.

{
    [conditionScripts autorelease];
    conditionScripts = [[NSMutableDictionary alloc] init];
    // get list of names from cache manager 
    [self addConditionScripts:[[[OOCacheManager sharedCache] objectForKey:@"equipment conditions" inCache:@"condition scripts"] objectEnumerator]];
    
    [self addConditionScripts:[[[OOCacheManager sharedCache] objectForKey:@"ship conditions" inCache:@"condition scripts"] objectEnumerator]];
 
    [self addConditionScripts:[[[OOCacheManager sharedCache] objectForKey:@"demoship conditions" inCache:@"condition scripts"] objectEnumerator]];
}

loadDescriptions

- (void) loadDescriptions

implementation

Provided by category Universe(OOPrivate).

Definition at line 7996 of file Universe.m.

{
    [_descriptions autorelease];
    _descriptions = [[ResourceManager dictionaryFromFilesNamed:@"descriptions.plist" inFolder:@"Config" andMerge:YES] retain];
    [self verifyDescriptions];
}

loadScenarios

- (void) loadScenarios

implementation

Provided by category Universe(OOPrivate).

Definition at line 7996 of file Universe.m.

{
    [_scenarios autorelease];
    _scenarios = [[ResourceManager arrayFromFilesNamed:@"scenarios.plist" inFolder:@"Config" andMerge:YES] retain];
}

loadStationMarkets:

- (void) loadStationMarkets:

(NSArray *)

marketData

Definition at line 7996 of file Universe.m.

                           :(NSArray *)marketData
{
    if (marketData == nil)
    {
        return;
    }
 
    NSArray *stations = [self stations];
    StationEntity *station = nil;
    NSDictionary *savedMarket = nil;
 
    foreach (savedMarket, marketData)
    {
        HPVector pos = [savedMarket oo_hpvectorForKey:@"position"];
        foreach (station, stations)
        {
            // must be deterministic and secondary
            if ([station allowsSaving] && station != [UNIVERSE station])
            {
                // allow a km of drift just in case
                if (HPdistance2(pos,[station position]) < 1000000)
                {
                    [station setLocalMarket:[savedMarket oo_arrayForKey:@"market"]];
                    break;
                }
            }
        }
    }
 
}

locationByCode:withSun:andPlanet:

- (HPVector) locationByCode:		(NSString *)	code
withSun:		(OOSunEntity *)	sun
andPlanet:		(OOPlanetEntity *)	planet

Definition at line 273 of file Universe.m.

                           :(NSString *)code withSun:(OOSunEntity *)sun andPlanet:(OOPlanetEntity *)planet
{
    HPVector result = kZeroHPVector;
    if ([code isEqualToString:@"WITCHPOINT"] || sun == nil || planet == nil || [sun goneNova])
    {
        result = OOHPVectorRandomSpatial(SCANNER_MAX_RANGE);
    }
    // past this point, can assume non-nil sun, planet
    else
    { 
        if ([code isEqualToString:@"LANE_WPS"])
        {   
            // pick position on one of the lanes, weighted by lane length
            double l1 = HPmagnitude([planet position]);
            double l2 = HPmagnitude(HPvector_subtract([sun position],[planet position]));
            double l3 = HPmagnitude([sun position]);
            double total = l1+l2+l3;
            float choice = randf();
            if (choice < l1/total)
            {
                return [self locationByCode:@"LANE_WP" withSun:sun andPlanet:planet];
            }
            else if (choice < (l1+l2)/total)
            {
                return [self locationByCode:@"LANE_PS" withSun:sun andPlanet:planet];
            }
            else
            {
                return [self locationByCode:@"LANE_WS" withSun:sun andPlanet:planet];
            }
        }
        else if ([code isEqualToString:@"LANE_WP"])
        {
            result = OORandomPositionInCylinder(kZeroHPVector,SCANNER_MAX_RANGE,[planet position],[planet radius]*3,LANE_WIDTH);
        }
        else if ([code isEqualToString:@"LANE_WS"])
        {
            result = OORandomPositionInCylinder(kZeroHPVector,SCANNER_MAX_RANGE,[sun position],[sun radius]*3,LANE_WIDTH);
        }
        else if ([code isEqualToString:@"LANE_PS"])
        {
            result = OORandomPositionInCylinder([planet position],[planet radius]*3,[sun position],[sun radius]*3,LANE_WIDTH);
        }
        else if ([code isEqualToString:@"STATION_AEGIS"])
        {
            do 
            {
                result = OORandomPositionInShell([[self station] position],[[self station] collisionRadius]*1.2,SCANNER_MAX_RANGE*2.0);
            } while(HPdistance2(result,[planet position])<[planet radius]*[planet radius]*1.5);
            // loop to make sure not generated too close to the planet's surface
        }
        else if ([code isEqualToString:@"PLANET_ORBIT_LOW"])
        {
            result = OORandomPositionInShell([planet position],[planet radius]*1.1,[planet radius]*2.0);
        }
        else if ([code isEqualToString:@"PLANET_ORBIT"])
        {
            result = OORandomPositionInShell([planet position],[planet radius]*2.0,[planet radius]*4.0);
        }
        else if ([code isEqualToString:@"PLANET_ORBIT_HIGH"])
        {
            result = OORandomPositionInShell([planet position],[planet radius]*4.0,[planet radius]*8.0);
        }
        else if ([code isEqualToString:@"STAR_ORBIT_LOW"])
        {
            result = OORandomPositionInShell([sun position],[sun radius]*1.1,[sun radius]*2.0);
        }
        else if ([code isEqualToString:@"STAR_ORBIT"])
        {
            result = OORandomPositionInShell([sun position],[sun radius]*2.0,[sun radius]*4.0);
        }
        else if ([code isEqualToString:@"STAR_ORBIT_HIGH"])
        {
            result = OORandomPositionInShell([sun position],[sun radius]*4.0,[sun radius]*8.0);
        }
        else if ([code isEqualToString:@"TRIANGLE"])
        {
            do {
                // pick random point in triangle by algorithm at
                // http://adamswaab.wordpress.com/2009/12/11/random-point-in-a-triangle-barycentric-coordinates/
                // simplified by using the origin as A
                OOScalar r = randf();
                OOScalar s = randf();
                if (r+s >= 1)
                {
                    r = 1-r;
                    s = 1-s;
                }
                result = HPvector_add(HPvector_multiply_scalar([planet position],r),HPvector_multiply_scalar([sun position],s));
            }
            // make sure at least 3 radii from vertices
            while(HPdistance2(result,[sun position]) < [sun radius]*[sun radius]*9.0 || HPdistance2(result,[planet position]) < [planet radius]*[planet radius]*9.0 || HPmagnitude2(result) < SCANNER_MAX_RANGE2 * 9.0);
        }
        else if ([code isEqualToString:@"INNER_SYSTEM"])
        {
            do {
                result = OORandomPositionInShell([sun position],[sun radius]*3.0,HPdistance([sun position],[planet position]));
                result = OOProjectHPVectorToPlane(result,kZeroHPVector,HPcross_product([sun position],[planet position]));
                result = HPvector_add(result,OOHPVectorRandomSpatial([planet radius]));
                // projection to plane could bring back too close to sun
            } while (HPdistance2(result,[sun position]) < [sun radius]*[sun radius]*9.0);
        }
        else if ([code isEqualToString:@"INNER_SYSTEM_OFFPLANE"])
        {
            result = OORandomPositionInShell([sun position],[sun radius]*3.0,HPdistance([sun position],[planet position]));
        }
        else if ([code isEqualToString:@"OUTER_SYSTEM"])
        {
            result = OORandomPositionInShell([sun position],HPdistance([sun position],[planet position]),HPdistance([sun position],[planet position])*10.0); // no more than 10 AU out
            result = OOProjectHPVectorToPlane(result,kZeroHPVector,HPcross_product([sun position],[planet position]));
            result = HPvector_add(result,OOHPVectorRandomSpatial(0.01*HPdistance(result,[sun position]))); // within 1% of plane
        }
        else if ([code isEqualToString:@"OUTER_SYSTEM_OFFPLANE"])
        {
            result = OORandomPositionInShell([sun position],HPdistance([sun position],[planet position]),HPdistance([sun position],[planet position])*10.0); // no more than 10 AU out
        }
        else
        {
            OOLog(kOOLogUniversePopulateError,@"Named populator region %@ is not implemented, falling back to WITCHPOINT",code); 
            result = OOHPVectorRandomSpatial(SCANNER_MAX_RANGE);
        }
    }
    return result;
}

MaintainLinkedLists

+ (static BOOL) MaintainLinkedLists (Universe *) uni

implementation

Definition at line 5364 of file Universe.m.

{
    NSCParameterAssert(uni != NULL);
    BOOL result = YES;
    
    // DEBUG check for loops and short lists
    if (uni->n_entities > 0)
    {
        int n;
        Entity  *checkEnt, *last;
        
        last = nil;
        
        n = uni->n_entities;
        checkEnt = uni->x_list_start;
        while ((n--)&&(checkEnt))
        {
            last = checkEnt;
            checkEnt = checkEnt->x_next;
        }
        if ((checkEnt)||(n > 0))
        {
            OOExtraLog(kOOLogEntityVerificationError, @"Broken x_next %@ list (%d) ***", uni->x_list_start, n);
            result = NO;
        }
        
        n = uni->n_entities;
        checkEnt = last;
        while ((n--)&&(checkEnt))   checkEnt = checkEnt->x_previous;
        if ((checkEnt)||(n > 0))
        {
            OOExtraLog(kOOLogEntityVerificationError, @"Broken x_previous %@ list (%d) ***", uni->x_list_start, n);
            if (result)
            {
                OOExtraLog(kOOLogEntityVerificationRebuild, @"%@", @"REBUILDING x_previous list from x_next list");
                checkEnt = uni->x_list_start;
                checkEnt->x_previous = nil;
                while (checkEnt->x_next)
                {
                    last = checkEnt;
                    checkEnt = checkEnt->x_next;
                    checkEnt->x_previous = last;
                }
            }
        }
        
        n = uni->n_entities;
        checkEnt = uni->y_list_start;
        while ((n--)&&(checkEnt))
        {
            last = checkEnt;
            checkEnt = checkEnt->y_next;
        }
        if ((checkEnt)||(n > 0))
        {
            OOExtraLog(kOOLogEntityVerificationError, @"Broken *** broken y_next %@ list (%d) ***", uni->y_list_start, n);
            result = NO;
        }
        
        n = uni->n_entities;
        checkEnt = last;
        while ((n--)&&(checkEnt))   checkEnt = checkEnt->y_previous;
        if ((checkEnt)||(n > 0))
        {
            OOExtraLog(kOOLogEntityVerificationError, @"Broken y_previous %@ list (%d) ***", uni->y_list_start, n);
            if (result)
            {
                OOExtraLog(kOOLogEntityVerificationRebuild, @"%@", @"REBUILDING y_previous list from y_next list");
                checkEnt = uni->y_list_start;
                checkEnt->y_previous = nil;
                while (checkEnt->y_next)
                {
                    last = checkEnt;
                    checkEnt = checkEnt->y_next;
                    checkEnt->y_previous = last;
                }
            }
        }
        
        n = uni->n_entities;
        checkEnt = uni->z_list_start;
        while ((n--)&&(checkEnt))
        {
            last = checkEnt;
            checkEnt = checkEnt->z_next;
        }
        if ((checkEnt)||(n > 0))
        {
            OOExtraLog(kOOLogEntityVerificationError, @"Broken z_next %@ list (%d) ***", uni->z_list_start, n);
            result = NO;
        }
        
        n = uni->n_entities;
        checkEnt = last;
        while ((n--)&&(checkEnt))   checkEnt = checkEnt->z_previous;
        if ((checkEnt)||(n > 0))
        {
            OOExtraLog(kOOLogEntityVerificationError, @"Broken z_previous %@ list (%d) ***", uni->z_list_start, n);
            if (result)
            {
                OOExtraLog(kOOLogEntityVerificationRebuild, @"%@", @"REBUILDING z_previous list from z_next list");
                checkEnt = uni->z_list_start;
                NSCAssert(checkEnt != nil, @"Expected z-list to be non-empty.");    // Previously an implicit assumption. -- Ahruman 2011-01-25
                checkEnt->z_previous = nil;
                while (checkEnt->z_next)
                {
                    last = checkEnt;
                    checkEnt = checkEnt->z_next;
                    checkEnt->z_previous = last;
                }
            }
        }
    }
    
    if (!result)
    {
        OOExtraLog(kOOLogEntityVerificationRebuild, @"%@", @"Rebuilding all linked lists from scratch");
        NSArray *allEntities = uni->entities;
        uni->x_list_start = nil;
        uni->y_list_start = nil;
        uni->z_list_start = nil;
        
        Entity *ent = nil;
        foreach (ent, allEntities)
        {
            ent->x_next = nil;
            ent->x_previous = nil;
            ent->y_next = nil;
            ent->y_previous = nil;
            ent->z_next = nil;
            ent->z_previous = nil;
            [ent addToLinkedLists];
        }
    }
    
    return result;
}

makeDemoShipWithRole:spinning:

- (ShipEntity *) makeDemoShipWithRole:		(NSString *)	role
spinning:		(BOOL)	spinning

Definition at line 5364 of file Universe.m.

                                     :(NSString *)role spinning:(BOOL)spinning
{
    if ([PLAYER dockedStation] == nil)  return nil;
    
    [self removeDemoShips]; // get rid of any pre-existing models on display
    
    [PLAYER setShowDemoShips: YES];
    Quaternion q2 = { (GLfloat)M_SQRT1_2, (GLfloat)M_SQRT1_2, (GLfloat)0.0, (GLfloat)0.0 };
    
    ShipEntity *ship = [self newShipWithRole:role];   // retain count = 1
    if (ship)
    {
        double cr = [ship collisionRadius];
        [ship setOrientation:q2];
        [ship setPositionX:0.0f y:0.0f z:3.6f * cr];
        [ship setScanClass:CLASS_NO_DRAW];
        [ship switchAITo:@"nullAI.plist"];
        [ship setPendingEscortCount:0];
        
        [UNIVERSE addEntity:ship];      // STATUS_IN_FLIGHT, AI state GLOBAL
 
        if (spinning)
        {
            [ship setDemoShip: 1.0f];
        }
        else
        {
            [ship setDemoShip: 0.0f];
        }
        [ship setStatus:STATUS_COCKPIT_DISPLAY];
        // stop problems on the ship library screen
        // demo ships shouldn't have this equipment
        [ship removeEquipmentItem:@"EQ_SHIELD_BOOSTER"];
        [ship removeEquipmentItem:@"EQ_SHIELD_ENHANCER"];
    }
    
    return [ship autorelease];
}

makeSunSkimmer:andSetAI:

- (void) makeSunSkimmer:		(ShipEntity *)	ship
andSetAI:		(BOOL)	setAI

Definition at line 7996 of file Universe.m.

                       :(ShipEntity *) ship andSetAI:(BOOL)setAI
{
    if (setAI) [ship switchAITo:@"oolite-traderAI.js"]; // perfectly acceptable for both route 2 & 3
    [ship setFuel:(Ranrot()&31)];
    // slow ships need extra insulation or they will burn up when sunskimming. (Tested at biggest sun in G3: Aenqute)
    float minInsulation = 1000 / [ship maxFlightSpeed] + 1;
    if ([ship heatInsulation] < minInsulation) [ship setHeatInsulation:minInsulation];
}

marketSeed

- (Random_Seed) marketSeed

Definition at line 7996 of file Universe.m.

{
    Random_Seed     ret = [systemManager getRandomSeedForCurrentSystem];
    
    // adjust basic seed by market random factor
    // which for (very bad) historical reasons is 0x80
 
    ret.f ^= 0x80;  // XOR back to front
    ret.e ^= ret.f; // XOR
    ret.d ^= ret.e; // XOR
    ret.c ^= ret.d; // XOR
    ret.b ^= ret.c; // XOR
    ret.a ^= ret.b; // XOR
    
    return ret;
}

maxCargoForShip:

- (OOCargoQuantity) maxCargoForShip:

(NSString *)

desc

Definition at line 3616 of file Universe.m.

                                   :(NSString *) desc
{
    return [[[OOShipRegistry sharedRegistry] shipInfoForKey:desc] oo_unsignedIntForKey:@"max_cargo" defaultValue:0];
}

messageGUI

- (GuiDisplayGen *) messageGUI

Definition at line 9471 of file Universe.m.

{
    return message_gui;
}

missiontext

- (NSDictionary *) missiontext

nearbyDestinationsWithinRange:

- (NSMutableArray *) nearbyDestinationsWithinRange:

(double)

range

Finds systems within range. If range is greater than 7.0LY then only look within 7.0LY.

Definition at line 7996 of file Universe.m.

                                                  :(double)range
{
    NSMutableArray *result = [NSMutableArray arrayWithCapacity:16];
    
    range = OOClamp_0_max_d(range, MAX_JUMP_RANGE); // limit to systems within 7LY
    NSPoint here = [PLAYER galaxy_coordinates];
    
    for (unsigned short i = 0; i < 256; i++)
    {
        NSPoint there = [self coordinatesForSystem:i];
        double dist = distanceBetweenPlanetPositions(here.x, here.y, there.x, there.y);
        if (dist <= range && (i != systemID || [self inInterstellarSpace])) // if we are in interstellar space, it's OK to include the system we (mis)jumped from
        {
            [result addObject: [NSDictionary dictionaryWithObjectsAndKeys:
                                [NSNumber numberWithDouble:dist], @"distance",
                                [NSNumber numberWithInt:i], @"sysID",
                                [[self generateSystemData:i] oo_stringForKey:@"sun_gone_nova" defaultValue:@"0"], @"nova",
                                nil]];
        }
    }
    
    return result;
}

nearestEntityMatchingPredicate:parameter:relativeToEntity:

- (id) nearestEntityMatchingPredicate:		(EntityFilterPredicate)	predicate
parameter:		(void *)	parameter
relativeToEntity:		(Entity *)	entity

Definition at line 6447 of file Universe.m.

                                     :(EntityFilterPredicate)predicate
                            parameter:(void *)parameter
                     relativeToEntity:(Entity *)entity
{
    unsigned        i;
    HPVector            p1;
    float           rangeSq = INFINITY;
    id              result = nil;
    
    if (predicate == NULL)  predicate = YESPredicate;
    
    if (entity != nil)  p1 = [entity position];
    else  p1 = kZeroHPVector;
    
    for (i = 0; i < n_entities; i++)
    {
        Entity *e2 = sortedEntities[i];
        float distanceToReferenceEntitySquared = (float)HPdistance2(p1, [e2 position]);
        
        if (entity != e2 &&
            distanceToReferenceEntitySquared < rangeSq &&
            predicate(e2, parameter))
        {
            result = e2;
            rangeSq = distanceToReferenceEntitySquared;
        }
    }
    
    return [[result retain] autorelease];
}

nearestShipMatchingPredicate:parameter:relativeToEntity:

- (id) nearestShipMatchingPredicate:		(EntityFilterPredicate)	predicate
parameter:		(void *)	parameter
relativeToEntity:		(Entity *)	entity

Definition at line 6447 of file Universe.m.

                                   :(EntityFilterPredicate)predicate
                          parameter:(void *)parameter
                   relativeToEntity:(Entity *)entity
{
    if (predicate != NULL)
    {
        BinaryOperationPredicateParameter param =
        {
            IsShipPredicate, NULL,
            predicate, parameter
        };
        
        return [self nearestEntityMatchingPredicate:ANDPredicate
                                          parameter:&param
                                   relativeToEntity:entity];
    }
    else
    {
        return [self nearestEntityMatchingPredicate:IsShipPredicate
                                          parameter:NULL
                                   relativeToEntity:entity];
    }
}

neighboursToSystem:

- (NSArray *) neighboursToSystem:

(OOSystemID)

system_number

Definition at line 7996 of file Universe.m.

                                : (OOSystemID) s
{
    if (s == systemID && closeSystems != nil) 
    {
        return closeSystems;
    }
    NSArray *neighbours = [systemManager getNeighbourIDsForSystem:s inGalaxy:galaxyID];
 
    if (s == systemID)
    {
        [closeSystems release];
        closeSystems = [neighbours copy];
        return closeSystems;
    }
    return neighbours;
}

newDockWithName:andScaleFactor:

- (DockEntity *) newDockWithName:		(NSString *)	shipKey
andScaleFactor:		(float)	OO_RETURNS_RETAINED

Definition at line 3616 of file Universe.m.

                                :(NSString *)shipDataKey andScaleFactor:(float)scale
{
    OOJS_PROFILE_ENTER
    
    NSDictionary    *shipDict = nil;
    DockEntity      *dock = nil;
    
    shipDict = [[OOShipRegistry sharedRegistry] shipInfoForKey:shipDataKey];
    if (shipDict == nil)  return nil;
    
    @try
    {
        if (scale != 1.0f)
        {
            NSMutableDictionary *mShipDict = [shipDict mutableCopy];
            [mShipDict setObject:[NSNumber numberWithFloat:scale] forKey:@"model_scale_factor"];
            shipDict = [NSDictionary dictionaryWithDictionary:mShipDict];
            [mShipDict release];
        }
        dock = [[DockEntity alloc] initWithKey:shipDataKey definition:shipDict];
    }
    @catch (NSException *exception)
    {
        if ([[exception name] isEqual:OOLITE_EXCEPTION_DATA_NOT_FOUND])
        {
            OOLog(kOOLogException, @"***** Oolite Exception : '%@' in [Universe newDockWithName: %@ ] *****", [exception reason], shipDataKey);
        }
        else  @throw exception;
    }
    
    // Set primary role to same as name, if ship name is also a role.
    // Otherwise, if caller doesn't set a role, one will be selected randomly.
    if ([dock hasRole:shipDataKey])  [dock setPrimaryRole:shipDataKey];
    
    return dock;
    
    OOJS_PROFILE_EXIT
}

newShipWithName:

- (ShipEntity *) newShipWithName:

(NSString *)

OO_RETURNS_RETAINED

Definition at line 3616 of file Universe.m.

                                :(NSString *)shipKey
{
    return [self newShipWithName:shipKey usePlayerProxy:NO];
}

newShipWithName:usePlayerProxy:

- (ShipEntity *) newShipWithName:		(NSString *)	shipKey
usePlayerProxy:		(BOOL)	OO_RETURNS_RETAINED

Definition at line 3616 of file Universe.m.

                                :(NSString *)shipKey usePlayerProxy:(BOOL)usePlayerProxy
{
    return [self newShipWithName:shipKey usePlayerProxy:usePlayerProxy isSubentity:NO];
}

newShipWithName:usePlayerProxy:isSubentity:

- (ShipEntity *) newShipWithName:		(NSString *)	shipKey
usePlayerProxy:		(BOOL)	usePlayerProxy
isSubentity:		(BOOL)	OO_RETURNS_RETAINED

Definition at line 3616 of file Universe.m.

                                :(NSString *)shipKey usePlayerProxy:(BOOL)usePlayerProxy isSubentity:(BOOL)isSubentity
{
    return [self newShipWithName:shipKey usePlayerProxy:usePlayerProxy isSubentity:isSubentity andScaleFactor:1.0f];
}

newShipWithName:usePlayerProxy:isSubentity:andScaleFactor:

- (ShipEntity *) newShipWithName:		(NSString *)	shipKey
usePlayerProxy:		(BOOL)	usePlayerProxy
isSubentity:		(BOOL)	isSubentity
andScaleFactor:		(float)	OO_RETURNS_RETAINED

Definition at line 3616 of file Universe.m.

                                :(NSString *)shipKey usePlayerProxy:(BOOL)usePlayerProxy isSubentity:(BOOL)isSubentity andScaleFactor:(float)scale
{
    OOJS_PROFILE_ENTER
    
    NSDictionary    *shipDict = nil;
    ShipEntity      *ship = nil;
    
    shipDict = [[OOShipRegistry sharedRegistry] shipInfoForKey:shipKey];
    if (shipDict == nil)  return nil;
    
    volatile Class shipClass = nil;
    if (isSubentity)
    {
        shipClass = [ShipEntity class];
    }
    else
    {
        shipClass = [self shipClassForShipDictionary:shipDict];
        if (usePlayerProxy && shipClass == [ShipEntity class])
        {
            shipClass = [ProxyPlayerEntity class];
        }
    }
    
    @try
    {
        if (scale != 1.0f)
        {
            NSMutableDictionary *mShipDict = [shipDict mutableCopy];
            [mShipDict setObject:[NSNumber numberWithFloat:scale] forKey:@"model_scale_factor"];
            shipDict = [NSDictionary dictionaryWithDictionary:mShipDict];
            [mShipDict release];
        }
        ship = [[shipClass alloc] initWithKey:shipKey definition:shipDict];
    }
    @catch (NSException *exception)
    {
        if ([[exception name] isEqual:OOLITE_EXCEPTION_DATA_NOT_FOUND])
        {
            OOLog(kOOLogException, @"***** Oolite Exception : '%@' in [Universe newShipWithName: %@ ] *****", [exception reason], shipKey);
        }
        else  @throw exception;
    }
    
    // Set primary role to same as ship name, if ship name is also a role.
    // Otherwise, if caller doesn't set a role, one will be selected randomly.
    if ([ship hasRole:shipKey])  [ship setPrimaryRole:shipKey];
    
    return ship;
    
    OOJS_PROFILE_EXIT
}

newShipWithRole:

- (ShipEntity *) newShipWithRole:

(NSString *)

OO_RETURNS_RETAINED

Definition at line 3616 of file Universe.m.

                                :(NSString *)role
{
    OOJS_PROFILE_ENTER
    
    ShipEntity              *ship = nil;
    NSString                *shipKey = nil;
    NSDictionary            *shipInfo = nil;
    NSString                *autoAI = nil;
    
    shipKey = [self randomShipKeyForRoleRespectingConditions:role];
    if (shipKey != nil)
    {
        ship = [self newShipWithName:shipKey];
        if (ship != nil)
        {
            [ship setPrimaryRole:role];
            
            shipInfo = [[OOShipRegistry sharedRegistry] shipInfoForKey:shipKey];
            if ([shipInfo oo_fuzzyBooleanForKey:@"auto_ai" defaultValue:YES])
            {
                // Set AI based on role
                autoAI = [self defaultAIForRole:role];
                if (autoAI != nil)
                {
                    [ship setAITo:autoAI];
                    // Nikos 20090604
                    // Pirate, trader or police with auto_ai? Follow populator rules for them.
                    if ([role isEqualToString:@"pirate"]) [ship setBounty:20 + randf() * 50 withReason:kOOLegalStatusReasonSetup];
                    if ([role isEqualToString:@"trader"]) [ship setBounty:0 withReason:kOOLegalStatusReasonSetup];
                    if ([role isEqualToString:@"police"]) [ship setScanClass:CLASS_POLICE];
                    if ([role isEqualToString:@"interceptor"])
                    {
                        [ship setScanClass: CLASS_POLICE];
                        [ship setPrimaryRole:@"police"]; // to make sure interceptors get the correct pilot later on.
                    }
                }
                if ([role isEqualToString:@"thargoid"]) [ship setScanClass: CLASS_THARGOID]; // thargoids are not on the autoAIMap
            }
        }
    }
    
    return ship;
    
    OOJS_PROFILE_EXIT
}

newSubentityWithName:andScaleFactor:

- (ShipEntity *) newSubentityWithName:		(NSString *)	shipKey
andScaleFactor:		(float)	OO_RETURNS_RETAINED

Definition at line 3616 of file Universe.m.

                                     :(NSString *)shipKey andScaleFactor:(float)scale
{
    return [self newShipWithName:shipKey usePlayerProxy:NO isSubentity:YES andScaleFactor:scale];
}

newVisualEffectWithName:

- (OOVisualEffectEntity *) newVisualEffectWithName:

(NSString *)

OO_RETURNS_RETAINED

Definition at line 3616 of file Universe.m.

                                                  :(NSString *)effectKey
{
    OOJS_PROFILE_ENTER
    
    NSDictionary            *effectDict = nil;
    OOVisualEffectEntity    *effect = nil;
    
    effectDict = [[OOShipRegistry sharedRegistry] effectInfoForKey:effectKey];
    if (effectDict == nil)  return nil;
    
    @try
    {
        effect = [[OOVisualEffectEntity alloc] initWithKey:effectKey definition:effectDict];
    }
    @catch (NSException *exception)
    {
        if ([[exception name] isEqual:OOLITE_EXCEPTION_DATA_NOT_FOUND])
        {
            OOLog(kOOLogException, @"***** Oolite Exception : '%@' in [Universe newVisualEffectWithName: %@ ] *****", [exception reason], effectKey);
        }
        else  @throw exception;
    }
    
    return effect;
    
    OOJS_PROFILE_EXIT
}

nextColorblindMode:

- (int) nextColorblindMode:

(int)

index

Definition at line 273 of file Universe.m.

                          :(int) index
{
    if (++index > OO_POSTFX_COLORBLINDNESS_TRITAN)
        index = OO_POSTFX_NONE;
    
    return index;
}

pauseGame

- (void) pauseGame

Definition at line 273 of file Universe.m.

{
    // deal with the machine going to sleep, or player pressing 'p'.
    PlayerEntity    *player = PLAYER;
    
    [self setPauseMessageVisible:NO];
    NSString *pauseKey = [PLAYER keyBindingDescription2:@"key_pausebutton"];
    
    if ([player status] == STATUS_DOCKED)
    {
        if ([gui setForegroundTextureKey:@"paused_docked_overlay"])
        {
            [gui drawGUI:1.0 drawCursor:NO];
        }
        else
        {
            [self setPauseMessageVisible:YES];
            [self addMessage:OOExpandKey(@"game-paused-docked", pauseKey) forCount:1.0];
        }
    }
    else
    {
        if ([player guiScreen] != GUI_SCREEN_MAIN && [gui setForegroundTextureKey:@"paused_overlay"])
        {
            [gui drawGUI:1.0 drawCursor:NO];
        }
        else
        {
            [self setPauseMessageVisible:YES];
            [self addMessage:OOExpandKey(@"game-paused", pauseKey) forCount:1.0];
        }
    }
    
    [[self gameController] setGamePaused:YES];
}

pauseMessageVisible

- (BOOL) pauseMessageVisible

Definition at line 9471 of file Universe.m.

{
    return _pauseMessage;
}

permanentCommLog

- (BOOL) permanentCommLog

Definition at line 9471 of file Universe.m.

{
    return _permanentCommLog;
}

permanentMessageLog

- (BOOL) permanentMessageLog

Definition at line 9471 of file Universe.m.

{
    return _permanentMessageLog;
}

planet

- (OOPlanetEntity *) planet

Definition at line 3616 of file Universe.m.

{
    if (cachedPlanet == nil && [allPlanets count] > 0)
    {
        cachedPlanet = [allPlanets objectAtIndex:0];
    }
    return cachedPlanet;
}

planets

- (NSArray *) planets

Definition at line 3616 of file Universe.m.

{
    return allPlanets;
}

populateNormalSpace

- (void) populateNormalSpace

Definition at line 273 of file Universe.m.

{   
    NSDictionary        *systeminfo = [systemManager getPropertiesForCurrentSystem];
 
    BOOL sunGoneNova = [systeminfo oo_boolForKey:@"sun_gone_nova"];
    // check for nova
    if (sunGoneNova)
    {
        OO_DEBUG_PUSH_PROGRESS(@"%@", @"setUpSpace - post-nova");
        
        HPVector v0 = make_HPvector(0,0,34567.89);
        double min_safe_dist2 = 6000000.0 * 6000000.0;
        HPVector sunPos = [cachedSun position];
        while (HPmagnitude2(cachedSun->position) < min_safe_dist2)  // back off the planetary bodies
        {
            v0.z *= 2.0;
            
            sunPos = HPvector_add(sunPos, v0);
            [cachedSun setPosition:sunPos];  // also sets light origin
            
        }
        
        [self removeEntity:cachedPlanet];   // and Poof! it's gone
        cachedPlanet = nil; 
        [self removeEntity:cachedStation];  // also remove main station
        cachedStation = nil;    
    }
 
    OO_DEBUG_PUSH_PROGRESS(@"%@", @"setUpSpace - populate from hyperpoint");
//  [self populateSpaceFromHyperPoint:witchPos toPlanetPosition: a_planet->position andSunPosition: a_sun->position];
    [self clearSystemPopulator];
 
    if ([PLAYER status] != STATUS_START_GAME)
    {
        NSString *populator = [systeminfo oo_stringForKey:@"populator" defaultValue:(sunGoneNova)?@"novaSystemWillPopulate":@"systemWillPopulate"];
        [system_repopulator release];
        system_repopulator = [[systeminfo oo_stringForKey:@"repopulator" defaultValue:(sunGoneNova)?@"novaSystemWillRepopulate":@"systemWillRepopulate"] retain];
 
        JSContext *context = OOJSAcquireContext();
        [PLAYER doWorldScriptEvent:OOJSIDFromString(populator) inContext:context withArguments:NULL count:0 timeLimit:kOOJSLongTimeLimit];
        OOJSRelinquishContext(context);
        [self populateSystemFromDictionariesWithSun:cachedSun andPlanet:cachedPlanet];
    }
 
    OO_DEBUG_POP_PROGRESS();
 
    // systeminfo might have a 'script_actions' resource we want to activate now...
    NSArray *script_actions = [systeminfo oo_arrayForKey:@"script_actions"];
    if (script_actions != nil)
    {
        OOStandardsDeprecated([NSString stringWithFormat:@"The script_actions system info key is deprecated for %@.",[self getSystemName:systemID]]);
        if (!OOEnforceStandards()) 
        {
            OO_DEBUG_PUSH_PROGRESS(@"%@", @"setUpSpace - legacy script_actions");
            [PLAYER runUnsanitizedScriptActions:script_actions
                              allowingAIMethods:NO
                                withContextName:@"<system script_actions>"
                                      forTarget:nil];
            OO_DEBUG_POP_PROGRESS();
        }
    }
 
    next_repopulation = randf() * SYSTEM_REPOPULATION_INTERVAL;
}

populateSpaceFromActiveWormholes

- (void) populateSpaceFromActiveWormholes

implementation

Provided by category Universe(OOPrivate).

Definition at line 10697 of file Universe.m.

{
    NSAutoreleasePool   *pool = nil;
    
    while ([activeWormholes count])
    {
        pool = [[NSAutoreleasePool alloc] init];
        @try
        {
            WormholeEntity* whole = [activeWormholes objectAtIndex:0];      
            // If the wormhole has been scanned by the player then the
            // PlayerEntity will take care of it
            if (![whole isScanned] &&
                NSEqualPoints([PLAYER galaxy_coordinates], [whole destinationCoordinates]) )
            {
                // this is a wormhole to this system
                [whole disgorgeShips];
            }
            [activeWormholes removeObjectAtIndex:0];    // empty it out
        }
        @catch (NSException *exception)
        {
            OOLog(kOOLogException, @"Squashing exception during wormhole unpickling (%@: %@).", [exception name], [exception reason]);
        }
        [pool release];
    }
}

populateSystemFromDictionariesWithSun:andPlanet:

- (void) populateSystemFromDictionariesWithSun:		(OOSunEntity *)	sun
andPlanet:		(OOPlanetEntity *)	planet

Definition at line 273 of file Universe.m.

                                              :(OOSunEntity *)sun andPlanet:(OOPlanetEntity *)planet
{
    Random_Seed systemSeed = [systemManager getRandomSeedForCurrentSystem];
    NSArray *blocks = [populatorSettings allValues];
    NSEnumerator *enumerator = [[blocks sortedArrayUsingFunction:populatorPrioritySort context:nil] objectEnumerator];
    NSDictionary *populator = nil;
    HPVector location = kZeroHPVector;
    uint32_t i, locationSeed, groupCount, rndvalue;
    RANROTSeed rndcache = RANROTGetFullSeed();
    RANROTSeed rndlocal = RANROTGetFullSeed();
    NSString *locationCode = nil;
    OOJSPopulatorDefinition *pdef = nil;
    while ((populator = [enumerator nextObject]))
    {
        deterministic_population = [populator oo_boolForKey:@"deterministic" defaultValue:NO];
        if (EXPECT_NOT(sun == nil || planet == nil))
        {
            // needs to be a non-nova system, and not interstellar space
            deterministic_population = NO;
        }
 
        locationSeed = [populator oo_unsignedIntForKey:@"locationSeed" defaultValue:0];
        groupCount = [populator oo_unsignedIntForKey:@"groupCount" defaultValue:1];
        
        for (i = 0; i < groupCount; i++)
        {
            locationCode = [populator oo_stringForKey:@"location" defaultValue:@"COORDINATES"];
            if ([locationCode isEqualToString:@"COORDINATES"])
            {
                location = [populator oo_hpvectorForKey:@"coordinates" defaultValue:kZeroHPVector];
            }
            else
            {
                if (locationSeed != 0)
                {
                    rndcache = RANROTGetFullSeed();
                    // different place for each system
                    rndlocal = RanrotSeedFromRandomSeed(systemSeed);
                    rndvalue = RanrotWithSeed(&rndlocal);
                    // ...for location seed
                    rndlocal = MakeRanrotSeed(rndvalue+locationSeed);
                    rndvalue = RanrotWithSeed(&rndlocal);
                    // ...for iteration (63647 is nothing special, just a largish prime)
                    RANROTSetFullSeed(MakeRanrotSeed(rndvalue+(i*63647)));
                }
                else
                {
                    // not fixed coordinates and not seeded RNG; can't
                    // be deterministic
                    deterministic_population = NO;
                }
                if (sun == nil || planet == nil)
                {
                    // all interstellar space and nova locations equal to WITCHPOINT
                    location = [self locationByCode:@"WITCHPOINT" withSun:nil andPlanet:nil];
                }
                else
                {
                    location = [self locationByCode:locationCode withSun:sun andPlanet:planet];
                }
                if(locationSeed != 0)
                {
                    // go back to the main random sequence
                    RANROTSetFullSeed(rndcache);
                }           
            }
            // location now contains a Vector coordinate, one way or another
            pdef = [populator objectForKey:@"callbackObj"];
            [pdef runCallback:location];
        }
    }
    // nothing is deterministic once the populator is done
    deterministic_population = NO;
}

PreloadOneSound

+ (static void) PreloadOneSound (NSString *) soundName

implementation

Definition at line 10697 of file Universe.m.

{
    if (![soundName hasPrefix:@"["] && ![soundName hasSuffix:@"]"])
    {
        [ResourceManager ooSoundNamed:soundName inFolder:@"Sounds"];
    }
}

preloadPlanetTexturesForSystem:

- (void) preloadPlanetTexturesForSystem:

(OOSystemID)

system

Definition at line 7996 of file Universe.m.

                                       :(OOSystemID)s
{
// #if NEW_PLANETS
#if 0
    [self prunePreloadingPlanetMaterials];
    
    if ([_preloadingPlanetMaterials count] < 3)
    {
        if (_preloadingPlanetMaterials == nil)  _preloadingPlanetMaterials = [[NSMutableArray alloc] initWithCapacity:4];
        
        OOPlanetEntity *planet = [[OOPlanetEntity alloc] initAsMainPlanetForSystem:s];
        OOMaterial *surface = [planet material];
        // can be nil if texture mis-defined
        if (surface != nil)
        {
            // if it's already loaded, no need to continue
            if (![surface isFinishedLoading])
            {
                [_preloadingPlanetMaterials addObject:surface];
        
                // In some instances (retextured planets atm), the main planet might not have an atmosphere defined.
                // Trying to add nil to _preloadingPlanetMaterials will prematurely terminate the calling function.(!) --Kaks 20100107
                OOMaterial *atmo = [planet atmosphereMaterial];
                if (atmo != nil)  [_preloadingPlanetMaterials addObject:atmo];
            }
        }
        
        [planet release];
    }
#endif
}

preloadSounds

- (void) preloadSounds

Definition at line 10697 of file Universe.m.

{
    // Preload sounds to avoid loading stutter.
    NSString *key = nil;
    foreachkey (key, customSounds)
    {
        id object = [customSounds objectForKey:key];
        if([object isKindOfClass:[NSString class]])
        {
            PreloadOneSound(object);
        }
        else if([object isKindOfClass:[NSArray class]] && [object count] > 0)
        {
            NSString *soundName = nil;
            foreach (soundName, object)
            {
                if ([soundName isKindOfClass:[NSString class]])
                {
                    PreloadOneSound(soundName);
                }
            }
        }
    }
    
    // Afterburner sound doesn't go through customsounds.plist.
    PreloadOneSound(@"afterburner1.ogg");
}

prepareToRenderIntoDefaultFramebuffer

- (void) prepareToRenderIntoDefaultFramebuffer

implementation

Provided by category Universe(OOPrivate).

Definition at line 4630 of file Universe.m.

{
    NSSize viewSize = [gameView viewSize];
    if([self useShaders])
    {
        if ([gameView msaa])
        {
            // resolve MSAA framebuffer to target framebuffer
            OOGL(glBindFramebuffer(GL_READ_FRAMEBUFFER, msaaFramebufferID));
            OOGL(glBindFramebuffer(GL_DRAW_FRAMEBUFFER, targetFramebufferID));
            OOGL(glBlitFramebuffer(0, 0, (GLint)viewSize.width, (GLint)viewSize.height, 0, 0, (GLint)viewSize.width, (GLint)viewSize.height, GL_COLOR_BUFFER_BIT, GL_NEAREST));
        }
    }
}

prevColorblindMode:

- (int) prevColorblindMode:

(int)

index

Definition at line 273 of file Universe.m.

                          :(int) index
{
    if (--index < OO_POSTFX_NONE)
        index = OO_POSTFX_COLORBLINDNESS_TRITAN;
    
    return index;
}

randomDistanceWithinScanner

- (float) randomDistanceWithinScanner

implementation

Provided by category Universe(OOPrivate).

Definition at line 9471 of file Universe.m.

{
    return SCANNER_MAX_RANGE * ((Ranrot() & 255) / 256.0 - 0.5);
}

randomPlaceWithinScannerFrom:alongRoute:withOffset:

- (Vector) randomPlaceWithinScannerFrom: (Vector) pos alongRoute: (Vector) route withOffset: (double) offset

implementation

Provided by category Universe(OOPrivate).

Definition at line 9471 of file Universe.m.

                                       :(Vector)pos alongRoute:(Vector)route withOffset:(double)offset
{
    pos.x += offset * route.x + [self randomDistanceWithinScanner];
    pos.y += offset * route.y + [self randomDistanceWithinScanner];
    pos.z += offset * route.z + [self randomDistanceWithinScanner];
    
    return pos;
}

randomShipKeyForRoleRespectingConditions:

- (NSString *) randomShipKeyForRoleRespectingConditions:

(NSString *)

role

Definition at line 3616 of file Universe.m.

                                                       :(NSString *)role
{
    OOJS_PROFILE_ENTER
    
    OOShipRegistry          *registry = [OOShipRegistry sharedRegistry];
    NSString                *shipKey = nil;
    OOMutableProbabilitySet *pset = nil;
    
#if PROFILE_SHIP_SELECTION
    static unsigned long    profTotal = 0, profSlowPath = 0;
    ++profTotal;
#endif
    
    // Select a ship, check conditions and return it if possible.
    shipKey = [registry randomShipKeyForRole:role];
    if ([self canInstantiateShip:shipKey])  return shipKey;
    
    /*  If we got here, condition check failed.
        We now need to keep trying until we either find an acceptable ship or
        run out of candidates.
        This is special-cased because it has more overhead than the more
        common conditionless lookup.
    */
    
#if PROFILE_SHIP_SELECTION
    ++profSlowPath;
    if ((profSlowPath % 10) == 0)   // Only print every tenth slow path, to reduce spamminess.
    {
        OOLog(@"shipRegistry.selection.profile", @"Hit slow path in ship selection for role \"%@\", having selected ship \"%@\". Now %lu of %lu on slow path (%f%%).", role, shipKey, profSlowPath, profTotal, ((double)profSlowPath)/((double)profTotal) * 100.0f);
    }
#endif
    
    pset = [[[registry probabilitySetForRole:role] mutableCopy] autorelease];
    
    while ([pset count] > 0)
    {
        // Select a ship, check conditions and return it if possible.
        shipKey = [pset randomObject];
        if ([self canInstantiateShip:shipKey])  return shipKey;
        
        // Condition failed -> remove ship from consideration.
        [pset removeObject:shipKey];
    }
    
    // If we got here, some ships existed but all failed conditions test.
    return nil;
    
    OOJS_PROFILE_EXIT
}

reducedDetail

- (BOOL) reducedDetail

Definition at line 9471 of file Universe.m.

{
    return detailLevel == DETAIL_LEVEL_MINIMUM;
}

reifyCargoPod:

- (ShipEntity *) reifyCargoPod:

(ShipEntity *)

cargoObj

Definition at line 3616 of file Universe.m.

                              :(ShipEntity *)cargoObj
{
    if ([cargoObj isTemplateCargoPod])
    {
        return [UNIVERSE cargoPodFromTemplate:cargoObj];
    }
    else
    {
        return cargoObj;
    }
}

reinitAndShowDemo:

- (BOOL) reinitAndShowDemo:

(BOOL)

showDemo

Definition at line 9471 of file Universe.m.

                          :(BOOL) showDemo
{
    no_update = YES;
    PlayerEntity* player = PLAYER;
    assert(player != nil);
    
    if (JSResetFlags != 0)  // JS reset failed, remember previous settings 
    {
        showDemo = (JSResetFlags & 2) > 0;  // binary 10, a.k.a. 1 << 1
    }
    else
    {
        JSResetFlags = (showDemo << 1);
    }
    
    [self removeAllEntitiesExceptPlayer];
    [OOTexture clearCache];
    
    _sessionID++;   // Must be after removing old entities and before adding new ones.
    
    [ResourceManager setUseAddOns:useAddOns];   // also logs the paths
    //[ResourceManager loadScripts]; // initialised inside [player setUp]!
    
    // NOTE: Anything in the sharedCache is now trashed and must be
    //       reloaded. Ideally anything using the sharedCache should
    //       be aware of cache flushes so it can automatically
    //       reinitialize itself - mwerle 20081107.
    [OOShipRegistry reload];
    [[self gameController] setGamePaused:NO];
    [[self gameController] setMouseInteractionModeForUIWithMouseInteraction:NO];
    [PLAYER setSpeed:0.0];
    
    [self loadDescriptions];
    [self loadScenarios];
    
    [missiontext autorelease];
    missiontext = [[ResourceManager dictionaryFromFilesNamed:@"missiontext.plist" inFolder:@"Config" andMerge:YES] retain];
    
    
    if(showDemo)
    {
        [demo_ships release];
        demo_ships = [[[OOShipRegistry sharedRegistry] demoShipKeys] retain];
        demo_ship_index = 0;
        demo_ship_subindex = 0;
    }
    
    breakPatternCounter = 0;
    
    cachedSun = nil;
    cachedPlanet = nil;
    cachedStation = nil;
    
    [self setUpSettings];
 
    // reset these in case OXP set has changed
 
    // set up cargopod templates
    [self setUpCargoPods];
    
    if (![player setUpAndConfirmOK:YES]) 
    {
        // reinitAndShowDemo rescheduled inside setUpAndConfirmOK...
        return NO;  // Abort!
    }
    
    // we can forget the previous settings now.
    JSResetFlags = 0;
    
    [self addEntity:player];
    demo_ship = nil;
    [[self gameController] setPlayerFileToLoad:nil];        // reset Quicksave
    
    [self setUpInitialUniverse];
    autoSaveNow = NO;   // don't autosave immediately after restarting a game
    
    [[self station] initialiseLocalMarket];
    
    if(showDemo)
    {
        [player setStatus:STATUS_START_GAME];
        // re-read keyconfig.plist just in case we've loaded a keyboard
        // configuration expansion
        [player initControls];
    }
    else
    {
        [player setDockedAtMainStation];
    }
    
    [player completeSetUp];
    if(showDemo)
    {
        [player setGuiToIntroFirstGo:YES];
    }
    else
    {
        // no need to do these if showing the demo as the only way out
        // now is to load a game
        [self populateNormalSpace];
 
        [player startUpComplete];
    }
 
    if(!showDemo)
    {
        [player setGuiToStatusScreen];
        [player doWorldEventUntilMissionScreen:OOJSID("missionScreenOpportunity")];
    }
    
    [self verifyEntitySessionIDs];
 
    no_update = NO;
    return YES;
}

removeAllEntitiesExceptPlayer

- (void) removeAllEntitiesExceptPlayer

Definition at line 5364 of file Universe.m.

{
    BOOL updating = no_update;
    no_update = YES;            // no drawing while we do this!
    
#ifndef NDEBUG
    Entity* p0 = [entities objectAtIndex:0];
    if (!(p0->isPlayer))
    {
        OOLog(kOOLogInconsistentState, @"%@", @"***** First entity is not the player in Universe.removeAllEntitiesExceptPlayer - exiting.");
        exit(EXIT_FAILURE);
    }
#endif
    
    // preserve wormholes
    NSMutableArray *savedWormholes = [activeWormholes mutableCopy];
    
    while ([entities count] > 1)
    {
        Entity* ent = [entities objectAtIndex:1];
        if (ent->isStation)  // clear out queues
            [(StationEntity *)ent clear];
        if (EXPECT(![ent isVisualEffect]))
        {
            [self removeEntity:ent];
        }
        else
        {
            // this will ensure the effectRemoved script event will run
            [(OOVisualEffectEntity *)ent remove];
        }
    }
    
    [activeWormholes release];
    activeWormholes = savedWormholes;   // will be cleared out by populateSpaceFromActiveWormholes
    
    // maintain sorted list
    n_entities = 1;
    
    cachedSun = nil;
    cachedPlanet = nil;
    cachedStation = nil;
    [closeSystems release];
    closeSystems = nil;
    
    [self resetBeacons];
    [waypoints removeAllObjects];
    
    no_update = updating;   // restore drawing
}

removeDemoShips

- (void) removeDemoShips

Definition at line 5364 of file Universe.m.

{
    int i;
    int ent_count = n_entities;
    if (ent_count > 0)
    {
        Entity* ent;
        for (i = 0; i < ent_count; i++)
        {
            ent = sortedEntities[i];
            if ([ent status] == STATUS_COCKPIT_DISPLAY && ![ent isPlayer])
            {
                [self removeEntity:ent];
            }
        }
    }
    demo_ship = nil;
}

removeEntity:

- (BOOL) removeEntity:

(Entity *)

entity

Definition at line 5364 of file Universe.m.

                     :(Entity *) entity
{
    if (entity != nil && ![entity isPlayer])
    {
        /*  Ensure entity won't actually be dealloced until the end of this
            update (or the next update if none is in progress), because
            there may be things pointing to it but not retaining it.
        */
        [entitiesDeadThisUpdate addObject:entity];
        if ([entity isStation])
        {
            [allStations removeObject:entity];
            if ([PLAYER getTargetDockStation] == entity)
            {
                [PLAYER setDockingClearanceStatus:DOCKING_CLEARANCE_STATUS_NONE];
            }
        }
        return [self doRemoveEntity:entity];
    }
    return NO;
}

repopulateSystem

- (void) repopulateSystem

implementation

Definition at line 6447 of file Universe.m.

{
    if (EXPECT_NOT([PLAYER status] == STATUS_START_GAME))
    {
        return; // no need to be adding ships as this is not a "real" game
    }
    JSContext           *context = OOJSAcquireContext();
    [PLAYER doWorldScriptEvent:OOJSIDFromString(system_repopulator) inContext:context withArguments:NULL count:0 timeLimit:kOOJSLongTimeLimit];
    OOJSRelinquishContext(context);
    next_repopulation = SYSTEM_REPOPULATION_INTERVAL;
}

resetBeacons

- (void) resetBeacons

Definition at line 3616 of file Universe.m.

{
    Entity <OOBeaconEntity> *beaconShip = [self firstBeacon], *next = nil;
    while (beaconShip)
    {
        next = [beaconShip nextBeacon];
        [beaconShip setPrevBeacon:nil];
        [beaconShip setNextBeacon:nil];
        beaconShip = next;
    }
    
    [self setFirstBeacon:nil];
    [self setLastBeacon:nil];
}

resetCommsLogColor

- (void) resetCommsLogColor

Definition at line 9471 of file Universe.m.

{
    [comm_log_gui setTextColor:[OOColor whiteColor]];
}

resetFramesDoneThisUpdate

- (void) resetFramesDoneThisUpdate

Definition at line 4630 of file Universe.m.

{
    framesDoneThisUpdate = 0;
}

resizeTargetFramebufferWithViewSize:

- (void) resizeTargetFramebufferWithViewSize: (NSSize) viewSize

implementation

Provided by category Universe(OOPrivate).

Definition at line 273 of file Universe.m.

                                            :(NSSize)viewSize
{
    int i;
    // resize MSAA color attachment
    OOGL(glBindTexture(GL_TEXTURE_2D_MULTISAMPLE, msaaTextureID));
    OOGL(glTexImage2DMultisample(GL_TEXTURE_2D_MULTISAMPLE, 4, GL_RGBA16F, (GLsizei)viewSize.width, (GLsizei)viewSize.height, GL_TRUE));
    OOGL(glBindTexture(GL_TEXTURE_2D_MULTISAMPLE, 0));
    
    // resize MSAA depth attachment
    OOGL(glBindRenderbuffer(GL_RENDERBUFFER, msaaDepthBufferID));
    OOGL(glRenderbufferStorageMultisample(GL_RENDERBUFFER, 4, GL_DEPTH_COMPONENT32F, (GLsizei)viewSize.width, (GLsizei)viewSize.height));
    OOGL(glBindRenderbuffer(GL_RENDERBUFFER, 0));
    
    // resize color attachments
    OOGL(glBindTexture(GL_TEXTURE_2D, targetTextureID));
    OOGL(glTexImage2D(GL_TEXTURE_2D, 0, GL_RGBA16F, (GLsizei)viewSize.width, (GLsizei)viewSize.height, 0, GL_RGBA, GL_FLOAT, NULL));
    OOGL(glBindTexture(GL_TEXTURE_2D, 0));
    
    for (i = 0; i < 2; i++)
    {
        OOGL(glBindTexture(GL_TEXTURE_2D, pingpongColorbuffers[i]));
        OOGL(glTexImage2D(GL_TEXTURE_2D, 0, GL_RGBA16F, (GLsizei)viewSize.width, (GLsizei)viewSize.height, 0, GL_RGBA, GL_FLOAT, NULL));
        OOGL(glBindTexture(GL_TEXTURE_2D, 0));
    }
    
    for (i = 0; i < 2; i++)
    {
        OOGL(glBindTexture(GL_TEXTURE_2D, passthroughTextureID[i]));
        OOGL(glTexImage2D(GL_TEXTURE_2D, 0, GL_RGBA16F, (GLsizei)viewSize.width, (GLsizei)viewSize.height, 0, GL_RGBA, GL_FLOAT, NULL));
        OOGL(glBindTexture(GL_TEXTURE_2D, 0));
    }
    
    // resize depth attachment
    OOGL(glBindRenderbuffer(GL_RENDERBUFFER, targetDepthBufferID));
    OOGL(glRenderbufferStorage(GL_RENDERBUFFER, GL_DEPTH_COMPONENT32F, (GLsizei)viewSize.width, (GLsizei)viewSize.height));
    OOGL(glBindRenderbuffer(GL_RENDERBUFFER, 0));
    
    targetFramebufferSize.width = viewSize.width;
    targetFramebufferSize.height = viewSize.height;
}

role:isInCategory:

- (BOOL) role:		(NSString *)	role
isInCategory:		(NSString *)	category

Definition at line 273 of file Universe.m.

             :(NSString *)role isInCategory:(NSString *)category
{
    NSSet *categoryInfo = [roleCategories objectForKey:category];
    if (categoryInfo == nil)
    {
        return NO;
    }
    return [categoryInfo containsObject:role];
}

roleIsPirateVictim:

- (BOOL) roleIsPirateVictim:

(NSString *)

role

Definition at line 273 of file Universe.m.

                           :(NSString *)role
{
    return [self role:role isInCategory:@"oolite-pirate-victim"];
}

routeFromSystem:toSystem:optimizedBy:

- (NSDictionary *) routeFromSystem:		(OOSystemID)	start
toSystem:		(OOSystemID)	goal
optimizedBy:		(OORouteType)	optimizeBy

Definition at line 7996 of file Universe.m.

                                  :(OOSystemID) start toSystem:(OOSystemID) goal optimizedBy:(OORouteType) optimizeBy
{
    /*
     time_cost = distance * distance
     jump_cost = jumps * max_total_distance + distance = max_total_tistance + distance
     
     max_total_distance is 7 * 256
     
     max_time_cost = max_planets * max_time_cost = 256 * (7 * 7)
     max_jump_cost = max_planets * max_jump_cost = 256 * (7 * 256 + 7)
     */
    
    // no interstellar space for start and/or goal please
    if (start == -1 || goal == -1)  return nil;
    
#ifdef CACHE_ROUTE_FROM_SYSTEM_RESULTS
    
    static NSDictionary *c_route = nil;
    static OOSystemID c_start, c_goal;
    static OORouteType c_optimizeBy;
    
    if (c_route != nil && c_start == start && c_goal == goal && c_optimizeBy == optimizeBy)
    {
        return c_route;
    }
    
#endif
    
    unsigned i, j;
    
    if (start > 255 || goal > 255) return nil;
    
    NSArray *neighbours[256];
    BOOL concealed[256];
    for (i = 0; i < 256; i++)
    {
        NSDictionary *systemInfo = [systemManager getPropertiesForSystem:i inGalaxy:galaxyID];
        NSInteger concealment = [systemInfo oo_intForKey:@"concealment" defaultValue:OO_SYSTEMCONCEALMENT_NONE];
        if (concealment >= OO_SYSTEMCONCEALMENT_NOTHING) {
            // system is not known
            neighbours[i] = [NSArray array];
            concealed[i] = YES;
        }
        else
        {
            neighbours[i] = [self neighboursToSystem:i];
            concealed[i] = NO;
        }
    }
    
    RouteElement *cheapest[256] = {0};
    
    double maxCost = optimizeBy == OPTIMIZED_BY_TIME ? 256 * (7 * 7) : 256 * (7 * 256 + 7);
    
    NSMutableArray *curr = [NSMutableArray arrayWithCapacity:256];
    [curr addObject:cheapest[start] = [RouteElement elementWithLocation:start parent:-1 cost:0 distance:0 time:0 jumps: 0]];
    
    NSMutableArray *next = [NSMutableArray arrayWithCapacity:256];
    while ([curr count] != 0)
    {
        for (i = 0; i < [curr count]; i++) {
            RouteElement *elemI = [curr objectAtIndex:i];
            NSArray *ns = neighbours[[elemI location]];
            for (j = 0; j < [ns count]; j++)
            {
                RouteElement *ce = cheapest[[elemI location]];
                OOSystemID n = [ns oo_intAtIndex:j];
                if (concealed[n])
                {
                    continue;
                }
                OOSystemID c = [ce location];
                
                NSPoint cpos = [systemManager getCoordinatesForSystem:c inGalaxy:galaxyID];
                NSPoint npos = [systemManager getCoordinatesForSystem:n inGalaxy:galaxyID];
 
                double lastDistance = distanceBetweenPlanetPositions(npos.x,npos.y,cpos.x,cpos.y);
                double lastTime = lastDistance * lastDistance;
                
                double distance = [ce distance] + lastDistance;
                double time = [ce time] + lastTime;
                double cost = [ce cost] + (optimizeBy == OPTIMIZED_BY_TIME ? lastTime : 7 * 256 + lastDistance);
                int jumps = [ce jumps] + 1;
                
                if (cost < maxCost && (cheapest[n] == nil || [cheapest[n] cost] > cost)) {
                    RouteElement *e = [RouteElement elementWithLocation:n parent:c cost:cost distance:distance time:time jumps:jumps];
                    cheapest[n] = e;
                    [next addObject:e];
                    
                    if (n == goal && cost < maxCost)
                        maxCost = cost;
                }
            }
        }
        [curr setArray:next];
        [next removeAllObjects];
    }
    
    
    if (!cheapest[goal]) return nil;
    
    NSMutableArray *route = [NSMutableArray arrayWithCapacity:256];
    RouteElement *e = cheapest[goal];
    for (;;)
    {
        [route insertObject:[NSNumber numberWithInt:[e location]] atIndex:0];
        if ([e parent] == -1) break;
        e = cheapest[[e parent]];
    }
    
#ifdef CACHE_ROUTE_FROM_SYSTEM_RESULTS
    c_start = start;
    c_goal = goal;
    c_optimizeBy = optimizeBy;
    [c_route release];
    c_route = [[NSDictionary alloc] initWithObjectsAndKeys: route, @"route", [NSNumber numberWithDouble:[cheapest[goal] distance]], @"distance", nil];
    
    return c_route;
#else
    return [NSDictionary dictionaryWithObjectsAndKeys:
            route, @"route",
            [NSNumber numberWithDouble:[cheapest[goal] distance]], @"distance",
            [NSNumber numberWithDouble:[cheapest[goal] time]], @"time",
            [NSNumber numberWithInt:[cheapest[goal] jumps]], @"jumps",
            nil];
#endif
}

safeWitchspaceExitDistance

- (GLfloat) safeWitchspaceExitDistance

Definition at line 273 of file Universe.m.

{
    for (unsigned i = 0; i < n_entities; i++)
    {
        Entity *e2 = sortedEntities[i];
        if ([e2 isShip] && [(ShipEntity*)e2 hasPrimaryRole:@"buoy-witchpoint"])
        {
            return [(ShipEntity*)e2 collisionRadius] + MIN_DISTANCE_TO_BUOY;
        }
    }
    return MIN_DISTANCE_TO_BUOY;
}

scenarios

- (NSArray *) scenarios

Definition at line 7996 of file Universe.m.

{
    return _scenarios;
}

screenTextureDescriptorForKey:

- (NSDictionary *) screenTextureDescriptorForKey:

(NSString *)

key

Definition at line 6447 of file Universe.m.

                                                :(NSString *)key
{
    id value = [screenBackgrounds objectForKey:key];
    while ([value isKindOfClass:[NSArray class]])  value = [value objectAtIndex:Ranrot() % [value count]];
    
    if ([value isKindOfClass:[NSString class]])  value = [NSDictionary dictionaryWithObject:value forKey:@"name"];
    else if (![value isKindOfClass:[NSDictionary class]])  value = nil;
    
    // Start loading the texture, and return nil if it doesn't exist.
    if (![[self gui] preloadGUITexture:value])  value = nil;
    
    return value;
}

selectIntro2Next

- (void) selectIntro2Next

Definition at line 273 of file Universe.m.

{
    demo_stage = DEMO_SHOW_THING;
    demo_stage_time  = universal_time - 1.0;    // force change
}

selectIntro2NextCategory

- (void) selectIntro2NextCategory

Definition at line 273 of file Universe.m.

{
    demo_stage = DEMO_SHOW_THING;
    demo_ship_index = (demo_ship_index + 1) % [demo_ships count];
    demo_ship_subindex = [[demo_ships objectAtIndex:demo_ship_index] count] - 1;
    demo_stage_time  = universal_time - 1.0;    // force change
}

selectIntro2Previous

- (void) selectIntro2Previous

Definition at line 273 of file Universe.m.

{
    demo_stage = DEMO_SHOW_THING;
    NSUInteger subcount = [[demo_ships objectAtIndex:demo_ship_index] count];
    demo_ship_subindex = (demo_ship_subindex + subcount - 2) % subcount;
    demo_stage_time  = universal_time - 1.0;    // force change
}

selectIntro2PreviousCategory

- (void) selectIntro2PreviousCategory

Definition at line 273 of file Universe.m.

{
    demo_stage = DEMO_SHOW_THING;
    demo_ship_index = (demo_ship_index + [demo_ships count] - 1) % [demo_ships count];
    demo_ship_subindex = [[demo_ships objectAtIndex:demo_ship_index] count] - 1;
    demo_stage_time  = universal_time - 1.0;    // force change
}

sessionID

- (NSUInteger) sessionID

Definition at line 273 of file Universe.m.

{
    return _sessionID;
}

setAirResistanceFactor:

- (void) setAirResistanceFactor:

(GLfloat)

newFactor

Definition at line 9471 of file Universe.m.

                               :(GLfloat)newFactor
{
    airResistanceFactor = OOClamp_0_1_f(newFactor);
}

setAmbientLightLevel:

- (void) setAmbientLightLevel:

(float)

newValue

Definition at line 273 of file Universe.m.

                             :(float)newValue
{
    NSAssert(UNIVERSE != nil, @"Attempt to set ambient light level with a non yet existent universe.");
    
    ambientLightLevel = OOClamp_0_max_f(newValue, 10.0f);
    return;
}

setAutoCommLog:

- (void) setAutoCommLog:

(BOOL)

value

Definition at line 9471 of file Universe.m.

                       :(BOOL)value
{
    _autoCommLog = value;
}

setAutoMessageLogBg:

- (void) setAutoMessageLogBg:

(BOOL)

value

Definition at line 9471 of file Universe.m.

                            :(BOOL)value
{
    _autoMessageLogBg = !!value;
}

setAutoSave:

- (void) setAutoSave:

(BOOL)

value

Definition at line 9471 of file Universe.m.

                    :(BOOL) value
{
    autoSave = !!value;
    [[NSUserDefaults standardUserDefaults] setBool:autoSave forKey:@"autosave"];
}

setAutoSaveNow:

- (void) setAutoSaveNow:

(BOOL)

value

Definition at line 9471 of file Universe.m.

                       :(BOOL) value
{
    autoSaveNow = !!value;
}

setBlockJSPlayerShipProps:

- (void) setBlockJSPlayerShipProps:

(BOOL)

value

Definition at line 9471 of file Universe.m.

                                  :(BOOL)value
{
    if (value)
    {
        gOOJSPlayerIfStale = PLAYER;
    }
    else
    {
        gOOJSPlayerIfStale = nil;
    }
}

setBloom:

- (void) setBloom:

(BOOL)

newBloom

Definition at line 273 of file Universe.m.

                 : (BOOL)newBloom
{
    _bloom = !!newBloom;
}

setCurrentPostFX:

- (void) setCurrentPostFX:

(int)

newCurrentPostFX

Definition at line 273 of file Universe.m.

                         : (int) newCurrentPostFX
{
    if (newCurrentPostFX < 1 || newCurrentPostFX > OO_POSTFX_ENDOFLIST - 1)
    {
        newCurrentPostFX = OO_POSTFX_NONE;
    }
    
    if  (OO_POSTFX_NONE <= newCurrentPostFX && newCurrentPostFX <= OO_POSTFX_COLORBLINDNESS_TRITAN)
    {
        _colorblindMode = newCurrentPostFX;
    }       
    
    _currentPostFX = newCurrentPostFX;
}

setDetailLevel:

- (void) setDetailLevel:

(OOGraphicsDetail)

value

Definition at line 9471 of file Universe.m.

                       :(OOGraphicsDetail)value
{
    OOGraphicsDetail old = detailLevel;
    [self setDetailLevelDirectly:value];
    [[NSUserDefaults standardUserDefaults] setInteger:detailLevel forKey:@"detailLevel"];
    // if changed then reset graphics state
    // (some items now require this even if shader on/off mode unchanged)
    if (old != detailLevel)
    {
        OOLog(@"rendering.detail-level", @"Detail level set to %@.", OOStringFromGraphicsDetail(detailLevel));
        [[OOGraphicsResetManager sharedManager] resetGraphicsState];
    }
 
}

setDetailLevelDirectly:

- (void) setDetailLevelDirectly: (OOGraphicsDetail) value

implementation

Provided by category Universe(OOPrivate).

Definition at line 9471 of file Universe.m.

                               :(OOGraphicsDetail)value
{
    if (value >= DETAIL_LEVEL_MAXIMUM)
    {
        value = DETAIL_LEVEL_MAXIMUM;
    }
    else if (value <= DETAIL_LEVEL_MINIMUM)
    {
        value = DETAIL_LEVEL_MINIMUM;
    }
    if (![[OOOpenGLExtensionManager sharedManager] shadersSupported])
    {
        value = DETAIL_LEVEL_MINIMUM;
    }
    detailLevel = value;
}

setDisplayFPS:

- (void) setDisplayFPS:

(BOOL)

value

Definition at line 9471 of file Universe.m.

                      :(BOOL) value
{
    displayFPS = !!value;
}

setDisplayText:

- (void) setDisplayText:

(BOOL)

value

Definition at line 9471 of file Universe.m.

                       :(BOOL) value
{
    displayGUI = !!value;
}

setDockingClearanceProtocolActive:

- (void) setDockingClearanceProtocolActive:

(BOOL)

newValue

Definition at line 273 of file Universe.m.

                                          :(BOOL)newValue
{
    OOShipRegistry  *registry = [OOShipRegistry sharedRegistry];
    NSEnumerator    *statEnum = [allStations objectEnumerator]; 
    StationEntity   *station = nil;
 
    /* CIM: picking a random ship type which can take the same primary
     * role as the station to determine whether it has no set docking
     * clearance requirements seems unlikely to work entirely
     * correctly. To be fixed. */
                           
    while ((station = [statEnum nextObject]))
    {
        NSString    *stationKey = [registry randomShipKeyForRole:[station primaryRole]];
        if (![[[registry shipInfoForKey:stationKey] allKeys] containsObject:@"requires_docking_clearance"])
        {
            [station setRequiresDockingClearance:!!newValue];
        }
    }
    
    _dockingClearanceProtocolActive = !!newValue;
}

setDoProcedurallyTexturedPlanets:

- (void) setDoProcedurallyTexturedPlanets:

(BOOL)

value

Definition at line 273 of file Universe.m.

                                         :(BOOL) value
{
    doProcedurallyTexturedPlanets = !!value;    // ensure yes or no
    [[NSUserDefaults standardUserDefaults] setBool:doProcedurallyTexturedPlanets forKey:@"procedurally-textured-planets"];
}

setFirstBeacon:

- (void) setFirstBeacon: (Entity <OOBeaconEntity> *) beacon

implementation

Provided by category Universe(OOPrivate).

Definition at line 3616 of file Universe.m.

                       :(Entity <OOBeaconEntity> *)beacon
{
    if (beacon != [self firstBeacon])
    {
        [beacon setPrevBeacon:nil];
        [beacon setNextBeacon:[self firstBeacon]];
        [[self firstBeacon] setPrevBeacon:beacon];
        [_firstBeacon release];
        _firstBeacon = [beacon weakRetain];
    }
}

setGalaxyTo:

- (void) setGalaxyTo:

(OOGalaxyID)

g

Definition at line 6447 of file Universe.m.

                    :(OOGalaxyID) g
{
    [self setGalaxyTo:g andReinit:NO];
}

setGalaxyTo:andReinit:

- (void) setGalaxyTo:		(OOGalaxyID)	g
andReinit:		(BOOL)	forced

Definition at line 6447 of file Universe.m.

                    :(OOGalaxyID) g andReinit:(BOOL) forced
{
    int                     i;
    NSAutoreleasePool       *pool = nil;
    
    if (galaxyID != g || forced) {
        galaxyID = g;
        
        // systems
        pool = [[NSAutoreleasePool alloc] init];
            
        for (i = 0; i < 256; i++)
        {
            if (system_names[i])
            {
                [system_names[i] release];
            }
            system_names[i] = [[systemManager getProperty:@"name" forSystem:i inGalaxy:g] retain];
 
        }
        [pool release];
    }
}

setGameView:

- (void) setGameView:

(MyOpenGLView *)

view

Definition at line 3616 of file Universe.m.

                    :(MyOpenGLView *)view
{
    [gameView release];
    gameView = [view retain];
}

setLastBeacon:

- (void) setLastBeacon: (Entity <OOBeaconEntity> *) beacon

implementation

Provided by category Universe(OOPrivate).

Definition at line 3616 of file Universe.m.

                      :(Entity <OOBeaconEntity> *)beacon
{
    if (beacon != [self lastBeacon])
    {
        [beacon setNextBeacon:nil];
        [beacon setPrevBeacon:[self lastBeacon]];
        [[self lastBeacon] setNextBeacon:beacon];
        [_lastBeacon release];
        _lastBeacon = [beacon weakRetain];
    }
}

setLibraryTextForDemoShip

- (void) setLibraryTextForDemoShip

implementation

Provided by category Universe(OOPrivate).

Definition at line 273 of file Universe.m.

{
    OOGUITabSettings tab_stops;
    tab_stops[0] = 0;
    tab_stops[1] = 170;
    tab_stops[2] = 340;
    [gui setTabStops:tab_stops];
 
/*  [gui setText:[demo_ship displayName] forRow:19 align:GUI_ALIGN_CENTER];
    [gui setColor:[OOColor whiteColor] forRow:19]; */
 
    NSDictionary *librarySettings = [self demoShipData];
    
    OOGUIRow descRow = 7;
 
    NSString *field1 = nil;
    NSString *field2 = nil;
    NSString *field3 = nil;
    NSString *override = nil;
 
    // clear rows
    for (NSUInteger i=1;i<=26;i++)
    {
        [gui setText:@"" forRow:i];
    }
    
    /* Row 1: ScanClass, Name, Summary */
    override = [librarySettings oo_stringForKey:kOODemoShipClass defaultValue:@"ship"];
    field1 = OOShipLibraryCategorySingular(override);
 
 
    field2 = [demo_ship shipClassName];
 
 
    override = [librarySettings oo_stringForKey:kOODemoShipSummary defaultValue:nil];
    if (override != nil)
    {
        field3 = OOExpand(override);
    }
    else
    {
        field3 = @"";
    }
    [gui setArray:[NSArray arrayWithObjects:field1,field2,field3,nil] forRow:1];
    [gui setColor:[OOColor greenColor] forRow:1];
 
    // ship_data defaults to true for "ship" class, false for everything else
    if (![librarySettings oo_boolForKey:kOODemoShipShipData defaultValue:[[librarySettings oo_stringForKey:kOODemoShipClass defaultValue:@"ship"] isEqualToString:@"ship"]])
    {
        descRow = 3;
    }
    else
    {
        /* Row 2: Speed, Turn Rate, Cargo */
 
        override = [librarySettings oo_stringForKey:kOODemoShipSpeed defaultValue:nil];
        if (override != nil)
        {
            if ([override length] == 0)
            {
                field1 = @"";
            }
            else
            {
                field1 = [NSString stringWithFormat:DESC(@"oolite-ship-library-speed-custom"),OOExpand(override)];
            }
        }
        else
        {
            field1 = OOShipLibrarySpeed(demo_ship);
        }
        
 
        override = [librarySettings oo_stringForKey:kOODemoShipTurnRate defaultValue:nil];
        if (override != nil)
        {
            if ([override length] == 0)
            {
                field2 = @"";
            }
            else
            {
                field2 = [NSString stringWithFormat:DESC(@"oolite-ship-library-turn-custom"),OOExpand(override)];
            }
        }
        else
        {
            field2 = OOShipLibraryTurnRate(demo_ship);
        }
 
 
        override = [librarySettings oo_stringForKey:kOODemoShipCargo defaultValue:nil];
        if (override != nil)
        {
            if ([override length] == 0)
            {
                field3 = @"";
            }
            else
            {
                field3 = [NSString stringWithFormat:DESC(@"oolite-ship-library-cargo-custom"),OOExpand(override)];
            }
        }
        else
        {
            field3 = OOShipLibraryCargo(demo_ship);
        }
    
 
        [gui setArray:[NSArray arrayWithObjects:field1,field2,field3,nil] forRow:3];
 
        /* Row 3: recharge rate, energy banks, witchspace */
        override = [librarySettings oo_stringForKey:kOODemoShipGenerator defaultValue:nil];
        if (override != nil)
        {
            if ([override length] == 0)
            {
                field1 = @"";
            }
            else
            {
                field1 = [NSString stringWithFormat:DESC(@"oolite-ship-library-generator-custom"),OOExpand(override)];
            }
        }
        else
        {
            field1 = OOShipLibraryGenerator(demo_ship);
        }
 
 
        override = [librarySettings oo_stringForKey:kOODemoShipShields defaultValue:nil];
        if (override != nil)
        {
            if ([override length] == 0)
            {
                field2 = @"";
            }
            else
            {
                field2 = [NSString stringWithFormat:DESC(@"oolite-ship-library-shields-custom"),OOExpand(override)];
            }
        }
        else
        {
            field2 = OOShipLibraryShields(demo_ship);
        }
 
 
        override = [librarySettings oo_stringForKey:kOODemoShipWitchspace defaultValue:nil];
        if (override != nil)
        {
            if ([override length] == 0)
            {
                field3 = @"";
            }
            else
            {
                field3 = [NSString stringWithFormat:DESC(@"oolite-ship-library-witchspace-custom"),OOExpand(override)];
            }
        }
        else
        {
            field3 = OOShipLibraryWitchspace(demo_ship);
        }
 
 
        [gui setArray:[NSArray arrayWithObjects:field1,field2,field3,nil] forRow:4];
 
 
        /* Row 4: weapons, turrets, size */
        override = [librarySettings oo_stringForKey:kOODemoShipWeapons defaultValue:nil];
        if (override != nil)
        {
            if ([override length] == 0)
            {
                field1 = @"";
            }
            else
            {
                field1 = [NSString stringWithFormat:DESC(@"oolite-ship-library-weapons-custom"),OOExpand(override)];
            }
        }
        else
        {
            field1 = OOShipLibraryWeapons(demo_ship);
        }
 
        override = [librarySettings oo_stringForKey:kOODemoShipTurrets defaultValue:nil];
        if (override != nil)
        {
            if ([override length] == 0)
            {
                field2 = @"";
            }
            else
            {
                field2 = [NSString stringWithFormat:DESC(@"oolite-ship-library-turrets-custom"),OOExpand(override)];
            }
        }
        else
        {
            field2 = OOShipLibraryTurrets(demo_ship);
        }
 
        override = [librarySettings oo_stringForKey:kOODemoShipSize defaultValue:nil];
        if (override != nil)
        {
            if ([override length] == 0)
            {
                field3 = @"";
            }
            else
            {
                field3 = [NSString stringWithFormat:DESC(@"oolite-ship-library-size-custom"),OOExpand(override)];
            }
        }
        else
        {
            field3 = OOShipLibrarySize(demo_ship);
        }
 
        [gui setArray:[NSArray arrayWithObjects:field1,field2,field3,nil] forRow:5];
    }
 
    override = [librarySettings oo_stringForKey:kOODemoShipDescription defaultValue:nil];
    if (override != nil)
    {
        [gui addLongText:OOExpand(override) startingAtRow:descRow align:GUI_ALIGN_LEFT];
    }
 
    
    // line 19: ship categories
    field1 = [NSString stringWithFormat:@"<-- %@",OOShipLibraryCategoryPlural([[[demo_ships objectAtIndex:((demo_ship_index+[demo_ships count]-1)%[demo_ships count])] objectAtIndex:0] oo_stringForKey:kOODemoShipClass])];
    field2 = OOShipLibraryCategoryPlural([[[demo_ships objectAtIndex:demo_ship_index] objectAtIndex:0] oo_stringForKey:kOODemoShipClass]);
    field3 = [NSString stringWithFormat:@"%@ -->",OOShipLibraryCategoryPlural([[[demo_ships objectAtIndex:((demo_ship_index+1)%[demo_ships count])] objectAtIndex:0] oo_stringForKey:kOODemoShipClass])];
    
    [gui setArray:[NSArray arrayWithObjects:field1,field2,field3,nil] forRow:19];
    [gui setColor:[OOColor greenColor] forRow:19];
 
    // lines 21-25: ship names
    NSArray *subList = [demo_ships objectAtIndex:demo_ship_index];
    NSUInteger i,start = demo_ship_subindex - (demo_ship_subindex%5);
    NSUInteger end = start + 4;
    if (end >= [subList count])
    {
        end = [subList count] - 1;
    }
    OOGUIRow row = 21;
    field1 = @"";
    field3 = @"";
    for (i = start ; i <= end ; i++)
    {
        field2 = [[subList objectAtIndex:i] oo_stringForKey:kOODemoShipName];
        [gui setArray:[NSArray arrayWithObjects:field1,field2,field3,nil] forRow:row];
        if (i == demo_ship_subindex)
        {
            [gui setColor:[OOColor yellowColor] forRow:row];
        }
        else
        {
            [gui setColor:[OOColor whiteColor] forRow:row];
        }
        row++;
    }
 
    field2 = @"...";
    if (start > 0)
    {
        [gui setArray:[NSArray arrayWithObjects:field1,field2,field3,nil] forRow:20];
        [gui setColor:[OOColor whiteColor] forRow:20];
    }
    if (end < [subList count]-1)
    {
        [gui setArray:[NSArray arrayWithObjects:field1,field2,field3,nil] forRow:26];
        [gui setColor:[OOColor whiteColor] forRow:26];
    }
 
}

setLighting

- (void) setLighting

Definition at line 273 of file Universe.m.

{
    /*
    
    GL_LIGHT1 is the sun and is active while a sun exists in space
    where there is no sun (witch/interstellar space) this is placed at the origin
    
    Shaders: this light is also used inside the station and needs to have its position reset
    relative to the player whenever demo ships or background scenes are to be shown -- 20100111
    
    
    GL_LIGHT0 is the light for inside the station and needs to have its position reset
    relative to the player whenever demo ships or background scenes are to be shown
    
    Shaders: this light is not used.  -- 20100111
    
    */
    
    OOSunEntity     *the_sun = [self sun];
    SkyEntity       *the_sky = nil;
    GLfloat         sun_pos[] = {0.0, 0.0, 0.0, 1.0};   // equivalent to kZeroVector - for interstellar space.
    GLfloat         sun_ambient[] = {0.0, 0.0, 0.0, 1.0};   // overridden later in code
    int i;
    
    for (i = n_entities - 1; i > 0; i--)
        if ((sortedEntities[i]) && ([sortedEntities[i] isKindOfClass:[SkyEntity class]]))
            the_sky = (SkyEntity*)sortedEntities[i];
    
    if (the_sun)
    {
        [the_sun getDiffuseComponents:sun_diffuse];
        [the_sun getSpecularComponents:sun_specular];
        OOGL(glLightfv(GL_LIGHT1, GL_AMBIENT, sun_ambient));
        OOGL(glLightfv(GL_LIGHT1, GL_DIFFUSE, sun_diffuse));
        OOGL(glLightfv(GL_LIGHT1, GL_SPECULAR, sun_specular));
        sun_pos[0] = the_sun->position.x;
        sun_pos[1] = the_sun->position.y;
        sun_pos[2] = the_sun->position.z;
    }
    else
    {
        // witchspace
        stars_ambient[0] = 0.05;    stars_ambient[1] = 0.20;    stars_ambient[2] = 0.05;    stars_ambient[3] = 1.0;
        sun_diffuse[0] = 0.85;  sun_diffuse[1] = 1.0;   sun_diffuse[2] = 0.85;  sun_diffuse[3] = 1.0;
        sun_specular[0] = 0.95; sun_specular[1] = 1.0;  sun_specular[2] = 0.95; sun_specular[3] = 1.0;
        OOGL(glLightfv(GL_LIGHT1, GL_AMBIENT, sun_ambient));
        OOGL(glLightfv(GL_LIGHT1, GL_DIFFUSE, sun_diffuse));
        OOGL(glLightfv(GL_LIGHT1, GL_SPECULAR, sun_specular));
    }
    
    OOGL(glLightfv(GL_LIGHT1, GL_POSITION, sun_pos));
    
    if (the_sky)
    {
        // ambient lighting!
        GLfloat r,g,b,a;
        [[the_sky skyColor] getRed:&r green:&g blue:&b alpha:&a];
        r = r * (1.0 - SUN_AMBIENT_INFLUENCE) + sun_diffuse[0] * SUN_AMBIENT_INFLUENCE;
        g = g * (1.0 - SUN_AMBIENT_INFLUENCE) + sun_diffuse[1] * SUN_AMBIENT_INFLUENCE;
        b = b * (1.0 - SUN_AMBIENT_INFLUENCE) + sun_diffuse[2] * SUN_AMBIENT_INFLUENCE;
        GLfloat ambient_level = [self ambientLightLevel];
        stars_ambient[0] = ambient_level * SKY_AMBIENT_ADJUSTMENT * (1.0 + r) * (1.0 + r);
        stars_ambient[1] = ambient_level * SKY_AMBIENT_ADJUSTMENT * (1.0 + g) * (1.0 + g);
        stars_ambient[2] = ambient_level * SKY_AMBIENT_ADJUSTMENT * (1.0 + b) * (1.0 + b);
        stars_ambient[3] = 1.0;
    }
    
    // light for demo ships display..
    OOGL(glLightfv(GL_LIGHT0, GL_AMBIENT, docked_light_ambient));
    OOGL(glLightfv(GL_LIGHT0, GL_DIFFUSE, docked_light_diffuse));
    OOGL(glLightfv(GL_LIGHT0, GL_SPECULAR, docked_light_specular));
    OOGL(glLightfv(GL_LIGHT0, GL_POSITION, demo_light_position));   
    OOGL(glLightModelfv(GL_LIGHT_MODEL_AMBIENT, stars_ambient));
}

setMainLightPosition:

- (void) setMainLightPosition:

(Vector)

sunPos

Definition at line 273 of file Universe.m.

                             : (Vector) sunPos
{
    main_light_position[0] = sunPos.x;
    main_light_position[1] = sunPos.y;
    main_light_position[2] = sunPos.z;
    main_light_position[3] = 1.0;
}

setMessageGuiBackgroundColor:

- (void) setMessageGuiBackgroundColor:

(OOColor *)

some_color

Definition at line 6447 of file Universe.m.

                                     :(OOColor *)some_color
{
    [message_gui setBackgroundColor:some_color];
}

setNextBeacon:

- (void) setNextBeacon:

(Entity <OOBeaconEntity> *)

beaconShip

Definition at line 3616 of file Universe.m.

                      :(Entity <OOBeaconEntity> *) beaconShip
{
    if ([beaconShip isBeacon])
    {
        [self setLastBeacon:beaconShip];
        if ([self firstBeacon] == nil)  [self setFirstBeacon:beaconShip];
    }
    else
    {
        OOLog(@"universe.beacon.error", @"***** ERROR: Universe setNextBeacon '%@'. The ship has no beacon code set.", beaconShip);
    }
}

setPauseMessageVisible:

- (void) setPauseMessageVisible:

(BOOL)

value

Definition at line 9471 of file Universe.m.

                               :(BOOL)value
{
    _pauseMessage = value;
}

setPermanentCommLog:

- (void) setPermanentCommLog:

(BOOL)

value

Definition at line 9471 of file Universe.m.

                            :(BOOL)value
{
    _permanentCommLog = value;
}

setPermanentMessageLog:

- (void) setPermanentMessageLog:

(BOOL)

value

Definition at line 9471 of file Universe.m.

                               :(BOOL)value
{
    _permanentMessageLog = value;
}

setPopulatorSetting:to:

- (void) setPopulatorSetting:		(NSString *)	key
to:		(NSDictionary *)	setting

Definition at line 273 of file Universe.m.

                            :(NSString *)key to:(NSDictionary *)setting
{
    if (setting == nil)
    {
        [populatorSettings removeObjectForKey:key];
    } 
    else
    {
        [populatorSettings setObject:setting forKey:key];
    }
}

setScreenTextureDescriptorForKey:descriptor:

- (void) setScreenTextureDescriptorForKey:		(NSString *)	key
descriptor:		(NSDictionary *)	desc

Definition at line 6447 of file Universe.m.

                                         :(NSString *)key descriptor:(NSDictionary *)desc
{
    NSMutableDictionary *sbCopy = [screenBackgrounds mutableCopy];
    if (desc == nil)
    {
        [sbCopy removeObjectForKey:key];
    } 
    else
    {
        [sbCopy setObject:desc forKey:key];
    }
    [screenBackgrounds release];
    screenBackgrounds = [sbCopy copy];
    [sbCopy release];
}

setShaderEffectsLevelDirectly:

- (void) setShaderEffectsLevelDirectly: (OOShaderSetting) value

implementation

Provided by category Universe(OOPrivate).

setSkyColorRed:green:blue:alpha:

- (void) setSkyColorRed:		(GLfloat)	red
green:		(GLfloat)	green
blue:		(GLfloat)	blue
alpha:		(GLfloat)	alpha

Definition at line 3616 of file Universe.m.

                       :(GLfloat)red green:(GLfloat)green blue:(GLfloat)blue alpha:(GLfloat)alpha
{
    skyClearColor[0] = red;
    skyClearColor[1] = green;
    skyClearColor[2] = blue;
    skyClearColor[3] = alpha;
    [self setAirResistanceFactor:alpha];
}

setSystemDataForGalaxy:planet:key:value:fromManifest:forLayer:

- (void) setSystemDataForGalaxy:		(OOGalaxyID)	gnum
planet:		(OOSystemID)	pnum
key:		(NSString *)	key
value:		(id)	object
fromManifest:		(NSString *)	manifest
forLayer:		(OOSystemLayer)	layer

Definition at line 7996 of file Universe.m.

                               :(OOGalaxyID)gnum planet:(OOSystemID)pnum key:(NSString *)key value:(id)object fromManifest:(NSString *)manifest forLayer:(OOSystemLayer)layer
{
    static BOOL sysdataLocked = NO;
    if (sysdataLocked)
    {
        OOLogERR(@"script.error", @"%@", @"System properties cannot be set during 'systemInformationChanged' events to avoid infinite loops.");
        return;
    }
 
    BOOL sameGalaxy = (gnum == [PLAYER currentGalaxyID]);
    BOOL sameSystem = (sameGalaxy && pnum == [self currentSystemID]);
 
    // trying to set  unsettable properties?  
    if ([key isEqualToString:KEY_RADIUS] && sameGalaxy && sameSystem) // buggy if we allow this key to be set while in the system
    {
        OOLogERR(@"script.error", @"System property '%@' cannot be set while in the system.",key);
        return;
    }
 
    if ([key isEqualToString:@"coordinates"]) // setting this in game would be very confusing
    {
        OOLogERR(@"script.error", @"System property '%@' cannot be set.",key);
        return;
    }
 
    
    NSString    *overrideKey = [NSString stringWithFormat:@"%u %u", gnum, pnum];
    NSDictionary *sysInfo = nil;
    
    // short range map fix
    [gui refreshStarChart];
 
    if (object != nil) {
        // long range map fixes
        if ([key isEqualToString:KEY_NAME])
        {   
            object=(id)[[(NSString *)object lowercaseString] capitalizedString];
            if(sameGalaxy)
            {
                if (system_names[pnum]) [system_names[pnum] release];
                system_names[pnum] = [(NSString *)object retain];
            }
        }
        else if ([key isEqualToString:@"sun_radius"])
        {
            if ([object doubleValue] < 1000.0 || [object doubleValue] > 10000000.0 ) 
            {
                object = ([object doubleValue] < 1000.0 ? (id)@"1000.0" : (id)@"10000000.0"); // works!
            }
        }
        else if ([key hasPrefix:@"corona_"])
        {
            object = (id)[NSString stringWithFormat:@"%f",OOClamp_0_1_f([object floatValue])];
        }
    }
    
    [systemManager setProperty:key forSystemKey:overrideKey andLayer:layer toValue:object fromManifest:manifest];
 
    
    // Apply changes that can be effective immediately, issue warning if they can't be changed just now
    if (sameSystem)
    {
        sysInfo = [systemManager getPropertiesForCurrentSystem];
 
        OOSunEntity* the_sun = [self sun];
        /* KEY_ECONOMY used to be here, but resetting the main station
         * market while the player is in the system is likely to cause
         * more trouble than it's worth. Let them leave and come back
         * - CIM */
        if ([key isEqualToString:KEY_TECHLEVEL])
        {   
            if([self station]){
                [[self station] setEquivalentTechLevel:[object intValue]];
                [[self station] setLocalShipyard:[self shipsForSaleForSystem:systemID
                                withTL:[object intValue] atTime:[PLAYER clockTime]]];
            }
        }
        else if ([key isEqualToString:@"sun_color"] || [key isEqualToString:@"star_count_multiplier"] ||
                [key isEqualToString:@"nebula_count_multiplier"] || [key hasPrefix:@"sky_"])
        {
            SkyEntity   *the_sky = nil;
            int i;
            
            for (i = n_entities - 1; i > 0; i--)
                if ((sortedEntities[i]) && ([sortedEntities[i] isKindOfClass:[SkyEntity class]]))
                    the_sky = (SkyEntity*)sortedEntities[i];
            
            if (the_sky != nil)
            {
                [the_sky changeProperty:key withDictionary:sysInfo];
                
                if ([key isEqualToString:@"sun_color"])
                {
                    OOColor *color = [the_sky skyColor];
                    if (the_sun != nil)
                    {
                        [the_sun setSunColor:color];
                        [the_sun getDiffuseComponents:sun_diffuse];
                        [the_sun getSpecularComponents:sun_specular];
                    }
                    for (i = n_entities - 1; i > 0; i--)
                        if ((sortedEntities[i]) && ([sortedEntities[i] isKindOfClass:[DustEntity class]]))
                            [(DustEntity*)sortedEntities[i] setDustColor:[color blendedColorWithFraction:0.5 ofColor:[OOColor whiteColor]]];
                }
            }
        }
        else if (the_sun != nil && ([key hasPrefix:@"sun_"] || [key hasPrefix:@"corona_"]))
        {
            [the_sun changeSunProperty:key withDictionary:sysInfo];
        }
        else if ([key isEqualToString:@"texture"])
        {
            [[self planet] setUpPlanetFromTexture:(NSString *)object];
        }
        else if ([key isEqualToString:@"texture_hsb_color"])
        {
            [[self planet] setUpPlanetFromTexture: [[self planet] textureFileName]];
        }
        else if ([key isEqualToString:@"air_color"])
        {
            [[self planet] setAirColor:[OOColor brightColorWithDescription:object]];
        }
        else if ([key isEqualToString:@"illumination_color"])
        {
            [[self planet] setIlluminationColor:[OOColor colorWithDescription:object]];
        }
        else if ([key isEqualToString:@"air_color_mix_ratio"])
        {
            [[self planet] setAirColorMixRatio:[sysInfo oo_floatForKey:key]];
        }
    }
    
    sysdataLocked = YES;
    [PLAYER doScriptEvent:OOJSID("systemInformationChanged") withArguments:[NSArray arrayWithObjects:[NSNumber numberWithInt:gnum],[NSNumber numberWithInt:pnum],key,object,nil]];
    sysdataLocked = NO;
 
}

setSystemDataKey:value:fromManifest:

- (void) setSystemDataKey:		(NSString*)	key
value:		(NSObject*)	object
fromManifest:		(NSString *)	manifest

Definition at line 7996 of file Universe.m.

                         :(NSString *)key value:(NSObject *)object fromManifest:(NSString *)manifest
{
    [self setSystemDataForGalaxy:galaxyID planet:systemID key:key value:object fromManifest:manifest forLayer:OO_LAYER_OXP_DYNAMIC];
}

setSystemTo:

- (void) setSystemTo:

(OOSystemID)

s

Definition at line 6447 of file Universe.m.

                    :(OOSystemID) s
{
    NSDictionary    *systemData;
    PlayerEntity    *player = PLAYER;
    OOEconomyID     economy;
    NSString        *scriptName;
    
    [self setGalaxyTo: [player galaxyNumber]];
    
    systemID = s;
    targetSystemID = s;
    
    systemData = [self generateSystemData:targetSystemID];
    economy = [systemData  oo_unsignedCharForKey:KEY_ECONOMY];
    scriptName = [systemData  oo_stringForKey:@"market_script" defaultValue:nil];
    
    DESTROY(commodityMarket);
    commodityMarket = [[commodities generateMarketForSystemWithEconomy:economy andScript:scriptName] retain];
}

setTimeAccelerationFactor:

- (void) setTimeAccelerationFactor:

(double)

newTimeAccelerationFactor

Definition at line 6447 of file Universe.m.

                                  :(double)newTimeAccelerationFactor
{
    if (newTimeAccelerationFactor < TIME_ACCELERATION_FACTOR_MIN || newTimeAccelerationFactor > TIME_ACCELERATION_FACTOR_MAX)
    {
        newTimeAccelerationFactor = TIME_ACCELERATION_FACTOR_DEFAULT;
    }
    timeAccelerationFactor = newTimeAccelerationFactor;
}

setUpBreakPattern:orientation:forDocking:

- (void) setUpBreakPattern:		(HPVector)	pos
orientation:		(Quaternion)	q
forDocking:		(BOOL)	forDocking

Definition at line 273 of file Universe.m.

                          :(HPVector) pos orientation:(Quaternion) q forDocking:(BOOL) forDocking
{
    int                     i;
    OOBreakPatternEntity    *ring = nil;
    id                      colorDesc = nil;
    OOColor                 *color = nil;
    
    [self setViewDirection:VIEW_FORWARD];
    
    q.w = -q.w;     // reverse the quaternion because this is from the player's viewpoint
    
    Vector          v = vector_forward_from_quaternion(q);
    Vector          vel = vector_multiply_scalar(v, -BREAK_PATTERN_RING_SPEED);
    
    // hyperspace colours
    
    OOColor *col1 = [OOColor colorWithRed:1.0 green:0.0 blue:0.0 alpha:0.5];    //standard tunnel colour
    OOColor *col2 = [OOColor colorWithRed:0.0 green:0.0 blue:1.0 alpha:0.25];   //standard tunnel colour
    
    colorDesc = [[self globalSettings] objectForKey:@"hyperspace_tunnel_color_1"];
    if (colorDesc != nil)
    {
        color = [OOColor colorWithDescription:colorDesc];
        if (color != nil)  col1 = color;
        else  OOLogWARN(@"hyperspaceTunnel.fromDict", @"could not interpret \"%@\" as a colour.", colorDesc);
    }
 
    colorDesc = [[self globalSettings] objectForKey:@"hyperspace_tunnel_color_2"];
    if (colorDesc != nil)
    {
        color = [OOColor colorWithDescription:colorDesc];
        if (color != nil)  col2 = color;
        else  OOLogWARN(@"hyperspaceTunnel.fromDict", @"could not interpret \"%@\" as a colour.", colorDesc);
    }
    
    unsigned    sides = kOOBreakPatternMaxSides;
    GLfloat     startAngle = 0;
    GLfloat     aspectRatio = 1;
    
    if (forDocking)
    {
        NSDictionary *info = [[PLAYER dockedStation] shipInfoDictionary];
        sides = [info oo_unsignedIntForKey:@"tunnel_corners" defaultValue:4];
        startAngle = [info oo_floatForKey:@"tunnel_start_angle" defaultValue:45.0f];
        aspectRatio = [info oo_floatForKey:@"tunnel_aspect_ratio" defaultValue:2.67f];
    }
    
    for (i = 1; i < 11; i++)
    {
        ring = [OOBreakPatternEntity breakPatternWithPolygonSides:sides startAngle:startAngle aspectRatio:aspectRatio];
        if (!forDocking)
        {
            [ring setInnerColor:col1 outerColor:col2];
        }
        
        Vector offset = vector_multiply_scalar(v, i * BREAK_PATTERN_RING_SPACING);
        [ring setPosition:HPvector_add(pos, vectorToHPVector(offset))];  // ahead of the player
        [ring setOrientation:q];
        [ring setVelocity:vel];
        [ring setLifetime:i * BREAK_PATTERN_RING_SPACING];
        
        // FIXME: better would be to have break pattern timing not depend on
        // these ring objects existing in the first place. - CIM
        if (forDocking && ![[PLAYER dockedStation] hasBreakPattern])
        {
            ring->isImmuneToBreakPatternHide = NO;
        }
        else if (!forDocking && ![self witchspaceBreakPattern])
        {
            ring->isImmuneToBreakPatternHide = NO;
        }
        [self addEntity:ring];
        breakPatternCounter++;
    }
}

setUpCargoPods

- (void) setUpCargoPods

implementation

Provided by category Universe(OOPrivate).

Definition at line 9471 of file Universe.m.

{
    NSMutableDictionary *tmp = [[NSMutableDictionary alloc] initWithCapacity:[commodities count]];
    OOCommodityType type = nil;
    foreach (type, [commodities goods])
    {
        ShipEntity *container = [self newShipWithRole:@"oolite-template-cargopod"];
        [container setScanClass:CLASS_CARGO];
        [container setCommodity:type andAmount:1];
        [tmp setObject:container forKey:type];
        [container release];
    }
    [cargoPods release];
    cargoPods = [[NSDictionary alloc] initWithDictionary:tmp];
    [tmp release];
}

setUpInitialUniverse

- (void) setUpInitialUniverse

implementation

Provided by category Universe(OOPrivate).

Definition at line 9471 of file Universe.m.

{
    PlayerEntity* player = PLAYER;
    
    OO_DEBUG_PUSH_PROGRESS(@"%@", @"Wormhole and character reset");
    if (activeWormholes) [activeWormholes autorelease];
    activeWormholes = [[NSMutableArray arrayWithCapacity:16] retain];
    if (characterPool) [characterPool autorelease];
    characterPool = [[NSMutableArray arrayWithCapacity:256] retain];
    OO_DEBUG_POP_PROGRESS();
    
    OO_DEBUG_PUSH_PROGRESS(@"%@", @"Galaxy reset");
    [self setGalaxyTo: [player galaxyNumber] andReinit:YES];
    systemID = [player systemID];
    OO_DEBUG_POP_PROGRESS();
    
    OO_DEBUG_PUSH_PROGRESS(@"%@", @"Player init: setUpShipFromDictionary");
    [player setUpShipFromDictionary:[[OOShipRegistry sharedRegistry] shipInfoForKey:[player shipDataKey]]]; // the standard cobra at this point
    [player baseMass]; // bootstrap the base mass used in all fuel charge calculations.
    OO_DEBUG_POP_PROGRESS();
    
    // Player init above finishes initialising all standard player ship properties. Now that the base mass is set, we can run setUpSpace! 
    [self setUpSpace];
    
    [self setDockingClearanceProtocolActive:
              [[self currentSystemData] oo_boolForKey:@"stations_require_docking_clearance" defaultValue:YES]];
 
    [self enterGUIViewModeWithMouseInteraction:NO];
    [player setPosition:[[self station] position]];
    [player setOrientation:kIdentityQuaternion];
}

setupIntroFirstGo:

- (void) setupIntroFirstGo:

(BOOL)

justCobra

Definition at line 273 of file Universe.m.

                          :(BOOL)justCobra
{
    PlayerEntity    *player = PLAYER;
    ShipEntity      *ship = nil;
    Quaternion      q2 = { 0.0f, 0.0f, 1.0f, 0.0f }; // w,x,y,z
    
    // in status demo draw ships and display text
    if (!justCobra)
    {
        DESTROY(demo_ships);
        demo_ships = [[[OOShipRegistry sharedRegistry] demoShipKeys] retain];
        // always, even if it's the cobra, because it's repositioned
        [self removeDemoShips];
    }
    if (justCobra)
    {
        [player setStatus: STATUS_START_GAME];
    }
    [player setShowDemoShips: YES];
    displayGUI = YES;
    
    if (justCobra)
    {
        /*- cobra - intro1 -*/
        ship = [self newShipWithName:PLAYER_SHIP_DESC usePlayerProxy:YES];
    }
    else
    {
        /*- demo ships - intro2 -*/
 
        demo_ship_index = 0;
        demo_ship_subindex = 0;
 
        /* Try to set the initial list position to Cobra III if
         * available, and at least the Ships category. */
        NSArray *subList = nil;
        foreach (subList, demo_ships)
        {
            if ([[[subList oo_dictionaryAtIndex:0] oo_stringForKey:kOODemoShipClass] isEqualToString:@"ship"])
            {
                demo_ship_index = [demo_ships indexOfObject:subList];
                NSDictionary *shipEntry = nil;
                foreach (shipEntry, subList)
                {
                    if ([[shipEntry oo_stringForKey:kOODemoShipKey] isEqualToString:@"cobra3-trader"])
                    {
                        demo_ship_subindex = [subList indexOfObject:shipEntry];
                        break;
                    }
                }
                break;
            }
        }
 
 
        if (!demo_ship) ship = [self newShipWithName:[[[demo_ships oo_arrayAtIndex:demo_ship_index] oo_dictionaryAtIndex:demo_ship_subindex] oo_stringForKey:kOODemoShipKey] usePlayerProxy:NO];
        // stop consistency problems on the ship library screen
        [ship removeEquipmentItem:@"EQ_SHIELD_BOOSTER"];
        [ship removeEquipmentItem:@"EQ_SHIELD_ENHANCER"];
    }
    
    if (ship)
    {
        [ship setOrientation:q2];
        if (!justCobra)
        {
            [ship setPositionX:0.0f y:0.0f z:DEMO2_VANISHING_DISTANCE * ship->collision_radius * 0.01];
            [ship setDestination: ship->position];  // ideal position
        }
        else
        {
            // main screen Cobra is closer
            [ship setPositionX:0.0f y:0.0f z:3.6 * ship->collision_radius];
        }
        [ship setDemoShip: 1.0f];
        [ship setDemoStartTime: universal_time];
        [ship setScanClass: CLASS_NO_DRAW];
        [ship switchAITo:@"nullAI.plist"];
        if([ship pendingEscortCount] > 0) [ship setPendingEscortCount:0];
        [self addEntity:ship];  // STATUS_IN_FLIGHT, AI state GLOBAL
        // now override status
        [ship setStatus:STATUS_COCKPIT_DISPLAY];
        demo_ship = ship;
        
        [ship release];
    }
    
    if (!justCobra)
    {
//      [gui setText:[demo_ship displayName] forRow:19 align:GUI_ALIGN_CENTER];
        [self setLibraryTextForDemoShip];
    }
    
    [self enterGUIViewModeWithMouseInteraction:NO];
    if (!justCobra)
    {
        demo_stage = DEMO_SHOW_THING;
        demo_stage_time = universal_time + 300.0;
    }
}

setUpPlanet

- (OOPlanetEntity *) setUpPlanet

Definition at line 273 of file Universe.m.

{
    // set the system seed for random number generation
    Random_Seed systemSeed = [systemManager getRandomSeedForCurrentSystem];
    seed_for_planet_description(systemSeed);
 
    NSMutableDictionary *planetDict = [NSMutableDictionary dictionaryWithDictionary:[systemManager getPropertiesForCurrentSystem]];
    [planetDict oo_setBool:YES forKey:@"mainForLocalSystem"];
    OOPlanetEntity *a_planet = [[OOPlanetEntity alloc] initFromDictionary:planetDict withAtmosphere:[planetDict oo_boolForKey:@"has_atmosphere" defaultValue:YES] andSeed:systemSeed forSystem:systemID];
    
    double planet_zpos = [planetDict oo_floatForKey:@"planet_distance" defaultValue:500000];
    planet_zpos *= [planetDict oo_floatForKey:@"planet_distance_multiplier" defaultValue:1.0];
    
#ifdef OO_DUMP_PLANETINFO
    OOLog(@"planetinfo.record",@"planet zpos = %f",planet_zpos);
#endif
    [a_planet setPosition:(HPVector){ 0, 0, planet_zpos }];
    [a_planet setEnergy:1000000.0];
    
    if ([allPlanets count]>0)   // F7 sets [UNIVERSE planet], which can lead to some trouble! TODO: track down where exactly that happens!
    {
        OOPlanetEntity *tmp=[allPlanets objectAtIndex:0];
        [self addEntity:a_planet];
        [allPlanets removeObject:a_planet];
        cachedPlanet=a_planet;
        [allPlanets replaceObjectAtIndex:0 withObject:a_planet];
        [self removeEntity:(Entity *)tmp];
    }
    else
    {
        [self addEntity:a_planet];
    }
    return [a_planet autorelease];
}

setUpSettings

- (void) setUpSettings

Definition at line 9471 of file Universe.m.

{
    [self resetBeacons];
    
    next_universal_id = 100;    // start arbitrarily above zero
    memset(entity_for_uid, 0, sizeof entity_for_uid);
    
    [self setMainLightPosition:kZeroVector];
 
    [gui autorelease];
    gui = [[GuiDisplayGen alloc] init];
    [gui setTextColor:[OOColor colorWithDescription:[[gui userSettings] objectForKey:kGuiDefaultTextColor]]];
 
    // message_gui and comm_log_gui defaults are set up inside [hud resetGuis:] ( via [player deferredInit], called from the code that calls this method). 
    [message_gui autorelease];
    message_gui = [[GuiDisplayGen alloc]
                    initWithPixelSize:NSMakeSize(480, 160)
                              columns:1
                                 rows:9
                            rowHeight:19
                             rowStart:20
                                title:nil];
    
    [comm_log_gui autorelease];
    comm_log_gui = [[GuiDisplayGen alloc]
                    initWithPixelSize:NSMakeSize(360, 120)
                              columns:1
                                 rows:10
                            rowHeight:12
                             rowStart:12
                                title:nil];
    
    //
    
    time_delta = 0.0;
#ifndef NDEBUG
    [self setTimeAccelerationFactor:TIME_ACCELERATION_FACTOR_DEFAULT];
#endif
    universal_time = 0.0;
    messageRepeatTime = 0.0;
    countdown_messageRepeatTime = 0.0;
    
#if OOLITE_SPEECH_SYNTH
    [speechArray autorelease];
    speechArray = [[ResourceManager arrayFromFilesNamed:@"speech_pronunciation_guide.plist" inFolder:@"Config" andMerge:YES] retain];
#endif
    
    [commodities autorelease];
    commodities = [[OOCommodities alloc] init];
 
    
    [self loadDescriptions];
    
    [characters autorelease];
    characters = [[ResourceManager dictionaryFromFilesNamed:@"characters.plist" inFolder:@"Config" andMerge:YES] retain];
    
    [customSounds autorelease];
    customSounds = [[ResourceManager dictionaryFromFilesNamed:@"customsounds.plist" inFolder:@"Config" andMerge:YES] retain];
    
    [globalSettings autorelease];
    globalSettings = [[ResourceManager dictionaryFromFilesNamed:@"global-settings.plist" inFolder:@"Config" mergeMode:MERGE_SMART cache:YES] retain];
 
    
    [systemManager autorelease];
    systemManager = [[ResourceManager systemDescriptionManager] retain];
 
    [screenBackgrounds autorelease];
    screenBackgrounds = [[ResourceManager dictionaryFromFilesNamed:@"screenbackgrounds.plist" inFolder:@"Config" andMerge:YES] retain];
 
    // role-categories.plist and pirate-victim-roles.plist
    [roleCategories autorelease];
    roleCategories = [[ResourceManager roleCategoriesDictionary] retain];
    
    [autoAIMap autorelease];
    autoAIMap = [[ResourceManager dictionaryFromFilesNamed:@"autoAImap.plist" inFolder:@"Config" andMerge:YES] retain];
    
    [equipmentData autorelease];
    [equipmentDataOutfitting autorelease];
    NSArray *equipmentTemp = [ResourceManager arrayFromFilesNamed:@"equipment.plist" inFolder:@"Config" andMerge:YES];
    equipmentData = [[equipmentTemp sortedArrayUsingFunction:equipmentSort context:NULL] retain];
    equipmentDataOutfitting = [[equipmentTemp sortedArrayUsingFunction:equipmentSortOutfitting context:NULL] retain];
    
    [OOEquipmentType loadEquipment];
 
    [explosionSettings autorelease];
    explosionSettings = [[ResourceManager dictionaryFromFilesNamed:@"explosions.plist" inFolder:@"Config" andMerge:YES] retain];
 
}

setUpSpace

- (void) setUpSpace

Definition at line 273 of file Universe.m.

{
    Entity              *thing;
//  ShipEntity          *nav_buoy;
    StationEntity       *a_station;
    OOSunEntity         *a_sun;
    OOPlanetEntity      *a_planet;
    
    HPVector                stationPos;
    
    Vector              vf;
    id          dict_object;
 
    NSDictionary        *systeminfo = [systemManager getPropertiesForCurrentSystem];
    unsigned            techlevel = [systeminfo oo_unsignedIntForKey:KEY_TECHLEVEL];
    NSString            *stationDesc = nil, *defaultStationDesc = nil;
    OOColor             *bgcolor;
    OOColor             *pale_bgcolor;
    BOOL                sunGoneNova;
    
    Random_Seed systemSeed = [systemManager getRandomSeedForCurrentSystem];
 
    [[GameController sharedController] logProgress:DESC(@"populating-space")];
    
    sunGoneNova = [systeminfo oo_boolForKey:@"sun_gone_nova" defaultValue:NO];
    
    OO_DEBUG_PUSH_PROGRESS(@"%@", @"setUpSpace - clearSubRegions, sky, dust");
    [universeRegion clearSubregions];
    
    // fixed entities (part of the graphics system really) come first...
    [self setSkyColorRed:0.0f
                   green:0.0f
                    blue:0.0f
                   alpha:0.0f];
 
    
#ifdef OO_DUMP_PLANETINFO
    OOLog(@"planetinfo.record",@"seed = %d %d %d %d",system_seed.c,system_seed.d,system_seed.e,system_seed.f);
    OOLog(@"planetinfo.record",@"coordinates = %d %d",system_seed.d,system_seed.b);
 
#define SPROP(PROP) OOLog(@"planetinfo.record",@#PROP " = \"%@\";",[systeminfo oo_stringForKey:@"" #PROP]);
#define IPROP(PROP) OOLog(@"planetinfo.record",@#PROP " = %d;",[systeminfo oo_intForKey:@#PROP]);
#define FPROP(PROP) OOLog(@"planetinfo.record",@#PROP " = %f;",[systeminfo oo_floatForKey:@"" #PROP]);
    IPROP(government);
    IPROP(economy);
    IPROP(techlevel);
    IPROP(population);
    IPROP(productivity);
    SPROP(name);
    SPROP(inhabitant);
    SPROP(inhabitants);
    SPROP(description);
#endif
 
    // set the system seed for random number generation
    seed_for_planet_description(systemSeed);
    
    /*- the sky backdrop -*/
    // colors...
    float h1 = randf();
    float h2 = h1 + 1.0 / (1.0 + (Ranrot() % 5));
    while (h2 > 1.0)
        h2 -= 1.0;
    OOColor *col1 = [OOColor colorWithHue:h1 saturation:randf() brightness:0.5 + randf()/2.0 alpha:1.0];
    OOColor *col2 = [OOColor colorWithHue:h2 saturation:0.5 + randf()/2.0 brightness:0.5 + randf()/2.0 alpha:1.0];
    
    thing = [[SkyEntity alloc] initWithColors:col1:col2 andSystemInfo: systeminfo]; // alloc retains!
    [thing setScanClass: CLASS_NO_DRAW];
    [self addEntity:thing];
//  bgcolor = [(SkyEntity *)thing skyColor];
//
    h1 = randf()/3.0;
    if (h1 > 0.17)
    {
        h1 += 0.33;
    }
    
    ambientLightLevel = [systeminfo oo_floatForKey:@"ambient_level" defaultValue:1.0];
    
    // pick a main sequence colour
 
    dict_object=[systeminfo objectForKey:@"sun_color"];
    if (dict_object!=nil) 
    {
        bgcolor = [OOColor colorWithDescription:dict_object];
    }
    else
    {
        bgcolor = [OOColor colorWithHue:h1 saturation:0.75*randf() brightness:0.65+randf()/5.0 alpha:1.0];
    }
 
    pale_bgcolor = [bgcolor blendedColorWithFraction:0.5 ofColor:[OOColor whiteColor]];
    [thing release];
    /*--*/
    
    /*- the dust particle system -*/
    thing = [[DustEntity alloc] init];  // alloc retains!
    [thing setScanClass: CLASS_NO_DRAW];
    [self addEntity:thing];
    [(DustEntity *)thing setDustColor:pale_bgcolor]; 
    [thing release];
    /*--*/
 
    float defaultSunFlare = randf()*0.1;
    float defaultSunHues = 0.5+randf()*0.5;
    OO_DEBUG_POP_PROGRESS();
    
    // actual entities next...
    
    OO_DEBUG_PUSH_PROGRESS(@"%@", @"setUpSpace - planet");
    a_planet=[self setUpPlanet]; // resets RNG when called
    double planet_radius = [a_planet radius];
    OO_DEBUG_POP_PROGRESS();
    
    // set the system seed for random number generation
    seed_for_planet_description(systemSeed);
    
    OO_DEBUG_PUSH_PROGRESS(@"%@", @"setUpSpace - sun");
    /*- space sun -*/
    double      sun_radius;
    double      sun_distance;
    double      sunDistanceModifier;
    double      safeDistance;
    HPVector        sunPos;
    
    sunDistanceModifier = [systeminfo oo_nonNegativeDoubleForKey:@"sun_distance_modifier" defaultValue:0.0];
    if (sunDistanceModifier < 6.0) // <6 isn't valid
    {
        sun_distance = [systeminfo oo_nonNegativeDoubleForKey:@"sun_distance" defaultValue:(planet_radius*20)];
        // note, old property was _modifier, new property is _multiplier
        sun_distance *= [systeminfo oo_nonNegativeDoubleForKey:@"sun_distance_multiplier" defaultValue:1];
    } 
    else
    {
        sun_distance = planet_radius * sunDistanceModifier;
    }
 
    sun_radius = [systeminfo oo_nonNegativeDoubleForKey:@"sun_radius" defaultValue:2.5 * planet_radius];
    // clamp the sun radius
    if ((sun_radius < 1000.0) || (sun_radius > sun_distance / 2  && !sunGoneNova))
    {
        OOLogWARN(@"universe.setup.badSun",@"Sun radius of %f is not valid for this system",sun_radius);
        sun_radius = sun_radius < 1000.0 ? 1000.0 : (sun_distance / 2);
    }
#ifdef OO_DUMP_PLANETINFO
    OOLog(@"planetinfo.record",@"sun_radius = %f",sun_radius);
#endif
    safeDistance=36 * sun_radius * sun_radius; // 6 times the sun radius
    
    // here we need to check if the sun collides with (or is too close to) the witchpoint
    // otherwise at (for example) Maregais in Galaxy 1 we go BANG!
    HPVector sun_dir = [systeminfo oo_hpvectorForKey:@"sun_vector"];
    sun_distance /= 2.0;
    do
    {
        sun_distance *= 2.0;
        sunPos = HPvector_subtract([a_planet position],
                              HPvector_multiply_scalar(sun_dir,sun_distance));
        
        // if not in the safe distance, multiply by two and try again
    } 
    while (HPmagnitude2(sunPos) < safeDistance);
 
    // set planetary axial tilt to 0 degrees
    // TODO: allow this to vary
    [a_planet setOrientation:quaternion_rotation_betweenHP(sun_dir,make_HPvector(1.0,0.0,0.0))];
 
#ifdef OO_DUMP_PLANETINFO
    OOLog(@"planetinfo.record",@"sun_vector = %.3f %.3f %.3f",vf.x,vf.y,vf.z);
    OOLog(@"planetinfo.record",@"sun_distance = %.0f",sun_distance);
#endif
    
 
    
    NSMutableDictionary *sun_dict = [NSMutableDictionary dictionaryWithCapacity:5];
    [sun_dict setObject:[NSNumber numberWithDouble:sun_radius] forKey:@"sun_radius"];
    dict_object=[systeminfo objectForKey: @"corona_shimmer"];
    if (dict_object!=nil) [sun_dict setObject:dict_object forKey:@"corona_shimmer"];
    dict_object=[systeminfo objectForKey: @"corona_hues"];
    if (dict_object!=nil)
    {
        [sun_dict setObject:dict_object forKey:@"corona_hues"];
    }
    else
    {
        [sun_dict setObject:[NSNumber numberWithFloat:defaultSunHues] forKey:@"corona_hues"];
    }
    dict_object=[systeminfo objectForKey: @"corona_flare"];
    if (dict_object!=nil) 
    {
        [sun_dict setObject:dict_object forKey:@"corona_flare"];
    }
    else
    {
        [sun_dict setObject:[NSNumber numberWithFloat:defaultSunFlare] forKey:@"corona_flare"];
    }
    dict_object=[systeminfo objectForKey:KEY_SUNNAME];
    if (dict_object!=nil) 
    {
        [sun_dict setObject:dict_object forKey:KEY_SUNNAME];
    }
#ifdef OO_DUMP_PLANETINFO
    OOLog(@"planetinfo.record",@"corona_flare = %f",[sun_dict oo_floatForKey:@"corona_flare"]);
    OOLog(@"planetinfo.record",@"corona_hues = %f",[sun_dict oo_floatForKey:@"corona_hues"]);
    OOLog(@"planetinfo.record",@"sun_color = %@",[bgcolor descriptionComponents]);
#endif
    a_sun = [[OOSunEntity alloc] initSunWithColor:bgcolor andDictionary:sun_dict];  // alloc retains!
    
    [a_sun setStatus:STATUS_ACTIVE];
    [a_sun setPosition:sunPos]; // sets also light origin
    [a_sun setEnergy:1000000.0];
    [self addEntity:a_sun];
    
    if (sunGoneNova)
    {
        [a_sun setRadius: sun_radius andCorona:0.3];
        [a_sun setThrowSparks:YES];
        [a_sun setVelocity: kZeroVector];
    }
    
    // set the lighting only after we know which sun we have.
    [self setLighting];
    OO_DEBUG_POP_PROGRESS();
    
    OO_DEBUG_PUSH_PROGRESS(@"%@", @"setUpSpace - main station");
    /*- space station -*/
    stationPos = [a_planet position];
 
    vf = [systeminfo oo_vectorForKey:@"station_vector"];
#ifdef OO_DUMP_PLANETINFO
    OOLog(@"planetinfo.record",@"station_vector = %.3f %.3f %.3f",vf.x,vf.y,vf.z);
#endif
    stationPos = HPvector_subtract(stationPos, vectorToHPVector(vector_multiply_scalar(vf, 2.0 * planet_radius)));
    
 
    stationDesc = [systeminfo oo_stringForKey:@"station" defaultValue:@"coriolis"];
#ifdef OO_DUMP_PLANETINFO
    OOLog(@"planetinfo.record",@"station = %@",stationDesc);
#endif
    
    a_station = (StationEntity *)[self newShipWithRole:stationDesc];            // retain count = 1
    
    /*  Sanity check: ensure that only stations are generated here. This is an
        attempt to fix exceptions of the form:
            NSInvalidArgumentException : *** -[ShipEntity setPlanet:]: selector
            not recognized [self = 0x19b7e000] *****
        which I presume to be originating here since all other uses of
        setPlanet: are guarded by isStation checks. This error could happen if
        a ship that is not a station has a station role, or equivalently if an
        OXP sets a system's station role to a role used by non-stations.
        -- Ahruman 20080303
    */
    if (![a_station isStation] || ![a_station validForAddToUniverse])
    {
        if (a_station == nil)
        {
            // Should have had a more specific error already, just specify context
            OOLog(@"universe.setup.badStation", @"Failed to set up a ship for role \"%@\" as system station, trying again with \"%@\".", stationDesc, defaultStationDesc);
        }
        else
        {
            OOLog(@"universe.setup.badStation", @"***** ERROR: Attempt to use non-station ship of type \"%@\" for role \"%@\" as system station, trying again with \"%@\".", [a_station name], stationDesc, defaultStationDesc);
        }
        [a_station release];
        stationDesc = defaultStationDesc;
        a_station = (StationEntity *)[self newShipWithRole:stationDesc];         // retain count = 1
        
        if (![a_station isStation] || ![a_station validForAddToUniverse])
        {
            if (a_station == nil)
            {
                OOLog(@"universe.setup.badStation", @"On retry, failed to set up a ship for role \"%@\" as system station. Trying to fall back to built-in Coriolis station.", stationDesc);
            }
            else
            {
                OOLog(@"universe.setup.badStation", @"***** ERROR: On retry, rolled non-station ship of type \"%@\" for role \"%@\". Non-station ships should not have this role! Trying to fall back to built-in Coriolis station.", [a_station name], stationDesc);
            }
            [a_station release];
            
            a_station = (StationEntity *)[self newShipWithName:@"coriolis-station"];
            if (![a_station isStation] || ![a_station validForAddToUniverse])
            {
                OOLog(@"universe.setup.badStation", @"%@", @"Could not create built-in Coriolis station! Generating a stationless system.");
                DESTROY(a_station);
            }
        }
    }
    
    if (a_station != nil)
    {
        [a_station setOrientation:quaternion_rotation_between(vf,make_vector(0.0,0.0,1.0))];
        [a_station setPosition: stationPos];
        [a_station setPitch: 0.0];
        [a_station setScanClass: CLASS_STATION];
        //[a_station setPlanet:[self planet]];  // done inside addEntity.
        [a_station setEquivalentTechLevel:techlevel];
        [self addEntity:a_station];     // STATUS_IN_FLIGHT, AI state GLOBAL
        [a_station setStatus:STATUS_ACTIVE];    // For backward compatibility. Might not be needed.
        [a_station setAllowsFastDocking:true];  // Main stations always allow fast docking.
        [a_station setAllegiance:@"galcop"]; // Main station is galcop controlled
    }
    OO_DEBUG_POP_PROGRESS();
    
    cachedSun = a_sun;
    cachedPlanet = a_planet;
    cachedStation = a_station;
    closeSystems = nil;
    OO_DEBUG_POP_PROGRESS();
    
    
    OO_DEBUG_PUSH_PROGRESS(@"%@", @"setUpSpace - populate from wormholes");
    [self populateSpaceFromActiveWormholes];
    OO_DEBUG_POP_PROGRESS();
 
    [a_sun release];
    [a_station release];
}

setUpUniverseFromMisjump

- (void) setUpUniverseFromMisjump

Definition at line 273 of file Universe.m.

{
    PlayerEntity        *player;
    
    //
    // check the player is still around!
    //
    if ([entities count] == 0)
    {
        /*- the player ship -*/
        player = [[PlayerEntity alloc] init];   // alloc retains!
        
        [self addEntity:player];
        
        /*--*/
    }
    else
    {
        player = [PLAYER retain];   // retained here
    }
    
    [self setUpWitchspace];
    // ensure that if we got here from a jump within a planet's atmosphere,
    // we don't get any residual air friction
    [self setAirResistanceFactor:0.0f];
    
    [player leaveWitchspace];
    [player release];                                           // released here
    
    [self setViewDirection:VIEW_FORWARD];
    
    displayGUI = NO;
}

setUpUniverseFromStation

- (void) setUpUniverseFromStation

Definition at line 273 of file Universe.m.

{
    if (![self sun])
    {
        // we're in witchspace...       
        
        PlayerEntity    *player = PLAYER;
        StationEntity   *dockedStation = [player dockedStation];
        NSPoint         coords = [player galaxy_coordinates];
        // check the nearest system
        OOSystemID sys = [self findSystemNumberAtCoords:coords withGalaxy:[player galaxyNumber] includingHidden:YES];
        BOOL interstel =[dockedStation interstellarUndockingAllowed];// && (s_seed.d != coords.x || s_seed.b != coords.y); - Nikos 20110623: Do we really need the commented out check?
        [player setPreviousSystemID:[player currentSystemID]];
 
        // remove everything except the player and the docked station
        if (dockedStation && !interstel)
        {   // jump to the nearest system
            [player setSystemID:sys];
            closeSystems = nil;
            [self setSystemTo: sys];
            int index = 0;
            while ([entities count] > 2)
            {
                Entity *ent = [entities objectAtIndex:index];
                if ((ent != player)&&(ent != dockedStation))
                {
                    if (ent->isStation)  // clear out queues
                        [(StationEntity *)ent clear];
                    [self removeEntity:ent];
                }
                else
                {
                    index++;    // leave that one alone
                }
            }
        }
        else
        {
            if (dockedStation == nil)  [self removeAllEntitiesExceptPlayer];    // get rid of witchspace sky etc. if still extant
        }
        
        if (!dockedStation || !interstel) 
        {
            [self setUpSpace];  // launching from station that jumped from interstellar space to normal space.
            [self populateNormalSpace];
            if (dockedStation)
            {
                if ([dockedStation maxFlightSpeed] > 0) // we are a carrier: exit near the WitchspaceExitPosition
                {
                    float       d1 = [self randomDistanceWithinScanner];
                    HPVector        pos = [UNIVERSE getWitchspaceExitPosition];     // no need to reset the PRNG
                    Quaternion  q1;
                    
                    quaternion_set_random(&q1);
                    if (abs((int)d1) < 2750)    
                    {
                        d1 += ((d1 > 0.0)? 2750.0f: -2750.0f); // no closer than 2750m. Carriers are bigger than player ships.
                    }
                    Vector      v1 = vector_forward_from_quaternion(q1);
                    pos.x += v1.x * d1; // randomise exit position
                    pos.y += v1.y * d1;
                    pos.z += v1.z * d1;
                    
                    [dockedStation setPosition: pos];
                }
                [self setWitchspaceBreakPattern:YES];
                [player setJumpCause:@"carried"];
                [player doScriptEvent:OOJSID("shipWillExitWitchspace") withArgument:[player jumpCause]];
                [player doScriptEvent:OOJSID("shipExitedWitchspace") withArgument:[player jumpCause]];
            }
        }
    }
    
    if(!autoSaveNow) [self setViewDirection:VIEW_FORWARD];
    displayGUI = NO;
    
    //reset atmospherics in case we ejected while we were in the atmophere
    [UNIVERSE setSkyColorRed:0.0f       // back to black
                       green:0.0f
                        blue:0.0f
                       alpha:0.0f];
}

setUpUniverseFromWitchspace

- (void) setUpUniverseFromWitchspace

Definition at line 273 of file Universe.m.

{
    PlayerEntity        *player;
    
    //
    // check the player is still around!
    //
    if ([entities count] == 0)
    {
        /*- the player ship -*/
        player = [[PlayerEntity alloc] init];   // alloc retains!
        
        [self addEntity:player];
        
        /*--*/
    }
    else
    {
        player = [PLAYER retain];   // retained here
    }
    
    [self setUpSpace];
    [self populateNormalSpace];
    
    [player leaveWitchspace];
    [player release];                                           // released here
 
    [self setViewDirection:VIEW_FORWARD];
    
    [comm_log_gui printLongText:[NSString stringWithFormat:@"%@ %@", [self getSystemName:systemID], [player dial_clock_adjusted]]
        align:GUI_ALIGN_CENTER color:[OOColor whiteColor] fadeTime:0 key:nil addToArray:[player commLog]];
    
    displayGUI = NO;
}

setUpWitchspace

- (void) setUpWitchspace

Definition at line 273 of file Universe.m.

{
    [self setUpWitchspaceBetweenSystem:[PLAYER systemID] andSystem:[PLAYER nextHopTargetSystemID]];
}

setUpWitchspaceBetweenSystem:andSystem:

- (void) setUpWitchspaceBetweenSystem:		(OOSystemID)	s1
andSystem:		(OOSystemID)	s2

Definition at line 273 of file Universe.m.

                                     :(OOSystemID)s1 andSystem:(OOSystemID)s2
{
    // new system is hyper-centric : witchspace exit point is origin
    
    Entity              *thing;
    PlayerEntity*       player = PLAYER;
    Quaternion          randomQ;
    
    NSString*       override_key = [self keyForInterstellarOverridesForSystems:s1 :s2 inGalaxy:galaxyID];
 
    NSDictionary *systeminfo = [systemManager getPropertiesForSystemKey:override_key];
    
    [universeRegion clearSubregions];
    
    // fixed entities (part of the graphics system really) come first...
    
    /*- the sky backdrop -*/
    OOColor *col1 = [OOColor colorWithRed:0.0 green:1.0 blue:0.5 alpha:1.0];
    OOColor *col2 = [OOColor colorWithRed:0.0 green:1.0 blue:0.0 alpha:1.0];
    thing = [[SkyEntity alloc] initWithColors:col1:col2 andSystemInfo: systeminfo]; // alloc retains!
    [thing setScanClass: CLASS_NO_DRAW];
    quaternion_set_random(&randomQ);
    [thing setOrientation:randomQ];
    [self addEntity:thing];
    [thing release];
    
    /*- the dust particle system -*/
    thing = [[DustEntity alloc] init];
    [thing setScanClass: CLASS_NO_DRAW];
    [self addEntity:thing];
    [thing release];
    
    ambientLightLevel = [systeminfo oo_floatForKey:@"ambient_level" defaultValue:1.0];
    [self setLighting]; // also sets initial lights positions.
    
    OOLog(kOOLogUniversePopulateWitchspace, @"%@", @"Populating witchspace ...");
    OOLogIndentIf(kOOLogUniversePopulateWitchspace);
    
    [self clearSystemPopulator];
    NSString *populator = [systeminfo oo_stringForKey:@"populator" defaultValue:@"interstellarSpaceWillPopulate"];
    [system_repopulator release];
    system_repopulator = [[systeminfo oo_stringForKey:@"repopulator" defaultValue:@"interstellarSpaceWillRepopulate"] retain];
    JSContext *context = OOJSAcquireContext();
    [PLAYER doWorldScriptEvent:OOJSIDFromString(populator) inContext:context withArguments:NULL count:0 timeLimit:kOOJSLongTimeLimit];
    OOJSRelinquishContext(context);
    [self populateSystemFromDictionariesWithSun:nil andPlanet:nil];
 
    // systeminfo might have a 'script_actions' resource we want to activate now...
    NSArray *script_actions = [systeminfo oo_arrayForKey:@"script_actions"];
    if (script_actions != nil)
    {
        OOStandardsDeprecated([NSString stringWithFormat:@"The script_actions system info key is deprecated for %@.",override_key]);
        if (!OOEnforceStandards()) 
        {
            [player runUnsanitizedScriptActions:script_actions
                              allowingAIMethods:NO
                                withContextName:@"<witchspace script_actions>"
                                      forTarget:nil];
        }
    }
    
    next_repopulation = randf() * SYSTEM_REPOPULATION_INTERVAL;
 
    OOLogOutdentIf(kOOLogUniversePopulateWitchspace);
}

setUseAddOns:fromSaveGame:

- (BOOL) setUseAddOns:		(NSString *)	newUse
fromSaveGame:		(BOOL)	saveGame

Definition at line 273 of file Universe.m.

                     :(NSString *) newUse fromSaveGame:(BOOL) saveGame
{
    return [self setUseAddOns:newUse fromSaveGame:saveGame forceReinit:NO];
}

setUseAddOns:fromSaveGame:forceReinit:

- (BOOL) setUseAddOns:		(NSString *)	newUse
fromSaveGame:		(BOOL)	saveGame
forceReinit:		(BOOL)	force

Definition at line 273 of file Universe.m.

                     :(NSString *) newUse fromSaveGame:(BOOL) saveGame forceReinit:(BOOL)force
{
    if (!force && [newUse isEqualToString:useAddOns])
    {
        return YES;
    } 
    DESTROY(useAddOns);
    useAddOns = [newUse retain];
 
    return [self reinitAndShowDemo:!saveGame];
}

setViewDirection:

- (void) setViewDirection:

(OOViewID)

vd

Definition at line 6447 of file Universe.m.

                         :(OOViewID) vd
{
    NSString        *ms = nil;
    BOOL            guiSelected = NO;
    
    if ((viewDirection == vd) && (vd != VIEW_CUSTOM) && (!displayGUI))
        return;
    
    switch (vd)
    {
        case VIEW_FORWARD:
            ms = DESC(@"forward-view-string");
            break;
            
        case VIEW_AFT:
            ms = DESC(@"aft-view-string");
            break;
            
        case VIEW_PORT:
            ms = DESC(@"port-view-string");
            break;
            
        case VIEW_STARBOARD:
            ms = DESC(@"starboard-view-string");
            break;
            
        case VIEW_CUSTOM:
            ms = [PLAYER customViewDescription];
            break;
            
        case VIEW_GUI_DISPLAY:
            [self setDisplayText:YES];
            [self setMainLightPosition:(Vector){ DEMO_LIGHT_POSITION }];
            guiSelected = YES;
            break;
            
        default:
            guiSelected = YES;
            break;
    }
    
    if (guiSelected)
    {
        [[self gameController] setMouseInteractionModeForUIWithMouseInteraction:NO];
    }
    else
    {
        displayGUI = NO;   // switch off any text displays
        [[self gameController] setMouseInteractionModeForFlight];
    }
    
    if (viewDirection != vd || viewDirection == VIEW_CUSTOM)
    {
        #if (ALLOW_CUSTOM_VIEWS_WHILE_PAUSED)
        BOOL gamePaused = [[self gameController] isGamePaused];
        #else
        BOOL gamePaused = NO;
        #endif
        // view notifications for when the player switches to/from gui!
        //if (EXPECT(viewDirection == VIEW_GUI_DISPLAY || vd == VIEW_GUI_DISPLAY )) [PLAYER noteViewDidChangeFrom:viewDirection toView:vd];
        viewDirection = vd;
        if (ms && !gamePaused)
        {
            [self addMessage:ms forCount:3];
        }
        else if (gamePaused)
        {
            [message_gui clear];
        }
    }
}

setWireframeGraphics:

- (void) setWireframeGraphics:

(BOOL)

value

Definition at line 9471 of file Universe.m.

                             :(BOOL) value
{
    wireframeGraphics = !!value;
    [[NSUserDefaults standardUserDefaults] setBool:wireframeGraphics forKey:@"wireframe-graphics"];
}

setWitchspaceBreakPattern:

- (void) setWitchspaceBreakPattern:

(BOOL)

newValue

Definition at line 273 of file Universe.m.

                                  :(BOOL)newValue
{
    _witchspaceBreakPattern = !!newValue;
}

shipClassForShipDictionary:

- (Class) shipClassForShipDictionary:

(NSDictionary *)

dict

Definition at line 3616 of file Universe.m.

                                    :(NSDictionary *)dict
{
    OOJS_PROFILE_ENTER
    
    if (dict == nil)  return Nil;
    
    BOOL        isStation = NO;
    NSString    *shipRoles = [dict oo_stringForKey:@"roles"];
    
    if (shipRoles != nil)
    {
        isStation = [shipRoles rangeOfString:@"station"].location != NSNotFound ||
        [shipRoles rangeOfString:@"carrier"].location != NSNotFound;
    }
    
    // Note priority here: is_carrier overrides isCarrier which overrides roles.
    isStation = [dict oo_boolForKey:@"isCarrier" defaultValue:isStation];
    isStation = [dict oo_boolForKey:@"is_carrier" defaultValue:isStation];
    
 
    return isStation ? [StationEntity class] : [ShipEntity class];
    
    OOJS_PROFILE_EXIT
}

shipsForSaleForSystem:withTL:atTime:

- (NSArray *) shipsForSaleForSystem:		(OOSystemID)	s
withTL:		(OOTechLevelID)	specialTL
atTime:		(OOTimeAbsolute)	current_time

Definition at line 7996 of file Universe.m.

                                   :(OOSystemID)s withTL:(OOTechLevelID)specialTL atTime:(OOTimeAbsolute)current_time
{
    RANROTSeed saved_seed = RANROTGetFullSeed();
    Random_Seed ship_seed = [self marketSeed];
    
    NSMutableDictionary     *resultDictionary = [NSMutableDictionary dictionary];
    
    float                   tech_price_boost = (ship_seed.a + ship_seed.b) / 256.0;
    unsigned                i;
    PlayerEntity            *player = PLAYER;
    OOShipRegistry          *registry = [OOShipRegistry sharedRegistry];
    RANROTSeed              personalitySeed = RanrotSeedFromRandomSeed(ship_seed);
    
    for (i = 0; i < 256; i++)
    {
        long long reference_time = 0x1000000 * floor(current_time / 0x1000000);
        
        long long c_time = ship_seed.a * 0x10000 + ship_seed.b * 0x100 + ship_seed.c;
        double ship_sold_time = reference_time + c_time;
        
        if (ship_sold_time < 0)
            ship_sold_time += 0x1000000;    // wraparound
        
        double days_until_sale = (ship_sold_time - current_time) / 86400.0;
        
        NSMutableArray  *keysForShips = [NSMutableArray arrayWithArray:[registry playerShipKeys]];
        unsigned        si;
        for (si = 0; si < [keysForShips count]; si++)
        {
            //eliminate any ships that fail a 'conditions test'
            NSString        *key = [keysForShips oo_stringAtIndex:si];
            NSDictionary    *dict = [registry shipyardInfoForKey:key];
            NSArray         *conditions = [dict oo_arrayForKey:@"conditions"];
            
            if (![player scriptTestConditions:conditions])
            {
                [keysForShips removeObjectAtIndex:si--];
            }
            NSString *condition_script = [dict oo_stringForKey:@"condition_script"];
            if (condition_script != nil)
            {
                OOJSScript *condScript = [self getConditionScript:condition_script];
                if (condScript != nil) // should always be non-nil, but just in case
                {
                    JSContext           *context = OOJSAcquireContext();
                    BOOL OK;
                    JSBool allow_purchase;
                    jsval result;
                    jsval args[] = { OOJSValueFromNativeObject(context, key) };
            
                    OK = [condScript callMethod:OOJSID("allowOfferShip")
                                                inContext:context
                                        withArguments:args count:sizeof args / sizeof *args
                                                     result:&result];
 
                    if (OK) OK = JS_ValueToBoolean(context, result, &allow_purchase);
            
                    OOJSRelinquishContext(context);
 
                    if (OK && !allow_purchase)
                    {
                        /* if the script exists, the function exists, the function
                         * returns a bool, and that bool is false, block
                         * purchase. Otherwise allow it as default */
                        [keysForShips removeObjectAtIndex:si--];
                    }
                }
            }
 
        }
        
        NSDictionary    *systemInfo = [self generateSystemData:s];
        OOTechLevelID   techlevel;
        if (specialTL != NSNotFound)  
        {
            //if we are passed a tech level use that
            techlevel = specialTL;
        }
        else
        {
            //otherwise use default for system
            techlevel = [systemInfo oo_unsignedIntForKey:KEY_TECHLEVEL];
        }
        unsigned        ship_index = (ship_seed.d * 0x100 + ship_seed.e) % [keysForShips count];
        NSString        *ship_key = [keysForShips oo_stringAtIndex:ship_index];
        NSDictionary    *ship_info = [registry shipyardInfoForKey:ship_key];
        OOTechLevelID   ship_techlevel = [ship_info oo_intForKey:KEY_TECHLEVEL];
        
        double chance = 1.0 - pow(1.0 - [ship_info oo_doubleForKey:KEY_CHANCE], MAX((OOTechLevelID)1, techlevel - ship_techlevel));
        
        // seed random number generator
        int superRand1 = ship_seed.a * 0x10000 + ship_seed.c * 0x100 + ship_seed.e;
        uint32_t superRand2 = ship_seed.b * 0x10000 + ship_seed.d * 0x100 + ship_seed.f;
        ranrot_srand(superRand2);
        
        NSDictionary* shipBaseDict = [[OOShipRegistry sharedRegistry] shipInfoForKey:ship_key];
        
        if ((days_until_sale > 0.0) && (days_until_sale < 30.0) && (ship_techlevel <= techlevel) && (randf() < chance) && (shipBaseDict != nil))
        {           
            NSMutableDictionary* shipDict = [NSMutableDictionary dictionaryWithDictionary:shipBaseDict];
            NSMutableString* shortShipDescription = [NSMutableString stringWithCapacity:256];
            NSString *shipName = [shipDict oo_stringForKey:@"display_name" defaultValue:[shipDict oo_stringForKey:KEY_NAME]];
            OOCreditsQuantity price = [ship_info oo_unsignedIntForKey:KEY_PRICE];
            OOCreditsQuantity base_price = price;
            NSMutableArray* extras = [NSMutableArray arrayWithArray:[[ship_info oo_dictionaryForKey:KEY_STANDARD_EQUIPMENT] oo_arrayForKey:KEY_EQUIPMENT_EXTRAS]];
            NSString* fwdWeaponString = [[ship_info oo_dictionaryForKey:KEY_STANDARD_EQUIPMENT] oo_stringForKey:KEY_EQUIPMENT_FORWARD_WEAPON];
            NSString* aftWeaponString = [[ship_info oo_dictionaryForKey:KEY_STANDARD_EQUIPMENT] oo_stringForKey:KEY_EQUIPMENT_AFT_WEAPON];
            
            NSMutableArray* options = [NSMutableArray arrayWithArray:[ship_info oo_arrayForKey:KEY_OPTIONAL_EQUIPMENT]];
            OOCargoQuantity maxCargo = [shipDict oo_unsignedIntForKey:@"max_cargo"];
            
            // more info for potential purchasers - how to reveal this I'm not yet sure...
            //NSString* brochure_desc = [self brochureDescriptionWithDictionary: ship_dict standardEquipment: extras optionalEquipment: options];
            //NSLog(@"%@ Brochure description : \"%@\"", [ship_dict objectForKey:KEY_NAME], brochure_desc);
            
            [shortShipDescription appendFormat:@"%@:", shipName];
            
            OOWeaponFacingSet availableFacings = [ship_info oo_unsignedIntForKey:KEY_WEAPON_FACINGS defaultValue:VALID_WEAPON_FACINGS] & VALID_WEAPON_FACINGS;
 
            OOWeaponType fwdWeapon = OOWeaponTypeFromEquipmentIdentifierSloppy(fwdWeaponString);
            OOWeaponType aftWeapon = OOWeaponTypeFromEquipmentIdentifierSloppy(aftWeaponString);
            //port and starboard weapons are not modified in the shipyard
            // apply fwd and aft weapons to the ship
            if (fwdWeapon && fwdWeaponString) [shipDict setObject:fwdWeaponString forKey:KEY_EQUIPMENT_FORWARD_WEAPON];
            if (aftWeapon && aftWeaponString) [shipDict setObject:aftWeaponString forKey:KEY_EQUIPMENT_AFT_WEAPON];
            
            int passengerBerthCount = 0;
            BOOL customised = NO;
            BOOL weaponCustomized = NO;
            
            NSString *fwdWeaponDesc = nil;
            
            NSString *shortExtrasKey = @"shipyard-first-extra";
            
            // for testing condition scripts
            ShipEntity *testship = [[ProxyPlayerEntity alloc] initWithKey:ship_key definition:shipDict];
            // customise the ship (if chance = 1, then ship will get all possible add ons)
            while ((randf() < chance) && ([options count]))
            {
                chance *= chance;   //decrease the chance of a further customisation (unless it is 1, which might be a bug)
                int             optionIndex = Ranrot() % [options count];
                NSString        *equipmentKey = [options oo_stringAtIndex:optionIndex];
                OOEquipmentType *item = [OOEquipmentType equipmentTypeWithIdentifier:equipmentKey];
                
                if (item != nil)
                {
                    OOTechLevelID       eqTechLevel = [item techLevel];
                    OOCreditsQuantity   eqPrice = [item price] / 10;    // all amounts are x/10 due to being represented in tenths of credits.
                    NSString            *eqShortDesc = [item name];
                    
                    if ([item techLevel] > techlevel)
                    {
                        // Cap maximum tech level.
                        eqTechLevel = MIN(eqTechLevel, 15U);
                        
                        // Higher tech items are rarer!
                        if (randf() * (eqTechLevel - techlevel) < 1.0)
                        {
                            // All included equip has a 10% discount.
                            eqPrice *= (tech_price_boost + eqTechLevel - techlevel) * 90 / 100;
                        }
                        else
                            break;  // Bar this upgrade.
                    }
                    
                    if ([item incompatibleEquipment] != nil && extras != nil)
                    {
                        NSEnumerator                *keyEnum = nil;
                        id                          key = nil;
                        BOOL                        incompatible = NO;
                        
                        for (keyEnum = [[item incompatibleEquipment] objectEnumerator]; (key = [keyEnum nextObject]); )
                        {
                            if ([extras containsObject:key])
                            {
                                [options removeObject:equipmentKey];
                                incompatible = YES;
                                break;
                            }
                        }
                        if (incompatible) break;
                        
                        // make sure the incompatible equipment is not choosen later on.
                        for (keyEnum = [[item incompatibleEquipment] objectEnumerator]; (key = [keyEnum nextObject]); )
                        {
                            if ([options containsObject:key])
                            {
                                [options removeObject:key]; 
                            }
                        }
                    }
                    
                    /* Check condition scripts */
                    NSString *condition_script = [item conditionScript];
                    if (condition_script != nil)
                    {
                        OOJSScript *condScript = [self getConditionScript:condition_script];
                        if (condScript != nil) // should always be non-nil, but just in case
                        {
                            JSContext           *JScontext = OOJSAcquireContext();
                            BOOL OK;
                            JSBool allow_addition;
                            jsval result;
                            jsval args[] = { OOJSValueFromNativeObject(JScontext, equipmentKey) , OOJSValueFromNativeObject(JScontext, testship) , OOJSValueFromNativeObject(JScontext, @"newShip")};
                
                            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 */
                                break;
                            }
                        }
                    }
 
 
                    if ([item requiresEquipment] != nil && extras != nil)
                    {
                        NSEnumerator                *keyEnum = nil;
                        id                          key = nil;
                        BOOL                        missing = NO;
                        
                        for (keyEnum = [[item requiresEquipment] objectEnumerator]; (key = [keyEnum nextObject]); )
                        {
                            if (![extras containsObject:key])
                            {
                                missing = YES;
                            }
                        }
                        if (missing) break;
                    }
                    
                    if ([item requiresAnyEquipment] != nil && extras != nil)
                    {
                        NSEnumerator                *keyEnum = nil;
                        id                          key = nil;
                        BOOL                        missing = YES;
                        
                        for (keyEnum = [[item requiresAnyEquipment] objectEnumerator]; (key = [keyEnum nextObject]); )
                        {
                            if ([extras containsObject:key])
                            {
                                missing = NO;
                            }
                        }
                        if (missing) break;
                    }
                    
                    // Special case, NEU has to be compatible with EEU inside equipment.plist
                    // but we can only have either one or the other on board.
                    if ([equipmentKey isEqualTo:@"EQ_NAVAL_ENERGY_UNIT"])
                    {
                        if ([extras containsObject:@"EQ_ENERGY_UNIT"])
                        {
                            [options removeObject:equipmentKey];
                            break;
                        }
                    }
                    
                    if ([equipmentKey hasPrefix:@"EQ_WEAPON"])
                    {
                        OOWeaponType new_weapon = OOWeaponTypeFromEquipmentIdentifierSloppy(equipmentKey);
                        //fit best weapon forward
                        if (availableFacings & WEAPON_FACING_FORWARD && [new_weapon weaponThreatAssessment] > [fwdWeapon weaponThreatAssessment])
                        {
                            //again remember to divide price by 10 to get credits from tenths of credit
                            price -= [self getEquipmentPriceForKey:fwdWeaponString] * 90 / 1000;    // 90% credits
                            price += eqPrice;
                            fwdWeaponString = equipmentKey;
                            fwdWeapon = new_weapon;
                            [shipDict setObject:fwdWeaponString forKey:KEY_EQUIPMENT_FORWARD_WEAPON];
                            weaponCustomized = YES;
                            fwdWeaponDesc = eqShortDesc;
                        }
                        else 
                        {
                            //if less good than current forward, try fitting is to rear
                            if (availableFacings & WEAPON_FACING_AFT && (isWeaponNone(aftWeapon) || [new_weapon weaponThreatAssessment] > [aftWeapon weaponThreatAssessment]))
                            {
                                price -= [self getEquipmentPriceForKey:aftWeaponString] * 90 / 1000;    // 90% credits
                                price += eqPrice;
                                aftWeaponString = equipmentKey;
                                aftWeapon = new_weapon;
                                [shipDict setObject:aftWeaponString forKey:KEY_EQUIPMENT_AFT_WEAPON];
                            }
                            else 
                            {
                                [options removeObject:equipmentKey]; //dont try again
                            }               
                        }
                    
                    }
                    else
                    {
                        if ([equipmentKey isEqualToString:@"EQ_PASSENGER_BERTH"])
                        {
                            if ((maxCargo >= PASSENGER_BERTH_SPACE) && (randf() < chance))
                            {
                                maxCargo -= PASSENGER_BERTH_SPACE;
                                price += eqPrice;
                                [extras addObject:equipmentKey];
                                passengerBerthCount++;
                                customised = YES;
                            }
                            else
                            {
                                // remove the option if there's no space left
                                [options removeObject:equipmentKey];
                            }
                        }
                        else
                        {
                            price += eqPrice;
                            [extras addObject:equipmentKey];
                            if ([item isVisible])
                            {
                                NSString *item = eqShortDesc;
                                [shortShipDescription appendString:OOExpandKey(shortExtrasKey, item)];
                                shortExtrasKey = @"shipyard-additional-extra";
                            }
                            customised = YES;
                            [options removeObject:equipmentKey]; //dont add twice
                        }
                    }
                }
                else
                {
                    [options removeObject:equipmentKey];
                }
            } // end adding optional equipment
            [testship release];
            // i18n: Some languages require that no conversion to lower case string takes place.
            BOOL lowercaseIgnore = [[self descriptions] oo_boolForKey:@"lowercase_ignore"];
            
            if (passengerBerthCount)
            {
                NSString* npb = (passengerBerthCount > 1)? [NSString stringWithFormat:@"%d ", passengerBerthCount] : (id)@"";
                NSString* ppb = DESC_PLURAL(@"passenger-berth", passengerBerthCount);
                NSString* extraPassengerBerthsDescription = [NSString stringWithFormat:DESC(@"extra-@-@-(passenger-berths)"), npb, ppb];
                NSString *item = extraPassengerBerthsDescription;
                [shortShipDescription appendString:OOExpandKey(shortExtrasKey, item)];
                shortExtrasKey = @"shipyard-additional-extra";
            }
            
            if (!customised)
            {
                [shortShipDescription appendString:OOExpandKey(@"shipyard-standard-customer-model")];
            }
            
            if (weaponCustomized)
            {
                NSString *weapon = (lowercaseIgnore ? fwdWeaponDesc : [fwdWeaponDesc lowercaseString]);
                [shortShipDescription appendString:OOExpandKey(@"shipyard-forward-weapon-upgraded", weapon)];
            }
            if (price > base_price)
            {
                price = base_price + cunningFee(price - base_price, 0.05);
            }
            
            [shortShipDescription appendString:OOExpandKey(@"shipyard-price", price)];
            
            NSString *shipID = [NSString stringWithFormat:@"%06x-%06x", superRand1, superRand2];
            
            uint16_t personality = RanrotWithSeed(&personalitySeed) & ENTITY_PERSONALITY_MAX;
            
            NSDictionary *ship_info_dictionary = [NSDictionary dictionaryWithObjectsAndKeys:
                shipID,                             SHIPYARD_KEY_ID,
                ship_key,                           SHIPYARD_KEY_SHIPDATA_KEY,
                shipDict,                           SHIPYARD_KEY_SHIP,
                shortShipDescription,               KEY_SHORT_DESCRIPTION,
                [NSNumber numberWithUnsignedLongLong:price], SHIPYARD_KEY_PRICE,
                extras,                             KEY_EQUIPMENT_EXTRAS,
                [NSNumber numberWithUnsignedShort:personality], SHIPYARD_KEY_PERSONALITY,                                 
                NULL];
            
            [resultDictionary setObject:ship_info_dictionary forKey:shipID];    // should order them fairly randomly
        }
        
        // next contract
        rotate_seed(&ship_seed);
        rotate_seed(&ship_seed);
        rotate_seed(&ship_seed);
        rotate_seed(&ship_seed);
    }
    
    NSMutableArray *resultArray = [[[resultDictionary allValues] mutableCopy] autorelease];
    [resultArray sortUsingFunction:compareName context:NULL];
    
    // remove identically priced ships of the same name
    i = 1;
    
    while (i < [resultArray count])
    {
        if (compareName([resultArray objectAtIndex:i - 1], [resultArray objectAtIndex:i], nil) == NSOrderedSame )
        {
            [resultArray removeObjectAtIndex: i];
        }
        else
        {
            i++;
        }
    }
    
    RANROTSetFullSeed(saved_seed);
 
    return [NSArray arrayWithArray:resultArray];
}

shortTimeDescription:

- (NSString *) shortTimeDescription:

(OOTimeDelta)

interval

Definition at line 7996 of file Universe.m.

                                   :(double) interval
{
    double r_time = interval;
    NSString* result = @"";
    int parts = 0;
    
    if (interval <= 0.0)
        return DESC(@"contracts-no-time");
    
    if (r_time > 86400)
    {
        int days = floor(r_time / 86400);
        r_time -= 86400 * days;
        result = [NSString stringWithFormat:@"%@ %d %@", result, days, DESC_PLURAL(@"contracts-day-word", days)];
        parts++;
    }
    if (r_time > 3600)
    {
        int hours = floor(r_time / 3600);
        r_time -= 3600 * hours;
        result = [NSString stringWithFormat:@"%@ %d %@", result, hours, DESC_PLURAL(@"contracts-hour-word", hours)];
        parts++;
    }
    if (parts < 2 && r_time > 60)
    {
        int mins = floor(r_time / 60);
        r_time -= 60 * mins;
        result = [NSString stringWithFormat:@"%@ %d %@", result, mins, DESC_PLURAL(@"contracts-minute-word", mins)];
        parts++;
    }
    if (parts < 2 && r_time > 0)
    {
        int secs = floor(r_time);
        result = [NSString stringWithFormat:@"%@ %d %@", result, secs, DESC_PLURAL(@"contracts-second-word", secs)];
    }
    return [result stringByTrimmingCharactersInSet:[NSCharacterSet whitespaceCharacterSet]];
}

showCommsLog:

- (void) showCommsLog:

(OOTimeDelta)

how_long

Definition at line 6447 of file Universe.m.

                     :(OOTimeDelta)how_long
{
    [comm_log_gui setAlpha:1.0];
    if (![self permanentCommLog]) [comm_log_gui fadeOutFromTime:[self getTime] overDuration:how_long];
}

showGUIMessage:withScroll:andColor:overDuration:

- (void) showGUIMessage:		(NSString *)	text
withScroll:		(BOOL)	scroll
andColor:		(OOColor *)	selectedColor
overDuration:		(OOTimeDelta)	how_long

Definition at line 6447 of file Universe.m.

                       :(NSString *)text withScroll:(BOOL)scroll andColor:(OOColor *)selectedColor overDuration:(OOTimeDelta)how_long
{
    if (scroll)
    {
        [message_gui printLongText:text align:GUI_ALIGN_CENTER color:selectedColor fadeTime:how_long key:nil addToArray:nil];
    }
    else
    {
        [message_gui printLineNoScroll:text align:GUI_ALIGN_CENTER color:selectedColor fadeTime:how_long key:nil addToArray:nil];
    }
    [message_gui setAlpha:1.0f];
}

skyClearColor

- (GLfloat *) skyClearColor

soundNameForCustomSoundKey:

- (NSString *) soundNameForCustomSoundKey:

(NSString *)

key

Definition at line 6447 of file Universe.m.

                                         :(NSString *)key
{
    NSString                *result = nil;
    NSMutableSet            *seen = nil;
    id object = [customSounds objectForKey:key];
    
    if ([object isKindOfClass:[NSArray class]] && [object count] > 0)
    {
        key = [object oo_stringAtIndex:Ranrot() % [object count]];
    }
    else
    {
        object=nil;
    }
    
    result = [[OOCacheManager sharedCache] objectForKey:key inCache:@"resolved custom sounds"];
    if (result == nil)
    {
        // Resolve sound, allowing indirection within customsounds.plist
        seen = [NSMutableSet set];
        result = key;
        if (object == nil || ([result hasPrefix:@"["] && [result hasSuffix:@"]"]))
        {
            for (;;)
            {
                [seen addObject:result];
                object = [customSounds objectForKey:result];
                if( [object isKindOfClass:[NSArray class]] && [object count] > 0)
                {
                    result = [object oo_stringAtIndex:Ranrot() % [object count]];
                    if ([key hasPrefix:@"["] && [key hasSuffix:@"]"]) key=result;
                }
                else
                {
                    if ([object isKindOfClass:[NSString class]])
                        result = object;
                    else
                        result = nil;
                }
                if (result == nil || ![result hasPrefix:@"["] || ![result hasSuffix:@"]"])  break;
                if ([seen containsObject:result])
                {
                    OOLogERR(@"sound.customSounds.recursion", @"recursion in customsounds.plist for '%@' (at '%@'), no sound will be played.", key, result);
                    result = nil;
                    break;
                }
            }
        }
        
        if (result == nil)  result = @"__oolite-no-sound";
        [[OOCacheManager sharedCache] setObject:result forKey:key inCache:@"resolved custom sounds"];
    }
    
    if ([result isEqualToString:@"__oolite-no-sound"])
    {
        OOLog(@"sound.customSounds", @"Could not resolve sound name in customsounds.plist for '%@', no sound will be played.", key);
        result = nil;
    }
    return result;
}

spawnShip:

- (BOOL) spawnShip:

(NSString *)

shipdesc

Definition at line 273 of file Universe.m.

                  :(NSString *) shipdesc
{
    // no need to do any more than log - enforcing modes wouldn't even have
    // loaded the legacy script
    OOStandardsDeprecated([NSString stringWithFormat:@"'spawn' via legacy script is deprecated as a way of adding ships for %@",shipdesc]);
 
    ShipEntity      *ship;
    NSDictionary    *shipdict = nil;
    
    shipdict = [[OOShipRegistry sharedRegistry] shipInfoForKey:shipdesc];
    if (shipdict == nil)  return NO;
    
    ship = [self newShipWithName:shipdesc]; // retain count is 1
    
    if (ship == nil)  return NO;
    
    // set any spawning characteristics
    NSDictionary    *spawndict = [shipdict oo_dictionaryForKey:@"spawn"];
    HPVector            pos, rpos, spos;
    NSString        *positionString = nil;
    
    // position
    positionString = [spawndict oo_stringForKey:@"position"];
    if (positionString != nil)
    {
        if([positionString hasPrefix:@"abs "] && ([self planet] != nil || [self sun] !=nil))
        {
            OOLogWARN(@"script.deprecated", @"setting %@ for %@ '%@' in 'abs' inside .plists can cause compatibility issues across Oolite versions. Use coordinates relative to main system objects instead.",@"position",@"entity",shipdesc);
        }
        
        pos = [self coordinatesFromCoordinateSystemString:positionString];
    }
    else
    {
        // without position defined, the ship will be added on top of the witchpoint buoy.
        pos = OOHPVectorRandomRadial(SCANNER_MAX_RANGE);
        OOLogERR(@"universe.spawnShip.error", @"***** ERROR: failed to find a spawn position for ship %@.", shipdesc);
    }
    [ship setPosition:pos];
    
    // facing_position
    positionString = [spawndict oo_stringForKey:@"facing_position"];
    if (positionString != nil)
    {
        if([positionString hasPrefix:@"abs "] && ([self planet] != nil || [self sun] !=nil))
        {
            OOLogWARN(@"script.deprecated", @"setting %@ for %@ '%@' in 'abs' inside .plists can cause compatibility issues across Oolite versions. Use coordinates relative to main system objects instead.",@"facing_position",@"entity",shipdesc);
        }
        
        spos = [ship position];
        Quaternion q1;
        rpos = [self coordinatesFromCoordinateSystemString:positionString];
        rpos = HPvector_subtract(rpos, spos); // position relative to ship
        
        if (!HPvector_equal(rpos, kZeroHPVector))
        {
            rpos = HPvector_normal(rpos);
            
            if (!HPvector_equal(rpos, HPvector_flip(kBasisZHPVector)))
            {
                q1 = quaternion_rotation_between(HPVectorToVector(rpos), kBasisZVector);
            }
            else
            {
                // for the inverse of the kBasisZVector the rotation is undefined, so we select one.
                q1 = make_quaternion(0,1,0,0);
            }
            
                        
            [ship setOrientation:q1];
        }
    }
    
    [self addEntity:ship];  // STATUS_IN_FLIGHT, AI state GLOBAL
    [ship release];
    
    return YES;
}

spawnShipWithRole:near:

- (ShipEntity *) spawnShipWithRole:		(NSString *)	desc
near:		(Entity *)	entity

Definition at line 273 of file Universe.m.

                                  :(NSString *) desc near:(Entity *) entity
{
    if (entity == nil)  return nil;
    
    ShipEntity  *ship = nil;
    HPVector        spawn_pos;
    Quaternion  spawn_q;
    GLfloat     offset = (randf() + randf()) * entity->collision_radius;
    
    quaternion_set_random(&spawn_q);
    spawn_pos = HPvector_add([entity position], vectorToHPVector(vector_multiply_scalar(vector_forward_from_quaternion(spawn_q), offset)));
    
    ship = [self addShipWithRole:desc launchPos:spawn_pos rfactor:0.0];
    [ship setOrientation:spawn_q];
    
    return ship;
}

speakWithSubstitutions:

- (void) speakWithSubstitutions: (NSString *) text

implementation

Definition at line 6447 of file Universe.m.

                               :(NSString *)text
{
#if OOLITE_SPEECH_SYNTH
    //speech synthesis
    
    PlayerEntity* player = PLAYER;
    if ([player isSpeechOn] > OOSPEECHSETTINGS_OFF)
    {
        NSString    *systemSaid = nil;
        NSString    *h_systemSaid = nil;
        
        NSString    *systemName = [self getSystemName:systemID];
        
        systemSaid = systemName;
        
        NSString    *h_systemName = [self getSystemName:[player targetSystemID]];
        h_systemSaid = h_systemName;
        
        NSString    *spokenText = text;
        if (speechArray != nil)
        {
            NSEnumerator    *speechEnumerator = nil;
            NSArray         *thePair = nil;
            
            for (speechEnumerator = [speechArray objectEnumerator]; (thePair = [speechEnumerator nextObject]); )
            {
                NSString *original_phrase = [thePair oo_stringAtIndex:0];
                
                NSUInteger replacementIndex;
#if OOLITE_MAC_OS_X
                replacementIndex = 1;
#elif OOLITE_ESPEAK
                replacementIndex = [thePair count] > 2 ? 2 : 1;
#endif
                
                NSString *replacement_phrase = [thePair oo_stringAtIndex:replacementIndex];
                if (![replacement_phrase isEqualToString:@"_"])
                {
                    spokenText = [spokenText stringByReplacingOccurrencesOfString:original_phrase withString:replacement_phrase];
                }
            }
            spokenText = [spokenText stringByReplacingOccurrencesOfString:systemName withString:systemSaid];
            spokenText = [spokenText stringByReplacingOccurrencesOfString:h_systemName withString:h_systemSaid];
        }
        [self stopSpeaking];
        [self startSpeakingString:spokenText];
    }
#endif  // OOLITE_SPEECH_SYNTH
}

startSpeakingString:

- (void) startSpeakingString:

(NSString *)

text

Definition at line 9471 of file Universe.m.

                            :(NSString *) text
{
    [speechSynthesizer startSpeakingString:[NSString stringWithFormat:@"[[volm %.3f]]%@", 0.3333333f * [OOSound masterVolume], text]];
}

station

- (StationEntity *) station

Definition at line 3616 of file Universe.m.

{
    if (cachedSun != nil && cachedStation == nil)
    {
        cachedStation = [self findOneEntityMatchingPredicate:IsCandidateMainStationPredicate
                                                   parameter:nil];
    }
    return cachedStation;
}

stationFriendlyTo:

- (StationEntity *) stationFriendlyTo:

(ShipEntity *)

ship

Definition at line 3616 of file Universe.m.

                                     :(ShipEntity *) ship
{
    // In interstellar space we select a random friendly carrier as mainStation.
    // No caching: friendly status can change!
    return [self findOneEntityMatchingPredicate:IsFriendlyStationPredicate parameter:ship];
}

stations

- (NSArray *) stations

Definition at line 3616 of file Universe.m.

{
    return [allStations allObjects];
}

stationWithRole:andPosition:

- (StationEntity *) stationWithRole:		(NSString *)	role
andPosition:		(HPVector)	position

Definition at line 3616 of file Universe.m.

                                   :(NSString *)role andPosition:(HPVector)position
{
    if ([role isEqualToString:@""])
    {
        return nil;
    }
 
    float range = 1000000; // allow a little variation in position
 
    NSArray *stations = [self stations];
    StationEntity *station = nil;
    foreach (station, stations)
    {
        if (HPdistance2(position,[station position]) < range)
        {
            if ([[station primaryRole] isEqualToString:role])
            {
                return station;
            }
        }
    }
    return nil;
}

stopSpeaking

- (void) stopSpeaking

Definition at line 9471 of file Universe.m.

{
    if ([speechSynthesizer respondsToSelector:@selector(stopSpeakingAtBoundary:)])
    {
        [speechSynthesizer stopSpeakingAtBoundary:NSSpeechWordBoundary];
    }
    else
    {
        [speechSynthesizer stopSpeaking];
    }
}

sun

- (OOSunEntity *) sun

Definition at line 3616 of file Universe.m.

{
    if (cachedSun == nil)
    {
        cachedSun = [self findOneEntityMatchingPredicate:IsSunPredicate parameter:nil];
    }
    return cachedSun;
}

systemDataForGalaxy:planet:key:

- (id) systemDataForGalaxy:		(OOGalaxyID)	gnum
planet:		(OOSystemID)	pnum
key:		(NSString *)	key

Definition at line 7996 of file Universe.m.

                          :(OOGalaxyID)gnum planet:(OOSystemID)pnum key:(NSString *)key
{
    return [systemManager getProperty:key forSystem:pnum inGalaxy:gnum];
}

systemDataKeysForGalaxy:planet:

- (NSArray *) systemDataKeysForGalaxy:		(OOGalaxyID)	gnum
planet:		(OOSystemID)	pnum

Definition at line 7996 of file Universe.m.

                                     :(OOGalaxyID)gnum planet:(OOSystemID)pnum
{
    return [[self generateSystemDataForGalaxy:gnum planet:pnum] allKeys];
}

systemManager

- (OOSystemDescriptionManager *) systemManager

systemNameIndex:

- (NSString *) systemNameIndex:

(OOSystemID)

index

Definition at line 7996 of file Universe.m.

                            :(OOSystemID)index
{
    return system_names[index & 255];
}

systemsFound

- (BOOL *) systemsFound

Definition at line 7996 of file Universe.m.

{
    return (BOOL*)system_found;
}

timeAccelerationFactor

- (double) timeAccelerationFactor

timeDescription:

- (NSString *) timeDescription:

(OOTimeDelta)

interval

Definition at line 7996 of file Universe.m.

                              :(double) interval
{
    double r_time = interval;
    NSString* result = @"";
    
    if (r_time > 86400)
    {
        int days = floor(r_time / 86400);
        r_time -= 86400 * days;
        result = [NSString stringWithFormat:@"%@ %d day%@", result, days, (days > 1) ? @"s" : @""];
    }
    if (r_time > 3600)
    {
        int hours = floor(r_time / 3600);
        r_time -= 3600 * hours;
        result = [NSString stringWithFormat:@"%@ %d hour%@", result, hours, (hours > 1) ? @"s" : @""];
    }
    if (r_time > 60)
    {
        int mins = floor(r_time / 60);
        r_time -= 60 * mins;
        result = [NSString stringWithFormat:@"%@ %d minute%@", result, mins, (mins > 1) ? @"s" : @""];
    }
    if (r_time > 0)
    {
        int secs = floor(r_time);
        result = [NSString stringWithFormat:@"%@ %d second%@", result, secs, (secs > 1) ? @"s" : @""];
    }
    return [result stringByTrimmingCharactersInSet:[NSCharacterSet whitespaceCharacterSet]];
}

tradeInValueForCommanderDictionary:

- (OOCreditsQuantity) tradeInValueForCommanderDictionary:

(NSDictionary*)

cmdr_dict

Definition at line 9471 of file Universe.m.

                                                        :(NSDictionary *)dict
{
    // get basic information about the craft
    OOCreditsQuantity   base_price = 0ULL;
    NSString            *ship_desc = [dict oo_stringForKey:@"ship_desc"];
    NSDictionary        *shipyard_info = [[OOShipRegistry sharedRegistry] shipyardInfoForKey:ship_desc];
    // This checks a rare, but possible case. If the ship for which we are trying to calculate a trade in value
    // does not have a shipyard dictionary entry, report it and set its base price to 0 -- Nikos 20090613.
    if (shipyard_info == nil)
    {
        OOLogERR(@"universe.tradeInValueForCommanderDictionary.valueCalculationError",
            @"Shipyard dictionary entry for ship %@ required for trade in value calculation, but does not exist. Setting ship value to 0.", ship_desc);
    }
    else
    {
        base_price = [shipyard_info oo_unsignedLongLongForKey:SHIPYARD_KEY_PRICE defaultValue:0ULL];
    }
    
    if(base_price == 0ULL) return base_price;
    
    OOCreditsQuantity   scrap_value = 351; // translates to 250 cr.
    
    OOWeaponType        ship_fwd_weapon = [OOEquipmentType equipmentTypeWithIdentifier:[dict oo_stringForKey:@"forward_weapon"]];
    OOWeaponType        ship_aft_weapon = [OOEquipmentType equipmentTypeWithIdentifier:[dict oo_stringForKey:@"aft_weapon"]];
    OOWeaponType        ship_port_weapon = [OOEquipmentType equipmentTypeWithIdentifier:[dict oo_stringForKey:@"port_weapon"]];
    OOWeaponType        ship_starboard_weapon = [OOEquipmentType equipmentTypeWithIdentifier:[dict oo_stringForKey:@"starboard_weapon"]];
    unsigned            ship_missiles = [dict oo_unsignedIntForKey:@"missiles"];
    unsigned            ship_max_passengers = [dict oo_unsignedIntForKey:@"max_passengers"];
    NSMutableArray      *ship_extra_equipment = [NSMutableArray arrayWithArray:[[dict oo_dictionaryForKey:@"extra_equipment"] allKeys]];
    
    NSDictionary        *basic_info = [shipyard_info oo_dictionaryForKey:KEY_STANDARD_EQUIPMENT];
    unsigned            base_missiles = [basic_info oo_unsignedIntForKey:KEY_EQUIPMENT_MISSILES];
    OOCreditsQuantity   base_missiles_value = base_missiles * [UNIVERSE getEquipmentPriceForKey:@"EQ_MISSILE"] / 10;
    NSString            *base_weapon_key = [basic_info oo_stringForKey:KEY_EQUIPMENT_FORWARD_WEAPON];
    OOCreditsQuantity   base_weapons_value = [UNIVERSE getEquipmentPriceForKey:base_weapon_key] / 10;
    NSMutableArray      *base_extra_equipment = [NSMutableArray arrayWithArray:[basic_info oo_arrayForKey:KEY_EQUIPMENT_EXTRAS]];
    NSString            *weapon_key = nil;
    
    // was aft_weapon defined as standard equipment ?
    base_weapon_key = [basic_info oo_stringForKey:KEY_EQUIPMENT_AFT_WEAPON defaultValue:nil];
    if (base_weapon_key != nil)
        base_weapons_value += [UNIVERSE getEquipmentPriceForKey:base_weapon_key] / 10;
    
    OOCreditsQuantity   ship_main_weapons_value = 0;
    OOCreditsQuantity   ship_other_weapons_value = 0;
    OOCreditsQuantity   ship_missiles_value = 0;
 
    // calculate the actual value for the missiles present on board.
    NSArray *missileRoles = [dict oo_arrayForKey:@"missile_roles"];
    if (missileRoles != nil)
    {
        unsigned i;
        for (i = 0; i < ship_missiles; i++)
        {
            NSString *missile_desc = [missileRoles oo_stringAtIndex:i];
            if (missile_desc != nil && ![missile_desc isEqualToString:@"NONE"])
            {
                ship_missiles_value += [UNIVERSE getEquipmentPriceForKey:missile_desc] / 10;
            }
        }
    }
    else
        ship_missiles_value = ship_missiles * [UNIVERSE getEquipmentPriceForKey:@"EQ_MISSILE"] / 10;
    
    // needs to be a signed value, we can then subtract from the base price, if less than standard equipment.
    long long extra_equipment_value = ship_max_passengers * [UNIVERSE getEquipmentPriceForKey:@"EQ_PASSENGER_BERTH"]/10;
    
    // add on missile values
    extra_equipment_value += ship_missiles_value - base_missiles_value;
    
    // work out weapon values
    if (ship_fwd_weapon)
    {
        weapon_key = OOEquipmentIdentifierFromWeaponType(ship_fwd_weapon);
        ship_main_weapons_value = [UNIVERSE getEquipmentPriceForKey:weapon_key] / 10;
    }
    if (ship_aft_weapon)
    {
        weapon_key = OOEquipmentIdentifierFromWeaponType(ship_aft_weapon);
        if (base_weapon_key != nil) // aft weapon was defined as a base weapon
        {
            ship_main_weapons_value += [UNIVERSE getEquipmentPriceForKey:weapon_key] / 10;  //take weapon downgrades into account
        }
        else
        {
            ship_other_weapons_value += [UNIVERSE getEquipmentPriceForKey:weapon_key] / 10;
        }
    }
    if (ship_port_weapon)
    {
        weapon_key = OOEquipmentIdentifierFromWeaponType(ship_port_weapon);
        ship_other_weapons_value += [UNIVERSE getEquipmentPriceForKey:weapon_key] / 10;
    }
    if (ship_starboard_weapon)
    {
        weapon_key = OOEquipmentIdentifierFromWeaponType(ship_starboard_weapon);
        ship_other_weapons_value += [UNIVERSE getEquipmentPriceForKey:weapon_key] / 10;
    }
    
    // add on extra weapons, take away the value of the base weapons
    extra_equipment_value += ship_other_weapons_value;
    extra_equipment_value += ship_main_weapons_value - base_weapons_value;
    
    NSInteger i;
    NSString *eq_key = nil;
    
    // shipyard.plist settings might have duplicate keys.
    // cull possible duplicates from inside base equipment
    for (i = [base_extra_equipment count]-1; i > 0;i--)
    {
        eq_key = [base_extra_equipment oo_stringAtIndex:i];
        if ([base_extra_equipment indexOfObject:eq_key inRange:NSMakeRange(0, i-1)] != NSNotFound)
                                [base_extra_equipment removeObjectAtIndex:i];
    }
    
    // do we at least have the same equipment as a standard ship? 
    for (i = [base_extra_equipment count]-1; i >= 0; i--)
    {
        eq_key = [base_extra_equipment oo_stringAtIndex:i];
        if ([ship_extra_equipment containsObject:eq_key])
                [ship_extra_equipment removeObject:eq_key];
        else // if the ship has less equipment than standard, deduct the missing equipent's price
                extra_equipment_value -= ([UNIVERSE getEquipmentPriceForKey:eq_key] / 10);
    }
    
    // remove portable equipment from the totals
    OOEquipmentType *item = nil;
    
    for (i = [ship_extra_equipment count]-1; i >= 0; i--)
    {
        eq_key = [ship_extra_equipment oo_stringAtIndex:i];
        item = [OOEquipmentType equipmentTypeWithIdentifier:eq_key];
        if ([item isPortableBetweenShips]) [ship_extra_equipment removeObjectAtIndex:i];
    }
    
    // add up what we've got left.
    for (i = [ship_extra_equipment count]-1; i >= 0; i--)
        extra_equipment_value += ([UNIVERSE getEquipmentPriceForKey:[ship_extra_equipment oo_stringAtIndex:i]] / 10);       
    
    // 10% discount for second hand value, steeper reduction if worse than standard.
    extra_equipment_value *= extra_equipment_value < 0 ? 1.4 : 0.9;
    
    // we'll return at least the scrap value
    // TODO: calculate scrap value based on the size of the ship.
    if ((long long)scrap_value > (long long)base_price + extra_equipment_value) return scrap_value;
    
    return base_price + extra_equipment_value;
}

unMagicMainStation

- (void) unMagicMainStation

Definition at line 3616 of file Universe.m.

{
    /*  During the demo screens, the player must remain docked in order for the
        UI to work. This means either enforcing invulnerability or launching
        the player when the station is destroyed even if on the "new game Y/N"
        screen.
        
        The latter is a) weirder and b) harder. If your OXP relies on being
        able to destroy the main station before the game has even started,
        your OXP sucks.
    */
    OOEntityStatus playerStatus = [PLAYER status];
    if (playerStatus == STATUS_START_GAME)  return;
    
    StationEntity *theStation = [self station];
    if (theStation != nil)  theStation->isExplicitlyNotMainStation = YES;
    cachedStation = nil;
}

update:

- (void) update:

(OOTimeDelta)

delta_t

Definition at line 6447 of file Universe.m.

               :(OOTimeDelta)inDeltaT
{
    volatile OOTimeDelta delta_t = inDeltaT * [self timeAccelerationFactor];
    NSUInteger sessionID = _sessionID;
    OOLog(@"universe.profile.update", @"%@", @"Begin update");
    if (EXPECT(!no_update))
    {
        next_repopulation -= delta_t;
        if (next_repopulation < 0)
        {
            [self repopulateSystem];
        }
 
        unsigned    i, ent_count = n_entities;
        Entity      *my_entities[ent_count];
        
        [self verifyEntitySessionIDs];
        
        // use a retained copy so this can't be changed under us.
        for (i = 0; i < ent_count; i++)
        {
            my_entities[i] = [sortedEntities[i] retain];    // explicitly retain each one
        }
        
        NSString * volatile update_stage = @"initialisation";
#ifndef NDEBUG
        id volatile update_stage_param = nil;
#endif
        
        @try
        {
            PlayerEntity *player = PLAYER;
            
            skyClearColor[0] = 0.0;
            skyClearColor[1] = 0.0;
            skyClearColor[2] = 0.0;
            skyClearColor[3] = 0.0;
            
            time_delta = delta_t;
            universal_time += delta_t;
            
            if (EXPECT_NOT([player showDemoShips] && [player guiScreen] == GUI_SCREEN_SHIPLIBRARY))
            {
                update_stage = @"demo management";
                
                if (universal_time >= demo_stage_time)
                {
                    if (ent_count > 1)
                    {
                        Vector      vel;
                        Quaternion  q2 = kIdentityQuaternion;
                        
                        quaternion_rotate_about_y(&q2,M_PI);
                        
                        switch (demo_stage)
                        {
                            case DEMO_FLY_IN:
                                [demo_ship setPosition:[demo_ship destination]];    // ideal position
                                demo_stage = DEMO_SHOW_THING;
                                demo_stage_time = universal_time + 300.0;
                                break;
                            case DEMO_SHOW_THING:
                                vel = make_vector(0, 0, DEMO2_VANISHING_DISTANCE * demo_ship->collision_radius * 6.0);
                                [demo_ship setVelocity:vel];
                                demo_stage = DEMO_FLY_OUT;
                                demo_stage_time = universal_time + 0.25;
                                break;
                            case DEMO_FLY_OUT:
                                // change the demo_ship here
                                [self removeEntity:demo_ship];
                                demo_ship = nil;
                                
/*                              NSString        *shipDesc = nil;
                                NSString        *shipName = nil;
                                NSDictionary    *shipDict = nil; */
                                
                                demo_ship_subindex = (demo_ship_subindex + 1) % [[demo_ships objectAtIndex:demo_ship_index] count];
                                demo_ship = [self newShipWithName:[[self demoShipData] oo_stringForKey:kOODemoShipKey] usePlayerProxy:NO];
                                
                                if (demo_ship != nil)
                                {
                                    [demo_ship removeEquipmentItem:@"EQ_SHIELD_BOOSTER"];
                                    [demo_ship removeEquipmentItem:@"EQ_SHIELD_ENHANCER"];
 
                                    [demo_ship switchAITo:@"nullAI.plist"];
                                    [demo_ship setOrientation:q2];
                                    [demo_ship setScanClass: CLASS_NO_DRAW];
                                    [demo_ship setStatus: STATUS_COCKPIT_DISPLAY]; // prevents it getting escorts on addition
                                    [demo_ship setDemoShip: 1.0f];
                                    [demo_ship setDemoStartTime: universal_time];
                                    if ([self addEntity:demo_ship])
                                    {
                                        [demo_ship release];        // We now own a reference through the entity list.
                                        [demo_ship setStatus:STATUS_COCKPIT_DISPLAY];
                                        demo_start_z=DEMO2_VANISHING_DISTANCE * demo_ship->collision_radius;
                                        [demo_ship setPositionX:0.0f y:0.0f z:demo_start_z];
                                        [demo_ship setDestination: make_HPvector(0.0f, 0.0f, demo_start_z * 0.01f)];    // ideal position
                                        [demo_ship setVelocity:kZeroVector];
                                        [demo_ship setScanClass: CLASS_NO_DRAW];
//                                      [gui setText:shipName != nil ? shipName : [demo_ship displayName] forRow:19 align:GUI_ALIGN_CENTER];
                                        
                                        [self setLibraryTextForDemoShip];
 
                                        demo_stage = DEMO_FLY_IN;
                                        demo_start_time=universal_time;
                                        demo_stage_time = demo_start_time + DEMO2_FLY_IN_STAGE_TIME;
                                    }
                                    else
                                    {
                                        demo_ship = nil;
                                    }
                                }
                                break;
                        }
                    }
                }
                else if (demo_stage == DEMO_FLY_IN)
                {
                    GLfloat delta = (universal_time - demo_start_time) / DEMO2_FLY_IN_STAGE_TIME;
                    [demo_ship setPositionX:0.0f y:[demo_ship destination].y * delta z:demo_start_z + ([demo_ship destination].z - demo_start_z) * delta ];
                }
            }
            
            update_stage = @"update:entity";
            NSMutableSet *zombies = nil;
            OOLog(@"universe.profile.update", @"%@", update_stage);
            for (i = 0; i < ent_count; i++)
            {
                Entity *thing = my_entities[i];
#ifndef NDEBUG
                update_stage_param = thing;
                update_stage = @"update:entity [%@]";
#endif
                // Game Over code depends on regular delta_t updates to the dead player entity. Ignore the player entity, even when dead.
                if (EXPECT_NOT([thing status] == STATUS_DEAD && ![entitiesDeadThisUpdate containsObject:thing] && ![thing isPlayer]))
                {
                    if (zombies == nil)  zombies = [NSMutableSet set];
                    [zombies addObject:thing];
                    continue;
                }
                
                [thing update:delta_t];
                if (EXPECT_NOT(sessionID != _sessionID))
                {
                    // Game was reset (in player update); end this update: cycle.
                    break;
                }
                
#ifndef NDEBUG
                update_stage = @"update:list maintenance [%@]";
#endif
                
                // maintain distance-from-player list
                GLfloat z_distance = thing->zero_distance;
                
                int index = thing->zero_index;
                while (index > 0 && z_distance < sortedEntities[index - 1]->zero_distance)
                {
                    sortedEntities[index] = sortedEntities[index - 1];  // bubble up the list, usually by just one position
                    sortedEntities[index - 1] = thing;
                    thing->zero_index = index - 1;
                    sortedEntities[index]->zero_index = index;
                    index--;
                }
                
                // update deterministic AI
                if ([thing isShip])
                {
#ifndef NDEBUG
                    update_stage = @"update:think [%@]";
#endif
                    AI* theShipsAI = [(ShipEntity *)thing getAI];
                    if (theShipsAI)
                    {
                        double thinkTime = [theShipsAI nextThinkTime];
                        if ((universal_time > thinkTime)||(thinkTime == 0.0))
                        {
                            [theShipsAI setNextThinkTime:universal_time + [theShipsAI thinkTimeInterval]];
                            [theShipsAI think];
                        }
                    }
                }
            }
#ifndef NDEBUG
        update_stage_param = nil;
#endif
            
            if (zombies != nil)
            {
                update_stage = @"shootin' zombies";
                NSEnumerator *zombieEnum = nil;
                Entity *zombie = nil;
                for (zombieEnum = [zombies objectEnumerator]; (zombie = [zombieEnum nextObject]); )
                {
                    OOLogERR(@"universe.zombie", @"Found dead entity %@ in active entity list, removing. This is an internal error, please report it.", zombie);
                    [self removeEntity:zombie];
                }
            }
            
            // Maintain x/y/z order lists
            update_stage = @"updating linked lists";
            OOLog(@"universe.profile.update", @"%@", update_stage);
            for (i = 0; i < ent_count; i++)
            {
                [my_entities[i] updateLinkedLists];
            }
            
            // detect collisions and light ships that can see the sun
            
            update_stage = @"collision and shadow detection";
            OOLog(@"universe.profile.update", @"%@", update_stage);
            [self filterSortedLists];
            [self findCollisionsAndShadows];
            
            // do any required check and maintenance of linked lists
            
            if (doLinkedListMaintenanceThisUpdate)
            {
                MaintainLinkedLists(self);
                doLinkedListMaintenanceThisUpdate = NO;
            }
        }
        @catch (NSException *exception)
        {
            if ([[exception name] hasPrefix:@"Oolite"])
            {
                [self handleOoliteException:exception];
            }
            else
            {
#ifndef NDEBUG
                if (update_stage_param != nil)  update_stage = [NSString stringWithFormat:update_stage, update_stage_param];
#endif
                OOLog(kOOLogException, @"***** Exception during [%@] in [Universe update:] : %@ : %@ *****", update_stage, [exception name], [exception reason]);
                @throw exception;
            }
        }
        
        // dispose of the non-mutable copy and everything it references neatly
        update_stage = @"clean up";
        OOLog(@"universe.profile.update", @"%@", update_stage);
        for (i = 0; i < ent_count; i++)
        {
            [my_entities[i] release];   // explicitly release each one
        }
        /* Garbage collection is going to result in a significant
         * pause when it happens. Doing it here is better than doing
         * it in the middle of the update when it might slow a
         * function into the timelimiter through no fault of its
         * own. JS_MaybeGC will only run a GC when it's
         * necessary. Merely checking is not significant in terms of
         * time. - CIM: 4/8/2013
         */
        update_stage = @"JS Garbage Collection";
        OOLog(@"universe.profile.update", @"%@", update_stage); 
#ifndef NDEBUG
        JSContext *context = OOJSAcquireContext(); 
        uint32 gcbytes1 = JS_GetGCParameter(JS_GetRuntime(context),JSGC_BYTES);
        OOJSRelinquishContext(context);
#endif
        [[OOJavaScriptEngine sharedEngine] garbageCollectionOpportunity:NO];
#ifndef NDEBUG
        context = OOJSAcquireContext(); 
        uint32 gcbytes2 = JS_GetGCParameter(JS_GetRuntime(context),JSGC_BYTES);
        OOJSRelinquishContext(context);
        if (gcbytes2 < gcbytes1)
        {
            OOLog(@"universe.profile.jsgc",@"Unplanned JS Garbage Collection from %d to %d",gcbytes1,gcbytes2);
        }
#endif
 
 
    }
    else
    {
        // always perform player's dead updates: allows deferred JS resets.
        if ([PLAYER status] == STATUS_DEAD)  [PLAYER update:delta_t];
    }
    
    [entitiesDeadThisUpdate autorelease];
    entitiesDeadThisUpdate = nil;
    entitiesDeadThisUpdate = [[NSMutableSet alloc] initWithCapacity:n_entities];
    
#if NEW_PLANETS
    [self prunePreloadingPlanetMaterials];
#endif
 
    OOLog(@"universe.profile.update", @"%@", @"Update complete");
}

useAddOns

- (NSString *) useAddOns

useGUILightSource:

- (void) useGUILightSource:

(BOOL)

GUILight

Definition at line 3616 of file Universe.m.

                          :(BOOL)GUILight
{
    if (GUILight != demo_light_on)
    {
        if (![self useShaders])
        {
            if (GUILight) 
            {
                OOGL(glEnable(GL_LIGHT0));
                OOGL(glDisable(GL_LIGHT1));
            }
            else
            {
                OOGL(glEnable(GL_LIGHT1));
                OOGL(glDisable(GL_LIGHT0));
            }
        }
        // There should be nothing to do for shaders, they use the same (always on) light source
        // both in flight & in gui mode. According to the standard, shaders should treat lights as
        // always enabled. At least one non-standard shader implementation (windows' X3100 Intel
        // core with GM965 chipset and version 6.14.10.4990 driver) does _not_ use glDisabled lights,
        // making the following line necessary.
        
        else OOGL(glEnable(GL_LIGHT1)); // make sure we have a light, even with shaders (!)
        
        demo_light_on = GUILight;
    }
}

useShaders

- (BOOL) useShaders

Definition at line 9471 of file Universe.m.

{
    return detailLevel >= DETAIL_LEVEL_SHADERS;
}

VerifyDesc

+ (static void) VerifyDesc (NSString *) key (id) desc

implementation

Definition at line 7996 of file Universe.m.

{
    if ([desc isKindOfClass:[NSString class]])
    {
        VerifyDescString(key, desc);
    }
    else if ([desc isKindOfClass:[NSArray class]])
    {
        VerifyDescArray(key, desc);
    }
    else if ([desc isKindOfClass:[NSNumber class]])
    {
        // No verification needed.
    }
    else
    {
        OOLogERR(@"descriptions.verify.badType", @"***** FATAL: descriptions.plist entry for \"%@\" is neither a string nor an array.", key);
        exit(EXIT_FAILURE);
    }
}

VerifyDescArray

+ (static void) VerifyDescArray (NSString *) key (NSArray *) desc

implementation

Definition at line 7986 of file Universe.m.

{
    id subDesc = nil;
    foreach (subDesc, desc)
    {
        VerifyDesc(key, subDesc);
    }
}

References nil.

verifyDescriptions

- (void) verifyDescriptions

implementation

Provided by category Universe(OOPrivate).

Definition at line 7996 of file Universe.m.

{
    /*
        Ensure that no descriptions.plist entries contain the %n format code,
        which can be used to smash the stack and potentially call arbitrary
        functions.
        
        %n is deliberately not supported in Foundation/CoreFoundation under
        Mac OS X, but unfortunately GNUstep implements it.
        -- Ahruman 2011-05-05
    */
    
    NSString *key = nil;
    if (_descriptions == nil)
    {
        OOLog(@"descriptions.verify", @"%@", @"***** FATAL: Tried to verify descriptions, but descriptions was nil - unable to load any descriptions.plist file.");
        exit(EXIT_FAILURE);
    }
    foreachkey (key, _descriptions)
    {
        VerifyDesc(key, [_descriptions objectForKey:key]);
    }
}

VerifyDescString

+ (static void) VerifyDescString (NSString *) key (NSString *) desc

implementation

Definition at line 7976 of file Universe.m.

{
    if ([desc rangeOfString:@"%n"].location != NSNotFound)
    {
        OOLog(@"descriptions.verify.percentN", @"***** FATAL: descriptions.plist entry \"%@\" contains the dangerous control sequence %%n.", key);
        exit(EXIT_FAILURE);
    }
}

References OOLog.

verifyEntitySessionIDs

- (void) verifyEntitySessionIDs

implementation

Provided by category Universe(OOPrivate).

Definition at line 9471 of file Universe.m.

{
#ifndef NDEBUG
    NSMutableArray *badEntities = nil;
    Entity *entity = nil;
    
    unsigned i;
    for (i = 0; i < n_entities; i++)
    {
        entity = sortedEntities[i];
        if ([entity sessionID] != _sessionID)
        {
            OOLogERR(@"universe.sessionIDs.verify.failed", @"Invalid entity %@ (came from session %lu, current session is %lu).", [entity shortDescription], [entity sessionID], _sessionID);
            if (badEntities == nil)  badEntities = [NSMutableArray array];
            [badEntities addObject:entity];
        }
    }
    
    foreach (entity, badEntities)
    {
        [self removeEntity:entity];
    }
#endif
}

viewDirection

- (OOViewID) viewDirection

viewFrustumIntersectsSphereAt:withRadius:

- (BOOL) viewFrustumIntersectsSphereAt:		(Vector)	position
withRadius:		(GLfloat)	radius

Definition at line 4630 of file Universe.m.

                                      :(Vector)position withRadius:(GLfloat)radius
{
    // position is the relative position between the camera and the object
    int p;
    for (p = 0; p < 6; p++)
    {
        if (frustum[p][0] * position.x + frustum[p][1] * position.y + frustum[p][2] * position.z + frustum[p][3] <= -radius)
        {
            return NO;
        }
    }
    return YES;
}

viewMatrix

- (OOMatrix) viewMatrix

wireframeGraphics

- (BOOL) wireframeGraphics

witchspaceBreakPattern

- (BOOL) witchspaceBreakPattern

Definition at line 273 of file Universe.m.

{
    return _witchspaceBreakPattern;
}

witchspaceShipWithPrimaryRole:

- (void) witchspaceShipWithPrimaryRole:

(NSString *)

role

Definition at line 273 of file Universe.m.

                                      :(NSString *)role
{
    // adds a ship exiting witchspace (corollary of when ships leave the system)
    ShipEntity          *ship = nil;
    NSDictionary        *systeminfo = nil;
    OOGovernmentID      government;
    
    systeminfo = [self currentSystemData];
    government = [systeminfo oo_unsignedCharForKey:KEY_GOVERNMENT];
    
    ship = [self newShipWithRole:role];   // retain count = 1
    
    // Deal with scripted cargopods and ensure they are filled with something.
    if (ship && [ship hasRole:@"cargopod"])
    {       
        [self fillCargopodWithRandomCargo:ship];
    }
    
    if (ship)
    {
        if (([ship scanClass] == CLASS_NO_DRAW)||([ship scanClass] == CLASS_NOT_SET))
            [ship setScanClass: CLASS_NEUTRAL];
        if ([role isEqual:@"trader"])
        {
            [ship setCargoFlag: CARGO_FLAG_FULL_SCARCE];
            if ([ship hasRole:@"sunskim-trader"] && randf() < 0.25) // select 1/4 of the traders suitable for sunskimming.
            {
                [ship setCargoFlag: CARGO_FLAG_FULL_PLENTIFUL];
                [self makeSunSkimmer:ship andSetAI:YES];
            }
            else
            {
                [ship switchAITo:@"oolite-traderAI.js"];
            }
            
            if (([ship pendingEscortCount] > 0)&&((Ranrot() % 7) < government)) // remove escorts if we feel safe
            {
                int nx = [ship pendingEscortCount] - 2 * (1 + (Ranrot() & 3));  // remove 2,4,6, or 8 escorts
                [ship setPendingEscortCount:(nx > 0) ? nx : 0];
            }
        }
        if ([role isEqual:@"pirate"])
        {
            [ship setCargoFlag: CARGO_FLAG_PIRATE];
            [ship setBounty: (Ranrot() & 7) + (Ranrot() & 7) + ((randf() < 0.05)? 63 : 23) withReason:kOOLegalStatusReasonSetup];   // they already have a price on their heads
        }
        if ([ship crew] == nil && ![ship isUnpiloted])
            [ship setCrew:[NSArray arrayWithObject:
                [OOCharacter randomCharacterWithRole:role
                andOriginalSystem: Ranrot() & 255]]];
        // The following is set inside leaveWitchspace: AI state GLOBAL, STATUS_EXITING_WITCHSPACE, ai message: EXITED_WITCHSPACE, then STATUS_IN_FLIGHT
        [ship leaveWitchspace];
        [ship release];
    }
}

wormholes

- (NSArray *) wormholes

Definition at line 3616 of file Universe.m.

{
    return activeWormholes;
}

Member Data Documentation

_autoCommLog

- (BOOL) _autoCommLog

private

Definition at line 349 of file Universe.h.

_autoMessageLogBg

- (BOOL) _autoMessageLogBg

private

Definition at line 351 of file Universe.h.

_bloom

- (BOOL) _bloom

private

Definition at line 373 of file Universe.h.

_colorblindMode

- (int) _colorblindMode

private

Definition at line 375 of file Universe.h.

_currentPostFX

- (int) _currentPostFX

private

Definition at line 374 of file Universe.h.

_descriptions

- (NSDictionary*) _descriptions

private

Definition at line 266 of file Universe.h.

_dockingClearanceProtocolActive

- (BOOL) _dockingClearanceProtocolActive

private

Definition at line 354 of file Universe.h.

_doingStartUp

- (BOOL) _doingStartUp

private

Definition at line 355 of file Universe.h.

_firstBeacon

- (OOWeakReference*) _firstBeacon

private

Definition at line 220 of file Universe.h.

_lastBeacon

- (OOWeakReference *) _lastBeacon

private

Definition at line 221 of file Universe.h.

_pauseMessage

- (BOOL) _pauseMessage

private

Definition at line 348 of file Universe.h.

_permanentCommLog

- (BOOL) _permanentCommLog

private

Definition at line 350 of file Universe.h.

_permanentMessageLog

- (BOOL) _permanentMessageLog

private

Definition at line 352 of file Universe.h.

_scenarios

- (NSArray*) _scenarios

private

Definition at line 269 of file Universe.h.

_sessionID

- (NSUInteger) _sessionID

private

Definition at line 201 of file Universe.h.

_witchspaceBreakPattern

- (BOOL) _witchspaceBreakPattern

private

Definition at line 353 of file Universe.h.

activeWormholes

- (NSMutableArray*) activeWormholes

private

Definition at line 317 of file Universe.h.

airResistanceFactor

- (GLfloat) airResistanceFactor

private

Definition at line 211 of file Universe.h.

allPlanets

- (NSMutableArray*) allPlanets

private

Definition at line 297 of file Universe.h.

allStations

- (NSMutableSet*) allStations

private

Definition at line 298 of file Universe.h.

ambientLightLevel

- (float) ambientLightLevel

private

Definition at line 300 of file Universe.h.

autoAIMap

- (NSDictionary*) autoAIMap

private

Definition at line 277 of file Universe.h.

autoSave

- (BOOL) autoSave

private

Definition at line 238 of file Universe.h.

autoSaveNow

- (BOOL) autoSaveNow

private

Definition at line 237 of file Universe.h.

blurProgram

- (OOShaderProgram*) blurProgram

private

Definition at line 367 of file Universe.h.

breakPatternCounter

- (int) breakPatternCounter

private

Definition at line 290 of file Universe.h.

cachedPlanet

- (OOPlanetEntity*) cachedPlanet

private

Definition at line 295 of file Universe.h.

cachedStation

- (StationEntity*) cachedStation

private

Definition at line 294 of file Universe.h.

cachedSun

- (OOSunEntity*) cachedSun

private

Definition at line 296 of file Universe.h.

cargoPods

- (NSDictionary*) cargoPods

private

Definition at line 281 of file Universe.h.

characterPool

- (NSMutableArray*) characterPool

private

Definition at line 319 of file Universe.h.

characters

- (NSDictionary *) characters

private

Definition at line 268 of file Universe.h.

closeSystems

- (NSArray*) closeSystems

private

Definition at line 307 of file Universe.h.

comm_log_gui

- (GuiDisplayGen*) comm_log_gui

private

Definition at line 232 of file Universe.h.

commodities

- (OOCommodities *) commodities

private

Definition at line 262 of file Universe.h.

commodityMarket

- (OOCommodityMarket *) commodityMarket

private

Definition at line 263 of file Universe.h.

conditionScripts

- (NSMutableDictionary*) conditionScripts

private

Definition at line 346 of file Universe.h.

countdown_messageRepeatTime

- (OOTimeAbsolute) countdown_messageRepeatTime

private

Definition at line 228 of file Universe.h.

currentMessage

- (NSString*) currentMessage

private

Definition at line 226 of file Universe.h.

cursor_row

- (int) cursor_row

Definition at line 193 of file Universe.h.

customSounds

- (NSDictionary*) customSounds

private

Definition at line 267 of file Universe.h.

defaultDrawFBO

- (GLint) defaultDrawFBO

private

Definition at line 370 of file Universe.h.

demo_ship

- (ShipEntity*) demo_ship

private

Definition at line 292 of file Universe.h.

demo_ship_index

- (NSUInteger) demo_ship_index

private

Definition at line 254 of file Universe.h.

demo_ship_subindex

- (NSUInteger) demo_ship_subindex

private

Definition at line 255 of file Universe.h.

demo_ships

- (NSArray*) demo_ships

private

Definition at line 256 of file Universe.h.

demo_stage

- (int) demo_stage

private

Definition at line 253 of file Universe.h.

demo_stage_time

- (OOTimeAbsolute) demo_stage_time

private

Definition at line 250 of file Universe.h.

demo_start_time

- (OOTimeAbsolute) demo_start_time

private

Definition at line 251 of file Universe.h.

demo_start_z

- (GLfloat) demo_start_z

private

Definition at line 252 of file Universe.h.

detailLevel

- (OOGraphicsDetail) detailLevel

private

Definition at line 240 of file Universe.h.

deterministic_population

- (BOOL) deterministic_population

private

Definition at line 305 of file Universe.h.

displayFPS

- (BOOL) displayFPS

private

Definition at line 245 of file Universe.h.

displayGUI

- (BOOL) displayGUI

private

Definition at line 234 of file Universe.h.

doLinkedListMaintenanceThisUpdate

- (BOOL) doLinkedListMaintenanceThisUpdate

private

Definition at line 324 of file Universe.h.

doProcedurallyTexturedPlanets

- (BOOL) doProcedurallyTexturedPlanets

private

Definition at line 342 of file Universe.h.

dumpCollisionInfo

- (BOOL) dumpCollisionInfo

private

Definition at line 260 of file Universe.h.

entities

- (NSMutableArray*) entities

private

Definition at line 218 of file Universe.h.

Referenced by addEntity:.

entitiesDeadThisUpdate

- (NSMutableSet*) entitiesDeadThisUpdate

private

Definition at line 326 of file Universe.h.

entity_for_uid

- (Entity* entity_for_uid[MAX_ENTITY_UID])

private

Definition at line 216 of file Universe.h.

equipmentData

- (NSArray *) equipmentData

private

Definition at line 273 of file Universe.h.

equipmentDataOutfitting

- (NSArray *) equipmentDataOutfitting

private

Definition at line 274 of file Universe.h.

explosionSettings

- (NSDictionary*) explosionSettings

private

Definition at line 279 of file Universe.h.

finalProgram

- (OOShaderProgram*) finalProgram

private

Definition at line 368 of file Universe.h.

framesDoneThisUpdate

- (int) framesDoneThisUpdate

private

Definition at line 327 of file Universe.h.

frustum

- (GLfloat frustum[6][4])

private

Definition at line 344 of file Universe.h.

galaxyID

- (OOGalaxyID) galaxyID

private

Definition at line 283 of file Universe.h.

gameView

- (MyOpenGLView *) gameView

private

Definition at line 213 of file Universe.h.

globalSettings

- (NSDictionary *) globalSettings

private

Definition at line 270 of file Universe.h.

gui

- (GuiDisplayGen *) gui

private

Definition at line 230 of file Universe.h.

main_light_position

- (GLfloat main_light_position[4])

private

Definition at line 258 of file Universe.h.

message_gui

- (GuiDisplayGen*) message_gui

private

Definition at line 231 of file Universe.h.

messageRepeatTime

- (OOTimeAbsolute) messageRepeatTime

private

Definition at line 227 of file Universe.h.

missiontext

- (NSDictionary *) missiontext

private

Definition at line 272 of file Universe.h.

msaaDepthBufferID

- (GLuint) msaaDepthBufferID

private

Definition at line 362 of file Universe.h.

msaaFramebufferID

- (GLuint) msaaFramebufferID

private

Definition at line 361 of file Universe.h.

msaaTextureID

- (GLuint) msaaTextureID

private

Definition at line 357 of file Universe.h.

n_entities

- (unsigned) n_entities

Definition at line 191 of file Universe.h.

Referenced by addEntity:.

next_repopulation

- (OOTimeDelta) next_repopulation

private

Definition at line 303 of file Universe.h.

next_universal_id

- (int) next_universal_id

private

Definition at line 215 of file Universe.h.

no_update

- (BOOL) no_update

private

Definition at line 311 of file Universe.h.

passthroughFramebufferID

- (GLuint) passthroughFramebufferID

private

Definition at line 365 of file Universe.h.

passthroughTextureID

- (GLuint passthroughTextureID[2])

private

Definition at line 359 of file Universe.h.

pingpongColorbuffers

- (GLuint pingpongColorbuffers[2])

private

Definition at line 372 of file Universe.h.

pingpongFBO

- (GLuint pingpongFBO[2])

private

Definition at line 371 of file Universe.h.

populatorSettings

- (NSMutableDictionary*) populatorSettings

private

Definition at line 302 of file Universe.h.

quadTextureEBO

- (GLuint) quadTextureEBO

private

Definition at line 369 of file Universe.h.

quadTextureVAO

- (GLuint) quadTextureVAO

private

Definition at line 369 of file Universe.h.

quadTextureVBO

- (GLuint) quadTextureVBO

private

Definition at line 369 of file Universe.h.

roleCategories

- (NSDictionary*) roleCategories

private

Definition at line 276 of file Universe.h.

screenBackgrounds

- (NSDictionary*) screenBackgrounds

private

Definition at line 278 of file Universe.h.

skyClearColor

- (GLfloat *) skyClearColor

private

Definition at line 224 of file Universe.h.

sortedEntities

- (Entity* sortedEntities[UNIVERSE_MAX_ENTITIES+1])

Definition at line 190 of file Universe.h.

speechArray

- (NSArray*) speechArray

private

Definition at line 336 of file Universe.h.

speechSynthesizer

- (NSSpeechSynthesizer*) speechSynthesizer

private

Definition at line 331 of file Universe.h.

stars_ambient

- (GLfloat stars_ambient[4])

Definition at line 198 of file Universe.h.

sun_diffuse

- (GLfloat sun_diffuse[4])

private

Definition at line 204 of file Universe.h.

sun_specular

- (GLfloat sun_specular[4])

private

Definition at line 205 of file Universe.h.

system_found

- (BOOL system_found[256])

private

Definition at line 288 of file Universe.h.

system_names

- (NSString* system_names[256])

private

Definition at line 287 of file Universe.h.

system_repopulator

- (NSString*) system_repopulator

private

Definition at line 304 of file Universe.h.

systemID

- (OOSystemID) systemID

private

Definition at line 284 of file Universe.h.

systemManager

- (OOSystemDescriptionManager *) systemManager

private

Definition at line 271 of file Universe.h.

targetDepthBufferID

- (GLuint) targetDepthBufferID

private

Definition at line 363 of file Universe.h.

targetFramebufferID

- (GLuint) targetFramebufferID

private

Definition at line 364 of file Universe.h.

targetFramebufferSize

- (NSSize) targetFramebufferSize

private

Definition at line 360 of file Universe.h.

targetSystemID

- (OOSystemID) targetSystemID

private

Definition at line 285 of file Universe.h.

targetTextureID

- (GLuint) targetTextureID

private

Definition at line 358 of file Universe.h.

textureProgram

- (OOShaderProgram*) textureProgram

private

Definition at line 366 of file Universe.h.

time_delta

- (OOTimeDelta) time_delta

private

Definition at line 248 of file Universe.h.

timeAccelerationFactor

- (double) timeAccelerationFactor

private

Definition at line 314 of file Universe.h.

universal_time

- (OOTimeAbsolute) universal_time

private

Definition at line 247 of file Universe.h.

universeRegion

- (CollisionRegion*) universeRegion

private

Definition at line 321 of file Universe.h.

useAddOns

- (NSString *) useAddOns

private

Definition at line 309 of file Universe.h.

viewDirection

- (OOViewID) viewDirection

private

Definition at line 207 of file Universe.h.

viewMatrix

- (OOMatrix) viewMatrix

private

Definition at line 209 of file Universe.h.

wasDisplayGUI

- (BOOL) wasDisplayGUI

private

Definition at line 235 of file Universe.h.

waypoints

- (NSMutableDictionary*) waypoints

private

Definition at line 222 of file Universe.h.

wireframeGraphics

- (BOOL) wireframeGraphics

private

Definition at line 239 of file Universe.h.

x_list_start

- (Entity*) x_list_start

Definition at line 196 of file Universe.h.

Referenced by addEntity:.

y_list_start

- (Entity *) y_list_start

Definition at line 196 of file Universe.h.

Referenced by addEntity:.

z_list_start

- (Entity *) z_list_start

Definition at line 196 of file Universe.h.

Referenced by addEntity:.

---

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

• src/Core/Universe.h
• src/Core/Universe.m