#include <Universe.h>

Inheritance diagram for Universe:

Collaboration diagram for Universe:

Instance Methods
(BOOL)	- bloom

(void)	- setBloom:

(int)	- currentPostFX

(void)	- setCurrentPostFX:

(void)	- terminatePostFX:

(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:

(BOOL)	- ECMVisualFXEnabled

(void)	- setECMVisualFXEnabled:

(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

BOOL	ECMVisualFXEnabled

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 187 of file Universe.h.

Method Documentation

◆ activeViewMatrix

- (OOMatrix) activeViewMatrix

implementation

Definition at line 4696 of file Universe.m.

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

References activeViewMatrix, and getActiveViewMatrix:forwardVector:upVector:.

Referenced by activeViewMatrix.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ addCommsMessage:forCount:

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

Definition at line 7005 of file Universe.m.

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

References addCommsMessage:forCount:andShowComms:logOnly:.

Here is the call graph for this function:

◆ addCommsMessage:forCount:andShowComms:logOnly:

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

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

References PlayerEntity::commLog, currentMessage, messageRepeatTime, OOExpand, OOExpandKey, OOSPEECHSETTINGS_COMMS, PLAYER, GuiDisplayGen::printLongText:align:color:fadeTime:key:addToArray:, showCommsLog:, showGUIMessage:withScroll:andColor:overDuration:, speakWithSubstitutions:, GuiDisplayGen::textCommsColor, and universal_time.

Referenced by addCommsMessage:forCount:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ addConditionScripts:

- (void) addConditionScripts: (NSEnumerator *) scripts

Definition at line 11028 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 conditionScripts, OOScript::jsScriptFromFileNamed:properties:, and nil.

Referenced by loadConditionScripts.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ addDelayedMessage:

- (void) addDelayedMessage: (NSDictionary *) textdict

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

References addMessage:forCount:, and nil.

Here is the call graph for this function:

◆ addDelayedMessage:forCount:afterDelay:

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

Definition at line 6906 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 5514 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 currentSystemData, debugDumpEntities, doLinkedListMaintenanceThisUpdate, entities, entity_for_uid, ShipEntity::getAI, Entity::isExplicitlyNotMainStation, MAX_ENTITY_UID, MIN_ENTITY_UID, n_entities, next_universal_id, nil, NO_TARGET, OODoubleFromObject(), OOLog, OOLogWillDisplayMessagesInClass(), planet, PLAYER, setNextBeacon:, AI::setOwner:, StationEntity::setPlanet:, ShipEntity::setRoll:, AI::setState:, ShipEntity::setStatus:, ShipEntity::shipInfoDictionary, sortedEntities, and UNIVERSE_MAX_ENTITIES.

Referenced by addLaserHitEffectsAt:against:damage:color:, addShipAt:withRole:withinRadius:, addShipWithRole:launchPos:rfactor:, addVisualEffectAt:withKey:, addWitchspaceJumpEffectForShip:, defineWaypoint:forKey:, initWithGameView:, reinitAndShowDemo:, setUpBreakPattern:orientation:forDocking:, setupIntroFirstGo:, setUpPlanet, setUpSpace, setUpUniverseFromMisjump, setUpUniverseFromWitchspace, setUpWitchspaceBetweenSystem:andSystem:, and spawnShip:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ addLaserHitEffectsAt:against:damage:color:

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

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

References addEntity:, addWreckageFrom:withRole:at:scale:lifetime:, OOExplosionCloudEntity::explosionCloudFromEntity:withSettings:, OOFlashEffectEntity::laserFlashWithPosition:velocity:color:, randf(), Entity::setPosition:, Entity::setVelocity:, and ShipEntity::velocity.

Here is the call graph for this function:

◆ addMessage:forCount:

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

Definition at line 6928 of file Universe.m.

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

References addMessage:forCount:forceDisplay:.

Referenced by addDelayedMessage:, handleOoliteException:, pauseGame, and setViewDirection:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ addMessage:forCount:forceDisplay:

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

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

References currentMessage, messageRepeatTime, OOSPEECHSETTINGS_ALL, PLAYER, showGUIMessage:withScroll:andColor:overDuration:, speakWithSubstitutions:, GuiDisplayGen::textColor, and universal_time.

Referenced by addMessage:forCount:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ 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 10916 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];
    }
}

References nil.

◆ addShipAt:withRole:withinRadius:

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

Definition at line 2783 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 addEntity:, coordinatesForPosition:withCoordinateSystem:returningScalar:, currentSystemData, fillCargopodWithRandomCargo:, getWitchspaceExitPosition, makeSunSkimmer:andSetAI:, newShipWithRole:, nil, OOHPVectorRandomSpatial(), OOJS_PROFILE_ENTER, OOJS_PROFILE_EXIT, ShipEntity::pendingEscortCount, randf(), OOCharacter::randomCharacterWithRole:andOriginalSystem:, Ranrot(), ShipEntity::scanClass, SCANNER_MAX_RANGE, ShipEntity::setBounty:withReason:, ShipEntity::setCargoFlag:, ShipEntity::setCrew:, Entity::setOrientation:, Entity::setPosition:, Entity::setScanClass:, ShipEntity::switchAITo:, and ShipEntity::witchspaceLeavingEffects.

Referenced by addShipsAt:withRole:quantity:withinRadius:asGroup:, and addShipsToRoute:withRole:quantity:routeFraction:asGroup:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ addShips:withRole:atPosition:withCoordinateSystem:

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

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

References addShipWithRole:launchPos:rfactor:, Entity::collision_radius, coordinatesForPosition:withCoordinateSystem:returningScalar:, kZeroHPVector, nil, quaternion_set_random(), randf(), SAFE_ADDITION_FACTOR2, ShipEntity::scanClass, Entity::setOrientation:, Entity::setPosition:, and Entity::setScanClass:.

Here is the call graph for this function:

◆ addShips:withRole:intoBoundingBox:

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

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

References nil, and randf().

Referenced by addShips:withRole:nearPosition:withCoordinateSystem:, and addShips:withRole:nearPosition:withCoordinateSystem:withinRadius:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ addShips:withRole:nearPosition:withCoordinateSystem:

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

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

References addShips:withRole:intoBoundingBox:, coordinatesForPosition:withCoordinateSystem:returningScalar:, and SCANNER_MAX_RANGE.

Here is the call graph for this function:

◆ addShips:withRole:nearPosition:withCoordinateSystem:withinRadius:

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

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

References addShips:withRole:intoBoundingBox:, and coordinatesForPosition:withCoordinateSystem:returningScalar:.

Here is the call graph for this function:

◆ addShipsAt:withRole:quantity:withinRadius:asGroup:

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

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

References addShipAt:withRole:withinRadius:, count, OOShipGroup::groupWithName:, nil, OOJS_PROFILE_ENTER, OOJS_PROFILE_EXIT, and ShipEntity::setGroup:.

Referenced by addShipsToRoute:withRole:quantity:routeFraction:asGroup:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ addShipsToRoute:withRole:quantity:routeFraction:asGroup:

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

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

References addShipAt:withRole:withinRadius:, addShipsAt:withRole:quantity:withinRadius:asGroup:, Entity::collisionRadius, count, fractionalPositionFrom:to:withFraction:, getWitchspaceExitPosition, kZeroHPVector, nil, planet, Entity::position, SCANNER_MAX_RANGE, station, and sun.

Here is the call graph for this function:

◆ addShipWithRole:launchPos:rfactor:

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

implementation

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

References addEntity:, fillCargopodWithRandomCargo:, newShipWithRole:, nil, randf(), OOCharacter::randomCharacterWithRole:andOriginalSystem:, ShipEntity::setCrew:, Entity::setPosition:, and Entity::setScanClass:.

Referenced by addShips:withRole:atPosition:withCoordinateSystem:, addShipWithRole:nearRouteOneAt:, and spawnShipWithRole:near:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ addShipWithRole:nearPosition:withCoordinateSystem:

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

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

References coordinatesForPosition:withCoordinateSystem:returningScalar:, nil, and SCANNER_MAX_RANGE.

Here is the call graph for this function:

◆ addShipWithRole:nearRouteOneAt:

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

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

References addShipWithRole:launchPos:rfactor:, getWitchspaceExitPosition, and station.

Here is the call graph for this function:

◆ addVisualEffectAt:withKey:

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

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

References addEntity:, newVisualEffectWithName:, nil, OOJS_PROFILE_ENTER, and OOJS_PROFILE_EXIT.

Here is the call graph for this function:

◆ addWitchspaceJumpEffectForShip:

- (void) addWitchspaceJumpEffectForShip: (ShipEntity *) ship

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

References addEntity:, PLAYER, OORingEffectEntity::ringFromEntity:, and OORingEffectEntity::shrinkingRingFromEntity:.

Here is the call graph for this function:

◆ addWreckageFrom:withRole:at:scale:lifetime:

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

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

References Entity::mass, ShipEntity::performTumble, quaternion_set_random(), randf(), ShipEntity::rescaleBy:writeToCache:, Entity::setEnergy:, ShipEntity::setHeatInsulation:, ShipEntity::setIsWreckage:, Entity::setOrientation:, Entity::setPosition:, ShipEntity::setTemperature:, Entity::setVelocity:, and ShipEntity::velocity.

Referenced by addLaserHitEffectsAt:against:damage:color:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ airResistanceFactor

- (GLfloat) airResistanceFactor

References airResistanceFactor, colorblindMode, int(), isSpeaking, and stopSpeaking.

Here is the call graph for this function:

◆ allShipsDoScriptEvent:andReactToAIMessage:

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

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

References ShipEntity::doScriptEvent:, ShipEntity::getAI, n_entities, nil, AI::reactToMessage:context:, and sortedEntities.

Referenced by carryPlayerOn:inWormhole:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ambientLightLevel

- (float) ambientLightLevel

References ambientLightLevel, currentWaypoints, dockingClearanceProtocolActive, firstBeacon, forceLightSwitch, forceWitchspaceEntries, handleGameOver, lastBeacon, planet, planets, resetBeacons, safeWitchspaceExitDistance, selectIntro2Next, selectIntro2NextCategory, selectIntro2Previous, selectIntro2PreviousCategory, setLighting, setUpPlanet, station, stations, sun, unMagicMainStation, witchspaceBreakPattern, and wormholes.

Here is the call graph for this function:

◆ autoMessageLogBg

- (BOOL) autoMessageLogBg

Definition at line 10240 of file Universe.m.

{
    return _autoMessageLogBg;
}

References _autoMessageLogBg, and autoMessageLogBg.

Referenced by autoMessageLogBg, and framesDoneThisUpdate.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ autoSave

- (BOOL) autoSave

References autoSave.

◆ autoSaveNow

- (BOOL) autoSaveNow

References autoSaveNow.

◆ blockJSPlayerShipProps

- (BOOL) blockJSPlayerShipProps

Definition at line 10270 of file Universe.m.

{
    return gOOJSPlayerIfStale != nil;
}

References blockJSPlayerShipProps, gOOJSPlayerIfStale, and nil.

Referenced by blockJSPlayerShipProps, and framesDoneThisUpdate.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ bloom

- (BOOL) bloom

Definition at line 281 of file Universe.m.

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

References _bloom, bloom, DETAIL_LEVEL_EXTRAS, and detailLevel.

Referenced by bloom, and Universe(OOPrivate)::drawTargetTextureIntoDefaultFramebuffer.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ breakPatternHide

- (BOOL) breakPatternHide

Definition at line 3890 of file Universe.m.

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

References breakPatternCounter, breakPatternHide, and PLAYER.

Referenced by breakPatternHide, drawUniverse, and skyClearColor.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ breakPatternOver

- (BOOL) breakPatternOver

Definition at line 3884 of file Universe.m.

{
    return (breakPatternCounter == 0);
}

References breakPatternCounter, and breakPatternOver.

Referenced by breakPatternOver, and skyClearColor.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ brochureDescriptionWithDictionary:standardEquipment:optionalEquipment:

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

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

References count, and nil.

◆ canInstantiateShip:

- (BOOL) canInstantiateShip: (NSString *) shipKey

implementation

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

References OOJSScript::callMethod:inContext:withArguments:count:result:, getConditionScript:, nil, OOJSAcquireContext(), OOJSRelinquishContext(), OOJSValueFromNativeObject(), OOShipRegistry::sharedRegistry, and OOShipRegistry::shipInfoForKey:.

Here is the call graph for this function:

◆ cargoPodFromTemplate:

- (ShipEntity *) cargoPodFromTemplate: (ShipEntity *) cargoObj

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

References ShipEntity::commodityType, nil, randf(), and ShipEntity::setCommodity:andAmount:.

Here is the call graph for this function:

◆ carryPlayerOn:inWormhole:

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

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

References PlayerEntity::addScannedWormhole:, PlayerEntity::addToAdjustTime:, allShipsDoScriptEvent:andReactToAIMessage:, WormholeEntity::destination, WormholeEntity::destinationCoordinates, WormholeEntity::disgorgeShips, ShipEntity::doScriptEvent:withArgument:, PlayerEntity::erodeReputation, PlayerEntity::jumpCause, PlayerEntity::legalStatus, OOJSAcquireContext(), OOJSRelinquishContext(), WormholeEntity::origin, PLAYER, populateNormalSpace, randf(), removeAllEntitiesExceptPlayer, PlayerEntity::setBounty:withReason:, PlayerEntity::setGalaxyCoordinates:, PlayerEntity::setJumpCause:, PlayerEntity::setPreviousSystemID:, PlayerEntity::setRandom_factor:, PlayerEntity::setSystemID:, setSystemTo:, setUpSpace, setUpWitchspaceBetweenSystem:andSystem:, setWitchspaceBreakPattern:, PlayerEntity::setWormhole:, ShipScriptEvent, PlayerEntity::systemID, and WormholeEntity::travelTime.

Here is the call graph for this function:

◆ characters

- (NSDictionary *) characters

References characters.

◆ chooseStringForKey:inDictionary:

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

implementation

Provided by category Universe(OOPrivate).

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

References count, and nil.

Referenced by descriptionForKey:.

Here is the caller graph for this function:

◆ clearBeacon:

- (void) clearBeacon: (Entity <OOBeaconEntity> *) beaconShip

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

References firstBeacon, lastBeacon, nil, setFirstBeacon:, and setLastBeacon:.

Referenced by Universe(OOPrivate)::doRemoveEntity:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ clearGUIs

- (void) clearGUIs

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

References GuiDisplayGen::clear, clearGUIs, GuiDisplayGen::printLongText:align:color:fadeTime:key:addToArray:, and OOColor::yellowColor.

Referenced by clearGUIs, and commodityMarket.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ clearPreviousMessage

- (void) clearPreviousMessage

Definition at line 6869 of file Universe.m.

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

References clearPreviousMessage, currentMessage, and nil.

Referenced by clearPreviousMessage, and viewDirection.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ clearSystemPopulator

- (void) clearSystemPopulator

Definition at line 1761 of file Universe.m.

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

References clearSystemPopulator, and populatorSettings.

Referenced by clearSystemPopulator, populateNormalSpace, setUpWitchspaceBetweenSystem:andSystem:, and useAddOns.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ collisionDescription

- (NSString *) collisionDescription

Definition at line 6676 of file Universe.m.

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

References CollisionRegion::collisionDescription, collisionDescription, nil, and universeRegion.

Referenced by collisionDescription, and viewMatrix.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ colorblindMode

- (int) colorblindMode

Definition at line 336 of file Universe.m.

{
    return _colorblindMode;
}

References _colorblindMode, colorblindMode, and int().

Referenced by airResistanceFactor, colorblindMode, drawUniverse, and terminatePostFX:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ commLogGUI

- (GuiDisplayGen *) commLogGUI

Definition at line 9920 of file Universe.m.

{
    return comm_log_gui;
}

References comm_log_gui, and commLogGUI.

Referenced by commLogGUI, and gui.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ commodities

- (OOCommodities *) commodities

References commodities, and getRandomCommodity.

Here is the call graph for this function:

◆ commodityDataForType:

- (NSDictionary *) commodityDataForType: (OOCommodityType) type

Definition at line 4419 of file Universe.m.

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

References OOCommodityMarket::definitionForGood:.

Referenced by describeCommodity:amount:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ commodityMarket

- (OOCommodityMarket *) commodityMarket

References clearGUIs, commodityMarket, getStationMarkets, getWitchspaceExitPosition, getWitchspaceExitRotation, and marketSeed.

Here is the call graph for this function:

◆ compareName

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

implementation

Definition at line 9479 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 9494 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 2169 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;
}

References getWitchspaceExitPosition, kZeroHPVector, nil, planet, Entity::position, OOSunEntity::radius, and sun.

Referenced by addShipAt:withRole:withinRadius:, addShips:withRole:atPosition:withCoordinateSystem:, addShips:withRole:nearPosition:withCoordinateSystem:, addShips:withRole:nearPosition:withCoordinateSystem:withinRadius:, addShipWithRole:nearPosition:withCoordinateSystem:, and coordinatesFromCoordinateSystemString:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ coordinatesForSystem:

- (NSPoint) coordinatesForSystem: (OOSystemID) s

Definition at line 8419 of file Universe.m.

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

References OOSystemDescriptionManager::getCoordinatesForSystem:inGalaxy:.

Referenced by nearbyDestinationsWithinRange:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ coordinatesFromCoordinateSystemString:

- (HPVector) coordinatesFromCoordinateSystemString: (NSString *) system_x_y_z

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

References coordinatesForPosition:withCoordinateSystem:returningScalar:, count, and ScanTokensFromString().

Referenced by spawnShip:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ countEntitiesMatchingPredicate:parameter:inRange:ofEntity:

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

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

References Entity::collision_radius, kZeroHPVector, n_entities, nil, Entity::position, sortedEntities, and YESPredicate().

Referenced by countShipsMatchingPredicate:parameter:inRange:ofEntity:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ countShipsMatchingPredicate:parameter:inRange:ofEntity:

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

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

References countEntitiesMatchingPredicate:parameter:inRange:ofEntity:, and IsShipPredicate().

Referenced by countShipsWithPrimaryRole:inRange:ofEntity:, countShipsWithRole:inRange:ofEntity:, and countShipsWithScanClass:inRange:ofEntity:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ countShipsWithPrimaryRole:

- (unsigned) countShipsWithPrimaryRole: (NSString *) role

Definition at line 6388 of file Universe.m.

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

References countShipsWithPrimaryRole:inRange:ofEntity:.

Here is the call graph for this function:

◆ countShipsWithPrimaryRole:inRange:ofEntity:

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

Definition at line 6370 of file Universe.m.

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

References countShipsMatchingPredicate:parameter:inRange:ofEntity:.

Referenced by countShipsWithPrimaryRole:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ countShipsWithRole:

- (unsigned) countShipsWithRole: (NSString *) role

Definition at line 6364 of file Universe.m.

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

References countShipsWithRole:inRange:ofEntity:.

Here is the call graph for this function:

◆ countShipsWithRole:inRange:ofEntity:

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

Definition at line 6355 of file Universe.m.

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

References countShipsMatchingPredicate:parameter:inRange:ofEntity:.

Referenced by countShipsWithRole:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ countShipsWithScanClass:inRange:ofEntity:

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

Definition at line 6379 of file Universe.m.

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

References countShipsMatchingPredicate:parameter:inRange:ofEntity:.

Here is the call graph for this function:

◆ currentPostFX

- (int) currentPostFX

Definition at line 291 of file Universe.m.

{
    return _currentPostFX;
}

References _currentPostFX, currentPostFX, and int().

Referenced by currentPostFX, drawUniverse, and terminatePostFX:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ currentSystemData

- (NSDictionary *) currentSystemData

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

References currentSystemData, DESC, generateSystemData:, inInterstellarSpace, nil, OOJS_PROFILE_ENTER, and OOJS_PROFILE_EXIT.

Referenced by addEntity:, addShipAt:withRole:withinRadius:, currentSystemData, Universe(OOPrivate)::setUpInitialUniverse, systemManager, and witchspaceShipWithPrimaryRole:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ currentSystemID

- (OOSystemID) currentSystemID

Definition at line 7974 of file Universe.m.

{
    return systemID;
}

References currentSystemID, and systemID.

Referenced by currentSystemID, ECMVisualFXEnabled, and setSystemDataForGalaxy:planet:key:value:fromManifest:forLayer:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ currentWaypoints

- (NSDictionary *) currentWaypoints

Definition at line 3831 of file Universe.m.

{
    return waypoints;
}

References currentWaypoints, and waypoints.

Referenced by ambientLightLevel, and currentWaypoints.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ dealloc

- (void) dealloc

implementation

Reimplemented from OOWeakRefObject.

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

References _firstBeacon, _lastBeacon, OOWeakRefObject::dealloc, dealloc, deleteOpenGLObjects, DESTROY, OOCacheManager::flush, gSharedUniverse, nil, OOCacheManager::sharedCache, system_names, and waypoints.

Referenced by dealloc.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ debugDumpEntities

- (void) debugDumpEntities

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

References count, debugDumpEntities, entities, n_entities, OOLog, OOLogIndent(), OOLogOutdent(), OOLogWillDisplayMessagesInClass(), and sortedEntities.

Referenced by addEntity:, debugDumpEntities, and useAddOns.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ defaultAIForRole:

- (NSString *) defaultAIForRole: (NSString *) role

Definition at line 4215 of file Universe.m.

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

Referenced by newShipWithRole:.

Here is the caller graph for this function:

◆ defineFrustum

- (void) defineFrustum

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

References defineFrustum, frustum, and OOGLGetModelViewProjection().

Referenced by defineFrustum, drawUniverse, and gameView.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ defineWaypoint:forKey:

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

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

References addEntity:, nil, PLAYER, removeEntity:, and OOWaypointEntity::waypointWithDictionary:.

Here is the call graph for this function:

◆ deleteOpenGLObjects

- (void) deleteOpenGLObjects

implementation

Provided by category Universe(OOPrivate).

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

References Universe(OOPrivate)::deleteOpenGLObjects, and OOGL.

Referenced by dealloc, and Universe(OOPrivate)::deleteOpenGLObjects.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ demoShipData

- (NSDictionary *) demoShipData

implementation

Provided by category Universe(OOPrivate).

Definition at line 3301 of file Universe.m.

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

References Universe(OOPrivate)::demoShipData.

Referenced by Universe(OOPrivate)::demoShipData, Universe(OOPrivate)::setLibraryTextForDemoShip, Universe(OOPrivate)::setShaderEffectsLevelDirectly:, and update:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ describeCommodity:amount:

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

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

References commodityDataForType:, DESC, OOCommodityMarket::massUnitForGood:, OOCommodityMarket::nameForGood:, nil, UNITS_GRAMS, UNITS_KILOGRAMS, and UNITS_TONS.

Here is the call graph for this function:

◆ descriptionBooleanForKey:

- (BOOL) descriptionBooleanForKey: (NSString *) key

Definition at line 8119 of file Universe.m.

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

References descriptions.

Here is the call graph for this function:

◆ descriptionForArrayKey:index:

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

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

References count, descriptions, and nil.

Here is the call graph for this function:

◆ descriptionForKey:

- (NSString *) descriptionForKey: (NSString *) key

Definition at line 8105 of file Universe.m.

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

References chooseStringForKey:inDictionary:, and descriptions.

Here is the call graph for this function:

◆ descriptions

- (NSDictionary *) descriptions

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

References _descriptions, ResourceManager::builtInPath, descriptions, nil, and verifyDescriptions.

Referenced by descriptionBooleanForKey:, descriptionForArrayKey:index:, descriptionForKey:, descriptions, ECMVisualFXEnabled, and shipsForSaleForSystem:withTL:atTime:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ detailLevel

- (OOGraphicsDetail) detailLevel

References detailLevel, and useShaders.

Here is the call graph for this function:

◆ deterministicPopulation

- (BOOL) deterministicPopulation

Definition at line 1787 of file Universe.m.

{
    return deterministic_population;
}

References deterministic_population, and deterministicPopulation.

Referenced by deterministicPopulation, and useAddOns.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ displayCountdownMessage:forCount:

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

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

References count, countdown_messageRepeatTime, currentMessage, showGUIMessage:withScroll:andColor:overDuration:, GuiDisplayGen::textColor, and universal_time.

Here is the call graph for this function:

◆ displayFPS

- (BOOL) displayFPS

References displayFPS.

◆ displayGUI

- (BOOL) displayGUI

References displayGUI.

◆ displayMessage:forCount:

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

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

References currentMessage, messageRepeatTime, showGUIMessage:withScroll:andColor:overDuration:, GuiDisplayGen::textColor, and universal_time.

Here is the call graph for this function:

◆ displayNameForCommodity:

- (NSString *) displayNameForCommodity: (OOCommodityType) co_type

Definition at line 4425 of file Universe.m.

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

References OOCommodityMarket::nameForGood:.

Here is the call graph for this function:

◆ dockingClearanceProtocolActive

- (BOOL) dockingClearanceProtocolActive

Definition at line 3156 of file Universe.m.

{
    return _dockingClearanceProtocolActive;
}

References _dockingClearanceProtocolActive, and dockingClearanceProtocolActive.

Referenced by ambientLightLevel, and dockingClearanceProtocolActive.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ doingStartUp

- (BOOL) doingStartUp

Definition at line 929 of file Universe.m.

{
    return _doingStartUp;
}

References _doingStartUp, and doingStartUp.

Referenced by doingStartUp, and useAddOns.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ doProcedurallyTexturedPlanets

- (BOOL) doProcedurallyTexturedPlanets

References doProcedurallyTexturedPlanets.

◆ doRemoveEntity:

- (BOOL) doRemoveEntity: (Entity *) entity

implementation

Provided by category Universe(OOPrivate).

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

References clearBeacon:, kOOLogInconsistentState, nil, OOLog, Entity::removeFromLinkedLists, Entity::setUniversalID:, Entity::universalID, Entity::wasRemovedFromUniverse, and Entity::zero_index.

Referenced by ensureEntityReallyRemoved:, and removeEntity:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ drawMessage

- (void) drawMessage

Definition at line 5309 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();
}

References GuiDisplayGen::alpha, cursor_row, displayGUI, GuiDisplayGen::drawGUI:drawCursor:, drawMessage, gameController, MOUSE_MODE_UI_SCREEN_WITH_INTERACTION, OOGL, OOSetOpenGLState, OOVerifyOpenGLState, and OPENGL_STATE_OVERLAY.

Referenced by drawMessage, drawUniverse, and gameView.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ drawTargetTextureIntoDefaultFramebuffer

- (void) drawTargetTextureIntoDefaultFramebuffer

implementation

Provided by category Universe(OOPrivate).

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

References bloom, Universe(OOPrivate)::drawTargetTextureIntoDefaultFramebuffer, and OOGL.

Referenced by Universe(OOPrivate)::drawTargetTextureIntoDefaultFramebuffer, and drawUniverse.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ drawUniverse

- (void) drawUniverse

Definition at line 4813 of file Universe.m.

{
    int currentPostFX = [self currentPostFX];
    BOOL hudSeparateRenderPass =  [self useShaders] && (currentPostFX == OO_POSTFX_NONE || ((currentPostFX == OO_POSTFX_CLOAK || currentPostFX == OO_POSTFX_CRTBADSIGNAL) && [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");
        }
    }
}

References airResistanceFactor, BILLBOARD_DEPTH, breakPatternHide, cachedSun, Entity::cameraRelativePosition, colorblindMode, OOColor::colorWithRed:green:blue:alpha:, currentPostFX, defaultDrawFBO, HeadUpDisplay::deferredHudName, defineFrustum, displayGUI, docked_light_ambient, OOSunEntity::drawDirectVisionSunGlare, GuiDisplayGen::drawGUIBackground, Entity::drawImmediate:translucent:, drawMessage, OOSunEntity::drawStarGlare, drawTargetTextureIntoDefaultFramebuffer, drawUniverse, drawWatermarkString:, EXPECT, MyOpenGLView::fov:, framesDoneThisUpdate, gameController, gameView, getActiveViewMatrix:forwardVector:upVector:, GLScaledLineWidth(), handleOoliteException:, PlayerEntity::hud, INTERMEDIATE_CLEAR_DEPTH, Entity::isImmuneToBreakPatternHide, Entity::isStellarObject, kBasisYVector, kBasisZVector, kIdentityMatrix, kOOLogException, kZeroVector, lightForEntity:, main_light_position, MAX_CLEAR_DEPTH, msaaFramebufferID, n_entities, nil, no_update, OO_POSTFX_CLOAK, OO_POSTFX_CRTBADSIGNAL, OO_POSTFX_NONE, OOCheckOpenGLErrors(), OOGL, OOGLFrustum(), OOGLGetModelView(), OOGLLoadModelView(), OOGLLookAt(), OOGLMultModelView(), OOGLPopModelView(), OOGLPushModelView(), OOGLResetModelView(), OOGLResetProjection(), OOGLTranslateModelView(), OOLog, OOMatrixMultiply(), OOSetOpenGLState, OOVerifyOpenGLState, OPENGL_STATE_OPAQUE, OPENGL_STATE_OVERLAY, HeadUpDisplay::overallAlpha, PLAYER, Entity::position, prepareToRenderIntoDefaultFramebuffer, reducedDetail, HeadUpDisplay::renderHUD, resizeTargetFramebufferWithViewSize:, Entity::setAtmosphereFogging:, HeadUpDisplay::setLineWidth:, setMainLightPosition:, HeadUpDisplay::setOverallAlpha:, PlayerEntity::showDemoShips, skyClearColor, sortedEntities, stars_ambient, Entity::status, PlayerEntity::switchHudTo:, targetFramebufferID, targetFramebufferSize, Entity::updateCameraRelativePosition, useShaders, viewMatrix, PlayerEntity::viewpointOffset, MyOpenGLView::viewSize, and wasDisplayGUI.

Referenced by drawUniverse, and gameView.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ drawWatermarkString:

- (void) drawWatermarkString: (NSString *) watermarkString

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

References gameView, MAIN_GUI_PIXEL_HEIGHT, MAIN_GUI_PIXEL_WIDTH, OODrawString(), OOGL, and OORectFromString().

Referenced by drawUniverse.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ dumpCollisions

- (void) dumpCollisions

Definition at line 6683 of file Universe.m.

{
    dumpCollisionInfo = YES;
}

References dumpCollisionInfo, and dumpCollisions.

Referenced by dumpCollisions, and viewMatrix.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ECMVisualFXEnabled

- (BOOL) ECMVisualFXEnabled

References currentSystemID, descriptions, ECMVisualFXEnabled, and filterSortedLists.

Here is the call graph for this function:

◆ ensureEntityReallyRemoved:

- (void) ensureEntityReallyRemoved: (Entity *) entity

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

References doRemoveEntity:, NO_TARGET, and OOLog.

Here is the call graph for this function:

◆ enterGUIViewModeWithMouseInteraction:

- (void) enterGUIViewModeWithMouseInteraction: (BOOL) mouseInteraction

Definition at line 6768 of file Universe.m.

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

References gameController, GameController::setMouseInteractionModeForUIWithMouseInteraction:, and setViewDirection:.

Referenced by Universe(OOPrivate)::setUpInitialUniverse, and setupIntroFirstGo:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ entitiesWithinRange:ofEntity:

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

Definition at line 6344 of file Universe.m.

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

References findShipsMatchingPredicate:parameter:inRange:ofEntity:, and nil.

Here is the call graph for this function:

◆ entityCount

- (NSUInteger) entityCount

Definition at line 974 of file Universe.m.

{
    return [entities count];
}

References entityCount.

Referenced by entityCount, and useAddOns.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ entityForUniversalID:

- (id) entityForUniversalID: (OOUniversalID) u_id

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

References entity_for_uid, MAX_ENTITY_UID, nil, NO_TARGET, OOLog, and PLAYER.

◆ EntityInRange

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

implementation

Definition at line 6458 of file Universe.m.

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

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

◆ entityList

- (NSArray *) entityList

Definition at line 1004 of file Universe.m.

{
    return [NSArray arrayWithArray:entities];
}

References entityList.

Referenced by entityList, and useAddOns.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ equipmentData

- (NSArray *) equipmentData

References equipmentData.

◆ equipmentDataOutfitting

- (NSArray *) equipmentDataOutfitting

References equipmentDataOutfitting.

◆ explosionSetting:

- (NSDictionary *) explosionSetting: (NSString *) explosion

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

References legacyPositionFrom:asCoordinateSystem:.

Here is the call graph for this function:

◆ fillCargopodWithRandomCargo:

- (void) fillCargopodWithRandomCargo: (ShipEntity *) cargopod

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

References CARGO_SCRIPTED_ITEM, getRandomAmountOfCommodity:, getRandomCommodity, nil, and ShipEntity::setCommodity:andAmount:.

Referenced by addShipAt:withRole:withinRadius:, addShipWithRole:launchPos:rfactor:, and witchspaceShipWithPrimaryRole:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ filterSortedLists

- (void) filterSortedLists

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

References Entity::canCollide, Entity::collision_chain, Entity::collision_radius, Entity::collisionTestFilter, filterSortedLists, nil, OOLog, Entity::position, 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.

Referenced by ECMVisualFXEnabled, filterSortedLists, and update:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ findCollisionsAndShadows

- (void) findCollisionsAndShadows

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

References CollisionRegion::checkEntity:, CollisionRegion::clearEntityList, CollisionRegion::findCollisions, findCollisionsAndShadows, CollisionRegion::findShadowedEntities, gameController, and n_entities.

Referenced by findCollisionsAndShadows, update:, and viewMatrix.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ findConnectedSystemAtCoords:withGalaxy:

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

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

References distanceBetweenPlanetPositions(), OOSystemDescriptionManager::getCoordinatesForSystem:inGalaxy:, and MAX_JUMP_RANGE.

Here is the call graph for this function:

◆ findEntitiesMatchingPredicate:parameter:inRange:ofEntity:

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

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

References EntityInRange(), kZeroHPVector, n_entities, nil, OOJS_PROFILE_ENTER, OOJS_PROFILE_EXIT, OOJSPauseTimeLimiter(), OOJSResumeTimeLimiter(), Entity::position, sortedEntities, and YESPredicate().

Referenced by findShipsMatchingPredicate:parameter:inRange:ofEntity:, and findVisualEffectsMatchingPredicate:parameter:inRange:ofEntity:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ findNeighbouringSystemToCoords:withGalaxy:

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

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

References distanceBetweenPlanetPositions(), OOSystemDescriptionManager::getCoordinatesForSystem:inGalaxy:, and MAX_JUMP_RANGE.

Here is the call graph for this function:

◆ findOneEntityMatchingPredicate:parameter:

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

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

References n_entities, nil, OOJSPauseTimeLimiter(), OOJSResumeTimeLimiter(), sortedEntities, and YESPredicate().

Referenced by station, stationFriendlyTo:, and sun.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ findShipsMatchingPredicate:parameter:inRange:ofEntity:

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

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

References findEntitiesMatchingPredicate:parameter:inRange:ofEntity:, and IsShipPredicate().

Referenced by entitiesWithinRange:ofEntity:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ findSystemAtCoords:withGalaxy:

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

Definition at line 8444 of file Universe.m.

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

References findSystemNumberAtCoords:withGalaxy:includingHidden:, and OOLog.

Here is the call graph for this function:

◆ findSystemCoordinatesWithPrefix:

- (NSPoint) findSystemCoordinatesWithPrefix: (NSString *) p_fix

Definition at line 8618 of file Universe.m.

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

References findSystemCoordinatesWithPrefix:exactMatch:.

Here is the call graph for this function:

◆ findSystemCoordinatesWithPrefix:exactMatch:

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

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

References OOSystemDescriptionManager::getCoordinatesForSystem:inGalaxy:, OOSystemDescriptionManager::getPropertiesForSystem:inGalaxy:, nil, OO_SYSTEMCONCEALMENT_NONAME, and system_found.

Referenced by findSystemCoordinatesWithPrefix:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ findSystemFromName:

- (OOSystemID) findSystemFromName: (NSString *) sysName

Definition at line 8425 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!
}

References nil.

◆ findSystemNumberAtCoords:withGalaxy:includingHidden:

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

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

References ABS, OOSystemDescriptionManager::getCoordinatesForSystem:inGalaxy:, OOSystemDescriptionManager::getPropertiesForSystem:inGalaxy:, kOOMinimumSystemID, OO_SYSTEMCONCEALMENT_NOTHING, PLAYER, and targetSystemID.

Referenced by findSystemAtCoords:withGalaxy:, and setUpUniverseFromStation.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ findVisualEffectsMatchingPredicate:parameter:inRange:ofEntity:

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

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

References findEntitiesMatchingPredicate:parameter:inRange:ofEntity:, and IsVisualEffectPredicate().

Here is the call graph for this function:

◆ firstBeacon

- (Entity< OOBeaconEntity > *) firstBeacon

Definition at line 3751 of file Universe.m.

{
    return [_firstBeacon weakRefUnderlyingObject];
}

References firstBeacon, and OOWeakReference::weakRefUnderlyingObject.

Referenced by ambientLightLevel, clearBeacon:, firstBeacon, listBeaconsWithCode:, resetBeacons, Universe(OOPrivate)::setFirstBeacon:, and setNextBeacon:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ firstEntityTargetedByPlayer

- (Entity *) firstEntityTargetedByPlayer

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

References basis_vectors_from_quaternion(), Entity::collisionRadius, firstEntityTargetedByPlayer, M_PI, n_entities, nil, PlayerEntity::normalOrientation, OOVectorMultiplyMatrix(), PLAYER, quaternion_rotate_about_axis(), SCANNER_MAX_RANGE, sortedEntities, viewDirection, and PlayerEntity::weaponViewOffset.

Referenced by firstEntityTargetedByPlayer, and viewMatrix.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ firstEntityTargetedByPlayerPrecisely

- (Entity *) firstEntityTargetedByPlayerPrecisely

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

References ShipEntity::aftWeaponOffset, firstEntityTargetedByPlayerPrecisely, firstShipHitByLaserFromShip:inDirection:offset:gettingRangeFound:, ShipEntity::forwardWeaponOffset, kZeroVector, PLAYER, ShipEntity::portWeaponOffset, ShipEntity::starboardWeaponOffset, viewDirection, WEAPON_FACING_AFT, WEAPON_FACING_FORWARD, WEAPON_FACING_PORT, and WEAPON_FACING_STARBOARD.

Referenced by firstEntityTargetedByPlayerPrecisely, and viewMatrix.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ firstShipHitByLaserFromShip:inDirection:offset:gettingRangeFound:

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

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

References Entity::absolutePositionForSubentityOffset:, basis_vectors_from_quaternion(), Entity::boundingBox, Entity::collision_radius, M_PI, n_entities, nil, Entity::normalOrientation, OOVectorMultiplyMatrix(), Entity::orientation, Entity::parentEntity, Entity::position, quaternion_rotate_about_axis(), ShipEntity::setSubEntityTakingDamage:, sortedEntities, WEAPON_FACING_AFT, WEAPON_FACING_FORWARD, WEAPON_FACING_NONE, WEAPON_FACING_PORT, WEAPON_FACING_STARBOARD, and ShipEntity::weaponRange.

Referenced by firstEntityTargetedByPlayerPrecisely.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ forceLightSwitch

- (void) forceLightSwitch

Definition at line 2101 of file Universe.m.

{
    demo_light_on = !demo_light_on;
}

References demo_light_on, and forceLightSwitch.

Referenced by ambientLightLevel, and forceLightSwitch.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ forceWitchspaceEntries

- (void) forceWitchspaceEntries

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

References ShipEntity::enterTargetWormhole, forceWitchspaceEntries, n_entities, ShipEntity::primaryTarget, and sortedEntities.

Referenced by ambientLightLevel, and forceWitchspaceEntries.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fractionalPositionFrom:to:withFraction:

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

implementation

Provided by category Universe(OOPrivate).

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

References randf(), and SCANNER_MAX_RANGE.

Referenced by addShipsToRoute:withRole:quantity:routeFraction:asGroup:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ framesDoneThisUpdate

- (int) framesDoneThisUpdate

References autoMessageLogBg, blockJSPlayerShipProps, framesDoneThisUpdate, INLINE_CONST_FUNC, int(), loadConditionScripts, OOINLINE, pauseMessageVisible, permanentCommLog, permanentMessageLog, and resetFramesDoneThisUpdate.

Here is the call graph for this function:

◆ gameController

- (GameController *) gameController

Definition at line 4493 of file Universe.m.

{
    return [[self gameView] gameController];
}

References gameController, MyOpenGLView::gameController, and gameView.

Referenced by drawMessage, drawUniverse, enterGUIViewModeWithMouseInteraction:, findCollisionsAndShadows, gameController, gameSettings, gameView, handleGameOver, handleOoliteException:, pauseGame, reinitAndShowDemo:, and setViewDirection:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ gameSettings

- (NSDictionary *) gameSettings

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

References detailLevel, MyOpenGLView::fov:, gameController, gameSettings, gameView, MyOpenGLView::gammaValue, GameController::inFullScreenMode, kOOMusicITunes, kOOMusicOff, kOOMusicOn, and MyOpenGLView::viewSize.

Referenced by gameSettings, and gameView.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ gameView

- (MyOpenGLView *) gameView

References defineFrustum, drawMessage, drawUniverse, gameController, gameSettings, and gameView.

Here is the call graph for this function:

◆ generateSystemData:

- (NSDictionary *) generateSystemData: (OOSystemID) s

Definition at line 8143 of file Universe.m.

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

References generateSystemData:useCache:.

Referenced by currentSystemData, nearbyDestinationsWithinRange:, setSystemTo:, and shipsForSaleForSystem:withTL:atTime:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ generateSystemData:useCache:

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

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

References OOSystemDescriptionManager::getPropertiesForSystemKey:, OOJS_PROFILE_ENTER, and OOJS_PROFILE_EXIT.

Referenced by generateSystemData:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ generateSystemDataForGalaxy:planet:

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

implementation

Definition at line 8357 of file Universe.m.

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

References OOSystemDescriptionManager::getPropertiesForSystemKey:, and keyForPlanetOverridesForSystem:inGalaxy:.

Referenced by systemDataKeysForGalaxy:planet:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getActiveViewMatrix:forwardVector:upVector:

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

implementation

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

References aft_matrix, PlayerEntity::customViewForwardVector, PlayerEntity::customViewMatrix, PlayerEntity::customViewUpVector, fwd_matrix, kBasisXVector, kBasisYVector, kBasisZVector, nil, PLAYER, port_matrix, starboard_matrix, and viewDirection.

Referenced by activeViewMatrix, and drawUniverse.

Here is the caller graph for this function:

◆ getConditionScript:

- (OOJSScript *) getConditionScript: (NSString *) scriptname

Definition at line 11045 of file Universe.m.

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

Referenced by canInstantiateShip:, and shipsForSaleForSystem:withTL:atTime:.

Here is the caller graph for this function:

◆ getContainersOfCommodity:commodity_name:

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

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

References commodities, and OOLog.

◆ getContainersOfGoods:scarce:legal:

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

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

References commodityMarket, OOCommodityMarket::count, OOCommodityMarket::goods, nil, OOLog, OOCommodityMarket::quantityForGood:, and Ranrot().

Here is the call graph for this function:

◆ getEquipmentPriceForKey:

- (OOCreditsQuantity) getEquipmentPriceForKey: (NSString *) eq_key

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

References equipmentData.

Referenced by shipsForSaleForSystem:withTL:atTime:.

Here is the caller graph for this function:

◆ getPopulatorSettings

- (NSDictionary *) getPopulatorSettings

Definition at line 1768 of file Universe.m.

{
    return populatorSettings;
}

References getPopulatorSettings, and populatorSettings.

Referenced by getPopulatorSettings, and useAddOns.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getRandomAmountOfCommodity:

- (OOCargoQuantity) getRandomAmountOfCommodity: (OOCommodityType) co_type

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

References OOCommodities::massUnitForGood:, nil, OOLog, and Ranrot().

Referenced by fillCargopodWithRandomCargo:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getRandomCommodity

- (NSString *) getRandomCommodity

Definition at line 4390 of file Universe.m.

{
    return [commodities getRandomCommodity];
}

References OOCommodities::getRandomCommodity, and getRandomCommodity.

Referenced by commodities, fillCargopodWithRandomCargo:, and getRandomCommodity.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getSafeVectorFromEntity:toDistance:fromPoint:

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

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

References Entity::collision_radius, int(), kOOLogParameterError, kZeroHPVector, n_entities, OOLog, Entity::position, Ranrot(), and sortedEntities.

Here is the call graph for this function:

◆ getStationMarkets

- (NSArray *) getStationMarkets

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

References getStationMarkets, StationEntity::localMarket, nil, Entity::position, OOCommodityMarket::saveStationAmounts, station, stations, and UNIVERSE.

Referenced by commodityMarket, and getStationMarkets.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getSunSkimEndPositionForShip:

- (HPVector) getSunSkimEndPositionForShip: (ShipEntity*) ship

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

References Entity::collision_radius, kOOLogInconsistentState, kOOLogParameterError, kZeroHPVector, OOLog, Entity::position, randf(), sun, and SUN_SKIM_RADIUS_FACTOR.

Here is the call graph for this function:

◆ getSunSkimStartPositionForShip:

- (HPVector) getSunSkimStartPositionForShip: (ShipEntity*) ship

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

References Entity::collision_radius, kOOLogInconsistentState, kOOLogParameterError, kZeroHPVector, OOLog, Entity::position, sun, and SUN_SKIM_RADIUS_FACTOR.

Here is the call graph for this function:

◆ getSystemGovernment:

- (OOGovernmentID) getSystemGovernment: (OOSystemID) sys

Definition at line 8389 of file Universe.m.

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

References OOSystemDescriptionManager::getProperty:forSystem:inGalaxy:.

Here is the call graph for this function:

◆ getSystemInhabitants:

- (NSString *) getSystemInhabitants: (OOSystemID) sys

Definition at line 8395 of file Universe.m.

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

References getSystemInhabitants:plural:.

Here is the call graph for this function:

◆ getSystemInhabitants:plural:

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

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

References OOSystemDescriptionManager::getProperty:forSystem:inGalaxy:, and nil.

Referenced by getSystemInhabitants:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getSystemName:

- (NSString *) getSystemName: (OOSystemID) sys

Definition at line 8377 of file Universe.m.

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

References getSystemName:forGalaxy:.

Referenced by setUpUniverseFromWitchspace, and speakWithSubstitutions:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getSystemName:forGalaxy:

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

Definition at line 8383 of file Universe.m.

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

References OOSystemDescriptionManager::getProperty:forSystem:inGalaxy:.

Referenced by getSystemName:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getTime

- (OOTimeAbsolute) getTime

Definition at line 6643 of file Universe.m.

{
    return universal_time;
}

References getTime, and universal_time.

Referenced by getTime, showCommsLog:, and viewMatrix.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getTimeDelta

- (OOTimeDelta) getTimeDelta

Definition at line 6649 of file Universe.m.

{
    return time_delta;
}

References getTimeDelta, and time_delta.

Referenced by getTimeDelta, and viewMatrix.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getWitchspaceExitPosition

- (HPVector) getWitchspaceExitPosition

Definition at line 9769 of file Universe.m.

{
    return kZeroHPVector;
}

References getWitchspaceExitPosition, and kZeroHPVector.

Referenced by addShipAt:withRole:withinRadius:, addShipsToRoute:withRole:quantity:routeFraction:asGroup:, addShipWithRole:nearRouteOneAt:, commodityMarket, coordinatesForPosition:withCoordinateSystem:returningScalar:, getWitchspaceExitPosition, and legacyPositionFrom:asCoordinateSystem:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getWitchspaceExitRotation

- (Quaternion) getWitchspaceExitRotation

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

References gen_rnd_number(), and getWitchspaceExitRotation.

Referenced by commodityMarket, and getWitchspaceExitRotation.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ globalSettings

- (NSDictionary *) globalSettings

References globalSettings.

◆ gui

- (GuiDisplayGen *) gui

References commLogGUI, gui, messageGUI, and resetCommsLogColor.

Here is the call graph for this function:

◆ handleGameOver

- (void) handleGameOver

Definition at line 3186 of file Universe.m.

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

References gameController, handleGameOver, GameController::loadPlayerIfRequired, and setUseAddOns:fromSaveGame:forceReinit:.

Referenced by ambientLightLevel, and handleGameOver.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ handleOoliteException:

- (void) handleOoliteException: (NSException *) ooliteException

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

References addMessage:forCount:, gameController, kOOLogException, nil, OOLITE_EXCEPTION_FATAL, OOLog, PLAYER, GameController::setGamePaused:, and ShipEntity::setStatus:.

Referenced by drawUniverse, and update:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ hazardOnRouteFromEntity:toDistance:fromPoint:

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

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

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

◆ inInterstellarSpace

- (BOOL) inInterstellarSpace

Definition at line 8202 of file Universe.m.

{
    return [self sun] == nil;
}

References inInterstellarSpace, nil, and sun.

Referenced by currentSystemData, inInterstellarSpace, nearbyDestinationsWithinRange:, and systemManager.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ initTargetFramebufferWithViewSize:

- (void) initTargetFramebufferWithViewSize: (NSSize) viewSize

implementation

Provided by category Universe(OOPrivate).

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

References DETAIL_LEVEL_EXTRAS, detailLevel, framebufferQuadIndices, framebufferQuadVertices, GL_CLAMP_TO_EDGE, OO_POSTFX_NONE, OOGL, and OOLogERR.

Referenced by initWithGameView:.

Here is the caller graph for this function:

◆ initWithGameView:

- (id) initWithGameView: (MyOpenGLView *) gameView

Definition at line 691 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];
 
    [self setECMVisualFXEnabled:[prefs oo_boolForKey:@"ecm-visual-fx" defaultValue:YES]];
    
    // 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;
}

References _doingStartUp, addEntity:, allPlanets, allStations, autoSave, comm_log_gui, PlayerEntity::completeSetUp, OOOpenGLExtensionManager::defaultDetailLevel, PlayerEntity::deferredInit, ResourceManager::dictionaryFromFilesNamed:inFolder:andMerge:, doProcedurallyTexturedPlanets, entities, entitiesDeadThisUpdate, framesDoneThisUpdate, gSharedUniverse, gui, initTargetFramebufferWithViewSize:, loadDescriptions, loadScenarios, GameController::logProgress:, OOSound::masterVolume, MIN_FOV_DEG, missiontext, nil, OO_DEBUG_PROGRESS, OOCPUInfoInit(), OOInitDebugSupport(), OOInitReallyRandom(), OOLog, populateNormalSpace, runLocalizationTools, setDetailLevelDirectly:, setECMVisualFXEnabled:, MyOpenGLView::setFov:fromFraction:, setGameView:, MyOpenGLView::setGammaValue:, MyOpenGLView::setMsaa:, PlayerEntity::setShowDemoShips:, ShipEntity::setStatus:, OOMaterial::setUp, setUpCargoPods, setUpInitialUniverse, setUpSettings, OOFlashEffectEntity::setUpTexture, OOLightParticleEntity::setUpTexture, ResourceManager::setUseAddOns:, OOCacheManager::sharedCache, GameController::sharedController, OOOpenGLExtensionManager::sharedManager, PlayerEntity::sharedPlayer, OOShipRegistry::sharedRegistry, OOJoystickManager::sharedStickHandler, speechSynthesizer, PlayerEntity::startUpComplete, universeRegion, useAddOns, MyOpenGLView::viewSize, waypoints, and wireframeGraphics.

Here is the call graph for this function:

◆ IsCandidateMainStationPredicate

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

implementation

Definition at line 3621 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 3627 of file Universe.m.

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

References ShipEntity::isHostileTo:, and Entity::isStation.

Here is the call graph for this function:

◆ isSpeaking

- (BOOL) isSpeaking

Definition at line 10118 of file Universe.m.

{
    return [speechSynthesizer isSpeaking];
}

References isSpeaking.

Referenced by airResistanceFactor, and isSpeaking.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isVectorClearFromEntity:toDistance:fromPoint:

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

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

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

◆ keyForInterstellarOverridesForSystems:s1:inGalaxy:

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

Definition at line 8137 of file Universe.m.

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

Referenced by setUpWitchspaceBetweenSystem:andSystem:.

Here is the caller graph for this function:

◆ keyForPlanetOverridesForSystem:inGalaxy:

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

Definition at line 8131 of file Universe.m.

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

Referenced by generateSystemDataForGalaxy:planet:.

Here is the caller graph for this function:

◆ lastBeacon

- (Entity< OOBeaconEntity > *) lastBeacon

Definition at line 3770 of file Universe.m.

{
    return [_lastBeacon weakRefUnderlyingObject];
}

References lastBeacon, and OOWeakReference::weakRefUnderlyingObject.

Referenced by ambientLightLevel, clearBeacon:, lastBeacon, and Universe(OOPrivate)::setLastBeacon:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ legacyPositionFrom:asCoordinateSystem:

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

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

References getWitchspaceExitPosition, kZeroHPVector, nil, planet, Entity::position, OOSunEntity::radius, and sun.

Referenced by expressPosition:inCoordinateSystem:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ lightForEntity:

- (void) lightForEntity: (BOOL) isLit

implementation

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

References demo_light_on, object_light_on, OOGL, sun_diffuse, sun_off, sun_specular, and useShaders.

Referenced by drawUniverse.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ listBeaconsWithCode:

- (NSArray *) listBeaconsWithCode: (NSString*) code

Definition at line 9870 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:)];
}

References firstBeacon, and nil.

Here is the call graph for this function:

◆ loadConditionScripts

- (void) loadConditionScripts

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

References addConditionScripts:, conditionScripts, loadConditionScripts, OOCacheManager::objectForKey:inCache:, and OOCacheManager::sharedCache.

Referenced by framesDoneThisUpdate, and loadConditionScripts.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ loadDescriptions

- (void) loadDescriptions

implementation

Provided by category Universe(OOPrivate).

Definition at line 8066 of file Universe.m.

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

References ResourceManager::dictionaryFromFilesNamed:inFolder:andMerge:, Universe(OOPrivate)::loadDescriptions, and verifyDescriptions.

Referenced by initWithGameView:, Universe(OOPrivate)::loadDescriptions, reinitAndShowDemo:, Universe(OOPrivate)::setShaderEffectsLevelDirectly:, and setUpSettings.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ loadScenarios

- (void) loadScenarios

implementation

Provided by category Universe(OOPrivate).

Definition at line 8086 of file Universe.m.

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

References ResourceManager::arrayFromFilesNamed:inFolder:andMerge:, and Universe(OOPrivate)::loadScenarios.

Referenced by initWithGameView:, Universe(OOPrivate)::loadScenarios, reinitAndShowDemo:, and Universe(OOPrivate)::setShaderEffectsLevelDirectly:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ loadStationMarkets:

- (void) loadStationMarkets: (NSArray *) marketData

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

References nil, StationEntity::setLocalMarket:, station, stations, and UNIVERSE.

Here is the call graph for this function:

◆ locationByCode:withSun:andPlanet:

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

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

References kOOLogUniversePopulateError, kZeroHPVector, LANE_WIDTH, locationByCode:withSun:andPlanet:, nil, OOHPVectorRandomSpatial(), OOLog, OOProjectHPVectorToPlane(), OORandomPositionInCylinder(), OORandomPositionInShell(), planet, randf(), SCANNER_MAX_RANGE, SCANNER_MAX_RANGE2, station, and sun.

Referenced by locationByCode:withSun:andPlanet:, and populateSystemFromDictionariesWithSun:andPlanet:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ MaintainLinkedLists

+ (static BOOL) MaintainLinkedLists (Universe *) uni

implementation

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

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:

◆ makeDemoShipWithRole:spinning:

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

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

References Entity::collisionRadius, M_SQRT1_2, newShipWithRole:, nil, PLAYER, removeDemoShips, ShipEntity::removeEquipmentItem:, ShipEntity::setDemoShip:, Entity::setOrientation:, ShipEntity::setPendingEscortCount:, Entity::setPositionX:y:z:, Entity::setScanClass:, ShipEntity::setStatus:, and ShipEntity::switchAITo:.

Here is the call graph for this function:

◆ makeSunSkimmer:andSetAI:

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

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

References ShipEntity::maxFlightSpeed, ShipEntity::setFuel:, ShipEntity::setHeatInsulation:, and ShipEntity::switchAITo:.

Referenced by addShipAt:withRole:withinRadius:, and witchspaceShipWithPrimaryRole:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ marketSeed

- (Random_Seed) marketSeed

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

References Random_Seed::a, Random_Seed::b, Random_Seed::c, Random_Seed::d, Random_Seed::e, Random_Seed::f, OOSystemDescriptionManager::getRandomSeedForCurrentSystem, and marketSeed.

Referenced by commodityMarket, marketSeed, and shipsForSaleForSystem:withTL:atTime:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ maxCargoForShip:

- (OOCargoQuantity) maxCargoForShip: (NSString *) desc

Definition at line 4221 of file Universe.m.

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

References OOShipRegistry::sharedRegistry, and OOShipRegistry::shipInfoForKey:.

Here is the call graph for this function:

◆ messageGUI

- (GuiDisplayGen *) messageGUI

Definition at line 9926 of file Universe.m.

{
    return message_gui;
}

References message_gui, and messageGUI.

Referenced by gui, and messageGUI.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ missiontext

- (NSDictionary *) missiontext

References missiontext, and scenarios.

Here is the call graph for this function:

◆ 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 8451 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;
}

References coordinatesForSystem:, distanceBetweenPlanetPositions(), generateSystemData:, inInterstellarSpace, MAX_JUMP_RANGE, and systemID.

Here is the call graph for this function:

◆ nearestEntityMatchingPredicate:parameter:relativeToEntity:

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

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

References kZeroHPVector, n_entities, nil, Entity::position, sortedEntities, and YESPredicate().

Referenced by nearestShipMatchingPredicate:parameter:relativeToEntity:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ nearestShipMatchingPredicate:parameter:relativeToEntity:

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

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

References IsShipPredicate(), and nearestEntityMatchingPredicate:parameter:relativeToEntity:.

Here is the call graph for this function:

◆ neighboursToSystem:

- (NSArray *) neighboursToSystem: (OOSystemID) system_number

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

References closeSystems, OOSystemDescriptionManager::getNeighbourIDsForSystem:inGalaxy:, nil, and systemID.

Referenced by routeFromSystem:toSystem:optimizedBy:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ newDockWithName:andScaleFactor:

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

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

References kOOLogException, nil, OOJS_PROFILE_ENTER, OOJS_PROFILE_EXIT, OOLITE_EXCEPTION_DATA_NOT_FOUND, OOLog, ShipEntity::setPrimaryRole:, OOShipRegistry::sharedRegistry, and OOShipRegistry::shipInfoForKey:.

Here is the call graph for this function:

◆ newShipWithName:

- (ShipEntity *) newShipWithName: (NSString *) OO_RETURNS_RETAINED

Definition at line 4183 of file Universe.m.

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

References newShipWithName:usePlayerProxy:.

Referenced by newShipWithRole:, and spawnShip:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ newShipWithName:usePlayerProxy:

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

Definition at line 4079 of file Universe.m.

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

References newShipWithName:usePlayerProxy:isSubentity:.

Referenced by newShipWithName:, setupIntroFirstGo:, and update:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ newShipWithName:usePlayerProxy:isSubentity:

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

Definition at line 4084 of file Universe.m.

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

References newShipWithName:usePlayerProxy:isSubentity:andScaleFactor:.

Referenced by newShipWithName:usePlayerProxy:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ newShipWithName:usePlayerProxy:isSubentity:andScaleFactor:

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

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

References kOOLogException, nil, OOJS_PROFILE_ENTER, OOJS_PROFILE_EXIT, OOLITE_EXCEPTION_DATA_NOT_FOUND, OOLog, ShipEntity::setPrimaryRole:, OOShipRegistry::sharedRegistry, shipClassForShipDictionary:, and OOShipRegistry::shipInfoForKey:.

Referenced by newShipWithName:usePlayerProxy:isSubentity:, and newSubentityWithName:andScaleFactor:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ newShipWithRole:

- (ShipEntity *) newShipWithRole: (NSString *) OO_RETURNS_RETAINED

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

References defaultAIForRole:, newShipWithName:, nil, OOJS_PROFILE_ENTER, OOJS_PROFILE_EXIT, randomShipKeyForRoleRespectingConditions:, ShipEntity::setAITo:, ShipEntity::setBounty:withReason:, ShipEntity::setPrimaryRole:, Entity::setScanClass:, OOShipRegistry::sharedRegistry, and OOShipRegistry::shipInfoForKey:.

Referenced by addShipAt:withRole:withinRadius:, addShipWithRole:launchPos:rfactor:, makeDemoShipWithRole:spinning:, Universe(OOPrivate)::setUpCargoPods, and witchspaceShipWithPrimaryRole:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ newSubentityWithName:andScaleFactor:

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

Definition at line 4073 of file Universe.m.

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

References newShipWithName:usePlayerProxy:isSubentity:andScaleFactor:.

Here is the call graph for this function:

◆ newVisualEffectWithName:

- (OOVisualEffectEntity *) newVisualEffectWithName: (NSString *) OO_RETURNS_RETAINED

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

References OOShipRegistry::effectInfoForKey:, kOOLogException, nil, OOJS_PROFILE_ENTER, OOJS_PROFILE_EXIT, OOLITE_EXCEPTION_DATA_NOT_FOUND, OOLog, and OOShipRegistry::sharedRegistry.

Referenced by addVisualEffectAt:withKey:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ nextColorblindMode:

- (int) nextColorblindMode: (int) index

Definition at line 320 of file Universe.m.

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

References int(), OO_POSTFX_COLORBLINDNESS_TRITAN, and OO_POSTFX_NONE.

Here is the call graph for this function:

◆ pauseGame

- (void) pauseGame

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

References addMessage:forCount:, GuiDisplayGen::drawGUI:drawCursor:, gameController, gui, pauseGame, PLAYER, GameController::setGamePaused:, and setPauseMessageVisible:.

Referenced by pauseGame, and useAddOns.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ pauseMessageVisible

- (BOOL) pauseMessageVisible

Definition at line 10216 of file Universe.m.

{
    return _pauseMessage;
}

References _pauseMessage, and pauseMessageVisible.

Referenced by framesDoneThisUpdate, and pauseMessageVisible.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ permanentCommLog

- (BOOL) permanentCommLog

Definition at line 10252 of file Universe.m.

{
    return _permanentCommLog;
}

References _permanentCommLog, and permanentCommLog.

Referenced by framesDoneThisUpdate, permanentCommLog, and showCommsLog:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ permanentMessageLog

- (BOOL) permanentMessageLog

Definition at line 10228 of file Universe.m.

{
    return _permanentMessageLog;
}

References _permanentMessageLog, and permanentMessageLog.

Referenced by framesDoneThisUpdate, and permanentMessageLog.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ planet

- (OOPlanetEntity *) planet

Definition at line 3677 of file Universe.m.

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

References allPlanets, cachedPlanet, count, nil, and planet.

Referenced by addEntity:, addShipsToRoute:withRole:quantity:routeFraction:asGroup:, ambientLightLevel, coordinatesForPosition:withCoordinateSystem:returningScalar:, legacyPositionFrom:asCoordinateSystem:, locationByCode:withSun:andPlanet:, planet, populateSystemFromDictionariesWithSun:andPlanet:, preloadPlanetTexturesForSystem:, setSystemDataForGalaxy:planet:key:value:fromManifest:forLayer:, and spawnShip:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ planets

- (NSArray *) planets

Definition at line 3697 of file Universe.m.

{
    return allPlanets;
}

References allPlanets, and planets.

Referenced by ambientLightLevel, and planets.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ populateNormalSpace

- (void) populateNormalSpace

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

References cachedPlanet, cachedStation, cachedSun, clearSystemPopulator, OOSystemDescriptionManager::getPropertiesForCurrentSystem, next_repopulation, nil, OO_DEBUG_POP_PROGRESS, OO_DEBUG_PUSH_PROGRESS, OOEnforceStandards(), OOJSAcquireContext(), OOJSRelinquishContext(), OOStandardsDeprecated(), PLAYER, populateNormalSpace, populateSystemFromDictionariesWithSun:andPlanet:, Entity::position, randf(), removeEntity:, OOSunEntity::setPosition:, SYSTEM_REPOPULATION_INTERVAL, system_repopulator, and systemID.

Referenced by carryPlayerOn:inWormhole:, initWithGameView:, populateNormalSpace, reinitAndShowDemo:, setUpUniverseFromStation, setUpUniverseFromWitchspace, and useAddOns.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ populateSpaceFromActiveWormholes

- (void) populateSpaceFromActiveWormholes

implementation

Provided by category Universe(OOPrivate).

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

References count, WormholeEntity::disgorgeShips, kOOLogException, nil, OOLog, PLAYER, and Universe(OOPrivate)::populateSpaceFromActiveWormholes.

Referenced by Universe(OOPrivate)::populateSpaceFromActiveWormholes, and setUpSpace.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ populateSystemFromDictionariesWithSun:andPlanet:

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

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

References deterministic_population, EXPECT_NOT, OOSystemDescriptionManager::getRandomSeedForCurrentSystem, kZeroHPVector, locationByCode:withSun:andPlanet:, MakeRanrotSeed(), nil, planet, RANROTGetFullSeed(), RanrotSeedFromRandomSeed(), RANROTSetFullSeed(), RanrotWithSeed(), OOJSPopulatorDefinition::runCallback:, and sun.

Referenced by populateNormalSpace, and setUpWitchspaceBetweenSystem:andSystem:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ PreloadOneSound

+ (static void) PreloadOneSound (NSString *) soundName

implementation

Definition at line 10720 of file Universe.m.

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

References ResourceManager::ooSoundNamed:inFolder:.

Referenced by preloadSounds.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ preloadPlanetTexturesForSystem:

- (void) preloadPlanetTexturesForSystem: (OOSystemID) system

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

References count, nil, and planet.

Here is the call graph for this function:

◆ preloadSounds

- (void) preloadSounds

Definition at line 10729 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");
}

References count, customSounds, foreachkey, nil, PreloadOneSound, and preloadSounds.

Referenced by preloadSounds, and systemManager.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ prepareToRenderIntoDefaultFramebuffer

- (void) prepareToRenderIntoDefaultFramebuffer

implementation

Provided by category Universe(OOPrivate).

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

References OOGL, and Universe(OOPrivate)::prepareToRenderIntoDefaultFramebuffer.

Referenced by drawUniverse, and Universe(OOPrivate)::prepareToRenderIntoDefaultFramebuffer.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ prevColorblindMode:

- (int) prevColorblindMode: (int) index

Definition at line 328 of file Universe.m.

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

References int(), OO_POSTFX_COLORBLINDNESS_TRITAN, and OO_POSTFX_NONE.

Here is the call graph for this function:

◆ randomDistanceWithinScanner

- (float) randomDistanceWithinScanner

implementation

Provided by category Universe(OOPrivate).

Definition at line 10573 of file Universe.m.

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

References Universe(OOPrivate)::randomDistanceWithinScanner, Ranrot(), and SCANNER_MAX_RANGE.

Referenced by Universe(OOPrivate)::randomDistanceWithinScanner, Universe(OOPrivate)::randomPlaceWithinScannerFrom:alongRoute:withOffset:, Universe(OOPrivate)::setShaderEffectsLevelDirectly:, and setUpUniverseFromStation.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ randomPlaceWithinScannerFrom:alongRoute:withOffset:

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

implementation

Provided by category Universe(OOPrivate).

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

References randomDistanceWithinScanner.

Here is the call graph for this function:

◆ randomShipKeyForRoleRespectingConditions:

- (NSString *) randomShipKeyForRoleRespectingConditions: (NSString *) role

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

References count, nil, OOJS_PROFILE_ENTER, OOJS_PROFILE_EXIT, OOLog, OOShipRegistry::probabilitySetForRole:, OOProbabilitySet::randomObject, OOShipRegistry::randomShipKeyForRole:, OOMutableProbabilitySet::removeObject:, and OOShipRegistry::sharedRegistry.

Referenced by newShipWithRole:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ reducedDetail

- (BOOL) reducedDetail

Definition at line 10010 of file Universe.m.

{
    return detailLevel == DETAIL_LEVEL_MINIMUM;
}

References DETAIL_LEVEL_MINIMUM, detailLevel, and reducedDetail.

Referenced by drawUniverse, reducedDetail, and wireframeGraphics.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ reifyCargoPod:

- (ShipEntity *) reifyCargoPod: (ShipEntity *) cargoObj

Definition at line 4252 of file Universe.m.

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

◆ reinitAndShowDemo:

- (BOOL) reinitAndShowDemo: (BOOL) showDemo

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

References _sessionID, addEntity:, autoSaveNow, breakPatternCounter, cachedPlanet, cachedStation, cachedSun, OOTexture::clearCache, PlayerEntity::completeSetUp, demo_ship, demo_ship_index, demo_ship_subindex, demo_ships, OOShipRegistry::demoShipKeys, ResourceManager::dictionaryFromFilesNamed:inFolder:andMerge:, PlayerEntity::doWorldEventUntilMissionScreen:, gameController, PlayerEntity::initControls, StationEntity::initialiseLocalMarket, JSResetFlags, loadDescriptions, loadScenarios, missiontext, nil, no_update, PLAYER, populateNormalSpace, OOShipRegistry::reload, removeAllEntitiesExceptPlayer, PlayerEntity::setDockedAtMainStation, GameController::setGamePaused:, PlayerEntity::setGuiToIntroFirstGo:, PlayerEntity::setGuiToStatusScreen, GameController::setMouseInteractionModeForUIWithMouseInteraction:, GameController::setPlayerFileToLoad:, ShipEntity::setStatus:, setUpCargoPods, setUpInitialUniverse, setUpSettings, ResourceManager::setUseAddOns:, OOShipRegistry::sharedRegistry, PlayerEntity::startUpComplete, station, and verifyEntitySessionIDs.

Referenced by setUseAddOns:fromSaveGame:forceReinit:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ removeAllEntitiesExceptPlayer

- (void) removeAllEntitiesExceptPlayer

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

References activeWormholes, cachedPlanet, cachedStation, cachedSun, StationEntity::clear, closeSystems, count, entities, EXPECT, Entity::isPlayer, Entity::isStation, kOOLogInconsistentState, n_entities, nil, no_update, OOLog, OOVisualEffectEntity::remove, removeAllEntitiesExceptPlayer, removeEntity:, and resetBeacons.

Referenced by carryPlayerOn:inWormhole:, reinitAndShowDemo:, removeAllEntitiesExceptPlayer, setUpUniverseFromStation, and viewMatrix.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ removeDemoShips

- (void) removeDemoShips

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

References demo_ship, n_entities, nil, removeDemoShips, removeEntity:, and sortedEntities.

Referenced by makeDemoShipWithRole:spinning:, removeDemoShips, setupIntroFirstGo:, and viewMatrix.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ removeEntity:

- (BOOL) removeEntity: (Entity *) entity

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

References doRemoveEntity:, nil, and PLAYER.

Referenced by defineWaypoint:forKey:, populateNormalSpace, removeAllEntitiesExceptPlayer, removeDemoShips, setUpPlanet, setUpUniverseFromStation, update:, and Universe(OOPrivate)::verifyEntitySessionIDs.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ repopulateSystem

- (void) repopulateSystem

implementation

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

References EXPECT_NOT, next_repopulation, OOJSAcquireContext(), OOJSRelinquishContext(), PLAYER, repopulateSystem, and SYSTEM_REPOPULATION_INTERVAL.

Referenced by repopulateSystem, and update:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ resetBeacons

- (void) resetBeacons

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

References firstBeacon, nil, resetBeacons, setFirstBeacon:, and setLastBeacon:.

Referenced by ambientLightLevel, removeAllEntitiesExceptPlayer, resetBeacons, and setUpSettings.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ resetCommsLogColor

- (void) resetCommsLogColor

Definition at line 9942 of file Universe.m.

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

References resetCommsLogColor, GuiDisplayGen::setTextColor:, and OOColor::whiteColor.

Referenced by gui, and resetCommsLogColor.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ resetFramesDoneThisUpdate

- (void) resetFramesDoneThisUpdate

Definition at line 5297 of file Universe.m.

{
    framesDoneThisUpdate = 0;
}

References framesDoneThisUpdate, and resetFramesDoneThisUpdate.

Referenced by framesDoneThisUpdate, and resetFramesDoneThisUpdate.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ resizeTargetFramebufferWithViewSize:

- (void) resizeTargetFramebufferWithViewSize: (NSSize) viewSize

implementation

Provided by category Universe(OOPrivate).

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

References OOGL.

Referenced by drawUniverse.

Here is the caller graph for this function:

◆ role:isInCategory:

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

Definition at line 3008 of file Universe.m.

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

References nil.

Referenced by roleIsPirateVictim:.

Here is the caller graph for this function:

◆ roleIsPirateVictim:

- (BOOL) roleIsPirateVictim: (NSString *) role

Definition at line 3002 of file Universe.m.

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

References role:isInCategory:.

Here is the call graph for this function:

◆ routeFromSystem:toSystem:optimizedBy:

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

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

References RouteElement::cost, count, RouteElement::distance, distanceBetweenPlanetPositions(), RouteElement::elementWithLocation:parent:cost:distance:time:jumps:, OOSystemDescriptionManager::getCoordinatesForSystem:inGalaxy:, OOSystemDescriptionManager::getPropertiesForSystem:inGalaxy:, RouteElement::jumps, RouteElement::location, neighboursToSystem:, nil, OO_SYSTEMCONCEALMENT_NOTHING, OPTIMIZED_BY_TIME, RouteElement::parent, and RouteElement::time.

Here is the call graph for this function:

◆ safeWitchspaceExitDistance

- (GLfloat) safeWitchspaceExitDistance

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

References Entity::collisionRadius, MIN_DISTANCE_TO_BUOY, n_entities, safeWitchspaceExitDistance, and sortedEntities.

Referenced by ambientLightLevel, and safeWitchspaceExitDistance.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ scenarios

- (NSArray *) scenarios

Definition at line 8080 of file Universe.m.

{
    return _scenarios;
}

References _scenarios, and scenarios.

Referenced by missiontext, and scenarios.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ screenTextureDescriptorForKey:

- (NSDictionary *) screenTextureDescriptorForKey: (NSString *) key

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

References gui, and nil.

◆ selectIntro2Next

- (void) selectIntro2Next

Definition at line 3614 of file Universe.m.

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

References DEMO_SHOW_THING, demo_stage, demo_stage_time, selectIntro2Next, and universal_time.

Referenced by ambientLightLevel, and selectIntro2Next.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ selectIntro2NextCategory

- (void) selectIntro2NextCategory

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

References count, demo_ship_index, demo_ship_subindex, demo_ships, DEMO_SHOW_THING, demo_stage, demo_stage_time, selectIntro2NextCategory, and universal_time.

Referenced by ambientLightLevel, and selectIntro2NextCategory.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ selectIntro2Previous

- (void) selectIntro2Previous

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

References demo_ship_subindex, DEMO_SHOW_THING, demo_stage, demo_stage_time, selectIntro2Previous, and universal_time.

Referenced by ambientLightLevel, and selectIntro2Previous.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ selectIntro2PreviousCategory

- (void) selectIntro2PreviousCategory

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

References count, demo_ship_index, demo_ship_subindex, demo_ships, DEMO_SHOW_THING, demo_stage, demo_stage_time, selectIntro2PreviousCategory, and universal_time.

Referenced by ambientLightLevel, and selectIntro2PreviousCategory.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ sessionID

- (NSUInteger) sessionID

Definition at line 923 of file Universe.m.

{
    return _sessionID;
}

References _sessionID, and sessionID.

Referenced by sessionID, and update:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setAirResistanceFactor:

- (void) setAirResistanceFactor: (GLfloat) newFactor

Definition at line 10090 of file Universe.m.

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

References airResistanceFactor.

Referenced by setSkyColorRed:green:blue:alpha:, and setUpUniverseFromMisjump.

Here is the caller graph for this function:

◆ setAmbientLightLevel:

- (void) setAmbientLightLevel: (float) newValue

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

References ambientLightLevel, nil, and UNIVERSE.

◆ setAutoCommLog:

- (void) setAutoCommLog: (BOOL) value

Definition at line 10264 of file Universe.m.

                       :(BOOL)value
{
    _autoCommLog = value;
}

References _autoCommLog.

◆ setAutoMessageLogBg:

- (void) setAutoMessageLogBg: (BOOL) value

Definition at line 10246 of file Universe.m.

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

References _autoMessageLogBg.

◆ setAutoSave:

- (void) setAutoSave: (BOOL) value

Definition at line 9972 of file Universe.m.

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

References autoSave.

◆ setAutoSaveNow:

- (void) setAutoSaveNow: (BOOL) value

Definition at line 9985 of file Universe.m.

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

References autoSaveNow.

◆ setBlockJSPlayerShipProps:

- (void) setBlockJSPlayerShipProps: (BOOL) value

Definition at line 10276 of file Universe.m.

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

References gOOJSPlayerIfStale, nil, and PLAYER.

◆ setBloom:

- (void) setBloom: (BOOL) newBloom

Definition at line 286 of file Universe.m.

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

References _bloom.

◆ setCurrentPostFX:

- (void) setCurrentPostFX: (int) newCurrentPostFX

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

References _colorblindMode, _currentPostFX, OO_POSTFX_COLORBLINDNESS_TRITAN, OO_POSTFX_ENDOFLIST, and OO_POSTFX_NONE.

Referenced by terminatePostFX:.

Here is the caller graph for this function:

◆ setDetailLevel:

- (void) setDetailLevel: (OOGraphicsDetail) value

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

References detailLevel, OOLog, OOStringFromGraphicsDetail(), OOGraphicsResetManager::resetGraphicsState, setDetailLevelDirectly:, and OOGraphicsResetManager::sharedManager.

Here is the call graph for this function:

◆ setDetailLevelDirectly:

- (void) setDetailLevelDirectly: (OOGraphicsDetail) value

implementation

Provided by category Universe(OOPrivate).

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

References DETAIL_LEVEL_MAXIMUM, and DETAIL_LEVEL_MINIMUM.

Referenced by initWithGameView:, and setDetailLevel:.

Here is the caller graph for this function:

◆ setDisplayFPS:

- (void) setDisplayFPS: (BOOL) value

Definition at line 9960 of file Universe.m.

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

References displayFPS.

◆ setDisplayText:

- (void) setDisplayText: (BOOL) value

Definition at line 9948 of file Universe.m.

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

References displayGUI.

Referenced by setViewDirection:.

Here is the caller graph for this function:

◆ setDockingClearanceProtocolActive:

- (void) setDockingClearanceProtocolActive: (BOOL) newValue

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

References _dockingClearanceProtocolActive, nil, ShipEntity::primaryRole, OOShipRegistry::randomShipKeyForRole:, StationEntity::setRequiresDockingClearance:, OOShipRegistry::sharedRegistry, and station.

Referenced by Universe(OOPrivate)::setUpInitialUniverse.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setDoProcedurallyTexturedPlanets:

- (void) setDoProcedurallyTexturedPlanets: (BOOL) value

Definition at line 941 of file Universe.m.

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

References doProcedurallyTexturedPlanets.

◆ setECMVisualFXEnabled:

- (void) setECMVisualFXEnabled: (BOOL) isEnabled

Definition at line 7403 of file Universe.m.

                              :(BOOL)isEnabled
{
    ECMVisualFXEnabled = isEnabled;
}

References ECMVisualFXEnabled.

Referenced by initWithGameView:.

Here is the caller graph for this function:

◆ setFirstBeacon:

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

implementation

Provided by category Universe(OOPrivate).

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

References firstBeacon.

Referenced by clearBeacon:, resetBeacons, and setNextBeacon:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setGalaxyTo:

- (void) setGalaxyTo: (OOGalaxyID) g

Definition at line 7922 of file Universe.m.

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

References setGalaxyTo:andReinit:.

Referenced by setSystemTo:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setGalaxyTo:andReinit:

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

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

References galaxyID, OOSystemDescriptionManager::getProperty:forSystem:inGalaxy:, nil, and system_names.

Referenced by setGalaxyTo:, and Universe(OOPrivate)::setUpInitialUniverse.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setGameView:

- (void) setGameView: (MyOpenGLView *) view

Definition at line 4480 of file Universe.m.

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

References gameView.

Referenced by initWithGameView:.

Here is the caller graph for this function:

◆ setLastBeacon:

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

implementation

Provided by category Universe(OOPrivate).

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

References lastBeacon.

Referenced by clearBeacon:, resetBeacons, and setNextBeacon:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setLibraryTextForDemoShip

- (void) setLibraryTextForDemoShip

implementation

Provided by category Universe(OOPrivate).

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

References count, demoShipData, OOColor::greenColor, kOODemoShipClass, kOODemoShipShipData, nil, OOExpand, OOShipLibraryCargo(), OOShipLibraryCategoryPlural(), OOShipLibraryCategorySingular(), OOShipLibraryGenerator(), OOShipLibraryShields(), OOShipLibrarySize(), OOShipLibrarySpeed(), OOShipLibraryTurnRate(), OOShipLibraryTurrets(), OOShipLibraryWeapons(), OOShipLibraryWitchspace(), Universe(OOPrivate)::setLibraryTextForDemoShip, OOColor::whiteColor, and OOColor::yellowColor.

Referenced by Universe(OOPrivate)::setLibraryTextForDemoShip, Universe(OOPrivate)::setShaderEffectsLevelDirectly:, setupIntroFirstGo:, and update:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setLighting

- (void) setLighting

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

References ambientLightLevel, demo_light_position, docked_light_ambient, docked_light_diffuse, docked_light_specular, OOSunEntity::getDiffuseComponents:, OOColor::getRed:green:blue:alpha:, OOSunEntity::getSpecularComponents:, n_entities, nil, OOGL, Entity::position, setLighting, SKY_AMBIENT_ADJUSTMENT, SkyEntity::skyColor, sortedEntities, stars_ambient, sun, SUN_AMBIENT_INFLUENCE, sun_diffuse, and sun_specular.

Referenced by ambientLightLevel, setLighting, setUpSpace, and setUpWitchspaceBetweenSystem:andSystem:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setMainLightPosition:

- (void) setMainLightPosition: (Vector) sunPos

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

References main_light_position.

Referenced by drawUniverse, setUpSettings, and setViewDirection:.

Here is the caller graph for this function:

◆ setMessageGuiBackgroundColor:

- (void) setMessageGuiBackgroundColor: (OOColor *) some_color

Definition at line 6876 of file Universe.m.

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

References GuiDisplayGen::setBackgroundColor:.

Here is the call graph for this function:

◆ setNextBeacon:

- (void) setNextBeacon: (Entity <OOBeaconEntity> *) beaconShip

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

References firstBeacon, nil, OOLog, setFirstBeacon:, and setLastBeacon:.

Referenced by addEntity:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setPauseMessageVisible:

- (void) setPauseMessageVisible: (BOOL) value

Definition at line 10222 of file Universe.m.

                               :(BOOL)value
{
    _pauseMessage = value;
}

References _pauseMessage.

Referenced by pauseGame.

Here is the caller graph for this function:

◆ setPermanentCommLog:

- (void) setPermanentCommLog: (BOOL) value

Definition at line 10258 of file Universe.m.

                            :(BOOL)value
{
    _permanentCommLog = value;
}

References _permanentCommLog.

◆ setPermanentMessageLog:

- (void) setPermanentMessageLog: (BOOL) value

Definition at line 10234 of file Universe.m.

                               :(BOOL)value
{
    _permanentMessageLog = value;
}

References _permanentMessageLog.

◆ setPopulatorSetting:to:

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

Definition at line 1774 of file Universe.m.

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

References nil.

◆ setScreenTextureDescriptorForKey:descriptor:

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

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

References nil, and screenBackgrounds.

◆ 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 3874 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];
}

References setAirResistanceFactor:, and skyClearColor.

Referenced by setUpSpace.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ 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 8218 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;
 
}

References OOColor::blendedColorWithFraction:ofColor:, OOColor::brightColorWithDescription:, SkyEntity::changeProperty:withDictionary:, OOSunEntity::changeSunProperty:withDictionary:, OOColor::colorWithDescription:, currentSystemID, OOSunEntity::getDiffuseComponents:, OOSystemDescriptionManager::getPropertiesForCurrentSystem, OOSunEntity::getSpecularComponents:, KEY_NAME, KEY_RADIUS, KEY_TECHLEVEL, n_entities, nil, OOLogERR, planet, GuiDisplayGen::refreshStarChart, DustEntity::setDustColor:, StationEntity::setEquivalentTechLevel:, StationEntity::setLocalShipyard:, OOSystemDescriptionManager::setProperty:forSystemKey:andLayer:toValue:fromManifest:, OOSunEntity::setSunColor:, shipsForSaleForSystem:withTL:atTime:, SkyEntity::skyColor, sortedEntities, station, sun, system_names, and OOColor::whiteColor.

Referenced by setSystemDataKey:value:fromManifest:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setSystemDataKey:value:fromManifest:

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

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

References setSystemDataForGalaxy:planet:key:value:fromManifest:forLayer:.

Here is the call graph for this function:

◆ setSystemTo:

- (void) setSystemTo: (OOSystemID) s

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

References commodityMarket, DESTROY, PlayerEntity::galaxyNumber, OOCommodities::generateMarketForSystemWithEconomy:andScript:, generateSystemData:, PLAYER, setGalaxyTo:, systemID, and targetSystemID.

Referenced by carryPlayerOn:inWormhole:, and setUpUniverseFromStation.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setTimeAccelerationFactor:

- (void) setTimeAccelerationFactor: (double) newTimeAccelerationFactor

Definition at line 7376 of file Universe.m.

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

References TIME_ACCELERATION_FACTOR_DEFAULT, TIME_ACCELERATION_FACTOR_MAX, and timeAccelerationFactor.

Referenced by setUpSettings.

Here is the caller graph for this function:

◆ setUpBreakPattern:orientation:forDocking:

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

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

References addEntity:, BREAK_PATTERN_RING_SPACING, BREAK_PATTERN_RING_SPEED, breakPatternCounter, OOBreakPatternEntity::breakPatternWithPolygonSides:startAngle:aspectRatio:, OOColor::colorWithDescription:, OOColor::colorWithRed:green:blue:alpha:, globalSettings, Entity::isImmuneToBreakPatternHide, kOOBreakPatternMaxSides, nil, OOLogWARN, PLAYER, OOBreakPatternEntity::setInnerColor:outerColor:, OOBreakPatternEntity::setLifetime:, Entity::setOrientation:, Entity::setPosition:, Entity::setVelocity:, setViewDirection:, vector_forward_from_quaternion(), and witchspaceBreakPattern.

Here is the call graph for this function:

◆ setUpCargoPods

- (void) setUpCargoPods

implementation

Provided by category Universe(OOPrivate).

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

References newShipWithRole:, nil, ShipEntity::setCommodity:andAmount:, Entity::setScanClass:, and Universe(OOPrivate)::setUpCargoPods.

Referenced by initWithGameView:, reinitAndShowDemo:, and Universe(OOPrivate)::setUpCargoPods.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setUpInitialUniverse

- (void) setUpInitialUniverse

implementation

Provided by category Universe(OOPrivate).

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

References PlayerEntity::baseMass, currentSystemData, enterGUIViewModeWithMouseInteraction:, PlayerEntity::galaxyNumber, OO_DEBUG_POP_PROGRESS, OO_DEBUG_PUSH_PROGRESS, PLAYER, Entity::position, setDockingClearanceProtocolActive:, setGalaxyTo:andReinit:, Entity::setOrientation:, Entity::setPosition:, Universe(OOPrivate)::setUpInitialUniverse, PlayerEntity::setUpShipFromDictionary:, setUpSpace, OOShipRegistry::sharedRegistry, ShipEntity::shipDataKey, OOShipRegistry::shipInfoForKey:, station, and PlayerEntity::systemID.

Referenced by initWithGameView:, reinitAndShowDemo:, and Universe(OOPrivate)::setUpInitialUniverse.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setupIntroFirstGo:

- (void) setupIntroFirstGo: (BOOL) justCobra

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

References addEntity:, demo_ship, demo_ship_index, demo_ship_subindex, demo_ships, DEMO_SHOW_THING, demo_stage, demo_stage_time, OOShipRegistry::demoShipKeys, DESTROY, displayGUI, enterGUIViewModeWithMouseInteraction:, kOODemoShipClass, kOODemoShipKey, newShipWithName:usePlayerProxy:, nil, PLAYER, removeDemoShips, ShipEntity::removeEquipmentItem:, ShipEntity::setDemoShip:, ShipEntity::setDemoStartTime:, ShipEntity::setDestination:, setLibraryTextForDemoShip, Entity::setOrientation:, ShipEntity::setPendingEscortCount:, Entity::setPositionX:y:z:, Entity::setScanClass:, PlayerEntity::setShowDemoShips:, ShipEntity::setStatus:, OOShipRegistry::sharedRegistry, ShipEntity::switchAITo:, and universal_time.

Here is the call graph for this function:

◆ setUpPlanet

- (OOPlanetEntity *) setUpPlanet

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

References addEntity:, allPlanets, cachedPlanet, count, OOSystemDescriptionManager::getPropertiesForCurrentSystem, OOSystemDescriptionManager::getRandomSeedForCurrentSystem, OOLog, removeEntity:, seed_for_planet_description(), and setUpPlanet.

Referenced by ambientLightLevel, setUpPlanet, and setUpSpace.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setUpSettings

- (void) setUpSettings

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

References ResourceManager::arrayFromFilesNamed:inFolder:andMerge:, autoAIMap, characters, OOColor::colorWithDescription:, comm_log_gui, commodities, countdown_messageRepeatTime, customSounds, ResourceManager::dictionaryFromFilesNamed:inFolder:andMerge:, ResourceManager::dictionaryFromFilesNamed:inFolder:mergeMode:cache:, entity_for_uid, equipmentData, equipmentDataOutfitting, explosionSettings, globalSettings, gui, loadDescriptions, OOEquipmentType::loadEquipment, message_gui, messageRepeatTime, next_universal_id, resetBeacons, roleCategories, ResourceManager::roleCategoriesDictionary, screenBackgrounds, setMainLightPosition:, GuiDisplayGen::setTextColor:, setTimeAccelerationFactor:, setUpSettings, speechArray, ResourceManager::systemDescriptionManager, systemManager, time_delta, universal_time, and GuiDisplayGen::userSettings.

Referenced by initWithGameView:, reinitAndShowDemo:, setUpSettings, and useAddOns.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setUpSpace

- (void) setUpSpace

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

References addEntity:, ambientLightLevel, OOColor::blendedColorWithFraction:ofColor:, cachedPlanet, cachedStation, cachedSun, CollisionRegion::clearSubregions, closeSystems, OOColor::colorWithDescription:, OOColor::colorWithHue:saturation:brightness:alpha:, DESTROY, OOSystemDescriptionManager::getPropertiesForCurrentSystem, OOSystemDescriptionManager::getRandomSeedForCurrentSystem, GameController::logProgress:, nil, OO_DEBUG_POP_PROGRESS, OO_DEBUG_PUSH_PROGRESS, OOLog, OOLogWARN, populateSpaceFromActiveWormholes, randf(), Ranrot(), seed_for_planet_description(), StationEntity::setAllegiance:, StationEntity::setAllowsFastDocking:, DustEntity::setDustColor:, Entity::setEnergy:, StationEntity::setEquivalentTechLevel:, setLighting, Entity::setOrientation:, ShipEntity::setPitch:, Entity::setPosition:, OOSunEntity::setPosition:, OOSunEntity::setRadius:andCorona:, Entity::setScanClass:, setSkyColorRed:green:blue:alpha:, Entity::setStatus:, ShipEntity::setStatus:, Entity::setThrowSparks:, setUpPlanet, setUpSpace, Entity::setVelocity:, GameController::sharedController, and OOColor::whiteColor.

Referenced by carryPlayerOn:inWormhole:, Universe(OOPrivate)::setUpInitialUniverse, setUpSpace, setUpUniverseFromStation, setUpUniverseFromWitchspace, and useAddOns.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setUpUniverseFromMisjump

- (void) setUpUniverseFromMisjump

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

References addEntity:, count, displayGUI, entities, PlayerEntity::leaveWitchspace, setAirResistanceFactor:, setUpUniverseFromMisjump, setUpWitchspace, and setViewDirection:.

Referenced by setUpUniverseFromMisjump, and useAddOns.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setUpUniverseFromStation

- (void) setUpUniverseFromStation

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

References autoSaveNow, StationEntity::clear, closeSystems, count, PlayerEntity::currentSystemID, displayGUI, PlayerEntity::dockedStation, ShipEntity::doScriptEvent:withArgument:, entities, findSystemNumberAtCoords:withGalaxy:includingHidden:, PlayerEntity::galaxy_coordinates, PlayerEntity::galaxyNumber, StationEntity::interstellarUndockingAllowed, Entity::isStation, PlayerEntity::jumpCause, nil, PLAYER, populateNormalSpace, quaternion_set_random(), randomDistanceWithinScanner, removeAllEntitiesExceptPlayer, removeEntity:, PlayerEntity::setJumpCause:, Entity::setPosition:, PlayerEntity::setPreviousSystemID:, PlayerEntity::setSystemID:, setSystemTo:, setUpSpace, setUpUniverseFromStation, setViewDirection:, setWitchspaceBreakPattern:, sun, and vector_forward_from_quaternion().

Referenced by setUpUniverseFromStation, and useAddOns.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setUpUniverseFromWitchspace

- (void) setUpUniverseFromWitchspace

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

References addEntity:, PlayerEntity::commLog, count, PlayerEntity::dial_clock_adjusted, displayGUI, entities, getSystemName:, PlayerEntity::leaveWitchspace, populateNormalSpace, GuiDisplayGen::printLongText:align:color:fadeTime:key:addToArray:, setUpSpace, setUpUniverseFromWitchspace, setViewDirection:, and OOColor::whiteColor.

Referenced by setUpUniverseFromWitchspace, and useAddOns.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setUpWitchspace

- (void) setUpWitchspace

Definition at line 1264 of file Universe.m.

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

References setUpWitchspace, and setUpWitchspaceBetweenSystem:andSystem:.

Referenced by setUpUniverseFromMisjump, setUpWitchspace, and useAddOns.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setUpWitchspaceBetweenSystem:andSystem:

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

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

References addEntity:, ambientLightLevel, CollisionRegion::clearSubregions, clearSystemPopulator, OOColor::colorWithRed:green:blue:alpha:, OOSystemDescriptionManager::getPropertiesForSystemKey:, keyForInterstellarOverridesForSystems:s1:inGalaxy:, kOOLogUniversePopulateWitchspace, next_repopulation, nil, OOEnforceStandards(), OOJSAcquireContext(), OOJSRelinquishContext(), OOLog, OOLogIndentIf, OOLogOutdentIf, OOStandardsDeprecated(), PLAYER, populateSystemFromDictionariesWithSun:andPlanet:, quaternion_set_random(), randf(), PlayerEntity::runUnsanitizedScriptActions:allowingAIMethods:withContextName:forTarget:, setLighting, Entity::setOrientation:, Entity::setScanClass:, SYSTEM_REPOPULATION_INTERVAL, and system_repopulator.

Referenced by carryPlayerOn:inWormhole:, and setUpWitchspace.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setUseAddOns:fromSaveGame:

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

Definition at line 954 of file Universe.m.

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

References setUseAddOns:fromSaveGame:forceReinit:.

Here is the call graph for this function:

◆ setUseAddOns:fromSaveGame:forceReinit:

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

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

References DESTROY, reinitAndShowDemo:, and useAddOns.

Referenced by handleGameOver, and setUseAddOns:fromSaveGame:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setViewDirection:

- (void) setViewDirection: (OOViewID) vd

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

References addMessage:forCount:, GuiDisplayGen::clear, DESC, displayGUI, gameController, GameController::isGamePaused, nil, setDisplayText:, setMainLightPosition:, GameController::setMouseInteractionModeForFlight, GameController::setMouseInteractionModeForUIWithMouseInteraction:, and viewDirection.

Referenced by enterGUIViewModeWithMouseInteraction:, setUpBreakPattern:orientation:forDocking:, setUpUniverseFromMisjump, setUpUniverseFromStation, and setUpUniverseFromWitchspace.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setWireframeGraphics:

- (void) setWireframeGraphics: (BOOL) value

Definition at line 9997 of file Universe.m.

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

References wireframeGraphics.

◆ setWitchspaceBreakPattern:

- (void) setWitchspaceBreakPattern: (BOOL) newValue

Definition at line 3150 of file Universe.m.

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

References _witchspaceBreakPattern.

Referenced by carryPlayerOn:inWormhole:, and setUpUniverseFromStation.

Here is the caller graph for this function:

◆ shipClassForShipDictionary:

- (Class) shipClassForShipDictionary: (NSDictionary *) dict

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

References nil, OOJS_PROFILE_ENTER, and OOJS_PROFILE_EXIT.

Referenced by newShipWithName:usePlayerProxy:isSubentity:andScaleFactor:.

Here is the caller graph for this function:

◆ shipsForSaleForSystem:withTL:atTime:

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

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

References Random_Seed::a, Random_Seed::b, Random_Seed::c, OOJSScript::callMethod:inContext:withArguments:count:result:, compareName(), OOEquipmentType::conditionScript, count, cunningFee(), Random_Seed::d, DESC_PLURAL, descriptions, Random_Seed::e, ENTITY_PERSONALITY_MAX, OOEquipmentType::equipmentTypeWithIdentifier:, Random_Seed::f, generateSystemData:, getConditionScript:, getEquipmentPriceForKey:, isWeaponNone(), KEY_CHANCE, marketSeed, MAX, MIN, OOEquipmentType::name, nil, OOJSAcquireContext(), OOJSRelinquishContext(), OOJSValueFromNativeObject(), OOWeaponTypeFromEquipmentIdentifierSloppy(), PASSENGER_BERTH_SPACE, PLAYER, OOShipRegistry::playerShipKeys, OOEquipmentType::price, randf(), Ranrot(), ranrot_srand(), RANROTGetFullSeed(), RanrotSeedFromRandomSeed(), RANROTSetFullSeed(), RanrotWithSeed(), rotate_seed(), OOShipRegistry::sharedRegistry, OOShipRegistry::shipInfoForKey:, OOShipRegistry::shipyardInfoForKey:, OOEquipmentType::techLevel, VALID_WEAPON_FACINGS, WEAPON_FACING_AFT, and WEAPON_FACING_FORWARD.

Referenced by setSystemDataForGalaxy:planet:key:value:fromManifest:forLayer:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ shortTimeDescription:

- (NSString *) shortTimeDescription: (OOTimeDelta) interval

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

References DESC.

◆ showCommsLog:

- (void) showCommsLog: (OOTimeDelta) how_long

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

References GuiDisplayGen::fadeOutFromTime:overDuration:, getTime, permanentCommLog, and GuiDisplayGen::setAlpha:.

Referenced by addCommsMessage:forCount:andShowComms:logOnly:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ showGUIMessage:withScroll:andColor:overDuration:

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

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

References GuiDisplayGen::printLineNoScroll:align:color:fadeTime:key:addToArray:, GuiDisplayGen::printLongText:align:color:fadeTime:key:addToArray:, and GuiDisplayGen::setAlpha:.

Referenced by addCommsMessage:forCount:andShowComms:logOnly:, addMessage:forCount:forceDisplay:, displayCountdownMessage:forCount:, and displayMessage:forCount:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ skyClearColor

- (GLfloat *) skyClearColor

References breakPatternHide, breakPatternOver, and skyClearColor.

Here is the call graph for this function:

◆ soundNameForCustomSoundKey:

- (NSString *) soundNameForCustomSoundKey: (NSString *) key

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

References count, nil, OOCacheManager::objectForKey:inCache:, OOLog, OOLogERR, OOCacheManager::setObject:forKey:inCache:, and OOCacheManager::sharedCache.

Here is the call graph for this function:

◆ spawnShip:

- (BOOL) spawnShip: (NSString *) shipdesc

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

References addEntity:, coordinatesFromCoordinateSystemString:, kBasisZHPVector, kBasisZVector, kZeroHPVector, newShipWithName:, nil, OOHPVectorRandomRadial(), OOLogERR, OOLogWARN, OOStandardsDeprecated(), planet, Entity::position, quaternion_rotation_between(), SCANNER_MAX_RANGE, Entity::setOrientation:, Entity::setPosition:, OOShipRegistry::sharedRegistry, OOShipRegistry::shipInfoForKey:, and sun.

Here is the call graph for this function:

◆ spawnShipWithRole:near:

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

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

References addShipWithRole:launchPos:rfactor:, Entity::collision_radius, nil, quaternion_set_random(), randf(), Entity::setOrientation:, and vector_forward_from_quaternion().

Here is the call graph for this function:

◆ speakWithSubstitutions:

- (void) speakWithSubstitutions: (NSString *) text

implementation

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

References getSystemName:, nil, OOSPEECHSETTINGS_OFF, PLAYER, speechArray, startSpeakingString:, stopSpeaking, and PlayerEntity::targetSystemID.

Referenced by addCommsMessage:forCount:andShowComms:logOnly:, and addMessage:forCount:forceDisplay:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ startSpeakingString:

- (void) startSpeakingString: (NSString *) text

Definition at line 10099 of file Universe.m.

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

References OOSound::masterVolume.

Referenced by speakWithSubstitutions:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ station

- (StationEntity *) station

Definition at line 3633 of file Universe.m.

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

References cachedStation, cachedSun, findOneEntityMatchingPredicate:parameter:, nil, and station.

Referenced by addShipsToRoute:withRole:quantity:routeFraction:asGroup:, addShipWithRole:nearRouteOneAt:, ambientLightLevel, getStationMarkets, loadStationMarkets:, locationByCode:withSun:andPlanet:, reinitAndShowDemo:, setDockingClearanceProtocolActive:, setSystemDataForGalaxy:planet:key:value:fromManifest:forLayer:, Universe(OOPrivate)::setUpInitialUniverse, station, stationWithRole:andPosition:, and unMagicMainStation.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ stationFriendlyTo:

- (StationEntity *) stationFriendlyTo: (ShipEntity *) ship

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

References findOneEntityMatchingPredicate:parameter:.

Here is the call graph for this function:

◆ stations

- (NSArray *) stations

Definition at line 3703 of file Universe.m.

{
    return [allStations allObjects];
}

References stations.

Referenced by ambientLightLevel, getStationMarkets, loadStationMarkets:, stations, and stationWithRole:andPosition:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ stationWithRole:andPosition:

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

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

References nil, station, and stations.

Here is the call graph for this function:

◆ stopSpeaking

- (void) stopSpeaking

Definition at line 10105 of file Universe.m.

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

References speechSynthesizer, and stopSpeaking.

Referenced by airResistanceFactor, speakWithSubstitutions:, and stopSpeaking.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ sun

- (OOSunEntity *) sun

Definition at line 3687 of file Universe.m.

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

References cachedSun, findOneEntityMatchingPredicate:parameter:, nil, and sun.

Referenced by addShipsToRoute:withRole:quantity:routeFraction:asGroup:, ambientLightLevel, coordinatesForPosition:withCoordinateSystem:returningScalar:, getSunSkimEndPositionForShip:, getSunSkimStartPositionForShip:, inInterstellarSpace, legacyPositionFrom:asCoordinateSystem:, locationByCode:withSun:andPlanet:, populateSystemFromDictionariesWithSun:andPlanet:, setLighting, setSystemDataForGalaxy:planet:key:value:fromManifest:forLayer:, setUpUniverseFromStation, spawnShip:, and sun.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ systemDataForGalaxy:planet:key:

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

Definition at line 8371 of file Universe.m.

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

References OOSystemDescriptionManager::getProperty:forSystem:inGalaxy:.

Here is the call graph for this function:

◆ systemDataKeysForGalaxy:planet:

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

Definition at line 8364 of file Universe.m.

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

References generateSystemDataForGalaxy:planet:.

Here is the call graph for this function:

◆ systemManager

- (OOSystemDescriptionManager *) systemManager

References currentSystemData, inInterstellarSpace, preloadSounds, systemManager, and systemsFound.

Here is the call graph for this function:

◆ systemNameIndex:

- (NSString *) systemNameIndex: (OOSystemID) index

Definition at line 8662 of file Universe.m.

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

References system_names.

◆ systemsFound

- (BOOL *) systemsFound

Definition at line 8656 of file Universe.m.

{
    return (BOOL*)system_found;
}

References system_found, and systemsFound.

Referenced by systemManager, and systemsFound.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ terminatePostFX:

- (void) terminatePostFX: (int) postFX

Definition at line 312 of file Universe.m.

                        :(int)postFX
{
    if ([self currentPostFX] == postFX)
    {
        [self setCurrentPostFX:[self colorblindMode]];
    }
}

References colorblindMode, currentPostFX, and setCurrentPostFX:.

Here is the call graph for this function:

◆ timeAccelerationFactor

- (double) timeAccelerationFactor

References timeAccelerationFactor.

◆ timeDescription:

- (NSString *) timeDescription: (OOTimeDelta) interval

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

References count, OOEquipmentType::equipmentTypeWithIdentifier:, nil, OOEquipmentIdentifierFromWeaponType(), OOLogERR, OOShipRegistry::sharedRegistry, OOShipRegistry::shipyardInfoForKey:, and UNIVERSE.

Here is the call graph for this function:

◆ unMagicMainStation

- (void) unMagicMainStation

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

References cachedStation, Entity::isExplicitlyNotMainStation, nil, station, and unMagicMainStation.

Referenced by ambientLightLevel, and unMagicMainStation.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ update:

- (void) update: (OOTimeDelta) delta_t

Definition at line 7078 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");
}

References _sessionID, count, DEMO2_FLY_IN_STAGE_TIME, DEMO2_VANISHING_DISTANCE, DEMO_FLY_IN, DEMO_FLY_OUT, demo_ship, demo_ship_index, demo_ship_subindex, demo_ships, DEMO_SHOW_THING, demo_stage, demo_stage_time, demo_start_time, demo_start_z, demoShipData, ShipEntity::destination, doLinkedListMaintenanceThisUpdate, entitiesDeadThisUpdate, EXPECT, EXPECT_NOT, filterSortedLists, findCollisionsAndShadows, OOJavaScriptEngine::garbageCollectionOpportunity:, ShipEntity::getAI, handleOoliteException:, kIdentityQuaternion, kOOLogException, M_PI, MaintainLinkedLists(), n_entities, newShipWithName:usePlayerProxy:, next_repopulation, AI::nextThinkTime, nil, no_update, OOJSAcquireContext(), OOJSRelinquishContext(), OOLog, OOLogERR, PLAYER, quaternion_rotate_about_y(), removeEntity:, ShipEntity::removeEquipmentItem:, repopulateSystem, sessionID, ShipEntity::setDemoShip:, ShipEntity::setDemoStartTime:, ShipEntity::setDestination:, setLibraryTextForDemoShip, AI::setNextThinkTime:, Entity::setOrientation:, Entity::setPosition:, Entity::setPositionX:y:z:, Entity::setScanClass:, ShipEntity::setStatus:, Entity::setVelocity:, OOJavaScriptEngine::sharedEngine, skyClearColor, sortedEntities, ShipEntity::switchAITo:, AI::think, AI::thinkTimeInterval, time_delta, timeAccelerationFactor, universal_time, Entity::update:, Entity::updateLinkedLists, verifyEntitySessionIDs, Entity::zero_distance, and Entity::zero_index.

Here is the call graph for this function:

◆ useAddOns

- (NSString *) useAddOns

References clearSystemPopulator, debugDumpEntities, deterministicPopulation, doingStartUp, entityCount, entityList, getPopulatorSettings, pauseGame, populateNormalSpace, setUpSettings, setUpSpace, setUpUniverseFromMisjump, setUpUniverseFromStation, setUpUniverseFromWitchspace, setUpWitchspace, and useAddOns.

Here is the call graph for this function:

◆ useGUILightSource:

- (void) useGUILightSource: (BOOL) GUILight

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

References demo_light_on, OOGL, and useShaders.

Here is the call graph for this function:

◆ useShaders

- (BOOL) useShaders

Definition at line 10056 of file Universe.m.

{
    return detailLevel >= DETAIL_LEVEL_SHADERS;
}

References DETAIL_LEVEL_SHADERS, detailLevel, and useShaders.

Referenced by detailLevel, drawUniverse, lightForEntity:, useGUILightSource:, and useShaders.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ VerifyDesc

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

implementation

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

References OOLogERR, VerifyDesc, VerifyDescArray, and VerifyDescString.

Referenced by VerifyDesc, and VerifyDescArray.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ VerifyDescArray

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

implementation

Definition at line 8009 of file Universe.m.

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

References nil, and VerifyDesc.

Referenced by VerifyDesc.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ verifyDescriptions

- (void) verifyDescriptions

implementation

Provided by category Universe(OOPrivate).

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

References foreachkey, nil, OOLog, and Universe(OOPrivate)::verifyDescriptions.

Referenced by descriptions, Universe(OOPrivate)::loadDescriptions, Universe(OOPrivate)::setShaderEffectsLevelDirectly:, and Universe(OOPrivate)::verifyDescriptions.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ VerifyDescString

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

implementation

Definition at line 7999 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.

Referenced by VerifyDesc.

Here is the caller graph for this function:

◆ verifyEntitySessionIDs

- (void) verifyEntitySessionIDs

implementation

Provided by category Universe(OOPrivate).

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

References nil, OOLogERR, removeEntity:, and Universe(OOPrivate)::verifyEntitySessionIDs.

Referenced by reinitAndShowDemo:, Universe(OOPrivate)::setShaderEffectsLevelDirectly:, update:, and Universe(OOPrivate)::verifyEntitySessionIDs.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ viewDirection

- (OOViewID) viewDirection

References clearPreviousMessage, and viewDirection.

Here is the call graph for this function:

◆ viewFrustumIntersectsSphereAt:withRadius:

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

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

References frustum.

◆ viewMatrix

- (OOMatrix) viewMatrix

References collisionDescription, dumpCollisions, findCollisionsAndShadows, firstEntityTargetedByPlayer, firstEntityTargetedByPlayerPrecisely, getTime, getTimeDelta, removeAllEntitiesExceptPlayer, removeDemoShips, and viewMatrix.

Here is the call graph for this function:

◆ wireframeGraphics

- (BOOL) wireframeGraphics

References reducedDetail, and wireframeGraphics.

Here is the call graph for this function:

◆ witchspaceBreakPattern

- (BOOL) witchspaceBreakPattern

Definition at line 3144 of file Universe.m.

{
    return _witchspaceBreakPattern;
}

References _witchspaceBreakPattern, and witchspaceBreakPattern.

Referenced by ambientLightLevel, setUpBreakPattern:orientation:forDocking:, and witchspaceBreakPattern.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ witchspaceShipWithPrimaryRole:

- (void) witchspaceShipWithPrimaryRole: (NSString *) role

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

References currentSystemData, fillCargopodWithRandomCargo:, ShipEntity::leaveWitchspace, makeSunSkimmer:andSetAI:, newShipWithRole:, nil, ShipEntity::pendingEscortCount, randf(), OOCharacter::randomCharacterWithRole:andOriginalSystem:, Ranrot(), ShipEntity::setBounty:withReason:, ShipEntity::setCargoFlag:, ShipEntity::setCrew:, Entity::setScanClass:, and ShipEntity::switchAITo:.

Here is the call graph for this function:

◆ wormholes

- (NSArray *) wormholes

Definition at line 3709 of file Universe.m.

{
    return activeWormholes;
}

References activeWormholes, and wormholes.

Referenced by ambientLightLevel, and wormholes.

Here is the call graph for this function:

Here is the caller graph for this function:

Member Data Documentation

◆ _autoCommLog

- (BOOL) _autoCommLog

private

Definition at line 352 of file Universe.h.

Referenced by setAutoCommLog:.

◆ _autoMessageLogBg

- (BOOL) _autoMessageLogBg

private

Definition at line 354 of file Universe.h.

Referenced by autoMessageLogBg, and setAutoMessageLogBg:.

◆ _bloom

- (BOOL) _bloom

private

Definition at line 376 of file Universe.h.

Referenced by bloom, and setBloom:.

◆ _colorblindMode

- (int) _colorblindMode

private

Definition at line 378 of file Universe.h.

Referenced by colorblindMode, and setCurrentPostFX:.

◆ _currentPostFX

- (int) _currentPostFX

private

Definition at line 377 of file Universe.h.

Referenced by currentPostFX, and setCurrentPostFX:.

◆ _descriptions

- (NSDictionary*) _descriptions

private

Definition at line 267 of file Universe.h.

Referenced by descriptions.

◆ _dockingClearanceProtocolActive

- (BOOL) _dockingClearanceProtocolActive

private

Definition at line 357 of file Universe.h.

Referenced by dockingClearanceProtocolActive, and setDockingClearanceProtocolActive:.

◆ _doingStartUp

- (BOOL) _doingStartUp

private

Definition at line 358 of file Universe.h.

Referenced by doingStartUp, and initWithGameView:.

◆ _firstBeacon

- (OOWeakReference*) _firstBeacon

private

Definition at line 221 of file Universe.h.

Referenced by dealloc.

◆ _lastBeacon

- (OOWeakReference *) _lastBeacon

private

Definition at line 222 of file Universe.h.

Referenced by dealloc.

◆ _pauseMessage

- (BOOL) _pauseMessage

private

Definition at line 351 of file Universe.h.

Referenced by pauseMessageVisible, and setPauseMessageVisible:.

◆ _permanentCommLog

- (BOOL) _permanentCommLog

private

Definition at line 353 of file Universe.h.

Referenced by permanentCommLog, and setPermanentCommLog:.

◆ _permanentMessageLog

- (BOOL) _permanentMessageLog

private

Definition at line 355 of file Universe.h.

Referenced by permanentMessageLog, and setPermanentMessageLog:.

◆ _scenarios

- (NSArray*) _scenarios

private

Definition at line 270 of file Universe.h.

Referenced by scenarios.

◆ _sessionID

- (NSUInteger) _sessionID

private

Definition at line 202 of file Universe.h.

Referenced by reinitAndShowDemo:, sessionID, and update:.

◆ _witchspaceBreakPattern

- (BOOL) _witchspaceBreakPattern

private

Definition at line 356 of file Universe.h.

Referenced by setWitchspaceBreakPattern:, and witchspaceBreakPattern.

◆ activeWormholes

- (NSMutableArray*) activeWormholes

private

Definition at line 320 of file Universe.h.

Referenced by removeAllEntitiesExceptPlayer, and wormholes.

◆ airResistanceFactor

- (GLfloat) airResistanceFactor

private

Definition at line 10084 of file Universe.m.

{
    return airResistanceFactor;
}

Referenced by airResistanceFactor, drawUniverse, and setAirResistanceFactor:.

◆ allPlanets

- (NSMutableArray*) allPlanets

private

Definition at line 298 of file Universe.h.

Referenced by initWithGameView:, planet, planets, and setUpPlanet.

◆ allStations

- (NSMutableSet*) allStations

private

Definition at line 299 of file Universe.h.

Referenced by initWithGameView:.

◆ ambientLightLevel

- (float) ambientLightLevel

private

Definition at line 2018 of file Universe.m.

{
    return ambientLightLevel;
}

Referenced by ambientLightLevel, setAmbientLightLevel:, setLighting, setUpSpace, and setUpWitchspaceBetweenSystem:andSystem:.

◆ autoAIMap

- (NSDictionary*) autoAIMap

private

Definition at line 278 of file Universe.h.

Referenced by setUpSettings.

◆ autoSave

- (BOOL) autoSave

private

Definition at line 9979 of file Universe.m.

{
    return autoSave;
}

Referenced by autoSave, initWithGameView:, and setAutoSave:.

◆ autoSaveNow

- (BOOL) autoSaveNow

private

Definition at line 9991 of file Universe.m.

{
    return autoSaveNow;
}

Referenced by autoSaveNow, reinitAndShowDemo:, setAutoSaveNow:, and setUpUniverseFromStation.

◆ blurProgram

- (OOShaderProgram*) blurProgram

private

Definition at line 370 of file Universe.h.

◆ breakPatternCounter

- (int) breakPatternCounter

private

Definition at line 291 of file Universe.h.

Referenced by breakPatternHide, breakPatternOver, reinitAndShowDemo:, and setUpBreakPattern:orientation:forDocking:.

◆ cachedPlanet

- (OOPlanetEntity*) cachedPlanet

private

Definition at line 296 of file Universe.h.

Referenced by planet, populateNormalSpace, reinitAndShowDemo:, removeAllEntitiesExceptPlayer, setUpPlanet, and setUpSpace.

◆ cachedStation

- (StationEntity*) cachedStation

private

Definition at line 295 of file Universe.h.

Referenced by populateNormalSpace, reinitAndShowDemo:, removeAllEntitiesExceptPlayer, setUpSpace, station, and unMagicMainStation.

◆ cachedSun

- (OOSunEntity*) cachedSun

private

Definition at line 297 of file Universe.h.

Referenced by drawUniverse, populateNormalSpace, reinitAndShowDemo:, removeAllEntitiesExceptPlayer, setUpSpace, station, and sun.

◆ cargoPods

- (NSDictionary*) cargoPods

private

Definition at line 282 of file Universe.h.

◆ characterPool

- (NSMutableArray*) characterPool

private

Definition at line 322 of file Universe.h.

◆ characters

- (NSDictionary *) characters

private

Definition at line 8093 of file Universe.m.

{
    return characters;
}

Referenced by characters, and setUpSettings.

◆ closeSystems

- (NSArray*) closeSystems

private

Definition at line 308 of file Universe.h.

Referenced by neighboursToSystem:, removeAllEntitiesExceptPlayer, setUpSpace, and setUpUniverseFromStation.

◆ comm_log_gui

- (GuiDisplayGen*) comm_log_gui

private

Definition at line 233 of file Universe.h.

Referenced by commLogGUI, initWithGameView:, and setUpSettings.

◆ commodities

- (OOCommodities *) commodities

private

Definition at line 4245 of file Universe.m.

{
    return commodities;
}

Referenced by commodities, getContainersOfCommodity:commodity_name:, and setUpSettings.

◆ commodityMarket

- (OOCommodityMarket *) commodityMarket

private

Definition at line 8894 of file Universe.m.

{
    return commodityMarket;
}

Referenced by commodityMarket, getContainersOfGoods:scarce:legal:, and setSystemTo:.

◆ conditionScripts

- (NSMutableDictionary*) conditionScripts

private

Definition at line 349 of file Universe.h.

Referenced by addConditionScripts:, and loadConditionScripts.

◆ countdown_messageRepeatTime

- (OOTimeAbsolute) countdown_messageRepeatTime

private

Definition at line 229 of file Universe.h.

Referenced by displayCountdownMessage:forCount:, and setUpSettings.

◆ currentMessage

- (NSString*) currentMessage

private

Definition at line 227 of file Universe.h.

Referenced by addCommsMessage:forCount:andShowComms:logOnly:, addMessage:forCount:forceDisplay:, clearPreviousMessage, displayCountdownMessage:forCount:, and displayMessage:forCount:.

◆ cursor_row

- (int) cursor_row

Definition at line 194 of file Universe.h.

Referenced by drawMessage.

◆ customSounds

- (NSDictionary*) customSounds

private

Definition at line 268 of file Universe.h.

Referenced by preloadSounds, and setUpSettings.

◆ defaultDrawFBO

- (GLint) defaultDrawFBO

private

Definition at line 373 of file Universe.h.

Referenced by drawUniverse.

◆ demo_ship

- (ShipEntity*) demo_ship

private

Definition at line 293 of file Universe.h.

Referenced by reinitAndShowDemo:, removeDemoShips, setupIntroFirstGo:, and update:.

◆ demo_ship_index

- (NSUInteger) demo_ship_index

private

Definition at line 255 of file Universe.h.

Referenced by reinitAndShowDemo:, selectIntro2NextCategory, selectIntro2PreviousCategory, setupIntroFirstGo:, and update:.

◆ demo_ship_subindex

- (NSUInteger) demo_ship_subindex

private

Definition at line 256 of file Universe.h.

Referenced by reinitAndShowDemo:, selectIntro2NextCategory, selectIntro2Previous, selectIntro2PreviousCategory, setupIntroFirstGo:, and update:.

◆ demo_ships

- (NSArray*) demo_ships

private

Definition at line 257 of file Universe.h.

Referenced by reinitAndShowDemo:, selectIntro2NextCategory, selectIntro2PreviousCategory, setupIntroFirstGo:, and update:.

◆ demo_stage

- (int) demo_stage

private

Definition at line 254 of file Universe.h.

Referenced by selectIntro2Next, selectIntro2NextCategory, selectIntro2Previous, selectIntro2PreviousCategory, setupIntroFirstGo:, and update:.

◆ demo_stage_time

- (OOTimeAbsolute) demo_stage_time

private

Definition at line 251 of file Universe.h.

Referenced by selectIntro2Next, selectIntro2NextCategory, selectIntro2Previous, selectIntro2PreviousCategory, setupIntroFirstGo:, and update:.

◆ demo_start_time

- (OOTimeAbsolute) demo_start_time

private

Definition at line 252 of file Universe.h.

Referenced by update:.

◆ demo_start_z

- (GLfloat) demo_start_z

private

Definition at line 253 of file Universe.h.

Referenced by update:.

◆ detailLevel

- (OOGraphicsDetail) detailLevel

private

Definition at line 10050 of file Universe.m.

{
    return detailLevel;
}

Referenced by bloom, detailLevel, gameSettings, Universe(OOPrivate)::initTargetFramebufferWithViewSize:, reducedDetail, setDetailLevel:, and useShaders.

◆ deterministic_population

- (BOOL) deterministic_population

private

Definition at line 306 of file Universe.h.

Referenced by deterministicPopulation, and populateSystemFromDictionariesWithSun:andPlanet:.

◆ displayFPS

- (BOOL) displayFPS

private

Definition at line 9966 of file Universe.m.

{
    return displayFPS;
}

Referenced by displayFPS, and setDisplayFPS:.

◆ displayGUI

- (BOOL) displayGUI

private

Definition at line 9954 of file Universe.m.

{
    return displayGUI;
}

Referenced by displayGUI, drawMessage, drawUniverse, setDisplayText:, setupIntroFirstGo:, setUpUniverseFromMisjump, setUpUniverseFromStation, setUpUniverseFromWitchspace, and setViewDirection:.

◆ doLinkedListMaintenanceThisUpdate

- (BOOL) doLinkedListMaintenanceThisUpdate

private

Definition at line 327 of file Universe.h.

Referenced by addEntity:, and update:.

◆ doProcedurallyTexturedPlanets

- (BOOL) doProcedurallyTexturedPlanets

private

Definition at line 935 of file Universe.m.

{
    return doProcedurallyTexturedPlanets;
}

Referenced by doProcedurallyTexturedPlanets, initWithGameView:, and setDoProcedurallyTexturedPlanets:.

◆ dumpCollisionInfo

- (BOOL) dumpCollisionInfo

private

Definition at line 261 of file Universe.h.

Referenced by dumpCollisions.

◆ ECMVisualFXEnabled

- (BOOL) ECMVisualFXEnabled

private

Definition at line 7397 of file Universe.m.

{
    return ECMVisualFXEnabled;
}

Referenced by ECMVisualFXEnabled, and setECMVisualFXEnabled:.

◆ entities

- (NSMutableArray*) entities

private

Definition at line 219 of file Universe.h.

Referenced by addEntity:, debugDumpEntities, initWithGameView:, MaintainLinkedLists, removeAllEntitiesExceptPlayer, setUpUniverseFromMisjump, setUpUniverseFromStation, and setUpUniverseFromWitchspace.

◆ entitiesDeadThisUpdate

- (NSMutableSet*) entitiesDeadThisUpdate

private

Definition at line 329 of file Universe.h.

Referenced by initWithGameView:, and update:.

◆ entity_for_uid

- (Entity* entity_for_uid[MAX_ENTITY_UID])

private

Definition at line 217 of file Universe.h.

Referenced by addEntity:, entityForUniversalID:, and setUpSettings.

◆ equipmentData

- (NSArray *) equipmentData

private

Definition at line 8882 of file Universe.m.

{
    return equipmentData;
}

Referenced by equipmentData, getEquipmentPriceForKey:, and setUpSettings.

◆ equipmentDataOutfitting

- (NSArray *) equipmentDataOutfitting

private

Definition at line 8888 of file Universe.m.

{
    return equipmentDataOutfitting;
}

Referenced by equipmentDataOutfitting, and setUpSettings.

◆ explosionSettings

- (NSDictionary*) explosionSettings

private

Definition at line 280 of file Universe.h.

Referenced by setUpSettings.

◆ finalProgram

- (OOShaderProgram*) finalProgram

private

Definition at line 371 of file Universe.h.

◆ framesDoneThisUpdate

- (int) framesDoneThisUpdate

private

Definition at line 5291 of file Universe.m.

{
    return framesDoneThisUpdate;
}

Referenced by drawUniverse, framesDoneThisUpdate, initWithGameView:, and resetFramesDoneThisUpdate.

◆ frustum

- (GLfloat frustum[6][4])

private

Definition at line 347 of file Universe.h.

Referenced by defineFrustum, and viewFrustumIntersectsSphereAt:withRadius:.

◆ galaxyID

- (OOGalaxyID) galaxyID

private

Definition at line 284 of file Universe.h.

Referenced by setGalaxyTo:andReinit:.

◆ gameView

- (MyOpenGLView *) gameView

private

Definition at line 4487 of file Universe.m.

{
    return gameView;
}

Referenced by drawUniverse, drawWatermarkString:, gameController, gameSettings, gameView, and setGameView:.

◆ globalSettings

- (NSDictionary *) globalSettings

private

Definition at line 8876 of file Universe.m.

{
    return globalSettings;
}

Referenced by globalSettings, setUpBreakPattern:orientation:forDocking:, and setUpSettings.

◆ gui

- (GuiDisplayGen *) gui

private

Definition at line 9914 of file Universe.m.

{
    return gui;
}

Referenced by gui, initWithGameView:, pauseGame, screenTextureDescriptorForKey:, and setUpSettings.

◆ main_light_position

- (GLfloat main_light_position[4])

private

Definition at line 259 of file Universe.h.

Referenced by drawUniverse, and setMainLightPosition:.

◆ message_gui

- (GuiDisplayGen*) message_gui

private

Definition at line 232 of file Universe.h.

Referenced by messageGUI, and setUpSettings.

◆ messageRepeatTime

- (OOTimeAbsolute) messageRepeatTime

private

Definition at line 228 of file Universe.h.

Referenced by addCommsMessage:forCount:andShowComms:logOnly:, addMessage:forCount:forceDisplay:, displayMessage:forCount:, and setUpSettings.

◆ missiontext

- (NSDictionary *) missiontext

private

Definition at line 8099 of file Universe.m.

{
    return missiontext;
}

Referenced by initWithGameView:, missiontext, and reinitAndShowDemo:.

◆ msaaDepthBufferID

- (GLuint) msaaDepthBufferID

private

Definition at line 365 of file Universe.h.

◆ msaaFramebufferID

- (GLuint) msaaFramebufferID

private

Definition at line 364 of file Universe.h.

Referenced by drawUniverse.

◆ msaaTextureID

- (GLuint) msaaTextureID

private

Definition at line 360 of file Universe.h.

◆ n_entities

- (unsigned) n_entities

Definition at line 192 of file Universe.h.

Referenced by addEntity:, allShipsDoScriptEvent:andReactToAIMessage:, countEntitiesMatchingPredicate:parameter:inRange:ofEntity:, debugDumpEntities, drawUniverse, findCollisionsAndShadows, findEntitiesMatchingPredicate:parameter:inRange:ofEntity:, findOneEntityMatchingPredicate:parameter:, firstEntityTargetedByPlayer, firstShipHitByLaserFromShip:inDirection:offset:gettingRangeFound:, forceWitchspaceEntries, getSafeVectorFromEntity:toDistance:fromPoint:, PlayerEntity(OOControlsPrivate)::handleAutopilotOn:, hazardOnRouteFromEntity:toDistance:fromPoint:, isVectorClearFromEntity:toDistance:fromPoint:, MaintainLinkedLists, nearestEntityMatchingPredicate:parameter:relativeToEntity:, removeAllEntitiesExceptPlayer, removeDemoShips, safeWitchspaceExitDistance, setLighting, setSystemDataForGalaxy:planet:key:value:fromManifest:forLayer:, and update:.

◆ next_repopulation

- (OOTimeDelta) next_repopulation

private

Definition at line 304 of file Universe.h.

Referenced by populateNormalSpace, repopulateSystem, setUpWitchspaceBetweenSystem:andSystem:, and update:.

◆ next_universal_id

- (int) next_universal_id

private

Definition at line 216 of file Universe.h.

Referenced by addEntity:, and setUpSettings.

◆ no_update

- (BOOL) no_update

private

Definition at line 312 of file Universe.h.

Referenced by drawUniverse, reinitAndShowDemo:, removeAllEntitiesExceptPlayer, and update:.

◆ passthroughFramebufferID

- (GLuint) passthroughFramebufferID

private

Definition at line 368 of file Universe.h.

◆ passthroughTextureID

- (GLuint passthroughTextureID[2])

private

Definition at line 362 of file Universe.h.

◆ pingpongColorbuffers

- (GLuint pingpongColorbuffers[2])

private

Definition at line 375 of file Universe.h.

◆ pingpongFBO

- (GLuint pingpongFBO[2])

private

Definition at line 374 of file Universe.h.

◆ populatorSettings

- (NSMutableDictionary*) populatorSettings

private

Definition at line 303 of file Universe.h.

Referenced by clearSystemPopulator, and getPopulatorSettings.

◆ quadTextureEBO

- (GLuint) quadTextureEBO

private

Definition at line 372 of file Universe.h.

◆ quadTextureVAO

- (GLuint) quadTextureVAO

private

Definition at line 372 of file Universe.h.

◆ quadTextureVBO

- (GLuint) quadTextureVBO

private

Definition at line 372 of file Universe.h.

◆ roleCategories

- (NSDictionary*) roleCategories

private

Definition at line 277 of file Universe.h.

Referenced by setUpSettings.

◆ screenBackgrounds

- (NSDictionary*) screenBackgrounds

private

Definition at line 279 of file Universe.h.

Referenced by setScreenTextureDescriptorForKey:descriptor:, and setUpSettings.

◆ skyClearColor

- (GLfloat *) skyClearColor

private

Definition at line 3868 of file Universe.m.

{
    return skyClearColor;
}

Referenced by drawUniverse, setSkyColorRed:green:blue:alpha:, skyClearColor, and update:.

◆ sortedEntities

- (Entity* sortedEntities[UNIVERSE_MAX_ENTITIES+1])

◆ speechArray

- (NSArray*) speechArray

private

Definition at line 339 of file Universe.h.

Referenced by setUpSettings, and speakWithSubstitutions:.

◆ speechSynthesizer

- (NSSpeechSynthesizer*) speechSynthesizer

private

Definition at line 334 of file Universe.h.

Referenced by initWithGameView:, and stopSpeaking.

◆ stars_ambient

- (GLfloat stars_ambient[4])

Definition at line 199 of file Universe.h.

Referenced by drawUniverse, and setLighting.

◆ sun_diffuse

- (GLfloat sun_diffuse[4])

private

Definition at line 205 of file Universe.h.

Referenced by lightForEntity:, and setLighting.

◆ sun_specular

- (GLfloat sun_specular[4])

private

Definition at line 206 of file Universe.h.

Referenced by lightForEntity:, and setLighting.

◆ system_found

- (BOOL system_found[256])

private

Definition at line 289 of file Universe.h.

Referenced by findSystemCoordinatesWithPrefix:exactMatch:, and systemsFound.

◆ system_names

- (NSString* system_names[256])

private

Definition at line 288 of file Universe.h.

Referenced by dealloc, setGalaxyTo:andReinit:, setSystemDataForGalaxy:planet:key:value:fromManifest:forLayer:, and systemNameIndex:.

◆ system_repopulator

- (NSString*) system_repopulator

private

Definition at line 305 of file Universe.h.

Referenced by populateNormalSpace, and setUpWitchspaceBetweenSystem:andSystem:.

◆ systemID

- (OOSystemID) systemID

private

Definition at line 285 of file Universe.h.

Referenced by currentSystemID, nearbyDestinationsWithinRange:, neighboursToSystem:, populateNormalSpace, and setSystemTo:.

◆ systemManager

- (OOSystemDescriptionManager *) systemManager

private

Definition at line 8125 of file Universe.m.

{
    return systemManager;
}

Referenced by setUpSettings, and systemManager.

◆ targetDepthBufferID

- (GLuint) targetDepthBufferID

private

Definition at line 366 of file Universe.h.

◆ targetFramebufferID

- (GLuint) targetFramebufferID

private

Definition at line 367 of file Universe.h.

Referenced by drawUniverse.

◆ targetFramebufferSize

- (NSSize) targetFramebufferSize

private

Definition at line 363 of file Universe.h.

Referenced by drawUniverse.

◆ targetSystemID

- (OOSystemID) targetSystemID

private

Definition at line 286 of file Universe.h.

Referenced by findSystemNumberAtCoords:withGalaxy:includingHidden:, and setSystemTo:.

◆ targetTextureID

- (GLuint) targetTextureID

private

Definition at line 361 of file Universe.h.

◆ textureProgram

- (OOShaderProgram*) textureProgram

private

Definition at line 369 of file Universe.h.

◆ time_delta

- (OOTimeDelta) time_delta

private

Definition at line 249 of file Universe.h.

Referenced by getTimeDelta, setUpSettings, and update:.

◆ timeAccelerationFactor

- (double) timeAccelerationFactor

private

Definition at line 7370 of file Universe.m.

{
    return timeAccelerationFactor;
}

Referenced by setTimeAccelerationFactor:, timeAccelerationFactor, and update:.

◆ universal_time

- (OOTimeAbsolute) universal_time

private

Definition at line 248 of file Universe.h.

Referenced by addCommsMessage:forCount:andShowComms:logOnly:, addMessage:forCount:forceDisplay:, displayCountdownMessage:forCount:, displayMessage:forCount:, getTime, selectIntro2Next, selectIntro2NextCategory, selectIntro2Previous, selectIntro2PreviousCategory, setupIntroFirstGo:, setUpSettings, and update:.

◆ universeRegion

- (CollisionRegion*) universeRegion

private

Definition at line 324 of file Universe.h.

Referenced by collisionDescription, and initWithGameView:.

◆ useAddOns

- (NSString *) useAddOns

private

Definition at line 948 of file Universe.m.

{
    return useAddOns;
}

Referenced by initWithGameView:, setUseAddOns:fromSaveGame:forceReinit:, and useAddOns.

◆ viewDirection

- (OOViewID) viewDirection

private

Definition at line 6689 of file Universe.m.

{
    return viewDirection;
}

Referenced by firstEntityTargetedByPlayer, firstEntityTargetedByPlayerPrecisely, getActiveViewMatrix:forwardVector:upVector:, setViewDirection:, and viewDirection.

◆ viewMatrix

- (OOMatrix) viewMatrix

private

Definition at line 5303 of file Universe.m.

{
    return viewMatrix;
}

Referenced by drawUniverse, and viewMatrix.

◆ wasDisplayGUI

- (BOOL) wasDisplayGUI

private

Definition at line 236 of file Universe.h.

Referenced by drawUniverse.

◆ waypoints

- (NSMutableDictionary*) waypoints

private

Definition at line 223 of file Universe.h.

Referenced by currentWaypoints, dealloc, and initWithGameView:.

◆ wireframeGraphics

- (BOOL) wireframeGraphics

private

Definition at line 10004 of file Universe.m.

{
    return wireframeGraphics;
}

Referenced by initWithGameView:, setWireframeGraphics:, and wireframeGraphics.

◆ x_list_start

- (Entity*) x_list_start

Definition at line 197 of file Universe.h.

Referenced by filterSortedLists, and MaintainLinkedLists.

◆ y_list_start

- (Entity *) y_list_start

Definition at line 197 of file Universe.h.

Referenced by filterSortedLists, and MaintainLinkedLists.

◆ z_list_start

- (Entity *) z_list_start

Definition at line 197 of file Universe.h.

Referenced by filterSortedLists, and MaintainLinkedLists.

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

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

Instance Methods

Class Methods

Public Attributes

Private Attributes

Additional Inherited Members

Detailed Description

Method Documentation

◆ activeViewMatrix

◆ addCommsMessage:forCount:

◆ addCommsMessage:forCount:andShowComms:logOnly:

◆ addConditionScripts:

◆ addDelayedMessage:

◆ addDelayedMessage:forCount:afterDelay:

◆ addEntity:

◆ addLaserHitEffectsAt:against:damage:color:

◆ addMessage:forCount:

◆ addMessage:forCount:forceDisplay:

◆ addNumericRefsInString:toGraphViz:fromNode:nodeCount:

◆ addShipAt:withRole:withinRadius:

◆ addShips:withRole:atPosition:withCoordinateSystem:

◆ addShips:withRole:intoBoundingBox:

◆ addShips:withRole:nearPosition:withCoordinateSystem:

◆ addShips:withRole:nearPosition:withCoordinateSystem:withinRadius:

◆ addShipsAt:withRole:quantity:withinRadius:asGroup:

◆ addShipsToRoute:withRole:quantity:routeFraction:asGroup:

◆ addShipWithRole:launchPos:rfactor:

◆ addShipWithRole:nearPosition:withCoordinateSystem:

◆ addShipWithRole:nearRouteOneAt:

◆ addVisualEffectAt:withKey:

◆ addWitchspaceJumpEffectForShip:

◆ addWreckageFrom:withRole:at:scale:lifetime:

◆ airResistanceFactor

◆ allShipsDoScriptEvent:andReactToAIMessage:

◆ ambientLightLevel

◆ autoMessageLogBg

◆ autoSave

◆ autoSaveNow

◆ blockJSPlayerShipProps

◆ bloom

◆ breakPatternHide

◆ breakPatternOver

◆ brochureDescriptionWithDictionary:standardEquipment:optionalEquipment:

◆ canInstantiateShip:

◆ cargoPodFromTemplate:

◆ carryPlayerOn:inWormhole:

◆ characters

◆ chooseStringForKey:inDictionary:

◆ clearBeacon:

◆ clearGUIs

◆ clearPreviousMessage

◆ clearSystemPopulator

◆ collisionDescription

◆ colorblindMode

◆ commLogGUI

◆ commodities

◆ commodityDataForType:

◆ commodityMarket

◆ compareName

◆ comparePrice

◆ coordinatesForPosition:withCoordinateSystem:returningScalar:

◆ coordinatesForSystem:

◆ coordinatesFromCoordinateSystemString:

◆ countEntitiesMatchingPredicate:parameter:inRange:ofEntity:

◆ countShipsMatchingPredicate:parameter:inRange:ofEntity:

◆ countShipsWithPrimaryRole:

◆ countShipsWithPrimaryRole:inRange:ofEntity:

◆ countShipsWithRole:

◆ countShipsWithRole:inRange:ofEntity:

◆ countShipsWithScanClass:inRange:ofEntity:

◆ currentPostFX

◆ currentSystemData

◆ currentSystemID

◆ currentWaypoints

◆ dealloc

◆ debugDumpEntities

◆ defaultAIForRole:

◆ defineFrustum

◆ defineWaypoint:forKey:

◆ deleteOpenGLObjects

◆ demoShipData