Handles all the space stuff, namely systems and space objects (spobs). More...

#include "space.h"
#include "background.h"
#include "conf.h"
#include "damagetype.h"
#include "dev_uniedit.h"
#include "economy.h"
#include "gatherable.h"
#include "gui.h"
#include "hook.h"
#include "land.h"
#include "log.h"
#include "map.h"
#include "map_overlay.h"
#include "menu.h"
#include "mission.h"
#include "music.h"
#include "ndata.h"
#include "nebula.h"
#include "nfile.h"
#include "nlua.h"
#include "nlua_pilot.h"
#include "nlua_spob.h"
#include "nlua_gfx.h"
#include "nlua_camera.h"
#include "nlua_tex.h"
#include "nluadef.h"
#include "nmath.h"
#include "nstring.h"
#include "ntime.h"
#include "nxml.h"
#include "opengl.h"
#include "pause.h"
#include "pilot.h"
#include "player.h"
#include "queue.h"
#include "rng.h"
#include "sound.h"
#include "spfx.h"
#include "start.h"
#include "toolkit.h"
#include "weapon.h"

Data Structures
struct	spob_lua_file

Macros
#define	XML_SPOB_TAG "spob"

#define	XML_SYSTEM_TAG "ssys"

#define	SPOB_GFX_EXTERIOR_PATH_W 400

#define	SPOB_GFX_EXTERIOR_PATH_H 400

#define	FLAG_POSSET (1<<0)

#define	FLAG_INTERFERENCESET (1<<1)

#define	FLAG_SERVICESSET (1<<2)

#define	FLAG_FACTIONSET (1<<3)

#define	DEBRIS_BUFFER 1000

#define	UNREF(x)

#define	MELEMENT(o, s) if (o) WARN(_("Spob '%s' missing '%s' element"), spob->name, s)

#define	MELEMENT(o, s) if (o) WARN(_("Asteroid Field in Star System '%s' has missing/invalid '%s' element"), sys->name, s)

#define	MELEMENT(o, s) if (o) WARN(_("Asteroid Exclusion Zone in Star System '%s' has missing/invalid '%s' element"), sys->name, s)

#define	MELEMENT(o, s) if (o) WARN(_("Star System '%s' missing '%s' element"), sys->name, s)

Functions
static int	spob_parse (Spob spob, const char filename, Commodity **stdList)
	Parses a spob from an xml node. More...

static int	space_parseSpobs (xmlNodePtr parent, StarSystem *sys)
	Parses spobs in a system. More...

static int	spob_parsePresence (xmlNodePtr node, SpobPresence *ap)
	Parsess an spob presence from xml. More...

static void	system_init (StarSystem *sys)
	Initializes a new star system with null memory. More...

static int	systems_load (void)
	Loads the entire systems, needs to be called after spobs_load. More...

static int	system_parse (StarSystem sys, const char filename)
	Creates a system from an XML node. More...

static int	system_parseJumpPoint (const xmlNodePtr node, StarSystem *sys)
	Parses a single jump point for a system. More...

static int	system_parseJumpPointDiff (const xmlNodePtr node, StarSystem *sys)
	Parses a single jump point for a system, from unidiff. More...

static int	system_parseJumps (StarSystem *sys)
	Loads the jumps into a system. More...

static int	system_parseAsteroidField (const xmlNodePtr node, StarSystem *sys)
	Parses a single asteroid field for a system. More...

static int	system_parseAsteroidExclusion (const xmlNodePtr node, StarSystem *sys)
	Parses a single asteroid exclusion zone for a system. More...

static int	getPresenceIndex (StarSystem *sys, int faction)
	Gets the index of the presence element for a faction. Creates one if it doesn't exist. More...

static void	system_scheduler (double dt, int init)
	Controls fleet spawning. More...

static int	space_addMarkerSystem (int sysid, MissionMarkerType type)

static int	space_addMarkerSpob (int pntid, MissionMarkerType type)

static int	space_rmMarkerSystem (int sysid, MissionMarkerType type)

static int	space_rmMarkerSpob (int pntid, MissionMarkerType type)

static void	space_renderJumpPoint (const JumpPoint *jp, int i)
	Renders a jump point. More...

static void	space_renderSpob (const Spob *p)
	Renders a spob. More...

static void	space_updateSpob (const Spob *p, double dt, double real_dt)
	Renders a spob. More...

static const MapShader *	mapshader_get (const char *name)
	Gets the map shader by name. More...

static int	spob_lua_cmp (const void a, const void b)

static nlua_env	spob_lua_get (int mem, const char filename)

static void	spob_lua_free (spob_lua_file *lf)

int	space_sysSave (xmlTextWriterPtr writer)
	Saves what is needed to be saved for space. More...

int	space_sysLoad (xmlNodePtr parent)
	Loads player's space properties from an XML node. More...

const char *	spob_getServiceName (int service)
	Gets the (English) name for a service code. More...

int	spob_getService (const char *name)
	Converts name to spob service flag. More...

const char *	spob_getClassName (const char *class)
	Gets the long class name for a spob. More...

credits_t	spob_commodityPrice (const Spob p, const Commodity c)
	Gets the price of a commodity at a spob. More...

credits_t	spob_commodityPriceAtTime (const Spob p, const Commodity c, ntime_t t)
	Gets the price of a commodity at a spob at given time. More...

void	spob_averageSeenPricesAtTime (const Spob *p, const ntime_t tupdate)
	Adds cost of commodities on spob p to known statistics at time t. More...

int	spob_averageSpobPrice (const Spob p, const Commodity c, credits_t mean, double std)
	Gets the average price of a commodity at a spob that has been seen so far. More...

void	system_updateAsteroids (StarSystem *sys)
	Updates some internal calculations about asteroids in a system. More...

int	spob_setFaction (Spob *p, int faction)
	Changes the spobs faction. More...

int	spob_addCommodity (Spob p, Commodity c)
	Adds a commodity to a spob. More...

int	spob_addService (Spob *p, int service)
	Removes a service from a spob. More...

int	spob_rmService (Spob *p, int service)
	Removes a service from a spob. More...

int	space_jumpDistance (const Pilot p, const JumpPoint jp)
	Distance at which a pilot can jump. More...

int	space_canHyperspace (const Pilot *p)
	Checks to make sure if pilot is far enough away to hyperspace. More...

int	space_hyperspace (Pilot *p)
	Tries to get the pilot into hyperspace. More...

int	space_calcJumpInPos (const StarSystem in, const StarSystem out, vec2 pos, vec2 vel, double dir, const Pilot p)
	Calculates the jump in pos for a pilot. More...

char **	space_getFactionSpob (int *factions, int landable)
	Gets the name of all the spobs that belong to factions. More...

const char *	space_getRndSpob (int landable, unsigned int services, int(filter)(Spob p))
	Gets the name of a random spob. More...

double	system_getClosest (const StarSystem sys, int pnt, int jp, int ast, int *fie, double x, double y)
	Gets the closest feature to a position in the system. More...

double	system_getClosestAng (const StarSystem sys, int pnt, int jp, int ast, int *fie, double x, double y, double ang)
	Gets the feature nearest to directly ahead of a position in the system. More...

int	space_sysReachable (const StarSystem *sys)
	Sees if a system is reachable. More...

int	space_sysReallyReachable (char *sysname)
	Sees if a system can be reached via jumping. More...

int	space_sysReachableFromSys (const StarSystem target, const StarSystem sys)
	Sees if a system is reachable from another system. More...

StarSystem *	system_getAll (void)
	Gets an array (array.h) of all star systems. More...

const char *	system_existsCase (const char *sysname)
	Checks to see if a system exists case insensitively. More...

char **	system_searchFuzzyCase (const char sysname, int n)
	Does a fuzzy case matching. Searches translated names but returns internal names. More...

static int	system_cmp (const void p1, const void p2)
	Comparison function for qsort'ing StarSystem by name. More...

StarSystem *	system_get (const char *sysname)
	Get the system from its name. More...

StarSystem *	system_getIndex (int id)
	Get the system by its index. More...

int	system_index (const StarSystem *sys)
	Gets the index of a star system. More...

int	spob_hasSystem (const Spob *spb)
	Get whether or not a spob has a system (i.e. is on the map). More...

char *	spob_getSystem (const char *spobname)
	Get the name of a system from a spobname. More...

static int	spob_cmp (const void p1, const void p2)
	Comparison function for qsort'ing Spob by name. More...

Spob *	spob_get (const char *spobname)
	Gets a spob based on its name. More...

Spob *	spob_getIndex (int ind)
	Gets spob by index. More...

int	spob_index (const Spob *p)
	Gets the ID of a spob. More...

Spob *	spob_getAll (void)
	Gets an array (array.h) of all spobs. More...

void	spob_setKnown (Spob *p)
	Sets a spob's known status, if it's real. More...

int	spob_exists (const char *spobname)
	Check to see if a spob exists. More...

const char *	spob_existsCase (const char *spobname)
	Check to see if a spob exists (case insensitive). More...

char **	spob_searchFuzzyCase (const char spobname, int n)
	Does a fuzzy case matching. Searches spob_name() but returns internal names. More...

VirtualSpob *	virtualspob_getAll (void)
	Gets all the virtual spobs. More...

static int	virtualspob_cmp (const void p1, const void p2)
	Comparison function for qsort'ing VirtuaSpob by name. More...

VirtualSpob *	virtualspob_get (const char *name)
	Gets a virtual spob by matching name. More...

JumpPoint *	jump_get (const char jumpname, const StarSystem sys)
	Gets a jump point based on its target and system. More...

JumpPoint *	jump_getTarget (const StarSystem target, const StarSystem sys)
	Less safe version of jump_get that works with pointers. More...

const char *	jump_getSymbol (const JumpPoint *jp)
	Gets the jump point symbol. More...

void	space_factionChange (void)
	Mark when a faction changes. More...

void	space_checkLand (void)
	Handles landing if necessary. More...

void	space_update (double dt, double real_dt)
	Controls fleet spawning. More...

int	space_isSimulation (void)
	returns whether we're just simulating. More...

int	space_isSimulationEffects (void)
	returns whether or not we're simulating with effects. More...

void	space_init (const char *sysname, int do_simulate)
	Initializes the system. More...

Spob *	spob_new (void)
	Creates a new spob. More...

const char *	spob_name (const Spob *p)
	Gets the translated name of a spob. More...

static int	spobs_load (void)
	Loads all the spobs in the game. More...

static int	virtualspobs_load (void)
	Loads all the virtual spobs. More...

char	spob_getColourChar (const Spob *p)
	Gets the spob colour char. More...

const char *	spob_getSymbol (const Spob *p)
	Gets the spob symbol. More...

const glColour *	spob_getColour (const Spob *p)
	Gets the spob colour. More...

void	spob_updateLand (Spob *p)
	Updates the land possibilities of a spob. More...

void	spob_luaInitMem (const Spob *spob)
	Initializes the memory fo a spob. More...

int	spob_luaInit (Spob *spob)
	Updatse the spob's internal Lua stuff. More...

void	spob_gfxLoad (Spob *spob)
	Loads a spob's graphics (and radius). More...

void	space_gfxLoad (StarSystem *sys)
	Loads all the graphics for a star system. More...

void	space_gfxUnload (StarSystem *sys)
	Unloads all the graphics for a star system. More...

int	system_addSpob (StarSystem sys, const char spobname)
	Adds a spob to a star system. More...

int	system_rmSpob (StarSystem sys, const char spobname)
	Removes a spob from a star system. More...

int	system_addVirtualSpob (StarSystem sys, const char spobname)
	Adds a virtual spob to a system. More...

int	system_rmVirtualSpob (StarSystem sys, const char spobname)
	Removes a virtual spob from a system. More...

int	system_addJumpDiff (StarSystem *sys, xmlNodePtr node)
	Adds a jump point to a star system from a diff. More...

int	system_rmJump (StarSystem sys, const char jumpname)
	Removes a jump point from a star system. More...

StarSystem *	system_new (void)
	Creates a new star system. More...

void	system_reconstructJumps (StarSystem *sys)
	Reconstructs the jumps for a single system. More...

void	systems_reconstructJumps (void)
	Reconstructs the jumps. More...

void	systems_reconstructSpobs (void)
	Updates the system spob pointers. More...

static int	sys_cmpSysFaction (const void a, const void b)
	Compares two system presences. More...

void	system_setFaction (StarSystem *sys)
	Sets the system faction based on the spobs it has. More...

int	space_load (void)
	Loads the entire universe into ram - pretty big feat eh? More...

int	space_loadLua (void)
	initializes the Lua for all the spobs. More...

void	space_render (const double dt)
	Renders the system. More...

void	space_renderOverlay (const double dt)
	Renders the system overlay. More...

void	spobs_render (void)
	Renders the current systems' spobs. More...

void	space_exit (void)
	Cleans up the system. More...

void	space_clearKnown (void)
	Clears all system knowledge. More...

void	space_clearMarkers (void)
	Clears all system markers. More...

void	space_clearComputerMarkers (void)
	Clears all the system computer markers. More...

int	space_addMarker (int objid, MissionMarkerType type)
	Adds a marker to a system. More...

int	space_rmMarker (int objid, MissionMarkerType type)
	Removes a marker from a system. More...

void	system_presenceAddSpob (StarSystem sys, const SpobPresence ap)
	Adds (or removes) some presence to a system. More...

double	system_getPresence (const StarSystem *sys, int faction)
	Get the presence of a faction in a system. More...

double	system_getPresenceFull (const StarSystem sys, int faction, double base, double *bonus)
	Get the presence of a faction in a system. More...

void	system_addAllSpobsPresence (StarSystem *sys)
	Go through all the spobs and call system_addPresence(). More...

void	space_reconstructPresences (void)
	Reset the presence of all systems. More...

int	system_hasSpob (const StarSystem *sys)
	See if the system has a spob. More...

void	system_rmCurrentPresence (StarSystem *sys, int faction, double amount)
	Removes active presence. More...

void	space_queueLand (Spob *pnt)
	Cues a spob to be landed on. This is not done immediately, but when the engine thinks it is ok to do. More...

const char *	space_populationStr (uint64_t population)
	Gets the population in an approximated string. Note this function changes the string value each call, so be careful! More...

Variables
static spob_lua_file *	spob_lua_stack = NULL

static char **	spobname_stack = NULL

static char **	systemname_stack = NULL

StarSystem *	systems_stack = NULL

static Spob *	spob_stack = NULL

static VirtualSpob *	vspob_stack = NULL

static MapShader **	mapshaders = NULL

static int	systems_loading = 1

StarSystem *	cur_system = NULL

glTexture *	jumppoint_gfx = NULL

static glTexture *	jumpbuoy_gfx = NULL

static int	space_fchg = 0

static int	space_simulating = 0

static int	space_simulating_effects = 0

static Spob *	space_landQueueSpob = NULL

int	space_spawn = 1

Detailed Description

Handles all the space stuff, namely systems and space objects (spobs).

Definition in file space.c.

Macro Definition Documentation

◆ DEBRIS_BUFFER

#define DEBRIS_BUFFER 1000

Buffer to smooth appearance of debris

Definition at line 73 of file space.c.

◆ FLAG_FACTIONSET

#define FLAG_FACTIONSET (1<<3)

Set the faction value.

Definition at line 71 of file space.c.

◆ FLAG_INTERFERENCESET

#define FLAG_INTERFERENCESET (1<<1)

Set the interference value.

Definition at line 69 of file space.c.

◆ FLAG_POSSET

#define FLAG_POSSET (1<<0)

Set the position.

Definition at line 68 of file space.c.

◆ FLAG_SERVICESSET

#define FLAG_SERVICESSET (1<<2)

Set the service value.

Definition at line 70 of file space.c.

◆ SPOB_GFX_EXTERIOR_PATH_H

#define SPOB_GFX_EXTERIOR_PATH_H 400

Spob exterior graphic height.

Definition at line 65 of file space.c.

◆ SPOB_GFX_EXTERIOR_PATH_W

#define SPOB_GFX_EXTERIOR_PATH_W 400

Spob exterior graphic width.

Definition at line 64 of file space.c.

◆ UNREF

#define UNREF ( x )

Value:

   do { if ((x) != LUA_NOREF) { \
      luaL_unref( naevL, LUA_REGISTRYINDEX, (x) ); \
      (x) = LUA_NOREF; \
   } } while (0)

◆ XML_SPOB_TAG

#define XML_SPOB_TAG "spob"

Individual spob xml tag.

Definition at line 61 of file space.c.

◆ XML_SYSTEM_TAG

#define XML_SYSTEM_TAG "ssys"

Individual systems xml tag.

Definition at line 62 of file space.c.

Function Documentation

◆ getPresenceIndex()

static int getPresenceIndex	(	StarSystem *	sys,
		int	faction
	)

static

Gets the index of the presence element for a faction. Creates one if it doesn't exist.

Parameters

sys	Pointer to the system to check.
faction	The index of the faction to search for.

Returns: The index of the presence array for faction.

Definition at line 3981 of file space.c.

◆ jump_get()

JumpPoint * jump_get	(	const char *	jumpname,
		const StarSystem *	sys
	)

Gets a jump point based on its target and system.

Parameters

jumpname	Name to match.
sys	System jump is in.

Returns: Jump point matich jumpname in sys or NULL if not found.

Definition at line 1174 of file space.c.

◆ jump_getSymbol()

const char * jump_getSymbol ( const JumpPoint * jp )

Gets the jump point symbol.

Definition at line 1212 of file space.c.

◆ jump_getTarget()

JumpPoint * jump_getTarget	(	const StarSystem *	target,
		const StarSystem *	sys
	)

Less safe version of jump_get that works with pointers.

Parameters

target	Target system jump leads to.
sys	System to look in.

Returns: Jump point in sys to target or NULL if not found.

Definition at line 1198 of file space.c.

◆ mapshader_get()

static const MapShader * mapshader_get ( const char * name )

static

Gets the map shader by name.

Parameters

name	NAme of the map shader.

Returns: The map shader.

Definition at line 4375 of file space.c.

◆ space_addMarker()

int space_addMarker	(	int	objid,
		MissionMarkerType	type
	)

Adds a marker to a system.

Parameters

objid	ID of the object to add marker to.
type	Type of the marker to add.

Returns: 0 on success.

Definition at line 3743 of file space.c.

◆ space_addMarkerSpob()

static int space_addMarkerSpob	(	int	pntid,
		MissionMarkerType	type
	)

static

Definition at line 3714 of file space.c.

◆ space_addMarkerSystem()

static int space_addMarkerSystem	(	int	sysid,
		MissionMarkerType	type
	)

static

Definition at line 3678 of file space.c.

◆ space_calcJumpInPos()

int space_calcJumpInPos	(	const StarSystem *	in,
		const StarSystem *	out,
		vec2 *	pos,
		vec2 *	vel,
		double *	dir,
		const Pilot *	p
	)

Calculates the jump in pos for a pilot.

Parameters

	in	Star system entering.
	out	Star system exiting.
[out]	pos	Position calculated.
[out]	vel	Velocity calculated.
[out]	dir	Angle calculated.
	p	Pilot that is entering to use stats of (or NULL if not important).

Definition at line 495 of file space.c.

◆ space_canHyperspace()

int space_canHyperspace ( const Pilot * p )

Checks to make sure if pilot is far enough away to hyperspace.

Parameters

p	Pilot to check if he can hyperspace.

Returns: 1 if he can hyperspace, 0 else.

Definition at line 437 of file space.c.

◆ space_checkLand()

void space_checkLand ( void )

Handles landing if necessary.

Definition at line 1352 of file space.c.

◆ space_clearComputerMarkers()

void space_clearComputerMarkers ( void )

Clears all the system computer markers.

Definition at line 3672 of file space.c.

◆ space_clearKnown()

void space_clearKnown ( void )

Clears all system knowledge.

Definition at line 3633 of file space.c.

◆ space_clearMarkers()

void space_clearMarkers ( void )

Clears all system markers.

Definition at line 3652 of file space.c.

◆ space_exit()

void space_exit ( void )

Cleans up the system.

Definition at line 3518 of file space.c.

◆ space_factionChange()

void space_factionChange ( void )

Mark when a faction changes.

Definition at line 1344 of file space.c.

◆ space_getFactionSpob()

char ** space_getFactionSpob	(	int *	factions,
		int	landable
	)

Gets the name of all the spobs that belong to factions.

Parameters

factions	Array (array.h): Factions to check against.
landable	Whether the search is limited to landable spobs.

Returns: An array (array.h) of faction names. Individual names are not allocated.

Definition at line 558 of file space.c.

◆ space_getRndSpob()

const char * space_getRndSpob	(	int	landable,
		unsigned int	services,
		int()(Spob p)	filter
	)

Gets the name of a random spob.

Parameters

landable	Whether the spob must let the player land normally.
services	Services the spob must have.
filter	Filter function for including spobs.

Returns: The name (internal/English) of a random spob.

Definition at line 601 of file space.c.

◆ space_gfxLoad()

void space_gfxLoad ( StarSystem * sys )

Loads all the graphics for a star system.

Parameters

sys	System to load graphics for.

Definition at line 2057 of file space.c.

◆ space_gfxUnload()

void space_gfxUnload ( StarSystem * sys )

Unloads all the graphics for a star system.

Parameters

sys	System to unload graphics for.

Definition at line 2068 of file space.c.

◆ space_hyperspace()

int space_hyperspace ( Pilot * p )

Tries to get the pilot into hyperspace.

Parameters

p	Pilot to try to start hyperspacing.

Returns: 0 on success.

Definition at line 471 of file space.c.

◆ space_init()

void space_init	(	const char *	sysname,
		int	do_simulate
	)

Initializes the system.

Parameters

sysname	Name of the system to initialize.
do_simulate	Whether or not perform the initial simulation.

Definition at line 1501 of file space.c.

◆ space_isSimulation()

int space_isSimulation ( void )

returns whether we're just simulating.

Definition at line 1482 of file space.c.

◆ space_isSimulationEffects()

int space_isSimulationEffects ( void )

returns whether or not we're simulating with effects.

Definition at line 1490 of file space.c.

◆ space_jumpDistance()

int space_jumpDistance	(	const Pilot *	p,
		const JumpPoint *	jp
	)

Distance at which a pilot can jump.

Definition at line 423 of file space.c.

◆ space_load()

int space_load ( void )

Loads the entire universe into ram - pretty big feat eh?

Returns: 0 on success.

Definition at line 3237 of file space.c.

◆ space_loadLua()

int space_loadLua ( void )

initializes the Lua for all the spobs.

Definition at line 3306 of file space.c.

◆ space_parseSpobs()

static int space_parseSpobs	(	xmlNodePtr	parent,
		StarSystem *	sys
	)

static

Parses spobs in a system.

Parameters

parent	Node of the system.
sys	System to populate.

Returns: 0 on success.

Definition at line 3954 of file space.c.

◆ space_populationStr()

const char * space_populationStr ( uint64_t population )

Gets the population in an approximated string. Note this function changes the string value each call, so be careful!

Parameters

population Population to get string of.

Returns: String corresponding to the population.

Definition at line 4332 of file space.c.

◆ space_queueLand()

void space_queueLand ( Spob * pnt )

Cues a spob to be landed on. This is not done immediately, but when the engine thinks it is ok to do.

Parameters

pnt	Spob to land on.

Definition at line 4321 of file space.c.

◆ space_reconstructPresences()

void space_reconstructPresences ( void )

Reset the presence of all systems.

Definition at line 4220 of file space.c.

◆ space_render()

void space_render ( const double dt )

Renders the system.

Parameters

dt	Current delta tick.

Definition at line 3395 of file space.c.

◆ space_renderJumpPoint()

static void space_renderJumpPoint	(	const JumpPoint *	jp,
		int	i
	)

static

Renders a jump point.

Definition at line 3455 of file space.c.

◆ space_renderOverlay()

void space_renderOverlay ( const double dt )

Renders the system overlay.

Parameters

dt	Current delta tick.

Definition at line 3411 of file space.c.

◆ space_renderSpob()

static void space_renderSpob ( const Spob * p )

static

Renders a spob.

Definition at line 3482 of file space.c.

◆ space_rmMarker()

int space_rmMarker	(	int	objid,
		MissionMarkerType	type
	)

Removes a marker from a system.

Parameters

objid	ID of the object to remove marker from.
type	Type of the marker to remove.

Returns: 0 on success.

Definition at line 3829 of file space.c.

◆ space_rmMarkerSpob()

static int space_rmMarkerSpob	(	int	pntid,
		MissionMarkerType	type
	)

static

Definition at line 3802 of file space.c.

◆ space_rmMarkerSystem()

static int space_rmMarkerSystem	(	int	sysid,
		MissionMarkerType	type
	)

static

Definition at line 3763 of file space.c.

◆ space_sysLoad()

int space_sysLoad ( xmlNodePtr parent )

Loads player's space properties from an XML node.

Parameters

parent Parent node for space.

Returns: 0 on success.

Definition at line 3894 of file space.c.

◆ space_sysReachable()

int space_sysReachable ( const StarSystem * sys )

Sees if a system is reachable.

Returns: 1 if target system is reachable, 0 if it isn't.

Definition at line 794 of file space.c.

◆ space_sysReachableFromSys()

int space_sysReachableFromSys	(	const StarSystem *	target,
		const StarSystem *	sys
	)

Sees if a system is reachable from another system.

Returns: 1 if target system is reachable, 0 if it isn't.

Definition at line 833 of file space.c.

◆ space_sysReallyReachable()

int space_sysReallyReachable ( char * sysname )

Sees if a system can be reached via jumping.

Returns: 1 if target system is reachable, 0 if it isn't.

Definition at line 814 of file space.c.

◆ space_sysSave()

int space_sysSave ( xmlTextWriterPtr writer )

Saves what is needed to be saved for space.

Parameters

writer XML writer to use.

Returns: 0 on success.

Definition at line 3854 of file space.c.

◆ space_update()

void space_update	(	double	dt,
		double	real_dt
	)

Controls fleet spawning.

Parameters

dt	Current delta tick.
real_dt	Real time incrcement (in real world seconds).

Definition at line 1366 of file space.c.

◆ space_updateSpob()

static void space_updateSpob	(	const Spob *	p,
		double	dt,
		double	real_dt
	)

static

Renders a spob.

Definition at line 3500 of file space.c.

◆ spob_addCommodity()

int spob_addCommodity	(	Spob *	p,
		Commodity *	c
	)

Adds a commodity to a spob.

Parameters

p	Spob to add commodity to.
c	Commodity to add.

Returns: 0 on success.

Definition at line 358 of file space.c.

◆ spob_addService()

int spob_addService	(	Spob *	p,
		int	service
	)

Removes a service from a spob.

Parameters

p	Spob to remove service from.
service	Service flag to remove.

Returns: 0 on success.

Definition at line 372 of file space.c.

◆ spob_averageSeenPricesAtTime()

void spob_averageSeenPricesAtTime	(	const Spob *	p,
		const ntime_t	tupdate
	)

Adds cost of commodities on spob p to known statistics at time t.

Parameters

p	Spob to get price at
tupdate	Time to get prices at

Definition at line 299 of file space.c.

◆ spob_averageSpobPrice()

int spob_averageSpobPrice	(	const Spob *	p,
		const Commodity *	c,
		credits_t *	mean,
		double *	std
	)

Gets the average price of a commodity at a spob that has been seen so far.

Parameters

	p	Spob to get average price at.
	c	Commodity to get average price of.
[out]	mean	Sample mean, rounded to nearest credit.
[out]	std	Sample standard deviation (via uncorrected population formula).

Definition at line 312 of file space.c.

◆ spob_cmp()

static int spob_cmp	(	const void *	p1,
		const void *	p2
	)

static

Comparison function for qsort'ing Spob by name.

Definition at line 992 of file space.c.

◆ spob_commodityPrice()

credits_t spob_commodityPrice	(	const Spob *	p,
		const Commodity *	c
	)

Gets the price of a commodity at a spob.

Parameters

p	Spob to get price at.
c	Commodity to get price of.

Definition at line 272 of file space.c.

◆ spob_commodityPriceAtTime()

credits_t spob_commodityPriceAtTime	(	const Spob *	p,
		const Commodity *	c,
		ntime_t	t
	)

Gets the price of a commodity at a spob at given time.

Parameters

p	Spob to get price at.
c	Commodity to get price of.
t	Time to get price at.

Definition at line 286 of file space.c.

◆ spob_exists()

int spob_exists ( const char * spobname )

Check to see if a spob exists.

Parameters

spobname Name of the spob to see if it exists.

Returns: 1 if spob exists.

Definition at line 1082 of file space.c.

◆ spob_existsCase()

const char * spob_existsCase ( const char * spobname )

Check to see if a spob exists (case insensitive).

Parameters

spobname Name of the spob to see if it exists.

Returns: The actual name of the spob or NULL if not found.

Definition at line 1096 of file space.c.

◆ spob_get()

Spob * spob_get ( const char * spobname )

Gets a spob based on its name.

Parameters

spobname Name to match.

Returns: Spob matching spobname.

Definition at line 1006 of file space.c.

◆ spob_getAll()

Spob * spob_getAll ( void )

Gets an array (array.h) of all spobs.

Definition at line 1063 of file space.c.

◆ spob_getClassName()

const char * spob_getClassName ( const char * class )

Gets the long class name for a spob.

Parameters

class Name of the class to process.

Returns: Long name of the class.

Definition at line 213 of file space.c.

◆ spob_getColour()

const glColour * spob_getColour ( const Spob * p )

Gets the spob colour.

Definition at line 1875 of file space.c.

◆ spob_getColourChar()

char spob_getColourChar ( const Spob * p )

Gets the spob colour char.

Definition at line 1834 of file space.c.

◆ spob_getIndex()

Spob * spob_getIndex ( int ind )

Gets spob by index.

Parameters

ind	Index of the spob to get.

Returns: The spob gotten.

Definition at line 1038 of file space.c.

◆ spob_getService()

int spob_getService ( const char * name )

Converts name to spob service flag.

Definition at line 184 of file space.c.

◆ spob_getServiceName()

const char * spob_getServiceName ( int service )

Gets the (English) name for a service code.

Parameters

service One of the SPOB_SERVICE_* enum values.

Returns: English name, reversible via spob_getService() and presentable via _().

Definition at line 165 of file space.c.

◆ spob_getSymbol()

const char * spob_getSymbol ( const Spob * p )

Gets the spob symbol.

Definition at line 1853 of file space.c.

◆ spob_getSystem()

char * spob_getSystem ( const char * spobname )

Get the name of a system from a spobname.

Parameters

spobname Spob name to match.

Returns: Name of the system spob belongs to.

Definition at line 980 of file space.c.

◆ spob_gfxLoad()

void spob_gfxLoad ( Spob * spob )

Loads a spob's graphics (and radius).

Definition at line 2019 of file space.c.

◆ spob_hasSystem()

int spob_hasSystem ( const Spob * spb )

Get whether or not a spob has a system (i.e. is on the map).

Parameters

spb	Spob to search for.

Returns: 1 if the spob has a system, 0 otherwise.

Definition at line 966 of file space.c.

◆ spob_index()

int spob_index ( const Spob * p )

Gets the ID of a spob.

Parameters

p	Spob to get ID of.

Returns: The ID of the spob.

Definition at line 1055 of file space.c.

◆ spob_lua_cmp()

static int spob_lua_cmp	(	const void *	a,
		const void *	b
	)

static

Definition at line 4403 of file space.c.

◆ spob_lua_free()

static void spob_lua_free ( spob_lua_file * lf )

static

Definition at line 4465 of file space.c.

◆ spob_lua_get()

static nlua_env spob_lua_get	(	int *	mem,
		const char *	filename
	)

static

Definition at line 4410 of file space.c.

◆ spob_luaInit()

int spob_luaInit ( Spob * spob )

Updatse the spob's internal Lua stuff.

Parameters

spob	Spob to update.

Definition at line 1942 of file space.c.

◆ spob_luaInitMem()

void spob_luaInitMem ( const Spob * spob )

Initializes the memory fo a spob.

Definition at line 1931 of file space.c.

◆ spob_name()

const char * spob_name ( const Spob * p )

Gets the translated name of a spob.

Parameters

p	Spob to get translated name of.

Returns: Translated name of the spob.

Definition at line 1705 of file space.c.

◆ spob_new()

Spob * spob_new ( void )

Creates a new spob.

Definition at line 1659 of file space.c.

◆ spob_parse()

static int spob_parse	(	Spob *	spob,
		const char *	filename,
		Commodity **	stdList
	)

static

Parses a spob from an xml node.

Parameters

	spob	Spob to fill up.
	filename	Name of the file to parse.
[in]	stdList	The array of standard commodities.

Returns: 0 on success.

Definition at line 2119 of file space.c.

◆ spob_parsePresence()

static int spob_parsePresence	(	xmlNodePtr	node,
		SpobPresence *	ap
	)

static

Parsess an spob presence from xml.

Parameters

	node	Node to process.
[out]	ap	Spob presence to save to.

Definition at line 2093 of file space.c.

◆ spob_rmService()

int spob_rmService	(	Spob *	p,
		int	service
	)

Removes a service from a spob.

Parameters

p	Spob to remove service from.
service	Service flag to remove.

Returns: 0 on success.

Definition at line 414 of file space.c.

◆ spob_searchFuzzyCase()

char ** spob_searchFuzzyCase	(	const char *	spobname,
		int *	n
	)

Does a fuzzy case matching. Searches spob_name() but returns internal names.

Definition at line 1107 of file space.c.

◆ spob_setFaction()

int spob_setFaction	(	Spob *	p,
		int	faction
	)

Changes the spobs faction.

Parameters

p	Spob to change faction of.
faction	Faction to change to.

Returns: 0 on success.

Definition at line 345 of file space.c.

◆ spob_setKnown()

void spob_setKnown ( Spob * p )

Sets a spob's known status, if it's real.

Definition at line 1071 of file space.c.

◆ spob_updateLand()

void spob_updateLand ( Spob * p )

Updates the land possibilities of a spob.

Parameters

p	Spob to update land possibilities of.

Definition at line 1896 of file space.c.

◆ spobs_load()

static int spobs_load ( void )

static

Loads all the spobs in the game.

Returns: 0 on success.

Definition at line 1717 of file space.c.

◆ spobs_render()

void spobs_render ( void )

Renders the current systems' spobs.

Definition at line 3430 of file space.c.

◆ sys_cmpSysFaction()

static int sys_cmpSysFaction	(	const void *	a,
		const void *	b
	)

static

Compares two system presences.

Definition at line 2990 of file space.c.

◆ system_addAllSpobsPresence()

void system_addAllSpobsPresence ( StarSystem * sys )

Go through all the spobs and call system_addPresence().

Parameters

sys	Pointer to the system to process.

Definition at line 4197 of file space.c.

◆ system_addJumpDiff()

int system_addJumpDiff	(	StarSystem *	sys,
		xmlNodePtr	node
	)

Adds a jump point to a star system from a diff.

Note that economy_execQueued should always be run after this.

Parameters

sys	Star System to add jump point to.
node	Parent node containing jump point information.

Returns: 0 on success.

Definition at line 2531 of file space.c.

◆ system_addSpob()

int system_addSpob	(	StarSystem *	sys,
		const char *	spobname
	)

Adds a spob to a star system.

Parameters

sys	Star System to add spob to. (Assumed to belong to systems_stack.)
spobname	Name of the spob to add.

Returns: 0 on success.

Definition at line 2372 of file space.c.

◆ system_addVirtualSpob()

int system_addVirtualSpob	(	StarSystem *	sys,
		const char *	spobname
	)

Adds a virtual spob to a system.

Parameters

sys	System to add virtual spob to.
spobname	Name of the virtual spob being added.

Definition at line 2466 of file space.c.

◆ system_cmp()

static int system_cmp	(	const void *	p1,
		const void *	p2
	)

static

Comparison function for qsort'ing StarSystem by name.

Definition at line 900 of file space.c.

◆ system_existsCase()

const char * system_existsCase ( const char * sysname )

Checks to see if a system exists case insensitively.

Parameters

sysname Name of the system to match (case insensitive).

Returns: The actual name of the system of NULL if not found.

Definition at line 858 of file space.c.

◆ system_get()

StarSystem * system_get ( const char * sysname )

Get the system from its name.

Parameters

sysname Name to match.

Returns: System matching sysname.

Definition at line 914 of file space.c.

◆ system_getAll()

StarSystem * system_getAll ( void )

Gets an array (array.h) of all star systems.

Definition at line 847 of file space.c.

◆ system_getClosest()

double system_getClosest	(	const StarSystem *	sys,
		int *	pnt,
		int *	jp,
		int *	ast,
		int *	fie,
		double	x,
		double	y
	)

Gets the closest feature to a position in the system.

Parameters

	sys	System to get closest feature from a position.
[out]	pnt	ID of closest spob or -1 if a jump point is closer (or none is close).
[out]	jp	ID of closest jump point or -1 if a spob is closer (or none is close).
[out]	ast	ID of closest asteroid or -1 if something else is closer (or none is close).
[out]	fie	ID of the asteroid anchor the asteroid belongs to.
	x	X position to get closest from.
	y	Y position to get closest from.

Definition at line 655 of file space.c.

◆ system_getClosestAng()

double system_getClosestAng	(	const StarSystem *	sys,
		int *	pnt,
		int *	jp,
		int *	ast,
		int *	fie,
		double	x,
		double	y,
		double	ang
	)

Gets the feature nearest to directly ahead of a position in the system.

Parameters

	sys	System to get closest feature from a position.
[out]	pnt	ID of closest spob or -1 if something else is closer (or none is close).
[out]	jp	ID of closest jump point or -1 if something else is closer (or none is close).
[out]	ast	ID of closest asteroid or -1 if something else is closer (or none is close).
[out]	fie	ID of the asteroid anchor the asteroid belongs to.
	x	X position to get closest from.
	y	Y position to get closest from.
	ang	Reference angle.

Returns: The nearest angle to ang which is the direction from (x, y) to a feature.

Definition at line 734 of file space.c.

◆ system_getIndex()

StarSystem * system_getIndex ( int id )

Get the system by its index.

Parameters

id	Index to match.

Returns: System matching index.

Definition at line 944 of file space.c.

◆ system_getPresence()

double system_getPresence	(	const StarSystem *	sys,
		int	faction
	)

Get the presence of a faction in a system.

Parameters

sys	Pointer to the system to process.
faction	The faction to get the presence for.

Returns: The amount of presence the faction has in the system.

Definition at line 4138 of file space.c.

◆ system_getPresenceFull()

double system_getPresenceFull	(	const StarSystem *	sys,
		int	faction,
		double *	base,
		double *	bonus
	)

Get the presence of a faction in a system.

Parameters

	sys	Pointer to the system to process.
	faction	The faction to get the presence for.
[out]	base	Base value of the presence.
[out]	bonus	Bonus value of the presence.

Returns: The amount of presence the faction has in the system.

Definition at line 4167 of file space.c.

◆ system_hasSpob()

int system_hasSpob ( const StarSystem * sys )

See if the system has a spob.

Parameters

sys	Pointer to the system to process.

Returns: 0 If empty; otherwise 1.

Definition at line 4251 of file space.c.

◆ system_index()

int system_index ( const StarSystem * sys )

Gets the index of a star system.

Parameters

sys	System to get index of.

Returns: The index of the system.

Definition at line 955 of file space.c.

◆ system_init()

static void system_init ( StarSystem * sys )

static

Initializes a new star system with null memory.

Definition at line 2586 of file space.c.

◆ system_new()

StarSystem * system_new ( void )

Creates a new star system.

Definition at line 2601 of file space.c.

◆ system_parse()

static int system_parse	(	StarSystem *	sys,
		const char *	filename
	)

static

Creates a system from an XML node.

Parameters

sys	System to set up.
filename	Name of the file to parse.

Returns: 0 on success.

Definition at line 2827 of file space.c.

◆ system_parseAsteroidExclusion()

static int system_parseAsteroidExclusion	(	const xmlNodePtr	node,
		StarSystem *	sys
	)

static

Parses a single asteroid exclusion zone for a system.

Parameters

node	Parent node containing asteroid exclusion information.
sys	System.

Returns: 0 on success.

< Define to help check for data errors.

Definition at line 2777 of file space.c.

◆ system_parseAsteroidField()

static int system_parseAsteroidField	(	const xmlNodePtr	node,
		StarSystem *	sys
	)

static

Parses a single asteroid field for a system.

Parameters

node	Parent node containing asteroid field information.
sys	System.

Returns: 0 on success.

< Define to help check for data errors.

Definition at line 2699 of file space.c.

◆ system_parseJumpPoint()

static int system_parseJumpPoint	(	const xmlNodePtr	node,
		StarSystem *	sys
	)

static

Parses a single jump point for a system.

Parameters

node	Parent node containing jump point information.
sys	System to which the jump point belongs.

Returns: 0 on success.

Definition at line 3116 of file space.c.

◆ system_parseJumpPointDiff()

static int system_parseJumpPointDiff	(	const xmlNodePtr	node,
		StarSystem *	sys
	)

static

Parses a single jump point for a system, from unidiff.

Parameters

node	Parent node containing jump point information.
sys	System to which the jump point belongs.

Returns: 0 on success.

Definition at line 3044 of file space.c.

◆ system_parseJumps()

static int system_parseJumps ( StarSystem * sys )

static

Loads the jumps into a system.

Parameters

sys	Star system to load jumps of.

Returns: 0 on success.

Definition at line 3200 of file space.c.

◆ system_presenceAddSpob()

void system_presenceAddSpob	(	StarSystem *	sys,
		const SpobPresence *	ap
	)

Adds (or removes) some presence to a system.

Parameters

sys	Pointer to the system to add to or remove from.
ap	Spob presence to add.

Definition at line 4010 of file space.c.

◆ system_reconstructJumps()

void system_reconstructJumps ( StarSystem * sys )

Reconstructs the jumps for a single system.

Definition at line 2640 of file space.c.

◆ system_rmCurrentPresence()

void system_rmCurrentPresence	(	StarSystem *	sys,
		int	faction,
		double	amount
	)

Removes active presence.

Definition at line 4269 of file space.c.

◆ system_rmJump()

int system_rmJump	(	StarSystem *	sys,
		const char *	jumpname
	)

Removes a jump point from a star system.

Note that economy_execQueued should always be run after this.

Parameters

sys	Star System to remove jump point from.
jumpname	Name of the jump point to remove.

Returns: 0 on success.

Definition at line 2550 of file space.c.

◆ system_rmSpob()

int system_rmSpob	(	StarSystem *	sys,
		const char *	spobname
	)

Removes a spob from a star system.

Parameters

sys	Star System to remove spob from.
spobname	Name of the spob to remove.

Returns: 0 on success.

Definition at line 2411 of file space.c.

◆ system_rmVirtualSpob()

int system_rmVirtualSpob	(	StarSystem *	sys,
		const char *	spobname
	)

Removes a virtual spob from a system.

Parameters

sys	System to remove virtual spob from.
spobname	Name of the virtual spob being removed.

Definition at line 2490 of file space.c.

◆ system_scheduler()

static void system_scheduler	(	double	dt,
		int	init
	)

static

Controls fleet spawning.

Parameters

dt	Current delta tick.
init	Should be 1 to initialize the scheduler.

Definition at line 1225 of file space.c.

◆ system_searchFuzzyCase()

char ** system_searchFuzzyCase	(	const char *	sysname,
		int *	n
	)

Does a fuzzy case matching. Searches translated names but returns internal names.

Definition at line 869 of file space.c.

◆ system_setFaction()

void system_setFaction ( StarSystem * sys )

Sets the system faction based on the spobs it has.

Parameters

sys	System to set the faction of.

Todo:: Handle multiple different factions.

Definition at line 3017 of file space.c.

◆ system_updateAsteroids()

void system_updateAsteroids ( StarSystem * sys )

Updates some internal calculations about asteroids in a system.

Parameters

sys	System to update.

Definition at line 322 of file space.c.

◆ systems_load()

static int systems_load ( void )

static

Loads the entire systems, needs to be called after spobs_load.

Does multiple passes to load:

First loads the star systems.
Next sets the jump routes.

Returns
0 on success.

Definition at line 3324 of file space.c.

◆ systems_reconstructJumps()

void systems_reconstructJumps ( void )

Reconstructs the jumps.

Definition at line 2671 of file space.c.

◆ systems_reconstructSpobs()

void systems_reconstructSpobs ( void )

Updates the system spob pointers.

Definition at line 2683 of file space.c.

◆ virtualspob_cmp()

static int virtualspob_cmp	(	const void *	p1,
		const void *	p2
	)

static

Comparison function for qsort'ing VirtuaSpob by name.

Definition at line 1146 of file space.c.

◆ virtualspob_get()

VirtualSpob * virtualspob_get ( const char * name )

Gets a virtual spob by matching name.

Definition at line 1157 of file space.c.

◆ virtualspob_getAll()

VirtualSpob * virtualspob_getAll ( void )

Gets all the virtual spobs.

Definition at line 1138 of file space.c.

◆ virtualspobs_load()

static int virtualspobs_load ( void )

static

Loads all the virtual spobs.

Returns: 0 on success.

Definition at line 1763 of file space.c.

Variable Documentation

◆ cur_system

StarSystem* cur_system = NULL

Current star system.

Definition at line 105 of file space.c.

◆ jumpbuoy_gfx

glTexture* jumpbuoy_gfx = NULL

static

Jump buoy graphics.

Definition at line 107 of file space.c.

◆ jumppoint_gfx

glTexture* jumppoint_gfx = NULL

Jump point graphics.

Definition at line 106 of file space.c.

◆ mapshaders

MapShader** mapshaders = NULL

static

Map shaders.

Definition at line 99 of file space.c.

◆ space_fchg

int space_fchg = 0

static

Faction change counter, to avoid unnecessary calls.

Definition at line 108 of file space.c.

◆ space_landQueueSpob

Spob* space_landQueueSpob = NULL

static

Definition at line 111 of file space.c.

◆ space_simulating

int space_simulating = 0

static

Are we simulating space?

Definition at line 109 of file space.c.

◆ space_simulating_effects

int space_simulating_effects = 0

static

Are we doing special effects?

Definition at line 110 of file space.c.

◆ space_spawn

int space_spawn = 1

Spawn enabled by default.

Definition at line 116 of file space.c.

◆ spob_lua_stack

spob_lua_file* spob_lua_stack = NULL

static

Handles spob Lua chunks.

Definition at line 81 of file space.c.

◆ spob_stack

Spob* spob_stack = NULL

static

Spob stack.

Definition at line 93 of file space.c.

◆ spobname_stack

char** spobname_stack = NULL

static

Spob name stack corresponding to system.

Definition at line 86 of file space.c.

◆ systemname_stack

char** systemname_stack = NULL

static

System name stack corresponding to spob.

Definition at line 87 of file space.c.

◆ systems_loading

int systems_loading = 1

static

Systems are loading.

Definition at line 104 of file space.c.

◆ systems_stack

StarSystem* systems_stack = NULL

Star system stack.

Definition at line 92 of file space.c.

◆ vspob_stack

VirtualSpob* vspob_stack = NULL

static

Virtual spob stack.

Definition at line 94 of file space.c.

Data Structures

Macros

Functions

Variables

Detailed Description

Macro Definition Documentation

◆ DEBRIS_BUFFER

◆ FLAG_FACTIONSET

◆ FLAG_INTERFERENCESET

◆ FLAG_POSSET

◆ FLAG_SERVICESSET

◆ SPOB_GFX_EXTERIOR_PATH_H

◆ SPOB_GFX_EXTERIOR_PATH_W

◆ UNREF

◆ XML_SPOB_TAG

◆ XML_SYSTEM_TAG

Function Documentation

◆ getPresenceIndex()

◆ jump_get()

◆ jump_getSymbol()

◆ jump_getTarget()

◆ mapshader_get()

◆ space_addMarker()

◆ space_addMarkerSpob()

◆ space_addMarkerSystem()

◆ space_calcJumpInPos()

◆ space_canHyperspace()

◆ space_checkLand()

◆ space_clearComputerMarkers()

◆ space_clearKnown()

◆ space_clearMarkers()

◆ space_exit()

◆ space_factionChange()

◆ space_getFactionSpob()

◆ space_getRndSpob()

◆ space_gfxLoad()

◆ space_gfxUnload()

◆ space_hyperspace()

◆ space_init()

◆ space_isSimulation()

◆ space_isSimulationEffects()

◆ space_jumpDistance()

◆ space_load()

◆ space_loadLua()

◆ space_parseSpobs()

◆ space_populationStr()

◆ space_queueLand()

◆ space_reconstructPresences()

◆ space_render()

◆ space_renderJumpPoint()

◆ space_renderOverlay()

◆ space_renderSpob()

◆ space_rmMarker()

◆ space_rmMarkerSpob()

◆ space_rmMarkerSystem()

◆ space_sysLoad()

◆ space_sysReachable()

◆ space_sysReachableFromSys()

◆ space_sysReallyReachable()

◆ space_sysSave()

◆ space_update()

◆ space_updateSpob()

◆ spob_addCommodity()

◆ spob_addService()

◆ spob_averageSeenPricesAtTime()

◆ spob_averageSpobPrice()

◆ spob_cmp()

◆ spob_commodityPrice()

◆ spob_commodityPriceAtTime()

◆ spob_exists()

◆ spob_existsCase()

◆ spob_get()

◆ spob_getAll()

◆ spob_getClassName()

◆ spob_getColour()

◆ spob_getColourChar()

◆ spob_getIndex()

◆ spob_getService()

◆ spob_getServiceName()

◆ spob_getSymbol()