entities.h

/*
 * 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.
*/
 
/* used to keep track of decl across different classnames */
.string declclass;
 
typedef enum
{
    ENT_NONE = 0,   
    ENT_ENTITY, 
    ENT_SOUND,  
    ENT_PMOVEVARS, 
    ENT_ENTITYRENDERABLE, 
    ENT_ENTITYPROJECTILE, 
    ENT_SURFPROP, 
    ENT_PHYSICS,    
    ENT_MONSTER,    
    ENT_TALKMONSTER,    
    ENT_SPEAKER, 
    ENT_PLAYER, 
    ENT_ITEM, 
    ENT_WEAPON, 
    ENT_RAGDOLL, 
    ENT_SPECTATOR,  
    ENT_PORTAL,     
    ENT_AMBIENTSOUND,   
    ENT_BEAM,   
    ENT_FUNNEL, 
    ENT_SMOKER, 
    ENT_DLIGHT, 
    ENT_PROJECTEDTEXTURE, 
    ENT_SPOTLIGHT, 
    ENT_FOG,            
    ENT_STEAM,  
    ENT_RAIN,   
    ENT_FOGCONTROLLER, 
    ENT_CASCADELIGHT, 
    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_HUDCOUNTER, 
    ENT_PUSH,       
    ENT_SOUNDSCAPE, 
    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) {
        ncError("%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;
}
 
 // end of entities