util.qh File Reference

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

Go to the source code of this file.

Macros
#define	APPEND_TO_STRING(list, sep, add)
#define	bprintf(...)
#define	COMPARE_INCREASING(to, from)
#define	CTF_RECORD   "/ctf100record/"
#define	CTS_RECORD   "/cts100record/"
#define	FOR_EACH_TAG(v)
#define	fprintf(file, ...)
#define	GENTLE   (autocvar_cl_gentle || autocvar_cl_gentle_messages)
#define	normal_or_gentle(normal, gentle)
#define	RACE_RECORD   "/race100record/"
#define	TIME_DECODE(n)
#define	TIME_ENCODE(t)
#define	TIME_ENCODED_TOSTRING(n, compact)
#define	TIME_TO_NTHS(t, n)
#define	XPD(...)

Typedefs
using	findNextEntityNearFunction_t = entity(entity cur, entity near, entity pass)
using	isConnectedFunction_t = float(entity a, entity b, entity pass)
using	textLengthUpToLength_lenFunction_t = float(string s)
using	textLengthUpToWidth_widthFunction_t = float(string s, vector size)

Functions
vector	animfixfps (entity e, vector a, vector b)
entity	Announcer_PickNumber (int type, int num)
void	attach_sameorigin (entity e, entity to, string tag)
float	blink (float base, float range, float freq)
float	blink_synced (float base, float range, float freq, float start_time, int start_blink)
float	CheckWireframeBox (entity forent, vector v0, vector dvx, vector dvy, vector dvz)
float	compressShortVector (vector vec)
float	compressShotOrigin (vector v)
float	cvar_or (string cv, float v)
float	cvar_settemp (string pKey, string pValue)
float	cvar_settemp_restore ()
vector	decompressShortVector (float data)
vector	decompressShotOrigin (float f)
void	depthfirst (entity start,.entity up,.entity downleft,.entity right, void(entity, entity) funcPre, void(entity, entity) funcPost, entity pass)
void	detach_sameorigin (entity e)
void	execute_next_frame ()
string	find_last_color_code (string s)
vector	findbetterlocation (vector org, float mindist)
void	FindConnectedComponent (entity e,.entity fld, findNextEntityNearFunction_t nxt, isConnectedFunction_t iscon, entity pass)
string	fixPriorityList (string pl, float from, float to, float subtract, float complete)
void	follow_sameorigin (entity e, entity to)
void	get_mi_min_max (float mode)
void	get_mi_min_max_texcoords (float mode)
string	get_model_datafilename (string mod, float skn, string fil)
float	get_model_parameters (string mod, float skn)
vector	get_shotvelocity (vector myvel, vector mydir, float spd, float newton_style, float mi, float ma)
string	getcurrentmod ()
string	getWrappedLine (float w, vector size, textLengthUpToWidth_widthFunction_t tw)
string	getWrappedLineLen (float w, textLengthUpToLength_lenFunction_t tw)
vector	healtharmor_applydamage (float a, float armorblock, int deathtype, float damage)
vector	healtharmor_maxdamage (float h, float a, float armorblock, int deathtype)
float	isGametypeInFilter (entity gt, float tp, float ts, string pattern)
int	LostMovetypeFollow (entity ent)
string	mapPriorityList (string order, string(string) mapfunc)
float	matchacl (string acl, string str)
int	Mod_Q1BSP_NativeContentsFromSuperContents (int supercontents)
int	Mod_Q1BSP_SuperContentsFromNativeContents (int nativecontents)
string	playername (string thename, int teamid, bool team_colorize)
void	queue_to_execute_next_frame (string s)
vector	real_origin (entity ent)
string	ScoreString (float vflags, float value, int rounds_played)
void	SetMovetypeFollow (entity ent, entity e)
void	Shutdown ()
void	Skeleton_SetBones (entity e)
vector	solve_shotdirection (vector myorg, vector myvel, vector eorg, vector evel, float spd, float newton_style)
	STATIC_INIT (g_saved_cvars)
string	strtolower (string s)
string	swapInPriorityList (string order, float i, float j)
float	textLengthUpToLength (string theText, int maxLength, textLengthUpToLength_lenFunction_t tw)
float	textLengthUpToWidth (string theText, float maxWidth, vector size, textLengthUpToWidth_widthFunction_t tw)
string	textShortenToLength (string theText, int maxLength, textLengthUpToLength_lenFunction_t tw)
string	textShortenToWidth (string theText, float maxWidth, vector size, textLengthUpToWidth_widthFunction_t tw)
float	trace_hits_box (vector start, vector end, vector thmi, vector thma)
float	trace_hits_box_1d (float end, float thmi, float thma)
float	tracebox_hits_box (vector start, vector mi, vector ma, vector end, vector thmi, vector thma)
float	tracebox_inverted (vector v1, vector mi, vector ma, vector v2, float nomonsters, entity forent, float stopatentity, entity ignorestopatentity)
void	traceline_inverted (vector v1, vector v2, float nomonsters, entity forent, float stopatentity, entity ignorestopatentity)
ERASEABLE string	translate_key (string key)
void	UnsetMovetypeFollow (entity ent)
string	wordwrap (string s, float l)
void	wordwrap_cb (string s, float l, void(string) callback)
void	wordwrap_sprint (entity to, string s, float l)
void	write_String_To_File (int fh, string str, bool alsoprint)
float	xdecode (string s)
string	xencode (float f)

Variables
bool	autocvar_cl_gentle
int	autocvar_cl_gentle_messages
const int	CNT_GAMESTART = 2
const int	CNT_KILL = 4
const int	CNT_NORMAL = 1
const int	CNT_RESPAWN = 5
const int	CNT_ROUNDSTART = 6
string	config_queue [MAX_CONFIG_SETTINGS]
IntrusiveList	g_saved_cvars
float	get_model_parameters_age
string	get_model_parameters_bone_aim [MAX_AIM_BONES]
float	get_model_parameters_bone_aimweight [MAX_AIM_BONES]
string	get_model_parameters_bone_upperbody
string	get_model_parameters_bone_weapon
string	get_model_parameters_desc
string	get_model_parameters_description
float	get_model_parameters_fixbone
bool	get_model_parameters_hidden
string	get_model_parameters_modelname
float	get_model_parameters_modelskin
string	get_model_parameters_name
string	get_model_parameters_sex
float	get_model_parameters_species
float	get_model_parameters_weight
string	getWrappedLine_remaining
string	ladder_reply
string	lsmaps_reply
string	maplist_reply
const int	MAX_AIM_BONES = 4
const int	MAX_CONFIG_SETTINGS = 70
string	message
vector	mi_max
vector	mi_min
vector	mi_picmax
vector	mi_picmin
vector	mi_pictexcoord0
vector	mi_pictexcoord1
vector	mi_pictexcoord2
vector	mi_pictexcoord3
string	mi_shortname
string	monsterlist_reply
string	netname
string	rankings_reply
string	records_reply [10]
float	skeleton_bones
const int	TIME_DECIMALS = 2
const float	TIME_FACTOR = 100
const float	XENCODE_LEN = 5
const float	XENCODE_MAX = 21295

Macro Definition Documentation

APPEND_TO_STRING

#define APPEND_TO_STRING	(		list,
			sep,
			add )

Value:

((list) = (((list) != "") ? strcat(list, sep, add) : (add)))

Definition at line 265 of file util.qh.

Referenced by UpdateNotification_URI_Get_Callback().

bprintf

#define bprintf

(

...

)

Value:

bprint(sprintf(__VA_ARGS__))

Definition at line 232 of file util.qh.

Referenced by CheatsAllowed().

COMPARE_INCREASING

#define COMPARE_INCREASING	(		to,
			from )

Value:

(to < from ? from + to + 2 : to - from)

Definition at line 268 of file util.qh.

Referenced by HitSound(), and UpdateDamage().

CTF_RECORD

#define CTF_RECORD   "/ctf100record/"

Definition at line 99 of file util.qh.

Referenced by ctf_Initialize().

CTS_RECORD

#define CTS_RECORD   "/cts100record/"

Definition at line 98 of file util.qh.

Referenced by cts_Initialize(), getladder(), and HUD_Mod_Race().

FOR_EACH_TAG

#define FOR_EACH_TAG

(

v

)

Value:

float tagnum; Skeleton_SetBones(v); for(tagnum = 0; tagnum < v.skeleton_bones; tagnum++, gettaginfo(v, tagnum))

Definition at line 216 of file util.qh.

Referenced by DamageEffect(), and MUTATOR_HOOKFUNCTION().

fprintf

#define fprintf	(		file,
			... )

Value:

fputs(file, sprintf(__VA_ARGS__))

Definition at line 231 of file util.qh.

GENTLE

#define GENTLE   (autocvar_cl_gentle || autocvar_cl_gentle_messages)

Definition at line 238 of file util.qh.

Referenced by Create_Notification_Entity_Annce(), and Create_Notification_Entity_InfoCenter().

normal_or_gentle

#define normal_or_gentle	(		normal,
			gentle )

Value:

((GENTLE && (gentle != "")) ? gentle : normal)

Definition at line 243 of file util.qh.

Referenced by notif_arg_spree_cen(), and notif_arg_spree_inf().

RACE_RECORD

#define RACE_RECORD   "/race100record/"

Definition at line 97 of file util.qh.

Referenced by getladder(), HUD_Mod_Race(), rc_SetLimits(), and spawnfunc().

TIME_DECODE

#define TIME_DECODE

(

n

)

Value:

((n) / TIME_FACTOR)

Definition at line 101 of file util.qh.

Referenced by HUD_RaceTimer(), HUD_Timer_Color(), and race_setTime().

TIME_ENCODE

#define TIME_ENCODE

(

t

)

Value:

TIME_TO_NTHS(t, TIME_FACTOR)

Definition at line 100 of file util.qh.

Referenced by ctf_CaptureRecord(), ctf_CheckFlagReturn(), ctf_Handle_Capture(), HUD_Checkpoints(), HUD_RaceTimer(), MakeRaceString(), race_ImposePenaltyTime(), race_SendTime(), and write_recordmarker().

TIME_ENCODED_TOSTRING

#define TIME_ENCODED_TOSTRING	(		n,
			compact )

Value:

mmssth(n, compact)

Definition at line 96 of file util.qh.

Referenced by getrankings(), HUD_Checkpoints(), HUD_RaceTimer(), HUD_Score(), MakeRaceString(), MUTATOR_HOOKFUNCTION(), MUTATOR_HOOKFUNCTION(), race_showTime(), race_UpdateDB(), Scoreboard_Rankings_Draw(), ScoreString(), and write_recordmarker().

TIME_TO_NTHS

#define TIME_TO_NTHS	(		t,
			n )

Value:

floor((t) * (n) + 0.5)

Definition at line 92 of file util.qh.

XPD

#define XPD

(

...

)

Value:

__VA_ARGS__

Definition at line 228 of file util.qh.

Typedef Documentation

findNextEntityNearFunction_t

using findNextEntityNearFunction_t = entity(entity cur, entity near, entity pass)

Definition at line 223 of file util.qh.

isConnectedFunction_t

using isConnectedFunction_t = float(entity a, entity b, entity pass)

Definition at line 224 of file util.qh.

textLengthUpToLength_lenFunction_t

using textLengthUpToLength_lenFunction_t = float(string s)

Definition at line 141 of file util.qh.

textLengthUpToWidth_widthFunction_t

using textLengthUpToWidth_widthFunction_t = float(string s, vector size)

Definition at line 140 of file util.qh.

Function Documentation

animfixfps()

vector animfixfps	(	entity	e,
		vector	a,
		vector	b )

Definition at line 1917 of file util.qc.

{
    // multi-frame anim: keep as-is
    if(a.y == 1)
    {
        float dur = frameduration(e.modelindex, a.x);
        if (dur <= 0 && b.y)
        {
            a = b;
            dur = frameduration(e.modelindex, a.x);
        }
        if (dur > 0)
            a.z = 1.0 / dur;
    }
    return a;
}

Announcer_PickNumber()

entity Announcer_PickNumber	(	int	type,
		int	num )

Definition at line 1936 of file util.qc.

{
    return = NULL;
    switch (type)
    {
        case CNT_GAMESTART:
        {
            switch(num)
            {
                case 10: return ANNCE_NUM_GAMESTART_10;
                case 9:  return ANNCE_NUM_GAMESTART_9;
                case 8:  return ANNCE_NUM_GAMESTART_8;
                case 7:  return ANNCE_NUM_GAMESTART_7;
                case 6:  return ANNCE_NUM_GAMESTART_6;
                case 5:  return ANNCE_NUM_GAMESTART_5;
                case 4:  return ANNCE_NUM_GAMESTART_4;
                case 3:  return ANNCE_NUM_GAMESTART_3;
                case 2:  return ANNCE_NUM_GAMESTART_2;
                case 1:  return ANNCE_NUM_GAMESTART_1;
            }
            break;
        }
        case CNT_KILL:
        {
            switch(num)
            {
                case 10: return ANNCE_NUM_KILL_10;
                case 9:  return ANNCE_NUM_KILL_9;
                case 8:  return ANNCE_NUM_KILL_8;
                case 7:  return ANNCE_NUM_KILL_7;
                case 6:  return ANNCE_NUM_KILL_6;
                case 5:  return ANNCE_NUM_KILL_5;
                case 4:  return ANNCE_NUM_KILL_4;
                case 3:  return ANNCE_NUM_KILL_3;
                case 2:  return ANNCE_NUM_KILL_2;
                case 1:  return ANNCE_NUM_KILL_1;
            }
            break;
        }
        case CNT_RESPAWN:
        {
            switch(num)
            {
                case 10: return ANNCE_NUM_RESPAWN_10;
                case 9:  return ANNCE_NUM_RESPAWN_9;
                case 8:  return ANNCE_NUM_RESPAWN_8;
                case 7:  return ANNCE_NUM_RESPAWN_7;
                case 6:  return ANNCE_NUM_RESPAWN_6;
                case 5:  return ANNCE_NUM_RESPAWN_5;
                case 4:  return ANNCE_NUM_RESPAWN_4;
                case 3:  return ANNCE_NUM_RESPAWN_3;
                case 2:  return ANNCE_NUM_RESPAWN_2;
                case 1:  return ANNCE_NUM_RESPAWN_1;
            }
            break;
        }
        case CNT_ROUNDSTART:
        {
            switch(num)
            {
                case 10: return ANNCE_NUM_ROUNDSTART_10;
                case 9:  return ANNCE_NUM_ROUNDSTART_9;
                case 8:  return ANNCE_NUM_ROUNDSTART_8;
                case 7:  return ANNCE_NUM_ROUNDSTART_7;
                case 6:  return ANNCE_NUM_ROUNDSTART_6;
                case 5:  return ANNCE_NUM_ROUNDSTART_5;
                case 4:  return ANNCE_NUM_ROUNDSTART_4;
                case 3:  return ANNCE_NUM_ROUNDSTART_3;
                case 2:  return ANNCE_NUM_ROUNDSTART_2;
                case 1:  return ANNCE_NUM_ROUNDSTART_1;
            }
            break;
        }
        case CNT_NORMAL:
        default:
        {
            switch(num)
            {
                case 10: return ANNCE_NUM_10;
                case 9:  return ANNCE_NUM_9;
                case 8:  return ANNCE_NUM_8;
                case 7:  return ANNCE_NUM_7;
                case 6:  return ANNCE_NUM_6;
                case 5:  return ANNCE_NUM_5;
                case 4:  return ANNCE_NUM_4;
                case 3:  return ANNCE_NUM_3;
                case 2:  return ANNCE_NUM_2;
                case 1:  return ANNCE_NUM_1;
            }
            break;
        }
    }
}

References CNT_GAMESTART, CNT_KILL, CNT_NORMAL, CNT_RESPAWN, CNT_ROUNDSTART, and NULL.

Referenced by Announcer_Countdown(), instagib_countdown(), KillIndicator_Think(), and ShowRespawnCountdown().

attach_sameorigin()

void attach_sameorigin	(	entity	e,
		entity	to,
		string	tag )

Definition at line 2069 of file util.qc.

{
    vector org, t_forward, t_left, t_up, e_forward, e_up;
    float tagscale;
 
    org = e.origin - gettaginfo(to, gettagindex(to, tag));
    tagscale = (vlen(v_forward) ** -2); // undo a scale on the tag
    t_forward = v_forward * tagscale;
    t_left = v_right * -tagscale;
    t_up = v_up * tagscale;
 
    e.origin_x = org * t_forward;
    e.origin_y = org * t_left;
    e.origin_z = org * t_up;
 
    // current forward and up directions
    if (substring(e.model, 0, 1) == "*") // bmodels have their own rules
        e.angles = AnglesTransform_FromVAngles(e.angles);
    else
        e.angles = AnglesTransform_FromAngles(e.angles);
    fixedmakevectors(e.angles);
 
    // untransform forward, up!
    e_forward.x = v_forward * t_forward;
    e_forward.y = v_forward * t_left;
    e_forward.z = v_forward * t_up;
    e_up.x = v_up * t_forward;
    e_up.y = v_up * t_left;
    e_up.z = v_up * t_up;
 
    e.angles = fixedvectoangles2(e_forward, e_up);
    if (substring(e.model, 0, 1) == "*") // bmodels have their own rules
        e.angles = AnglesTransform_ToVAngles(e.angles);
    else
        e.angles = AnglesTransform_ToAngles(e.angles);
 
    setattachment(e, to, tag);
    setorigin(e, e.origin);
}

References AnglesTransform_FromAngles(), AnglesTransform_FromVAngles(), AnglesTransform_ToAngles(), AnglesTransform_ToVAngles(), entity(), fixedmakevectors(), fixedvectoangles2, gettagindex, gettaginfo, org, substring(), v_forward, v_right, v_up, vector, and vlen().

Referenced by follow_init().

blink()

float blink	(	float	base,
		float	range,
		float	freq )

Definition at line 2286 of file util.qc.

{
    return blink_synced(base, range, freq, 0, 0);
}

References blink_synced(), and freq.

Referenced by DrawItemsTimeItem(), HUD_Get_Num_Color(), HUD_HealthArmor(), HUD_Mod_Keepaway(), HUD_Mod_KH(), HUD_Mod_TeamKeepaway(), and HUD_Radar_InputEvent().

blink_synced()

float blink_synced	(	float	base,
		float	range,
		float	freq,
		float	start_time,
		int	start_blink )

Definition at line 2274 of file util.qc.

{
    // note:
    //   RMS = sqrt(base^2 + 0.5 * range^2)
    // thus
    //   base = sqrt(RMS^2 - 0.5 * range^2)
    // ensure RMS == 1
 
    return base + range * sin((time - start_time - (M_PI / 2) * start_pos) * freq);
}

References freq, M_PI, sin(), and time.

Referenced by blink(), and HUD_HealthArmor().

CheckWireframeBox()

float CheckWireframeBox	(	entity	forent,
		vector	v0,
		vector	dvx,
		vector	dvy,
		vector	dvz )

Definition at line 592 of file util.qc.

{
    traceline(v0, v0 + dvx, true, forent); if(trace_fraction < 1) return 0;
    traceline(v0, v0 + dvy, true, forent); if(trace_fraction < 1) return 0;
    traceline(v0, v0 + dvz, true, forent); if(trace_fraction < 1) return 0;
    traceline(v0 + dvx, v0 + dvx + dvy, true, forent); if(trace_fraction < 1) return 0;
    traceline(v0 + dvx, v0 + dvx + dvz, true, forent); if(trace_fraction < 1) return 0;
    traceline(v0 + dvy, v0 + dvy + dvx, true, forent); if(trace_fraction < 1) return 0;
    traceline(v0 + dvy, v0 + dvy + dvz, true, forent); if(trace_fraction < 1) return 0;
    traceline(v0 + dvz, v0 + dvz + dvx, true, forent); if(trace_fraction < 1) return 0;
    traceline(v0 + dvz, v0 + dvz + dvy, true, forent); if(trace_fraction < 1) return 0;
    traceline(v0 + dvx + dvy, v0 + dvx + dvy + dvz, true, forent); if(trace_fraction < 1) return 0;
    traceline(v0 + dvx + dvz, v0 + dvx + dvy + dvz, true, forent); if(trace_fraction < 1) return 0;
    traceline(v0 + dvy + dvz, v0 + dvx + dvy + dvz, true, forent); if(trace_fraction < 1) return 0;
    return 1;
}

References entity(), trace_fraction, and vector.

Referenced by Portal_Spawn(), and Porto_Draw().

compressShortVector()

float compressShortVector

(

vector

vec

)

Definition at line 531 of file util.qc.

{
    vector ang;
    float p, y, len;
    if(vec == '0 0 0')
        return 0;
    //print("compress: ", vtos(vec), "\n");
    ang = vectoangles(vec);
    ang.x = -ang.x;
    if(ang.x < -90)
        ang.x += 360;
    if(ang.x < -90 && ang.x > +90)
        error("BOGUS vectoangles");
    //print("angles: ", vtos(ang), "\n");
 
    p = floor(0.5 + (ang.x + 90) * (16 / 180)) & 15; // -90..90 to 0..14
    if(p == 0)
    {
        if(vec.z < 0)
            y = 31;
        else
            y = 30;
    }
    else
        y = floor(0.5 + ang.y * (32 / 360)) & 31; // 0..360 to 0..32
    len = invertLengthLog(vlen(vec));
 
    //print("compressed: p:", ftos(p)); print(" y:", ftos(y)); print(" len:", ftos(len), "\n");
 
    return (p * 0x1000) + (y * 0x80) + len;
}

References ang, error, floor(), invertLengthLog(), vectoangles(), vector, vlen(), and y.

Referenced by pointparticles_SendEntity(), rainsnow_SendEntity(), SpawnCasing(), STATIC_INIT(), and Violence_GibSplash_At().

compressShotOrigin()

float compressShotOrigin

(

vector

v

)

Definition at line 1360 of file util.qc.

{
    int rx_neg = (v.x < 0) ? 1 : 0;
    int ry_neg = (v.y < 0) ? 1 : 0;
    int rz_neg = (v.z < 0) ? 1 : 0;
    int rx = rint(fabs(v.x) * 2);
    int ry = rint(fabs(v.y) * 2);
    int rz = rint(fabs(v.z) * 2);
    if(rx > 255) // 128 * 2 - 1
    {
        LOG_DEBUG("shot origin ", vtos(v), " x out of bounds\n");
        rx = bound(0, rx, 255);
    }
    if(ry > 63) // 32 * 2 - 1
    {
        LOG_DEBUG("shot origin ", vtos(v), " y out of bounds\n");
        ry = bound(0, ry, 63);
    }
    if(rz > 63) // 32 * 2 - 1
    {
        LOG_DEBUG("shot origin ", vtos(v), " z out of bounds\n");
        rz = bound(0, rz, 63);
    }
    ry |= ry_neg * BIT(6) + rx_neg * BIT(7);
    rz |= rz_neg * BIT(6); // BIT(7) unused
    return rx * 0x10000 + ry * 0x100 + rz;
}

References BIT, bound(), fabs(), LOG_DEBUG, rint(), vector, and vtos().

Referenced by CL_WeaponEntity_SetModel(), and ClientInit_misc().

cvar_or()

float cvar_or	(	string	cv,
		float	v )

Definition at line 2258 of file util.qc.

{
    string s = cvar_string(cv);
    if(s == "")
        return v;
    else
        return stof(s);
}

References cvar_string(), and stof().

cvar_settemp()

float cvar_settemp	(	string	pKey,
		string	pValue )

Definition at line 819 of file util.qc.

{
    float created_saved_value = 0;
 
    if (!(tmp_cvar || tmp_value))
    {
        LOG_TRACE("Error: Invalid usage of cvar_settemp(string, string); !");
        return 0;
    }
 
    if(!cvar_type(tmp_cvar))
    {
        LOG_INFOF("Error: cvar %s doesn't exist!", tmp_cvar);
        return 0;
    }
 
    IL_EACH(g_saved_cvars, it.netname == tmp_cvar,
    {
        created_saved_value = -1; // skip creation
        break; // no need to continue
    });
 
    if(created_saved_value != -1)
    {
        // creating a new entity to keep track of this cvar
        entity e = new_pure(saved_cvar_value);
        IL_PUSH(g_saved_cvars, e);
        e.netname = strzone(tmp_cvar);
        e.message = strzone(cvar_string(tmp_cvar));
        created_saved_value = 1;
    }
 
    // update the cvar to the value given
    cvar_set(tmp_cvar, tmp_value);
 
    return created_saved_value;
}

References cvar_set(), cvar_string(), entity(), g_saved_cvars, IL_EACH, IL_PUSH(), LOG_INFOF, LOG_TRACE, new_pure, and strzone().

Referenced by _MapInfo_Parse_Settemp(), CampaignPreInit(), CSQC_Init(), CSQCPlayer_PostUpdate(), CSQCPlayer_Remove(), GameCommand_bot_cmd(), GameCommand_nospectators(), GameCommand_setbots(), GenericCommand_settemp(), NET_HANDLE(), NET_HANDLE(), REGISTER_MUTATOR(), View_EventChase(), and View_Ortho().

cvar_settemp_restore()

float cvar_settemp_restore

(

)

Definition at line 857 of file util.qc.

{
    int j = 0;
    // FIXME this new-style loop fails!
#if 0
    FOREACH_ENTITY_CLASS("saved_cvar_value", true,
    {
        if(cvar_type(it.netname))
        {
            cvar_set(it.netname, it.message);
            strunzone(it.netname);
            strunzone(it.message);
            delete(it);
            ++j;
        }
        else
            LOG_INFOF("Error: cvar %s doesn't exist anymore! It can still be restored once it's manually recreated.", it.netname);
    });
 
#else
    entity e = NULL;
    while((e = find(e, classname, "saved_cvar_value")))
    {
        if(cvar_type(e.netname))
        {
            cvar_set(e.netname, e.message);
            delete(e);
            ++j;
        }
        else
            print(sprintf("Error: cvar %s doesn't exist anymore! It can still be restored once it's manually recreated.", e.netname));
    }
#endif
 
    return j;
}

References classname, cvar_set(), entity(), find(), FOREACH_ENTITY_CLASS, LOG_INFOF, NULL, print(), and strunzone().

Referenced by DoNextMapOverride(), GenericCommand_settemp_restore(), MapInfo_LoadMap(), and SV_Shutdown().

decompressShortVector()

vector decompressShortVector

(

float

data

)

References entity(), and vector.

decompressShotOrigin()

vector decompressShotOrigin

(

float

f

)

References vector.

depthfirst()

void depthfirst	(	entity	start,
		.entity	up,
		.entity	downleft,
		.entity	right,
		void(entity, entity)	funcPre,
		void(entity, entity)	funcPost,
		entity	pass )

Definition at line 404 of file util.qc.

{
    entity e = start;
    funcPre(pass, e);
    while (e.(downleft))
    {
        e = e.(downleft);
        funcPre(pass, e);
    }
    funcPost(pass, e);
    while(e != start)
    {
        if (e.(right))
        {
            e = e.(right);
            funcPre(pass, e);
            while (e.(downleft))
            {
                e = e.(downleft);
                funcPre(pass, e);
            }
        }
        else
            e = e.(up);
        funcPost(pass, e);
    }
}

References entity(), and pass.

Referenced by forAllDescendants().

detach_sameorigin()

void detach_sameorigin

(

entity

e

)

Definition at line 2109 of file util.qc.

{
    vector org = gettaginfo(e, 0);
    e.angles = fixedvectoangles2(v_forward, v_up);
    if (substring(e.model, 0, 1) == "*") // bmodels have their own rules
        e.angles = AnglesTransform_ToVAngles(e.angles);
    else
        e.angles = AnglesTransform_ToAngles(e.angles);
    setorigin(e, org);
    setattachment(e, NULL, "");
    setorigin(e, e.origin);
}

References AnglesTransform_ToAngles(), AnglesTransform_ToVAngles(), entity(), fixedvectoangles2, gettaginfo, NULL, org, substring(), v_forward, v_up, and vector.

Referenced by Drag().

execute_next_frame()

void execute_next_frame

(

)

Definition at line 1857 of file util.qc.

{
    if(to_execute_next_frame)
    {
        localcmd("\n", to_execute_next_frame, "\n");
        strfree(to_execute_next_frame);
    }
}

References localcmd(), strfree, and to_execute_next_frame.

Referenced by CSQC_UpdateView(), m_draw(), and StartFrame().

find_last_color_code()

string find_last_color_code

(

string

s

)

Definition at line 966 of file util.qc.

{
    int start = strstrofs(s, "^", 0);
    if (start == -1) // no caret found
        return "";
    int len = strlen(s)-1;
    for(int i = len; i >= start; --i)
    {
        if(substring(s, i, 1) != "^")
            continue;
 
        int carets = 1;
        while (i-carets >= start && substring(s, i-carets, 1) == "^")
            ++carets;
 
        // check if carets aren't all escaped
        if (carets & 1)
        {
            if(i+1 <= len)
            if(IS_DIGIT(substring(s, i+1, 1)))
            {
                if(start == 0 && len == 1)
                    return "";
                return substring(s, i, 2);
            }
 
            if(i+4 <= len)
            if(substring(s, i+1, 1) == "x")
            if(IS_HEXDIGIT(substring(s, i + 2, 1)))
            if(IS_HEXDIGIT(substring(s, i + 3, 1)))
            if(IS_HEXDIGIT(substring(s, i + 4, 1)))
            {
                if(start == 0 && len == 4)
                    return "";
                return substring(s, i, 5);
            }
        }
        i -= carets; // this also skips one char before the carets
    }
 
    return "";
}

References IS_DIGIT, IS_HEXDIGIT, strlen, strstrofs, and substring().

Referenced by hash_replace(), minigame_getWrappedLine(), and take_wrapped_line_until().

findbetterlocation()

vector findbetterlocation	(	vector	org,
		float	mindist )

Definition at line 116 of file util.qc.

{
    vector vec = mindist * '1 0 0';
    int c = 0;
    while (c < 6)
    {
        traceline (org, org + vec, true, NULL);
        vec = -vec;
        if (trace_fraction < 1)
        {
            vector loc = trace_endpos;
            traceline (loc, loc + vec, true, NULL);
            if (trace_fraction >= 1)
                org = loc + vec;
        }
        if (c & 1)
        {
            float h = vec.y;
            vec.y = vec.x;
            vec.x = vec.z;
            vec.z = h;
        }
        ++c;
    }
 
    return org;
}

References NULL, org, trace_endpos, trace_fraction, and vector.

Referenced by nade_boom(), and W_Seeker_Tag_Touch().

FindConnectedComponent()

void FindConnectedComponent	(	entity	e,
		.entity	fld,
		findNextEntityNearFunction_t	nxt,
		isConnectedFunction_t	iscon,
		entity	pass )

Definition at line 1875 of file util.qc.

{
    entity queue_start, queue_end;
 
    // we build a queue of to-be-processed entities.
    // queue_start is the next entity to be checked for neighbors
    // queue_end is the last entity added
 
    if(e.FindConnectedComponent_processing)
        error("recursion or broken cleanup");
 
    // start with a 1-element queue
    queue_start = queue_end = e;
    queue_end.(fld) = NULL;
    queue_end.FindConnectedComponent_processing = 1;
 
    // for each queued item:
    for (; queue_start; queue_start = queue_start.(fld))
    {
        // find all neighbors of queue_start
        entity t;
        for(t = NULL; (t = nxt(t, queue_start, pass)); )
        {
            if(t.FindConnectedComponent_processing)
                continue;
            if(iscon(t, queue_start, pass))
            {
                // it is connected? ADD IT. It will look for neighbors soon too.
                queue_end.(fld) = t;
                queue_end = t;
                queue_end.(fld) = NULL;
                queue_end.FindConnectedComponent_processing = 1;
            }
        }
    }
 
    // unmark
    for (queue_start = e; queue_start; queue_start = queue_start.(fld))
        queue_start.FindConnectedComponent_processing = 0;
}

References entity(), error, NULL, and pass.

Referenced by LinkDoors().

fixPriorityList()

string fixPriorityList	(	string	pl,
		float	from,
		float	to,
		float	subtract,
		float	complete )

Definition at line 610 of file util.qc.

{
    string neworder;
    float i, n, w;
 
    n = tokenize_console(order);
    neworder = "";
    for(i = 0; i < n; ++i)
    {
        w = stof(argv(i));
        if(w == floor(w))
        {
            if(w >= from && w <= to)
                neworder = strcat(neworder, ftos(w), " ");
            else
            {
                w -= subtract;
                if(w >= from && w <= to)
                    neworder = strcat(neworder, ftos(w), " ");
            }
        }
    }
 
    if(complete)
    {
        n = tokenize_console(neworder);
        for(w = to; w >= from; --w)
        {
            int wflags = REGISTRY_GET(Weapons, w).spawnflags;
            if(wflags & WEP_FLAG_SPECIALATTACK)
                continue;
            for(i = 0; i < n; ++i)
                if(stof(argv(i)) == w)
                    break;
            if(i == n) // not found
                neworder = strcat(neworder, ftos(w), " ");
        }
    }
 
    return substring(neworder, 0, strlen(neworder) - 1);
}

References argv(), floor(), ftos(), REGISTRY_GET, stof(), strcat(), strlen, substring(), tokenize_console, Weapons, and WEP_FLAG_SPECIALATTACK.

Referenced by W_FixWeaponOrder().

follow_sameorigin()

void follow_sameorigin	(	entity	e,
		entity	to )

Definition at line 2122 of file util.qc.

{
    set_movetype(e, MOVETYPE_FOLLOW); // make the hole follow
    e.aiment = to; // make the hole follow bmodel
    e.punchangle = to.angles; // the original angles of bmodel
    e.view_ofs = e.origin - to.origin; // relative origin
    e.v_angle = e.angles - to.angles; // relative angles
}

References entity(), MOVETYPE_FOLLOW, and set_movetype().

Referenced by follow_init().

get_mi_min_max()

void get_mi_min_max

(

float

mode

)

Definition at line 686 of file util.qc.

{
    vector mi, ma;
 
    string s = mapname;
    if(!strcasecmp(substring(s, 0, 5), "maps/"))
        s = substring(s, 5, strlen(s) - 5);
    if(!strcasecmp(substring(s, strlen(s) - 4, 4), ".bsp"))
        s = substring(s, 0, strlen(s) - 4);
    strcpy(mi_shortname, s);
 
#ifdef CSQC
    mi = world.mins;
    ma = world.maxs;
#else
    mi = world.absmin;
    ma = world.absmax;
#endif
 
    mi_min = mi;
    mi_max = ma;
    MapInfo_Get_ByName(mi_shortname, 0, NULL);
    if(MapInfo_Map_mins.x < MapInfo_Map_maxs.x)
    {
        mi_min = MapInfo_Map_mins;
        mi_max = MapInfo_Map_maxs;
    }
    else
    {
        // not specified
        if(mode)
        {
            // be clever
            tracebox('1 0 0' * mi.x,
                     '0 1 0' * mi.y + '0 0 1' * mi.z,
                     '0 1 0' * ma.y + '0 0 1' * ma.z,
                     '1 0 0' * ma.x,
                     MOVE_WORLDONLY,
                     NULL);
            if(!trace_startsolid)
                mi_min.x = trace_endpos.x;
 
            tracebox('0 1 0' * mi.y,
                     '1 0 0' * mi.x + '0 0 1' * mi.z,
                     '1 0 0' * ma.x + '0 0 1' * ma.z,
                     '0 1 0' * ma.y,
                     MOVE_WORLDONLY,
                     NULL);
            if(!trace_startsolid)
                mi_min.y = trace_endpos.y;
 
            tracebox('0 0 1' * mi.z,
                     '1 0 0' * mi.x + '0 1 0' * mi.y,
                     '1 0 0' * ma.x + '0 1 0' * ma.y,
                     '0 0 1' * ma.z,
                     MOVE_WORLDONLY,
                     NULL);
            if(!trace_startsolid)
                mi_min.z = trace_endpos.z;
 
            tracebox('1 0 0' * ma.x,
                     '0 1 0' * mi.y + '0 0 1' * mi.z,
                     '0 1 0' * ma.y + '0 0 1' * ma.z,
                     '1 0 0' * mi.x,
                     MOVE_WORLDONLY,
                     NULL);
            if(!trace_startsolid)
                mi_max.x = trace_endpos.x;
 
            tracebox('0 1 0' * ma.y,
                     '1 0 0' * mi.x + '0 0 1' * mi.z,
                     '1 0 0' * ma.x + '0 0 1' * ma.z,
                     '0 1 0' * mi.y,
                     MOVE_WORLDONLY,
                     NULL);
            if(!trace_startsolid)
                mi_max.y = trace_endpos.y;
 
            tracebox('0 0 1' * ma.z,
                     '1 0 0' * mi.x + '0 1 0' * mi.y,
                     '1 0 0' * ma.x + '0 1 0' * ma.y,
                     '0 0 1' * mi.z,
                     MOVE_WORLDONLY,
                     NULL);
            if(!trace_startsolid)
                mi_max.z = trace_endpos.z;
        }
    }
}

References MapInfo_Get_ByName(), MapInfo_Map_maxs, MapInfo_Map_mins, mapname, mi_max, mi_min, mi_shortname, MOVE_WORLDONLY, NULL, strcasecmp, strcpy, strlen, substring(), trace_endpos, trace_startsolid, vector, and world.

Referenced by get_mi_min_max_texcoords(), and InitGameplayMode().

get_mi_min_max_texcoords()

void get_mi_min_max_texcoords

(

float

mode

)

Definition at line 776 of file util.qc.

{
    vector extend;
 
    get_mi_min_max(mode);
 
    mi_picmin = mi_min;
    mi_picmax = mi_max;
 
    // extend mi_picmax to get a square aspect ratio
    // center the map in that area
    extend = mi_picmax - mi_picmin;
    if(extend.y > extend.x)
    {
        mi_picmin.x -= (extend.y - extend.x) * 0.5;
        mi_picmax.x += (extend.y - extend.x) * 0.5;
    }
    else
    {
        mi_picmin.y -= (extend.x - extend.y) * 0.5;
        mi_picmax.y += (extend.x - extend.y) * 0.5;
    }
 
    // add another some percent
    extend = (mi_picmax - mi_picmin) * (1 / 64.0);
    mi_picmin -= extend;
    mi_picmax += extend;
 
    // calculate the texcoords
    mi_pictexcoord0 = mi_pictexcoord1 = mi_pictexcoord2 = mi_pictexcoord3 = '0 0 0';
    // first the two corners of the origin
    mi_pictexcoord0_x = (mi_min.x - mi_picmin.x) / (mi_picmax.x - mi_picmin.x);
    mi_pictexcoord0_y = (mi_min.y - mi_picmin.y) / (mi_picmax.y - mi_picmin.y);
    mi_pictexcoord2_x = (mi_max.x - mi_picmin.x) / (mi_picmax.x - mi_picmin.x);
    mi_pictexcoord2_y = (mi_max.y - mi_picmin.y) / (mi_picmax.y - mi_picmin.y);
    // then the other corners
    mi_pictexcoord1_x = mi_pictexcoord0_x;
    mi_pictexcoord1_y = mi_pictexcoord2_y;
    mi_pictexcoord3_x = mi_pictexcoord2_x;
    mi_pictexcoord3_y = mi_pictexcoord0_y;
}

References get_mi_min_max(), mi_max, mi_min, mi_picmax, mi_picmin, mi_pictexcoord0, mi_pictexcoord1, mi_pictexcoord2, mi_pictexcoord3, and vector.

Referenced by CSQC_Init().

get_model_datafilename()

string get_model_datafilename	(	string	mod,
		float	skn,
		string	fil )

Definition at line 1491 of file util.qc.

{
    if(m)
        m = strcat(m, "_");
    else
        m = "models/player/*_";
    if(sk >= 0)
        m = strcat(m, ftos(sk));
    else
        m = strcat(m, "*");
    return strcat(m, ".", fil);
}

References ftos(), and strcat().

Referenced by get_model_parameters(), UpdatePlayerSounds(), and XonoticPlayerModelSelector_loadModels().

get_model_parameters()

float get_model_parameters	(	string	mod,
		float	skn )

Definition at line 1504 of file util.qc.

{
    get_model_parameters_modelname = string_null;
    get_model_parameters_modelskin = -1;
    get_model_parameters_name = string_null;
    get_model_parameters_species = -1;
    get_model_parameters_sex = string_null;
    get_model_parameters_weight = -1;
    get_model_parameters_age = -1;
    get_model_parameters_desc = string_null;
    get_model_parameters_bone_upperbody = string_null;
    get_model_parameters_bone_weapon = string_null;
    for(int i = 0; i < MAX_AIM_BONES; ++i)
    {
        get_model_parameters_bone_aim[i] = string_null;
        get_model_parameters_bone_aimweight[i] = 0;
    }
    get_model_parameters_fixbone = 0;
    get_model_parameters_hidden = false;
 
#ifdef GAMEQC
    MUTATOR_CALLHOOK(ClearModelParams);
#endif
 
    if (!m)
        return 1;
 
    if(substring(m, -9, 5) == "_lod1" || substring(m, -9, 5) == "_lod2")
        m = strcat(substring(m, 0, -10), substring(m, -4, -1));
 
    if(sk < 0)
    {
        if(substring(m, -4, -1) != ".txt")
            return 0;
        if(substring(m, -6, 1) != "_")
            return 0;
        sk = stof(substring(m, -5, 1));
        m = substring(m, 0, -7);
    }
 
    string fn = get_model_datafilename(m, sk, "txt");
    int fh = fopen(fn, FILE_READ);
    if(fh < 0)
    {
        sk = 0;
        fn = get_model_datafilename(m, sk, "txt");
        fh = fopen(fn, FILE_READ);
        if(fh < 0)
            return 0;
    }
 
    get_model_parameters_modelname = m;
    get_model_parameters_modelskin = sk;
    string s, c;
    while((s = fgets(fh)))
    {
        if(s == "")
            break; // next lines will be description
        c = car(s);
        s = cdr(s);
        if(c == "name")
            get_model_parameters_name = s;
        if(c == "species")
            switch(s)
            {
                case "human":       get_model_parameters_species = SPECIES_HUMAN;       break;
                case "alien":       get_model_parameters_species = SPECIES_ALIEN;       break;
                case "robot_shiny": get_model_parameters_species = SPECIES_ROBOT_SHINY; break;
                case "robot_rusty": get_model_parameters_species = SPECIES_ROBOT_RUSTY; break;
                case "robot_solid": get_model_parameters_species = SPECIES_ROBOT_SOLID; break;
                case "animal":      get_model_parameters_species = SPECIES_ANIMAL;      break;
                case "reserved":    get_model_parameters_species = SPECIES_RESERVED;    break;
            }
        if(c == "sex")
        {
            if (s == "Male")                s = _("Male");
            else if (s == "Female")         s = _("Female");
            else if (s == "Undisclosed")    s = _("Undisclosed");
            get_model_parameters_sex = s;
        }
        if(c == "weight")
            get_model_parameters_weight = stof(s);
        if(c == "age")
            get_model_parameters_age = stof(s);
        if(c == "description")
            get_model_parameters_description = s;
        if(c == "bone_upperbody")
            get_model_parameters_bone_upperbody = s;
        if(c == "bone_weapon")
            get_model_parameters_bone_weapon = s;
    #ifdef GAMEQC
        MUTATOR_CALLHOOK(GetModelParams, c, s);
    #endif
        for(int i = 0; i < MAX_AIM_BONES; ++i)
            if(c == strcat("bone_aim", ftos(i)))
            {
                get_model_parameters_bone_aimweight[i] = stof(car(s));
                get_model_parameters_bone_aim[i] = cdr(s);
            }
        if(c == "fixbone")
            get_model_parameters_fixbone = stof(s);
        if(c == "hidden")
            get_model_parameters_hidden = stob(s);
    }
 
    while((s = fgets(fh)))
    {
        if(get_model_parameters_desc)
            get_model_parameters_desc = strcat(get_model_parameters_desc, "\n");
        if(s != "")
            get_model_parameters_desc = strcat(get_model_parameters_desc, s);
    }
 
    fclose(fh);
 
    return 1;
}

References car(), cdr(), fclose(), fgets(), FILE_READ, fopen(), ftos(), get_model_datafilename(), get_model_parameters_age, get_model_parameters_bone_aim, get_model_parameters_bone_aimweight, get_model_parameters_bone_upperbody, get_model_parameters_bone_weapon, get_model_parameters_desc, get_model_parameters_description, get_model_parameters_fixbone, get_model_parameters_hidden, get_model_parameters_modelname, get_model_parameters_modelskin, get_model_parameters_name, get_model_parameters_sex, get_model_parameters_species, get_model_parameters_weight, MAX_AIM_BONES, MUTATOR_CALLHOOK, SPECIES_ALIEN, SPECIES_ANIMAL, SPECIES_HUMAN, SPECIES_RESERVED, SPECIES_ROBOT_RUSTY, SPECIES_ROBOT_SHINY, SPECIES_ROBOT_SOLID, stob, stof(), strcat(), string_null, and substring().

Referenced by player_getspecies(), skeleton_loadinfo(), and XonoticPlayerModelSelector_loadModels().

get_shotvelocity()

vector get_shotvelocity	(	vector	myvel,
		vector	mydir,
		float	spd,
		float	newton_style,
		float	mi,
		float	ma )

Definition at line 1308 of file util.qc.

{
    if(!newton_style)
        return spd * mydir;
 
    if(newton_style == 2)
    {
        // true Newtonian projectiles with automatic aim adjustment
        //
        // solve: |outspeed * mydir - myvel| = spd
        // outspeed^2 - 2 * outspeed * (mydir * myvel) + myvel^2 - spd^2 = 0
        // outspeed = (mydir * myvel) +- sqrt((mydir * myvel)^2 - myvel^2 + spd^2)
        // PLUS SIGN!
        // not defined?
        // then...
        // myvel^2 - (mydir * myvel)^2 > spd^2
        // velocity without mydir component > spd
        // fire at smallest possible spd that works?
        // |(mydir * myvel) * myvel - myvel| = spd
 
        vector solution = solve_quadratic(1, -2 * (mydir * myvel), myvel * myvel - spd * spd);
 
        float outspeed;
        if(solution.z)
            outspeed = solution.y; // the larger one
        else
        {
            //outspeed = 0; // slowest possible shot
            outspeed = solution.x; // the real part (that is, the average!)
            //dprint("impossible shot, adjusting\n");
        }
 
        outspeed = bound(spd * mi, outspeed, spd * ma);
        return mydir * outspeed;
    }
 
    // real Newtonian
    return myvel + spd * mydir;
}

References bound(), solve_quadratic(), and vector.

Referenced by W_CalculateProjectileVelocity().

getcurrentmod()

string getcurrentmod

(

)

Definition at line 1439 of file util.qc.

{
    string m = cvar_string("fs_gamedir");
    float n = tokenize_console(m);
    if(n == 0)
        return "data";
    else
        return argv(n - 1);
}

References argv(), cvar_string(), and tokenize_console.

Referenced by resolvemod().

getWrappedLine()

string getWrappedLine	(	float	w,
		vector	size,
		textLengthUpToWidth_widthFunction_t	tw )

Definition at line 1143 of file util.qc.

{
    string s = getWrappedLine_remaining;
    if (maxWidth <= 0)
    {
        getWrappedLine_remaining = string_null;
        return s; // the line has no size ANYWAY, nothing would be displayed.
    }
 
    int take_until = textLengthUpToWidth(s, maxWidth, theFontSize, tw);
 
    if (take_until <= 0 || take_until >= strlen(s)) {
        getWrappedLine_remaining = string_null;
        return s; // remaining text fits the line
    }
 
    float colorlen = tw("^7", theFontSize);
    return take_wrapped_line_until(take_until, colorlen);
}

References getWrappedLine_remaining, string_null, strlen, take_wrapped_line_until(), textLengthUpToWidth(), and vector.

Referenced by Checkpoints_drawstring(), GameTypeVote_DrawGameTypeItem(), HUD_CenterPrint(), InfoMessages_drawstring(), Label_draw(), Label_recalcPositionWithText(), m_tooltip(), rewrapCampaign(), wrapGuideText(), XonoticEntryList_drawListBoxItem(), and XonoticTextBox_setText().

getWrappedLineLen()

string getWrappedLineLen	(	float	w,
		textLengthUpToLength_lenFunction_t	tw )

healtharmor_applydamage()

vector healtharmor_applydamage	(	float	a,
		float	armorblock,
		int	deathtype,
		float	damage )

Definition at line 1425 of file util.qc.

{
    vector v;
    if (DEATH_IS(deathtype, DEATH_DROWN))  // Why should armor help here...
        armorblock = 0;
    if (deathtype & HITTYPE_ARMORPIERCE)
        armorblock = 0;
    v.y = bound(0, damage * armorblock, a); // save
    v.x = bound(0, damage - v.y, damage); // take
    v.z = 0;
    return v;
}

References bound(), DEATH_IS, HITTYPE_ARMORPIERCE, and vector.

Referenced by Damage(), Monster_Damage(), PlayerCorpseDamage(), and PlayerDamage().

healtharmor_maxdamage()

vector healtharmor_maxdamage	(	float	h,
		float	a,
		float	armorblock,
		int	deathtype )

Definition at line 1401 of file util.qc.

{
    // NOTE: we'll always choose the SMALLER value...
    float healthdamage, armordamage, armorideal;
    if (DEATH_IS(deathtype, DEATH_DROWN))  // Why should armor help here...
        armorblock = 0;
    vector v;
    healthdamage = (h - 1) / (1 - armorblock); // damage we can take if we could use more health
    armordamage = a + (h - 1); // damage we can take if we could use more armor
    armorideal = healthdamage * armorblock;
    v.y = armorideal;
    if(armordamage < healthdamage)
    {
        v.x = armordamage;
        v.z = 1;
    }
    else
    {
        v.x = healthdamage;
        v.z = 0;
    }
    return v;
}

References DEATH_IS, and vector.

Referenced by crosshair_getcolor(), ctf_FlagcarrierWaypoints(), HUD_HealthArmor(), if(), and WaypointSprite_AttachCarrier().

isGametypeInFilter()

float isGametypeInFilter	(	entity	gt,
		float	tp,
		float	ts,
		string	pattern )

References entity(), and vector.

LostMovetypeFollow()

int LostMovetypeFollow

(

entity

ent

)

Definition at line 2171 of file util.qc.

{
/*
    if(ent.move_movetype != MOVETYPE_FOLLOW)
        if(ent.aiment)
            error("???");
*/
    // FIXME: engine bug?
    // when aiment disconnects the engine will set orb's origin close to world's origin
    if(!ent.aiment)
        return 2;
    if(ent.aiment.classname != ent.aiment_classname || ent.aiment.deadflag != ent.aiment_deadflag)
        return 1;
    return 0;
}

References entity().

Referenced by GrapplingHookThink(), W_Electro_Orb_Follow_Think(), and W_MineLayer_Think().

mapPriorityList()

string mapPriorityList	(	string	order,
		string(string)	mapfunc )

Definition at line 652 of file util.qc.

{
    string neworder;
    float n = tokenize_console(order);
    neworder = "";
    for(float i = 0; i < n; ++i)
        neworder = strcat(neworder, mapfunc(argv(i)), " ");
 
    return substring(neworder, 0, strlen(neworder) - 1);
}

References argv(), strcat(), strlen, substring(), and tokenize_console.

Referenced by W_NameWeaponOrder(), and W_NumberWeaponOrder().

matchacl()

float matchacl	(	string	acl,
		string	str )

Definition at line 1449 of file util.qc.

{
    string t, s;
    float r, d;
    r = 0;
    while(acl)
    {
        t = car(acl); acl = cdr(acl);
 
        d = 1;
        if(substring(t, 0, 1) == "-")
        {
            d = -1;
            t = substring(t, 1, strlen(t) - 1);
        }
        else if(substring(t, 0, 1) == "+")
            t = substring(t, 1, strlen(t) - 1);
 
        if(substring(t, -1, 1) == "*")
        {
            t = substring(t, 0, strlen(t) - 1);
            s = substring(str, 0, strlen(t));
        }
        else
            s = str;
 
        if(s == t)
        {
            r = d;
            break; // if we found a killing case, apply it! other settings may be allowed in the future, but this one is caught
        }
    }
    return r;
}

References car(), cdr(), strlen, and substring().

Referenced by _MapInfo_Parse_Settemp().

Mod_Q1BSP_NativeContentsFromSuperContents()

int Mod_Q1BSP_NativeContentsFromSuperContents

(

int

supercontents

)

Definition at line 2052 of file util.qc.

{
    if(supercontents & (DPCONTENTS_SOLID | DPCONTENTS_BODY))
        return CONTENT_SOLID;
    if(supercontents & DPCONTENTS_SKY)
        return CONTENT_SKY;
    if(supercontents & DPCONTENTS_LAVA)
        return CONTENT_LAVA;
    if(supercontents & DPCONTENTS_SLIME)
        return CONTENT_SLIME;
    if(supercontents & DPCONTENTS_WATER)
        return CONTENT_WATER;
    return CONTENT_EMPTY;
}

References CONTENT_EMPTY, CONTENT_LAVA, CONTENT_SKY, CONTENT_SLIME, CONTENT_SOLID, CONTENT_WATER, DPCONTENTS_BODY, DPCONTENTS_LAVA, DPCONTENTS_SKY, DPCONTENTS_SLIME, DPCONTENTS_SOLID, and DPCONTENTS_WATER.

Mod_Q1BSP_SuperContentsFromNativeContents()

int Mod_Q1BSP_SuperContentsFromNativeContents

(

int

nativecontents

)

Definition at line 2032 of file util.qc.

{
    switch(nativecontents)
    {
        case CONTENT_EMPTY:
            return 0;
        case CONTENT_SOLID:
            return DPCONTENTS_SOLID | DPCONTENTS_OPAQUE;
        case CONTENT_WATER:
            return DPCONTENTS_WATER;
        case CONTENT_SLIME:
            return DPCONTENTS_SLIME;
        case CONTENT_LAVA:
            return DPCONTENTS_LAVA | DPCONTENTS_NODROP;
        case CONTENT_SKY:
            return DPCONTENTS_SKY | DPCONTENTS_NODROP | DPCONTENTS_OPAQUE; // to match behaviour of Q3 maps, let sky count as opaque
    }
    return 0;
}

References CONTENT_EMPTY, CONTENT_LAVA, CONTENT_SKY, CONTENT_SLIME, CONTENT_SOLID, CONTENT_WATER, DPCONTENTS_LAVA, DPCONTENTS_NODROP, DPCONTENTS_OPAQUE, DPCONTENTS_SKY, DPCONTENTS_SLIME, DPCONTENTS_SOLID, and DPCONTENTS_WATER.

Referenced by _Movetype_CheckWater(), and racer_frame().

playername()

string playername	(	string	thename,
		int	teamid,
		bool	team_colorize )

Definition at line 2190 of file util.qc.

{
    TC(int, teamid);
    bool do_colorize = (teamplay && team_colorize);
#ifdef SVQC
    if(do_colorize && !intermission_running)
#else
    if(do_colorize)
#endif
    {
        string t = Team_ColorCode(teamid);
        return strcat(t, strdecolorize(thename));
    }
    else
        return thename;
}

References intermission_running, strcat(), TC, Team_ColorCode(), and teamplay.

Referenced by CheatsAllowed(), ClientCommand_ready(), ClientConnect(), Draw_ShowNames(), DumpStats(), GameCommand_adminmsg(), GameCommand_defer_clear(), GameCommand_moveplayer(), GetCallerName(), MatchEnd_RestoreSpectatorAndTeamStatus(), NextLevel(), OriginalCallerName(), PlayerFrame(), PlayerStats_GameReport_FinalizePlayer(), Remove_Countdown(), Say(), Score_NicePrint_Player(), Score_NicePrint_Spectator(), TeamBalance_RemoveExcessPlayers(), and W_HitPlotOpen().

queue_to_execute_next_frame()

void queue_to_execute_next_frame

(

string

s

)

Definition at line 1865 of file util.qc.

{
    if(to_execute_next_frame)
    {
        s = strcat(s, "\n", to_execute_next_frame);
    }
    strcpy(to_execute_next_frame, s);
}

References strcat(), strcpy, and to_execute_next_frame.

Referenced by GenericCommand_nextframe().

real_origin()

vector real_origin

(

entity

ent

)

Definition at line 147 of file util.qc.

{
    vector v = ((ent.absmin + ent.absmax) * 0.5);
    entity e = ent.tag_entity;
 
    while(e)
    {
        v += (e.absmin + e.absmax) * 0.5;
        e = e.tag_entity;
    }
 
    return v;
}

References entity(), and vector.

Referenced by bumblebee_gunner_exit(), bumblebee_gunner_frame(), bumblebee_pilot_frame(), racer_frame(), raptor_frame(), turret_aim_generic(), turret_do_updates(), turret_targetscore_generic(), turret_validate_target(), and vehicles_damage().

ScoreString()

string ScoreString	(	float	vflags,
		float	value,
		int	rounds_played )

References rounds_played.

SetMovetypeFollow()

void SetMovetypeFollow	(	entity	ent,
		entity	e )

Definition at line 2141 of file util.qc.

{
    set_movetype(ent, MOVETYPE_FOLLOW); // make the hole follow
    ent.solid = SOLID_NOT; // MOVETYPE_FOLLOW is always non-solid - this means this cannot be teleported by warpzones any more! Instead, we must notice when our owner gets teleported.
    ent.aiment = e; // make the hole follow bmodel
    ent.punchangle = e.angles; // the original angles of bmodel
    ent.view_ofs = ent.origin - e.origin; // relative origin
    ent.v_angle = ent.angles - e.angles; // relative angles
    ent.aiment_classname = e.classname;
    ent.aiment_deadflag = e.deadflag;
 
    if(IS_PLAYER(ent.aiment))
    {
        entity pl = ent.aiment;
        ent.view_ofs.x = bound(pl.mins.x + 4, ent.view_ofs.x, pl.maxs.x - 4);
        ent.view_ofs.y = bound(pl.mins.y + 4, ent.view_ofs.y, pl.maxs.y - 4);
        ent.view_ofs.z = bound(pl.mins.z + 4, ent.view_ofs.z, pl.maxs.z - 4);
    }
}

References bound(), entity(), IS_PLAYER, MOVETYPE_FOLLOW, set_movetype(), and SOLID_NOT.

Referenced by GrapplingHookTouch(), W_Electro_Orb_Stick(), and W_MineLayer_Stick().

Shutdown()

void Shutdown

(

)

Definition at line 162 of file main.qc.

{
    WarpZone_Shutdown();
 
    delete(teams);
    delete(players);
    db_close(binddb);
    db_close(tempdb);
    if(autocvar_cl_db_saveasdump)
        db_dump(ClientProgsDB, "client.db");
    else
        db_save(ClientProgsDB, "client.db");
    db_close(ClientProgsDB);
 
    if(camera_active)
        cvar_set("chase_active",ftos(chase_active_backup));
 
    // unset the event chasecam's chase_active
    if(autocvar_chase_active < 0)
        cvar_set("chase_active", "0");
 
    if (autocvar_r_drawviewmodel < 0)
        cvar_set("r_drawviewmodel", "0");
 
    cvar_set("slowmo", cvar_defstring("slowmo")); // reset it back to 'default'
 
    // if _cl_hook_gamestart wasn't called with an actual gametype
    // before CSQC VM shutdown then call it with nop fallback here
    if (!(calledhooks & HOOK_START) && !isdemo())
        localcmd("\n_cl_hook_gamestart nop\n");
 
    // fire game or demo end hooks when CSQC VM shuts down
    if (!(calledhooks & HOOK_END))
    {
        // call gameend hook if it hasn't somehow yet fired by intermission starting
        if (!isdemo())
        {
            localcmd("\ncl_hook_gameend\n");
 
            // NOTE: using localcmd here to ensure it's executed AFTER cl_hook_gameend
            // earlier versions of the game abuse the hook to set this cvar
            int gamecount = cvar("cl_matchcount");
            localcmd(strcat("cl_matchcount ", itos(gamecount + 1), "\n"));
            //cvar_set("cl_matchcount", itos(gamecount + 1));
        }
        else
            localcmd("\ncl_hook_demoend\n");
 
        calledhooks |= HOOK_END; // mark the hook as having fired
    }
 
    localcmd("\ncl_hook_shutdown\n");
 
    localcmd("\n-button12\n");
 
    strfree(gametype_custom_name);
 
    deactivate_minigame();
    HUD_MinigameMenu_Close(NULL, NULL, NULL);
 
    ReplicateVars(REPLICATEVARS_DESTROY);
}

References __init_dedicated_server_shutdown(), autocvar_chase_active, autocvar_cl_db_saveasdump, autocvar_developer, autocvar_r_drawviewmodel, autocvar_sessionid, autocvar_sv_db_saveasdump, Ban_SaveBans(), binddb, bot_endgame(), calledhooks, camera_active, chase_active_backup, cheatcount_total, CheatShutdown(), ClientProgsDB, cvar(), cvar_defstring(), cvar_set(), db_close(), db_dump(), db_save(), deactivate_minigame(), FOREACH_ENTITY_ORDERED, ftos(), game_stopped, gametype_custom_name, HOOK_END, HOOK_START, HUD_MinigameMenu_Close(), isdemo(), itos, loaded_gametype_custom_string, localcmd(), LOG_INFO, LOG_TRACE, m_hide(), MapInfo_Shutdown(), NULL, orig_slowmo, players, PlayerStats_GameReport(), ReplicateVars(), REPLICATEVARS_DESTROY, ServerProgsDB, strcat(), strfree, sv_termsofservice_url_escaped, teams, tempdb, TemporaryDB, TIMEOUT_ACTIVE, timeout_status, WarpZone_Shutdown(), WeaponStats_Shutdown(), and world_initialized.

Referenced by SV_Shutdown().

Skeleton_SetBones()

void Skeleton_SetBones

(

entity

e

)

Definition at line 1843 of file util.qc.

{
    // set skeleton_bones to the total number of bones on the model
    if(e.skeleton_bones_index == e.modelindex)
        return; // same model, nothing to update
 
    float skelindex = skel_create(e.modelindex);
    e.skeleton_bones = skel_get_numbones(skelindex);
    skel_delete(skelindex);
    e.skeleton_bones_index = e.modelindex;
}

References entity().

solve_shotdirection()

vector solve_shotdirection	(	vector	myorg,
		vector	myvel,
		vector	eorg,
		vector	evel,
		float	spd,
		float	newton_style )

Definition at line 1245 of file util.qc.

{
    vector ret;
 
    // make origin and speed relative
    eorg -= myorg;
    if(newton_style)
        evel -= myvel;
 
    // now solve for ret, ret normalized:
    //   eorg + t * evel == t * ret * spd
    // or, rather, solve for t:
    //   |eorg + t * evel| == t * spd
    //   eorg^2 + t^2 * evel^2 + 2 * t * (eorg * evel) == t^2 * spd^2
    //   t^2 * (evel^2 - spd^2) + t * (2 * (eorg * evel)) + eorg^2 == 0
    vector solution = solve_quadratic(evel * evel - spd * spd, 2 * (eorg * evel), eorg * eorg);
    // p = 2 * (eorg * evel) / (evel * evel - spd * spd)
    // q = (eorg * eorg) / (evel * evel - spd * spd)
    if(!solution.z) // no real solution
    {
        // happens if D < 0
        // (eorg * evel)^2 < (evel^2 - spd^2) * eorg^2
        // (eorg * evel)^2 / eorg^2 < evel^2 - spd^2
        // spd^2 < ((evel^2 * eorg^2) - (eorg * evel)^2) / eorg^2
        // spd^2 < evel^2 * (1 - cos^2 angle(evel, eorg))
        // spd^2 < evel^2 * sin^2 angle(evel, eorg)
        // spd < |evel| * sin angle(evel, eorg)
        return '0 0 0';
    }
    else if(solution.x > 0)
    {
        // both solutions > 0: take the smaller one
        // happens if p < 0 and q > 0
        ret = normalize(eorg + solution.x * evel);
    }
    else if(solution.y > 0)
    {
        // one solution > 0: take the larger one
        // happens if q < 0 or q == 0 and p < 0
        ret = normalize(eorg + solution.y * evel);
    }
    else
    {
        // no solution > 0: reject
        // happens if p > 0 and q >= 0
        // 2 * (eorg * evel) / (evel * evel - spd * spd) > 0
        // (eorg * eorg) / (evel * evel - spd * spd) >= 0
        //
        // |evel| >= spd
        // eorg * evel > 0
        //
        // "Enemy is moving away from me at more than spd"
        return '0 0 0';
    }
 
    // NOTE: we always got a solution if spd > |evel|
 
    if(newton_style == 2)
        ret = normalize(ret * spd + myvel);
 
    return ret;
}

References normalize(), solve_quadratic(), and vector.

STATIC_INIT()

STATIC_INIT

(

g_saved_cvars

)

Definition at line 34 of file util.qh.

{ g_saved_cvars = IL_NEW(); }

References g_saved_cvars, and IL_NEW.

strtolower()

string strtolower

(

string

s

)

Referenced by _MapInfo_CheckArenaFile(), _MapInfo_ParseArena(), bd_editor_place(), bd_move(), CategoryForEntry(), CheckPlayerModel(), ClientCommand_macro_command(), ClientCommand_macro_usage(), ClientCommand_physics(), Cmd_Scoreboard_SetFields(), CommonCommand_editmob(), CommonCommand_macro_command(), CommonCommand_macro_usage(), CSQC_ConsoleCommand(), CvarList_Load(), float(), GameCommand(), GameCommand(), GameCommand_macro_command(), GameCommand_macro_usage(), GenericCommand_macro_command(), GenericCommand_macro_usage(), InterpretBoolean(), Local_Notification_centerprint_Add(), Local_Notification_HUD_Notify_Push(), Local_Notification_sprintf(), LocalCommand_macro_command(), LocalCommand_macro_usage(), MapInfo_FilterString(), notif_arg_item_wepammo(), Process_Notif_Args(), string(), SV_ParseClientCommand(), Team_ColorToTeam(), void(), VoteCommand_master(), Weapons_Draw(), and XonoticServerList_drawListBoxItem().

swapInPriorityList()

string swapInPriorityList	(	string	order,
		float	i,
		float	j )

Definition at line 663 of file util.qc.

{
    float n = tokenize_console(order);
 
    if(i >= 0 && i < n && j >= 0 && j < n && i != j)
    {
        string s = "";
        for(float w = 0; w < n; ++w)
        {
            if(w == i)
                s = strcat(s, argv(j), " ");
            else if(w == j)
                s = strcat(s, argv(i), " ");
            else
                s = strcat(s, argv(w), " ");
        }
        return substring(s, 0, strlen(s) - 1);
    }
 
    return order;
}

References argv(), strcat(), strlen, substring(), and tokenize_console.

Referenced by WeaponsList_MoveDown_Click(), WeaponsList_MoveUp_Click(), XonoticPlayList_mouseDrag(), and XonoticWeaponsList_mouseDrag().

textLengthUpToLength()

float textLengthUpToLength	(	string	theText,
		int	maxLength,
		textLengthUpToLength_lenFunction_t	tw )

Definition at line 930 of file util.qc.

{
    // STOP.
    // The following function is SLOW.
    // For your safety and for the protection of those around you...
    // DO NOT CALL THIS AT HOME.
    // No really, don't.
    if(w(theText) <= maxLength)
        return strlen(theText); // yeah!
 
    bool colors = (w("^7") == 0);
 
    // binary search for right place to cut string
    int len, left, right, middle;
    left = 0;
    right = len = strlen(theText);
    int ofs = 0;
    do
    {
        middle = floor((left + right) / 2);
        if(colors)
        {
            vector res = checkColorCode(theText, len, middle, true);
            ofs = (!res.x) ? 0 : res.x - res.y;
        }
 
        if(w(substring(theText, 0, middle + ofs)) <= maxLength)
            left = middle + ofs;
        else
            right = middle;
    }
    while(left < right - 1);
 
    return left;
}

References checkColorCode(), floor(), strlen, substring(), and vector.

Referenced by getWrappedLineLen(), PlayerFrame(), and textShortenToLength().

textLengthUpToWidth()

float textLengthUpToWidth	(	string	theText,
		float	maxWidth,
		vector	size,
		textLengthUpToWidth_widthFunction_t	tw )

Definition at line 894 of file util.qc.

{
    // STOP.
    // The following function is SLOW.
    // For your safety and for the protection of those around you...
    // DO NOT CALL THIS AT HOME.
    // No really, don't.
    if(w(theText, theSize) <= maxWidth)
        return strlen(theText); // yeah!
 
    bool colors = (w("^7", theSize) == 0);
 
    // binary search for right place to cut string
    int len, left, right, middle;
    left = 0;
    right = len = strlen(theText);
    int ofs = 0;
    do
    {
        middle = floor((left + right) / 2);
        if(colors)
        {
            vector res = checkColorCode(theText, len, middle, false);
            ofs = (res.x) ? res.x - res.y : 0;
        }
 
        if(w(substring(theText, 0, middle + ofs), theSize) <= maxWidth)
            left = middle + ofs;
        else
            right = middle;
    }
    while(left < right - 1);
 
    return left;
}

References checkColorCode(), floor(), strlen, substring(), and vector.

Referenced by draw_TextLengthUpToWidth(), getWrappedLine(), minigame_getWrappedLine(), and textShortenToWidth().

textShortenToLength()

string textShortenToLength	(	string	theText,
		int	maxLength,
		textLengthUpToLength_lenFunction_t	tw )

textShortenToWidth()

string textShortenToWidth	(	string	theText,
		float	maxWidth,
		vector	size,
		textLengthUpToWidth_widthFunction_t	tw )

Definition at line 1183 of file util.qc.

{
    if(tw(theText, theFontSize) <= maxWidth)
        return theText;
    else
        return strcat(substring(theText, 0, textLengthUpToWidth(theText, maxWidth - tw("...", theFontSize), theFontSize, tw)), "...");
}

References strcat(), substring(), textLengthUpToWidth(), and vector.

Referenced by centerprint_SetDuelTitle(), Draw_ShowNames(), draw_TextShortenToWidth(), HUD_Chat(), HUD_Mod_Race(), HUD_Notify(), HUD_Pickup(), HUD_Quickmenu_DrawEntry(), HUD_Score_Rankings(), HUD_Vote(), MakeRaceString(), MapVote_FormatItem(), minigame_drawcolorcodedstring_trunc(), minigame_drawstring_trunc(), minigame_show_allspecs(), Scoreboard_Draw(), Scoreboard_DrawOthers(), Scoreboard_FixColumnWidth(), and Scoreboard_Rankings_Draw().

trace_hits_box()

float trace_hits_box	(	vector	start,
		vector	end,
		vector	thmi,
		vector	thma )

Definition at line 2231 of file util.qc.

{
    end -= start;
    thmi -= start;
    thma -= start;
    // now it is a trace from 0 to end
 
    trace_hits_box_a0 = 0;
    trace_hits_box_a1 = 1;
 
    if (!trace_hits_box_1d(end.x, thmi.x, thma.x))
        return false;
    if (!trace_hits_box_1d(end.y, thmi.y, thma.y))
        return false;
    if (!trace_hits_box_1d(end.z, thmi.z, thma.z))
        return false;
 
    return true;
}

References trace_hits_box_1d(), trace_hits_box_a0, trace_hits_box_a1, and vector.

Referenced by Headshot(), and tracebox_hits_box().

trace_hits_box_1d()

float trace_hits_box_1d	(	float	end,
		float	thmi,
		float	thma )

Definition at line 2209 of file util.qc.

{
    if (end == 0)
    {
        // just check if x is in range
        if (0 < thmi)
            return false;
        if (0 > thma)
            return false;
    }
    else
    {
        // do the trace with respect to x
        // 0 -> end has to stay in thmi -> thma
        trace_hits_box_a0 = max(trace_hits_box_a0, min(thmi / end, thma / end));
        trace_hits_box_a1 = min(trace_hits_box_a1, max(thmi / end, thma / end));
        if (trace_hits_box_a0 > trace_hits_box_a1)
            return false;
    }
    return true;
}

References max(), min(), trace_hits_box_a0, and trace_hits_box_a1.

Referenced by trace_hits_box().

tracebox_hits_box()

float tracebox_hits_box	(	vector	start,
		vector	mi,
		vector	ma,
		vector	end,
		vector	thmi,
		vector	thma )

Definition at line 2251 of file util.qc.

{
    return trace_hits_box(start, end, thmi - ma, thma - mi);
}

References trace_hits_box(), and vector.

Referenced by tracebox_hits_trigger_hurt().

tracebox_inverted()

float tracebox_inverted	(	vector	v1,
		vector	mi,
		vector	ma,
		vector	v2,
		float	nomonsters,
		entity	forent,
		float	stopatentity,
		entity	ignorestopatentity )

Definition at line 23 of file util.qc.

{
    vector pos, dir, t;
    float nudge;
    entity stopentity;
 
    //nudge = 2 * cvar("collision_impactnudge"); // why not?
    nudge = 0.5;
 
    dir = normalize(v2 - v1);
 
    pos = v1 + dir * nudge;
 
    float c = 0;
 
    for (;;)
    {
        if(pos * dir >= v2 * dir)
        {
            // went too far
            trace_fraction = 1;
            trace_endpos = v2;
            return c;
        }
 
        tracebox(pos, mi, ma, v2, nomonsters, forent);
        ++c;
 
        if(c == 50)
        {
            LOG_TRACE("When tracing from ", vtos(v1), " to ", vtos(v2));
            LOG_TRACE("  Nudging gets us nowhere at ", vtos(pos));
            LOG_TRACE("  trace_endpos is ", vtos(trace_endpos));
            LOG_TRACE("  trace distance is ", ftos(vlen(pos - trace_endpos)));
        }
 
        stopentity = trace_ent;
 
        if(trace_startsolid)
        {
            // we started inside solid.
            // then trace from endpos to pos
            t = trace_endpos;
            tracebox(t, mi, ma, pos, nomonsters, forent);
            ++c;
            if(trace_startsolid)
            {
                // t is still inside solid? bad
                // force advance, then, and retry
                pos = t + dir * nudge;
 
                // but if we hit an entity, stop RIGHT before it
                if(stopatentity && stopentity && stopentity != ignorestopatentity)
                {
                    trace_ent = stopentity;
                    trace_endpos = t;
                    trace_fraction = ((trace_endpos - v1) * dir) / ((v2 - v1) * dir);
                    return c;
                }
            }
            else
            {
                // we actually LEFT solid!
                trace_fraction = ((trace_endpos - v1) * dir) / ((v2 - v1) * dir);
                return c;
            }
        }
        else
        {
            // pos is outside solid?!? but why?!? never mind, just return it.
            trace_endpos = pos;
            trace_fraction = ((trace_endpos - v1) * dir) / ((v2 - v1) * dir);
            return c;
        }
    }
}

References dir, entity(), ftos(), LOG_TRACE, normalize(), trace_endpos, trace_ent, trace_fraction, trace_startsolid, vector, vlen(), and vtos().

Referenced by traceline_inverted().

traceline_inverted()

void traceline_inverted	(	vector	v1,
		vector	v2,
		float	nomonsters,
		entity	forent,
		float	stopatentity,
		entity	ignorestopatentity )

Definition at line 100 of file util.qc.

{
    tracebox_inverted(v1, '0 0 0', '0 0 0', v2, nomonsters, forent, stopatentity, ignorestopatentity);
}

References entity(), tracebox_inverted(), and vector.

Referenced by fireBullet_falloff().

translate_key()

ERASEABLE string translate_key

(

string

key

)

Definition at line 1622 of file util.qc.

{
    if (prvm_language == "en") return key;
 
    if (substring(key, 0, 1) == "<")
    {
        if (key == "<KEY NOT FOUND>") return _("<KEY NOT FOUND>");
        if (key == "<UNKNOWN KEYNUM>") return _("<UNKNOWN KEYNUM>");
    }
 
    switch(key)
    {
        case "TAB":             return _("TAB");
        case "ENTER":           return _("ENTER");
        case "ESCAPE":          return _("ESCAPE");
        case "SPACE":           return _("SPACE");
 
        case "BACKSPACE":       return _("BACKSPACE");
        case "UPARROW":         return _("UPARROW");
        case "DOWNARROW":       return _("DOWNARROW");
        case "LEFTARROW":       return _("LEFTARROW");
        case "RIGHTARROW":      return _("RIGHTARROW");
 
        case "ALT":             return _("ALT");
        case "CTRL":            return _("CTRL");
        case "SHIFT":           return _("SHIFT");
 
        case "INS":             return _("INS");
        case "DEL":             return _("DEL");
        case "PGDN":            return _("PGDN");
        case "PGUP":            return _("PGUP");
        case "HOME":            return _("HOME");
        case "END":             return _("END");
 
        case "PAUSE":           return _("PAUSE");
 
        case "NUMLOCK":         return _("NUMLOCK");
        case "CAPSLOCK":        return _("CAPSLOCK");
        case "SCROLLOCK":       return _("SCROLLOCK");
 
        case "SEMICOLON":       return _("SEMICOLON");
        case "TILDE":           return _("TILDE");
        case "BACKQUOTE":       return _("BACKQUOTE");
        case "QUOTE":           return _("QUOTE");
        case "APOSTROPHE":      return _("APOSTROPHE");
        case "BACKSLASH":       return _("BACKSLASH");
    }
 
    if (substring(key, 0, 1) == "F")
    {
        string subkey = substring(key, 1, -1);
        if (IS_DIGIT(substring(key, 3, 1))) // check only first digit
        {
            return sprintf(_("F%d"), stof(subkey));
        }
        // continue in case there is another key name starting with F
    }
 
    if (substring(key, 0, 3) == "KP_")
    {
        string subkey = substring(key, 3, -1);
        if (IS_DIGIT(substring(key, 3, 1))) // check only first digit
        {
            return sprintf(_("KP_%d"), stof(subkey));
        }
 
        switch(subkey)
        {
            case "INS":             return sprintf(_("KP_%s"), _("INS"));
            case "END":             return sprintf(_("KP_%s"), _("END"));
            case "DOWNARROW":       return sprintf(_("KP_%s"), _("DOWNARROW"));
            case "PGDN":            return sprintf(_("KP_%s"), _("PGDN"));
            case "LEFTARROW":       return sprintf(_("KP_%s"), _("LEFTARROW"));
            case "RIGHTARROW":      return sprintf(_("KP_%s"), _("RIGHTARROW"));
            case "HOME":            return sprintf(_("KP_%s"), _("HOME"));
            case "UPARROW":         return sprintf(_("KP_%s"), _("UPARROW"));
            case "PGUP":            return sprintf(_("KP_%s"), _("PGUP"));
            case "PERIOD":          return sprintf(_("KP_%s"), _("PERIOD"));
            case "DEL":             return sprintf(_("KP_%s"), _("DEL"));
            case "DIVIDE":          return sprintf(_("KP_%s"), _("DIVIDE"));
            case "SLASH":           return sprintf(_("KP_%s"), _("SLASH"));
            case "MULTIPLY":        return sprintf(_("KP_%s"), _("MULTIPLY"));
            case "MINUS":           return sprintf(_("KP_%s"), _("MINUS"));
            case "PLUS":            return sprintf(_("KP_%s"), _("PLUS"));
            case "ENTER":           return sprintf(_("KP_%s"), _("ENTER"));
            case "EQUALS":          return sprintf(_("KP_%s"), _("EQUALS"));
            default:                return key;
        }
    }
 
    if (key == "PRINTSCREEN") return _("PRINTSCREEN");
 
    if (substring(key, 0, 5) == "MOUSE")
        return sprintf(_("MOUSE%d"), stof(substring(key, 5, -1)));
 
    if (key == "MWHEELUP") return _("MWHEELUP");
    if (key == "MWHEELDOWN") return _("MWHEELDOWN");
 
    if (substring(key, 0,3) == "JOY")
        return sprintf(_("JOY%d"), stof(substring(key, 3, -1)));
 
    if (substring(key, 0,3) == "AUX")
        return sprintf(_("AUX%d"), stof(substring(key, 3, -1)));
 
    if (substring(key, 0, 4) == "X360_")
    {
        string subkey = substring(key, 4, -1);
        switch(subkey)
        {
            case "DPAD_UP":                 return sprintf(_("X360_%s"), _("DPAD_UP"));
            case "DPAD_DOWN":               return sprintf(_("X360_%s"), _("DPAD_DOWN"));
            case "DPAD_LEFT":               return sprintf(_("X360_%s"), _("DPAD_LEFT"));
            case "DPAD_RIGHT":              return sprintf(_("X360_%s"), _("DPAD_RIGHT"));
            case "START":                   return sprintf(_("X360_%s"), _("START"));
            case "BACK":                    return sprintf(_("X360_%s"), _("BACK"));
            case "LEFT_THUMB":              return sprintf(_("X360_%s"), _("LEFT_THUMB"));
            case "RIGHT_THUMB":             return sprintf(_("X360_%s"), _("RIGHT_THUMB"));
            case "LEFT_SHOULDER":           return sprintf(_("X360_%s"), _("LEFT_SHOULDER"));
            case "RIGHT_SHOULDER":          return sprintf(_("X360_%s"), _("RIGHT_SHOULDER"));
            case "LEFT_TRIGGER":            return sprintf(_("X360_%s"), _("LEFT_TRIGGER"));
            case "RIGHT_TRIGGER":           return sprintf(_("X360_%s"), _("RIGHT_TRIGGER"));
            case "LEFT_THUMB_UP":           return sprintf(_("X360_%s"), _("LEFT_THUMB_UP"));
            case "LEFT_THUMB_DOWN":         return sprintf(_("X360_%s"), _("LEFT_THUMB_DOWN"));
            case "LEFT_THUMB_LEFT":         return sprintf(_("X360_%s"), _("LEFT_THUMB_LEFT"));
            case "LEFT_THUMB_RIGHT":        return sprintf(_("X360_%s"), _("LEFT_THUMB_RIGHT"));
            case "RIGHT_THUMB_UP":          return sprintf(_("X360_%s"), _("RIGHT_THUMB_UP"));
            case "RIGHT_THUMB_DOWN":        return sprintf(_("X360_%s"), _("RIGHT_THUMB_DOWN"));
            case "RIGHT_THUMB_LEFT":        return sprintf(_("X360_%s"), _("RIGHT_THUMB_LEFT"));
            case "RIGHT_THUMB_RIGHT":       return sprintf(_("X360_%s"), _("RIGHT_THUMB_RIGHT"));
            default:                        return key;
        }
    }
 
    if (substring(key, 0, 4) == "JOY_")
    {
        string subkey = substring(key, 4, -1);
        switch(subkey)
        {
            case "UP":          return sprintf(_("JOY_%s"), _("UP"));
            case "DOWN":        return sprintf(_("JOY_%s"), _("DOWN"));
            case "LEFT":        return sprintf(_("JOY_%s"), _("LEFT"));
            case "RIGHT":       return sprintf(_("JOY_%s"), _("RIGHT"));
            default:            return key;
        }
    }
 
    if (substring(key, 0, 8) == "MIDINOTE")
        return sprintf(_("MIDINOTE%d"), stof(substring(key, 8, -1)));
 
    return key;
}

References IS_DIGIT, prvm_language, stof(), and substring().

Referenced by _getcommandkey(), KeyBinds_BuildList(), Scoreboard_Draw(), W_Guide_Keybinds(), and XonoticKeyBinder_drawListBoxItem().

UnsetMovetypeFollow()

void UnsetMovetypeFollow

(

entity

ent

)

Definition at line 2161 of file util.qc.

{
    set_movetype(ent, MOVETYPE_FLY);
    PROJECTILE_MAKETRIGGER(ent);
    ent.aiment_classname = string_null;
    // FIXME: engine bug?
    // resetting aiment the engine will set orb's origin close to world's origin
    //ent.aiment = NULL;
}

References entity(), MOVETYPE_FLY, PROJECTILE_MAKETRIGGER, set_movetype(), and string_null.

Referenced by W_MineLayer_Think().

wordwrap()

string wordwrap	(	string	s,
		float	l )

Definition at line 169 of file util.qc.

{
    string r;
    wordwrap_buffer = "";
    wordwrap_cb(s, l, wordwrap_buffer_put);
    r = wordwrap_buffer;
    wordwrap_buffer = "";
    return r;
}

References wordwrap_buffer, wordwrap_buffer_put(), and wordwrap_cb().

wordwrap_cb()

void wordwrap_cb	(	string	s,
		float	l,
		void(string)	callback )

Definition at line 338 of file util.qc.

{
    string c;
    float lleft, i, j, wlen;
 
    s = strzone(s);
    lleft = l;
    int len = strlen(s);
    for (i = 0; i < len; ++i)
    {
        if (substring(s, i, 2) == "\\n")
        {
            callback("\n");
            lleft = l;
            ++i;
        }
        else if (substring(s, i, 1) == "\n")
        {
            callback("\n");
            lleft = l;
        }
        else if (substring(s, i, 1) == " ")
        {
            if (lleft > 0)
            {
                callback(" ");
                --lleft;
            }
        }
        else
        {
            for (j = i+1; j < len; ++j)
                //    ^^ this skips over the first character of a word, which
                //       is ALWAYS part of the word
                //       this is safe since if i+1 == strlen(s), i will become
                //       strlen(s)-1 at the end of this block and the function
                //       will terminate. A space can't be the first character we
                //       read here, and neither can a \n be the start, since these
                //       two cases have been handled above.
            {
                c = substring(s, j, 1);
                if (c == " ")
                    break;
                if (c == "\\")
                    break;
                if (c == "\n")
                    break;
                // we need to keep this tempstring alive even if substring is
                // called repeatedly, so call strcat even though we're not
                // doing anything
                callback("");
            }
            wlen = j - i;
            if (lleft < wlen)
            {
                callback("\n");
                lleft = l;
            }
            callback(substring(s, i, wlen));
            lleft -= wlen;
            i = j - 1;
        }
    }
    strunzone(s);
}

References strlen, strunzone(), strzone(), and substring().

Referenced by wordwrap(), and wordwrap_sprint().

wordwrap_sprint()

void wordwrap_sprint	(	entity	to,
		string	s,
		float	l )

Definition at line 191 of file util.qc.

{
    wordwrap_buffer = "";
    _wordwrap_buffer_sprint_ent = to;
    wordwrap_cb(s, l, wordwrap_buffer_sprint);
    _wordwrap_buffer_sprint_ent = NULL;
    if(wordwrap_buffer != "")
        sprint(to, strcat(wordwrap_buffer, "\n"));
    wordwrap_buffer = "";
    return;
}

References _wordwrap_buffer_sprint_ent, entity(), NULL, sprint(), strcat(), wordwrap_buffer, wordwrap_buffer_sprint(), and wordwrap_cb().

Referenced by CommonCommand_info(), and VoteCommand_macro_help().

write_String_To_File()

void write_String_To_File	(	int	fh,
		string	str,
		bool	alsoprint )

Definition at line 1485 of file util.qc.

{
    fputs(fh, str);
    if (alsoprint) LOG_HELP(str);
}

References fputs(), and LOG_HELP.

xdecode()

float xdecode

(

string

s

)

Definition at line 1792 of file util.qc.

{
    float a, b, c, d;
    if(substring(s, 0, 1) != "^")
        return -1;
    if(strlen(s) < 5)
        return -1;
    a = strstrofs(XENCODE_2,  substring(s, 1, 1), 0);
    b = strstrofs(XENCODE_22, substring(s, 2, 1), 0);
    c = strstrofs(XENCODE_22, substring(s, 3, 1), 0);
    d = strstrofs(XENCODE_22, substring(s, 4, 1), 0);
    if(a < 0 || b < 0 || c < 0 || d < 0)
        return -1;
    return ((a * 22 + b) * 22 + c) * 22 + d;
}

References strlen, strstrofs, substring(), XENCODE_2, and XENCODE_22.

xencode()

string xencode

(

float

f

)

Variable Documentation

autocvar_cl_gentle

bool autocvar_cl_gentle

Definition at line 236 of file util.qh.

Referenced by DamageEffect(), HUD_Damage(), and NET_HANDLE().

autocvar_cl_gentle_messages

int autocvar_cl_gentle_messages

Definition at line 237 of file util.qh.

CNT_GAMESTART

const int CNT_GAMESTART = 2

Definition at line 252 of file util.qh.

Referenced by Announcer_Countdown(), and Announcer_PickNumber().

CNT_KILL

const int CNT_KILL = 4

Definition at line 254 of file util.qh.

Referenced by Announcer_PickNumber(), and KillIndicator_Think().

CNT_NORMAL

const int CNT_NORMAL = 1

Definition at line 251 of file util.qh.

Referenced by Announcer_PickNumber(), and instagib_countdown().

CNT_RESPAWN

const int CNT_RESPAWN = 5

Definition at line 255 of file util.qh.

Referenced by Announcer_PickNumber(), and ShowRespawnCountdown().

CNT_ROUNDSTART

const int CNT_ROUNDSTART = 6

Definition at line 256 of file util.qh.

Referenced by Announcer_Countdown(), and Announcer_PickNumber().

config_queue

string config_queue[MAX_CONFIG_SETTINGS]

Definition at line 27 of file util.qh.

Referenced by Dump_Turret_Settings(), Dump_Weapon_Settings(), T_Config_Queue(), T_Config_Queue_Compare(), T_Config_Queue_Swap(), W_Config_Queue(), W_Config_Queue_Compare(), and W_Config_Queue_Swap().

g_saved_cvars

IntrusiveList g_saved_cvars

Definition at line 33 of file util.qh.

Referenced by cvar_settemp(), and STATIC_INIT().

get_model_parameters_age

float get_model_parameters_age

Definition at line 183 of file util.qh.

Referenced by get_model_parameters(), and XonoticPlayerModelSelector_loadModels().

get_model_parameters_bone_aim

string get_model_parameters_bone_aim[MAX_AIM_BONES]

Definition at line 189 of file util.qh.

Referenced by get_model_parameters(), and skeleton_loadinfo().

get_model_parameters_bone_aimweight

float get_model_parameters_bone_aimweight[MAX_AIM_BONES]

Definition at line 190 of file util.qh.

Referenced by get_model_parameters(), and skeleton_loadinfo().

get_model_parameters_bone_upperbody

string get_model_parameters_bone_upperbody

Definition at line 186 of file util.qh.

Referenced by get_model_parameters(), and skeleton_loadinfo().

get_model_parameters_bone_weapon

string get_model_parameters_bone_weapon

Definition at line 187 of file util.qh.

Referenced by get_model_parameters(), and skeleton_loadinfo().

get_model_parameters_desc

string get_model_parameters_desc

Definition at line 192 of file util.qh.

Referenced by get_model_parameters(), and XonoticPlayerModelSelector_loadModels().

get_model_parameters_description

string get_model_parameters_description

Definition at line 185 of file util.qh.

Referenced by get_model_parameters(), and XonoticPlayerModelSelector_loadModels().

get_model_parameters_fixbone

float get_model_parameters_fixbone

Definition at line 191 of file util.qh.

Referenced by get_model_parameters(), and skeleton_loadinfo().

get_model_parameters_hidden

bool get_model_parameters_hidden

Definition at line 184 of file util.qh.

Referenced by get_model_parameters(), and XonoticPlayerModelSelector_loadModels().

get_model_parameters_modelname

string get_model_parameters_modelname

Definition at line 177 of file util.qh.

Referenced by get_model_parameters(), and XonoticPlayerModelSelector_loadModels().

get_model_parameters_modelskin

float get_model_parameters_modelskin

Definition at line 178 of file util.qh.

Referenced by get_model_parameters(), and XonoticPlayerModelSelector_loadModels().

get_model_parameters_name

string get_model_parameters_name

Definition at line 179 of file util.qh.

Referenced by get_model_parameters(), and XonoticPlayerModelSelector_loadModels().

get_model_parameters_sex

string get_model_parameters_sex

Definition at line 181 of file util.qh.

Referenced by get_model_parameters(), and XonoticPlayerModelSelector_loadModels().

get_model_parameters_species

float get_model_parameters_species

Definition at line 180 of file util.qh.

Referenced by get_model_parameters(), and player_getspecies().

get_model_parameters_weight

float get_model_parameters_weight

Definition at line 182 of file util.qh.

Referenced by get_model_parameters(), and XonoticPlayerModelSelector_loadModels().

getWrappedLine_remaining

string getWrappedLine_remaining

Definition at line 147 of file util.qh.

Referenced by Checkpoints_drawstring(), GameTypeVote_DrawGameTypeItem(), getWrappedLine(), getWrappedLineLen(), HUD_CenterPrint(), InfoMessages_drawstring(), Label_draw(), Label_recalcPositionWithText(), m_tooltip(), minigame_drawcolorcodedstring_wrapped(), minigame_drawstring_wrapped(), minigame_getWrappedLine(), rewrapCampaign(), Say(), take_wrapped_line_until(), wrapGuideText(), XonoticEntryList_drawListBoxItem(), and XonoticTextBox_setText().

ladder_reply

string ladder_reply

Definition at line 161 of file util.qh.

Referenced by CommonCommand_ladder(), and spawnfunc().

lsmaps_reply

string lsmaps_reply

Definition at line 161 of file util.qh.

Referenced by CommonCommand_lsmaps(), GameTypeVote_SetGametype(), and spawnfunc().

maplist_reply

string maplist_reply

Definition at line 161 of file util.qh.

Referenced by CommonCommand_printmaplist(), and spawnfunc().

MAX_AIM_BONES

const int MAX_AIM_BONES = 4

Definition at line 188 of file util.qh.

Referenced by classfield(), get_model_parameters(), skeleton_from_frames(), and skeleton_loadinfo().

MAX_CONFIG_SETTINGS

const int MAX_CONFIG_SETTINGS = 70

Definition at line 26 of file util.qh.

Referenced by Dump_Turret_Settings(), Dump_Weapon_Settings(), T_Config_Queue(), and W_Config_Queue().

message

string message

Definition at line 31 of file util.qh.

mi_max

vector mi_max

Definition at line 128 of file util.qh.

Referenced by CSQC_Init(), get_mi_min_max(), get_mi_min_max_texcoords(), HUD_Radar(), and InitGameplayMode().

mi_min

vector mi_min

Definition at line 127 of file util.qh.

Referenced by CSQC_Init(), get_mi_min_max(), get_mi_min_max_texcoords(), HUD_Radar(), and InitGameplayMode().

mi_picmax

vector mi_picmax

Definition at line 132 of file util.qh.

Referenced by get_mi_min_max_texcoords(), HUD_Radar(), teamradar_3dcoord_to_texcoord(), teamradar_texcoord_to_3dcoord(), and View_Ortho().

mi_picmin

vector mi_picmin

Definition at line 131 of file util.qh.

Referenced by get_mi_min_max_texcoords(), HUD_Radar(), teamradar_3dcoord_to_texcoord(), teamradar_texcoord_to_3dcoord(), and View_Ortho().

mi_pictexcoord0

vector mi_pictexcoord0

Definition at line 133 of file util.qh.

Referenced by draw_teamradar_background(), and get_mi_min_max_texcoords().

mi_pictexcoord1

vector mi_pictexcoord1

Definition at line 134 of file util.qh.

Referenced by draw_teamradar_background(), and get_mi_min_max_texcoords().

mi_pictexcoord2

vector mi_pictexcoord2

Definition at line 135 of file util.qh.

Referenced by draw_teamradar_background(), and get_mi_min_max_texcoords().

mi_pictexcoord3

vector mi_pictexcoord3

Definition at line 136 of file util.qh.

Referenced by draw_teamradar_background(), and get_mi_min_max_texcoords().

mi_shortname

string mi_shortname

Definition at line 126 of file util.qh.

Referenced by BGMScript_Init(), CSQC_Init(), get_mi_min_max(), HUD_Mod_Race(), MapInfo_Get_ByName_NoFallbacks(), race_UpdateDB(), Scoreboard_Draw(), and SendWelcomeMessage().

monsterlist_reply

string monsterlist_reply

Definition at line 161 of file util.qh.

Referenced by CommonCommand_editmob(), and spawnfunc().

netname

string netname

Definition at line 30 of file util.qh.

rankings_reply

string rankings_reply

Definition at line 161 of file util.qh.

Referenced by CommonCommand_rankings(), race_deleteTime(), race_setTime(), and spawnfunc().

records_reply

string records_reply[10]

Definition at line 162 of file util.qh.

Referenced by CommonCommand_records(), and spawnfunc().

skeleton_bones

float skeleton_bones

Definition at line 213 of file util.qh.

TIME_DECIMALS

const int TIME_DECIMALS = 2

Definition at line 94 of file util.qh.

Referenced by HUD_Score(), and MakeRaceString().

TIME_FACTOR

const float TIME_FACTOR = 100

Definition at line 95 of file util.qh.

XENCODE_LEN

const float XENCODE_LEN = 5

Definition at line 201 of file util.qh.

XENCODE_MAX

const float XENCODE_MAX = 21295

Definition at line 200 of file util.qh.