Nuclide
Software Development Kit for id Technology (BETA)
Loading...
Searching...
No Matches
entities.h
1/*
2 * Copyright (c) 2016-2024 Vera Visions LLC.
3 *
4 * Permission to use, copy, modify, and distribute this software for any
5 * purpose with or without fee is hereby granted, provided that the above
6 * copyright notice and this permission notice appear in all copies.
7 *
8 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
9 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
10 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
11 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
12 * WHATSOEVER RESULTING FROM LOSS OF MIND, USE, DATA OR PROFITS, WHETHER
13 * IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING
14 * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
15*/
16
17/* used to keep track of decl across different classnames */
18.string declclass;
19.string spawnclass;
20
34
91
92
95entity
96Entity_FindClosest(entity startTarget, string className)
97{
98 entity best = world;
99 float bestdist;
100 float dist;
101
102 bestdist = 9999999;
103
104 for (entity e = world; (e = find(e, classname, className));) {
105 dist = vlen(startTarget.origin - e.origin);
106
107 if (dist < bestdist) {
108 bestdist = dist;
109 best = e;
110 }
111 }
112
113 return best;
114}
115
116
119entity
120Entity_SelectRandom(string className)
121{
122 entity spot = world;
123 int max = 0i;
124
125 /* count the total number of entities of the desired class */
126 for (entity e = world; (e = find(e, ::classname, className));) {
127 max++;
128 }
129
130 /* immediately exit out if we've got none */
131 if (max < 1i) {
132 ncError("%S is not present on this map.", className);
133 return __NULL__;
134 }
135
136 /* select a random point */
137 for (int i = random(1, max); i > 0; i--) {
138 spot = find(spot, ::classname, className);
139 }
140
141 /* we might end up not finding anything, wrap around? */
142 if (spot == __NULL__) {
143 spot = find(spot, ::classname, className);
144 }
145
146 /* we should have returned something valid now */
147 return spot;
148}
149
150 // end of entities
entupdate_t
Entity update identifiers.
Definition entities.h:37
entity Entity_FindClosest(entity startTarget, string className)
Returns the closest point entity of a given classname.
Definition entities.h:96
entity Entity_SelectRandom(string className)
Returns a random entity of a given classname.
Definition entities.h:120
@ ENT_SPRITE
of type env_sprite
Definition entities.h:69
@ ENT_RAGDOLL
of type ncRagdoll
Definition entities.h:52
@ ENT_GLOW
of type env_glow
Definition entities.h:70
@ ENT_MONITOR
of type func_monitor
Definition entities.h:74
@ ENT_PARTSYSTEM
of type info_particle_system
Definition entities.h:68
@ ENT_ENTITY
of type ncEntity
Definition entities.h:39
@ ENT_CASCADELIGHT
of type env_cascade_light
Definition entities.h:66
@ ENT_NONE
invalid, but reserved.
Definition entities.h:38
@ ENT_SPECTATOR
of type ncSpectator
Definition entities.h:53
@ ENT_TALKMONSTER
of type ncTalkMonster
Definition entities.h:47
@ ENT_SPRAY
of type ncSpraylogo
Definition entities.h:71
@ ENT_VEH_TANKMORTAR
of type func_tankmortar
Definition entities.h:78
@ ENT_SOUNDSCAPE
of type ncSoundScape
Definition entities.h:88
@ ENT_RAIN
of type env_rain
Definition entities.h:64
@ ENT_WEAPON
of type ncWeapon
Definition entities.h:51
@ ENT_PORTAL
of type ncPortal
Definition entities.h:54
@ ENT_SURFPROP
of type ncSurfacePropEntity
Definition entities.h:44
@ ENT_PROJECTEDTEXTURE
of type env_projectedtexture
Definition entities.h:60
@ ENT_SPEAKER
of type speaker
Definition entities.h:48
@ ENT_OLDCAMERA
of type trigger_camera
Definition entities.h:73
@ ENT_ITEM
of type ncItem
Definition entities.h:50
@ ENT_FOG
of type env_fog
Definition entities.h:62
@ ENT_FOGCONTROLLER
of type env_fog_controller
Definition entities.h:65
@ ENT_STEAM
of type env_steam
Definition entities.h:63
@ ENT_SEPARATOR
This is a separator.
Definition entities.h:89
@ ENT_LASER
of type env_laser
Definition entities.h:67
@ ENT_FUNNEL
of type env_funnel
Definition entities.h:57
@ ENT_VEHICLE
Reserved.
Definition entities.h:75
@ ENT_PUSH
of type trigger_push
Definition entities.h:87
@ ENT_SMOKER
of type env_smoker
Definition entities.h:58
@ ENT_TRACKTRAIN
of type func_tracktrain
Definition entities.h:76
@ ENT_DLIGHT
of type light_dynamic
Definition entities.h:59
@ ENT_AMBIENTSOUND
of type ambient_generic
Definition entities.h:55
@ ENT_VEH_BRUSH
of type func_vehicle
Definition entities.h:77
@ ENT_WAYPOINT
of type info_waypoint
Definition entities.h:84
@ ENT_PROPROPE
of type prop_rope
Definition entities.h:80
@ ENT_PHYSICS
of type ncPhysicsEntity
Definition entities.h:45
@ ENT_BEAM
of type env_beam
Definition entities.h:56
@ ENT_ENTITYPROJECTILE
of type ncProjectile
Definition entities.h:43
@ ENT_INSTRUCTOR
of type env_instructor_hint
Definition entities.h:85
@ ENT_SPOTLIGHT
of type point_spotlight
Definition entities.h:61
@ ENT_PLAYER
of type ncPlayer
Definition entities.h:49
@ ENT_PHYSROPE
of type phys_rope
Definition entities.h:81
@ ENT_ENTITYRENDERABLE
of type ncRenderableEntity
Definition entities.h:42
@ ENT_PMOVEVARS
of type ncPMoveVars
Definition entities.h:41
@ ENT_MONSTER
of type ncMonster
Definition entities.h:46
@ ENT_SOUND
of type ncSound
Definition entities.h:40
@ ENT_CONVEYOR
of type func_conveyor
Definition entities.h:83
@ ENT_DECAL
of type ncDecal
Definition entities.h:72
@ ENT_HUDCOUNTER
of type env_hudcounter
Definition entities.h:86
@ ENT_BUBBLES
of type env_bubbles
Definition entities.h:82
@ ENT_VEH_4WHEEL
of type prop_vehicle_driveable
Definition entities.h:79