entities.h

Go to the documentation of this file.

/*
 * Copyright (c) 2016-2024 Vera Visions LLC.
 *
 * Permission to use, copy, modify, and distribute this software for any
 * purpose with or without fee is hereby granted, provided that the above
 * copyright notice and this permission notice appear in all copies.
 *
 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
 * WHATSOEVER RESULTING FROM LOSS OF MIND, USE, DATA OR PROFITS, WHETHER
 * IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING
 * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
*/
 
typedef enum
{
        ENT_NONE = 0,   
        ENT_ENTITY,     
        ENT_PMOVEVARS, 
        ENT_ENTITYRENDERABLE, 
        ENT_ENTITYPROJECTILE, 
        ENT_SURFPROP, 
        ENT_PHYSICS,    
        ENT_MONSTER,    
        ENT_TALKMONSTER,        
        ENT_SPEAKER, 
        ENT_PLAYER,     
        ENT_WEAPON, 
        ENT_SPECTATOR,  
        ENT_PORTAL,             
        ENT_AMBIENTSOUND,       
        ENT_BEAM,       
        ENT_FUNNEL, 
        ENT_SMOKER, 
        ENT_DLIGHT,     
        ENT_PROJECTEDTEXTURE, 
        ENT_SPOTLIGHT, 
        ENT_FOG,                        /*<< of type env_fog */
        ENT_STEAM,      /*<< of type env_steam */
        ENT_FOGCONTROLLER, 
        ENT_CASCADELIGHT, /*<< of type env_cascade_light */
        ENT_LASER,      
        ENT_PARTSYSTEM, 
        ENT_SPRITE,     
        ENT_GLOW, 
        ENT_SPRAY,      
        ENT_DECAL,      
        ENT_OLDCAMERA,  
        ENT_MONITOR,    
        ENT_VEHICLE,    
        ENT_TRACKTRAIN, 
        ENT_VEH_BRUSH,  
        ENT_VEH_TANKMORTAR,     
        ENT_VEH_4WHEEL, 
        ENT_PROPROPE,   
        ENT_PHYSROPE,   
        ENT_BUBBLES,    
        ENT_CONVEYOR,   
        ENT_WAYPOINT,   
        ENT_INSTRUCTOR, 
        ENT_PUSH,               
        ENT_SEPARATOR,  
} entupdate_t;
 
 
entity
Entity_FindClosest(entity startTarget, string className)
{
        entity best = world;
        float bestdist;
        float dist;
 
        bestdist = 9999999;
 
        for (entity e = world; (e = find(e, classname, className));) {
                dist = vlen(startTarget.origin - e.origin);
 
                if (dist < bestdist) {
                        bestdist = dist;
                        best = e;
                }
        }
 
        return best;
}
 
 
entity
Entity_SelectRandom(string className)
{
        entity spot = world;
        int max = 0i;
 
        /* count the total number of entities of the desired class */
        for (entity e = world; (e = find(e, ::classname, className));) {
                max++;
        }
 
        /* immediately exit out if we've got none */
        if (max < 1i) {
                NSError("%S is not present on this map.", className);
                return __NULL__;
        }
 
        /* select a random point */
        for (int i = random(1, max); i > 0; i--) {
                spot = find(spot, ::classname, className);
        }
 
        /* we might end up not finding anything, wrap around? */
        if (spot == __NULL__) {
                spot = find(spot, ::classname, className);
        }
 
        /* we should have returned something valid now */
        return spot;
}