functions to handle the storage and lifecycle of all edicts in the game module. More...

#include "g_local.h"

Include dependency graph for g_edicts.h:

This graph shows which files directly or indirectly include this file:

Functions
Edict *	G_EdictsConstruct (void)
	Allocate space for the entity pointers.
void	G_EdictsInit (void)
	Reset the entity pointers for eg. a new game.
Edict *	G_EdictsGetNewEdict (void)
	Find an entity that is not in use.
Edict *	G_EdictDuplicate (const Edict *edict)
int	G_EdictsGetNumber (const Edict *ent)
	Get an entity's ID number.
bool	G_EdictsIsValidNum (const int idx)
	Check if the given number could point to an existing entity.
Edict *	G_EdictsGetByNum (const int num)
	Get an entity by it's number.
Edict *	G_EdictsGetFirst (void)
	Returns the first entity.
Edict *	G_EdictsGetNext (Edict *lastEnt)
	Iterate through the list of entities.
Edict *	G_EdictsGetNextInUse (Edict *lastEnt)
	Iterate through the entities that are in use.
Actor *	G_EdictsGetNextActor (Actor *lastEnt)
	Iterate through the actor entities (even the dead!).
Actor *	G_EdictsGetNextLivingActor (Actor *lastEnt)
	Iterate through the living actor entities.
Actor *	G_EdictsGetNextLivingActorOfTeam (Actor *lastEnt, const int team)
	Iterate through the living actor entities of the given team.
Actor *	G_EdictsGetActorByUCN (const int ucn, const int team)
	Searches an actor by a unique character number.
Edict *	G_EdictsGetTriggerNextMaps (Edict *lastEnt)
	Iterator through all the trigger_nextmap edicts.
Actor *	G_EdictsGetLivingActorFromPos (const pos3_t pos)
	Searches an actor at the given grid location.
Edict *	G_EdictsFindTargetEntity (const char *target)
	Searches the edict that has the given target as `targetname` set.
void	G_EdictsThink (void)
	Called every frame to let the edicts tick.

Detailed Description

functions to handle the storage and lifecycle of all edicts in the game module.

Definition in file g_edicts.h.

Function Documentation

◆ G_EdictDuplicate()

Edict * G_EdictDuplicate ( const Edict * edict )

Definition at line 128 of file g_edicts.cpp.

References G_EdictsGetNewEdict(), G_EdictsGetNumber(), and Edict::number.

Referenced by G_ClientGetFreeSpawnPointForActorSize().

◆ G_EdictsConstruct()

Edict * G_EdictsConstruct ( void )

Allocate space for the entity pointers.

Note: No need to set it to zero, G_TagMalloc will do that for us

Definition at line 39 of file g_edicts.cpp.

References g_edicts, G_TagMalloc, game, and TAG_GAME.

Referenced by G_Init().

◆ G_EdictsFindTargetEntity()

Edict * G_EdictsFindTargetEntity ( const char * target )

Searches the edict that has the given target as targetname set.

Parameters

target The target name of the edict that you are searching

Returns: nullptr if no edict with the given target name was found, otherwise the edict that has the targetname set you were looking for.

Definition at line 290 of file g_edicts.cpp.

References G_EdictsGetNextInUse(), Q_streq, and Edict::targetname.

Referenced by G_MissionUse(), and Touch_TouchTrigger().

◆ G_EdictsGetActorByUCN()

Actor * G_EdictsGetActorByUCN	(	const int	ucn,
		const int	team )

Searches an actor by a unique character number.

Parameters

[in]	ucn	The unique character number
[in]	team	The team to get the actor with the ucn from

Returns: The actor edict if found, otherwise nullptr

Definition at line 254 of file g_edicts.cpp.

References Edict::chr, G_EdictsGetNextActor(), Edict::getTeam(), and character_t::ucn.

Referenced by G_ClientInitActorStates().

◆ G_EdictsGetByNum()

Edict * G_EdictsGetByNum ( const int num )

Get an entity by it's number.

Parameters

[in] num The entity's index in the array of entities

Definition at line 83 of file g_edicts.cpp.

References g_edicts, G_EdictsIsValidNum(), and gi.

Referenced by AI_CheckLineOfFire(), G_ClientAction(), G_EventShoot(), G_ShootGrenade(), G_ShootSingle(), ReactionFireTargets::notifyClientMove(), ReactionFireTargets::notifyClientOnShot(), and ReactionFireTargets::notifyClientOnStep().

◆ G_EdictsGetFirst()

Edict * G_EdictsGetFirst ( void )

Returns the first entity.

Note: This is always a world edict - but in case of rma there might be several parts of the world spread all over the array.

Definition at line 98 of file g_edicts.cpp.

References g_edicts.

Referenced by G_ClientSendEdictsAndBrushModels(), G_FindEdictGroups(), G_GetTouchingEdicts(), and G_SendBoundingBoxes().

◆ G_EdictsGetLivingActorFromPos()

Actor * G_EdictsGetLivingActorFromPos ( const pos3_t pos )

Searches an actor at the given grid location.

Parameters

pos	The grid location to look for an edict.

Returns: nullptr if nothing was found, otherwise the actor located at the given grid position.

Definition at line 270 of file g_edicts.cpp.

References G_EdictsGetNextLivingActor(), Edict::pos, and VectorCompare.

Referenced by G_ActorShouldStopInMidMove(), G_ClientGetFreeSpawnPoint(), G_ClientShoot(), and G_SpawnItemOnFloor().

◆ G_EdictsGetNewEdict()

Edict * G_EdictsGetNewEdict ( void )

Find an entity that is not in use.

Definition at line 141 of file g_edicts.cpp.

References g_edicts, G_EdictsGetNext(), game, globals, and Edict::inuse.

Referenced by G_EdictDuplicate(), and G_Spawn().

◆ G_EdictsGetNext()

Edict * G_EdictsGetNext ( Edict * lastEnt )

Iterate through the list of entities.

Parameters

lastEnt The entity found in the previous iteration; if nullptr, we start at the beginning

Definition at line 107 of file g_edicts.cpp.

References g_edicts, and globals.

Referenced by G_EdictsGetNewEdict(), and G_EdictsGetNextInUse().

◆ G_EdictsGetNextActor()

Actor * G_EdictsGetNextActor ( Actor * lastEnt )

Iterate through the actor entities (even the dead!).

Parameters

lastEnt The entity found in the previous iteration; if nullptr, we start at the beginning

Definition at line 231 of file g_edicts.cpp.

References g_edicts, G_EdictsGetNextInUse(), G_IsActor, globals, and Sys_Error().

Referenced by AIL_squad(), G_ClientEndRound(), G_EdictsGetActorByUCN(), G_MatchSendResults(), G_SendInvisible(), and G_SendPlayerStats().

◆ G_EdictsGetNextInUse()

Edict * G_EdictsGetNextInUse ( Edict * lastEnt )

Iterate through the entities that are in use.

Note: we can hopefully get rid of this function once we know when it makes sense to iterate through entities that are NOT in use

Parameters

lastEnt The entity found in the previous iteration; if nullptr, we start at the beginning

Definition at line 166 of file g_edicts.cpp.

References G_EdictsGetNext(), and Edict::inuse.

Referenced by AI_CheckForMissionTargets(), AI_CheckPosition(), AI_SearchDestroyableObject(), AIL_findweapons(), AIL_missiontargets(), G_ActorCheckRevitalise(), G_BuildForbiddenList(), G_CheckVisPlayer(), G_CheckVisTeamAll(), G_ClientGetFreeSpawnPoint(), G_ClientSendEdictsAndBrushModels(), G_CompleteRecalcRouting(), G_EdictsFindTargetEntity(), G_EdictsGetNextActor(), G_EdictsGetNextLivingActor(), G_EdictsGetTriggerNextMaps(), G_EdictsThink(), G_FindEdictGroups(), G_FindRadius(), G_GenerateEntList(), G_GetEdictFromPos(), G_GetEdictFromPosExcluding(), G_GetTouchingEdicts(), G_ResetTriggers(), G_SendBoundingBoxes(), G_SmokeVis(), G_SplashDamage(), G_TeamPointVis(), G_TestVis(), G_VisFlagsClear(), G_VisMakeEverythingVisible(), TEST_F(), TEST_F(), and TEST_F().

◆ G_EdictsGetNextLivingActor()

Actor * G_EdictsGetNextLivingActor ( Actor * lastEnt )

Iterate through the living actor entities.

Parameters

lastEnt The entity found in the previous iteration; if nullptr, we start at the beginning

Definition at line 196 of file g_edicts.cpp.

References G_EdictsGetNextInUse(), G_IsLivingActor(), and Sys_Error().

Referenced by actorL_throwgrenade(), AI_CheckCrouch(), AI_CheckUsingDoor(), AI_CivilianCalcActionScore(), AI_FighterCalcActionScore(), AI_FindHerdLocation(), AI_HideNeeded(), AI_IsExposed(), AI_PanicCalcActionScore(), AIL_positionflee(), AIL_see(), ReactionFire::checkExecution(), G_ClientDisconnect(), G_EdictsGetLivingActorFromPos(), G_EdictsGetNextLivingActorOfTeam(), G_MatchSendResults(), G_Morale(), G_PlayerSoldiersCount(), G_ReactionFirePreShot(), G_ShotMorale(), and ReactionFire::updateAllTargets().

◆ G_EdictsGetNextLivingActorOfTeam()

Actor * G_EdictsGetNextLivingActorOfTeam	(	Actor *	lastEnt,
		const int	team )

Iterate through the living actor entities of the given team.

Parameters

lastEnt	The entity found in the previous iteration; if nullptr, we start at the beginning
team	The team we are looking for

Definition at line 216 of file g_edicts.cpp.

References G_EdictsGetNextLivingActor(), and Edict::getTeam().

Referenced by AI_CheckFF(), AI_CheckForMissionTargets(), AI_FighterCalcActionScore(), AI_PlayerRun(), AIL_waypoints(), G_BleedWounds(), G_GiveTimeUnits(), G_MatchEndCheck(), G_MoraleBehaviour(), G_ReactionFireReset(), G_RoundTouchTriggers(), G_TeamPointVis(), G_UpdateCarriedWeight(), G_UpdateStunState(), TEST_F(), TEST_F(), TEST_F(), and TEST_F().

◆ G_EdictsGetNumber()

int G_EdictsGetNumber ( const Edict * ent )

Get an entity's ID number.

Parameters

ent	The entity

Returns: the entity's ID number, currently the index in the array

Note: DO NOT use this number as anything other than an identifier !

Definition at line 60 of file g_edicts.cpp.

References g_edicts, and globals.

Referenced by G_EdictDuplicate(), and G_Spawn().

◆ G_EdictsGetTriggerNextMaps()

Edict * G_EdictsGetTriggerNextMaps ( Edict * lastEnt )

Iterator through all the trigger_nextmap edicts.

Parameters

lastEnt The entity found in the previous iteration; if nullptr, we start at the beginning

Definition at line 181 of file g_edicts.cpp.

References G_EdictsGetNextInUse(), and G_IsTriggerNextMap.

Referenced by G_MatchEndTrigger().

◆ G_EdictsInit()

void G_EdictsInit ( void )

Reset the entity pointers for eg. a new game.

Definition at line 48 of file g_edicts.cpp.

References g_edicts, game, and i.

Referenced by G_SpawnEntities().

◆ G_EdictsIsValidNum()

bool G_EdictsIsValidNum ( const int num )

Check if the given number could point to an existing entity.

Note: entity must also be 'in use' to be really valid

Parameters

[in] num The entity's index in the array of entities

Definition at line 72 of file g_edicts.cpp.

References globals.

Referenced by G_EdictsGetByNum().

◆ G_EdictsThink()

void G_EdictsThink ( void )

Called every frame to let the edicts tick.

Definition at line 306 of file g_edicts.cpp.

References G_EdictsGetNextInUse(), level, Edict::nextthink, SERVER_FRAME_SECONDS, and Edict::think.

Referenced by G_RunFrame().

Functions

Detailed Description

Function Documentation

◆ G_EdictDuplicate()

◆ G_EdictsConstruct()

◆ G_EdictsFindTargetEntity()

◆ G_EdictsGetActorByUCN()

◆ G_EdictsGetByNum()

◆ G_EdictsGetFirst()

◆ G_EdictsGetLivingActorFromPos()

◆ G_EdictsGetNewEdict()

◆ G_EdictsGetNext()

◆ G_EdictsGetNextActor()

◆ G_EdictsGetNextInUse()

◆ G_EdictsGetNextLivingActor()

◆ G_EdictsGetNextLivingActorOfTeam()

◆ G_EdictsGetNumber()

◆ G_EdictsGetTriggerNextMaps()

◆ G_EdictsInit()

◆ G_EdictsIsValidNum()

◆ G_EdictsThink()