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)   ((list) = (((list) != "") ? strcat(list, sep, add) : (add)))
#define	bprintf(...)   bprint(sprintf(__VA_ARGS__))
#define	COMPARE_INCREASING(to, from)   (to < from ? from + to + 2 : to - from)
#define	CTF_RECORD   "/ctf100record/"
#define	CTS_RECORD   "/cts100record/"
#define	fprintf(file, ...)   fputs(file, sprintf(__VA_ARGS__))
#define	RACE_RECORD   "/race100record/"
#define	TIME_DECODE(n)   ((n) / TIME_FACTOR)
#define	TIME_ENCODE(t)   TIME_TO_NTHS(t, TIME_FACTOR)
#define	TIME_ENCODED_TOSTRING(n)   mmssth(n)
#define	TIME_TO_NTHS(t, n)   floor((t) * (n) + 0.5)
#define	XPD(...)   __VA_ARGS__

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
float	blink (float base, float range, float freq)
float	blink_synced (float base, float range, float freq, float start_time, int start_blink)
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)
string	draw_UseSkinFor (string pic)
void	execute_next_frame ()
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)
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)
float	isGametypeInFilter (entity gt, float tp, float ts, string pattern)
string	mapPriorityList (string order, string(string) mapfunc)
float	matchacl (string acl, string str)
void	queue_to_execute_next_frame (string s)
void	Shutdown ()
vector	solve_shotdirection (vector myorg, vector myvel, vector eorg, vector evel, float spd, float newton_style)
	STATIC_INIT (g_saved_cvars)
string	swapInPriorityList (string order, float i, float j)
float	textLengthUpToLength (string theText, float maxWidth, textLengthUpToLength_lenFunction_t tw)
float	textLengthUpToWidth (string theText, float maxWidth, vector size, textLengthUpToWidth_widthFunction_t tw)
string	textShortenToLength (string theText, float maxWidth, textLengthUpToLength_lenFunction_t tw)
string	textShortenToWidth (string theText, float maxWidth, vector size, textLengthUpToWidth_widthFunction_t tw)
ERASEABLE string	translate_key (string key)
string	wordwrap (string s, float l)
void	wordwrap_cb (string s, float l, void(string) callback)
void	write_String_To_File (int fh, string str, bool alsoprint)
float	xdecode (string s)
string	xencode (float f)

Variables
string	draw_currentSkin
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
const int	MAX_AIM_BONES = 4
string	message
string	netname
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
	)		((list) = (((list) != "") ? strcat(list, sep, add) : (add)))

Definition at line 225 of file util.qh.

Referenced by UpdateNotification_URI_Get_Callback().

bprintf

#define bprintf

(

...

)

bprint(sprintf(__VA_ARGS__))

Definition at line 192 of file util.qh.

Referenced by CheatsAllowed().

COMPARE_INCREASING

#define COMPARE_INCREASING	(		to,
			from
	)		(to < from ? from + to + 2 : to - from)

Definition at line 228 of file util.qh.

Referenced by HitSound(), and UpdateDamage().

CTF_RECORD

#define CTF_RECORD   "/ctf100record/"

Definition at line 60 of file util.qh.

Referenced by ctf_Initialize().

CTS_RECORD

#define CTS_RECORD   "/cts100record/"

Definition at line 59 of file util.qh.

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

fprintf

#define fprintf	(		file,
			...
	)		fputs(file, sprintf(__VA_ARGS__))

Definition at line 191 of file util.qh.

RACE_RECORD

#define RACE_RECORD   "/race100record/"

Definition at line 58 of file util.qh.

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

TIME_DECODE

#define TIME_DECODE

(

n

)

((n) / TIME_FACTOR)

Definition at line 62 of file util.qh.

Referenced by race_setTime().

TIME_ENCODE

#define TIME_ENCODE

(

t

)

TIME_TO_NTHS(t, TIME_FACTOR)

Definition at line 61 of file util.qh.

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

TIME_ENCODED_TOSTRING

#define TIME_ENCODED_TOSTRING

(

n

)

mmssth(n)

Definition at line 57 of file util.qh.

Referenced by getrankings(), HUD_Score(), MUTATOR_HOOKFUNCTION(), race_showTime(), Scoreboard_Rankings_Draw(), and write_recordmarker().

TIME_TO_NTHS

#define TIME_TO_NTHS	(		t,
			n
	)		floor((t) * (n) + 0.5)

Definition at line 53 of file util.qh.

XPD

#define XPD

(

...

)

__VA_ARGS__

Definition at line 188 of file util.qh.

Typedef Documentation

findNextEntityNearFunction_t

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

Definition at line 183 of file util.qh.

isConnectedFunction_t

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

Definition at line 184 of file util.qh.

textLengthUpToLength_lenFunction_t

using textLengthUpToLength_lenFunction_t = float(string s)

Definition at line 102 of file util.qh.

textLengthUpToWidth_widthFunction_t

using textLengthUpToWidth_widthFunction_t = float(string s, vector size)

Definition at line 101 of file util.qh.

Function Documentation

blink()

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

Definition at line 2044 of file util.qc.

References blink_synced().

Referenced by HUD_HealthArmor(), HUD_Mod_Keepaway(), HUD_Mod_KH(), and Item_ItemsTime_Allow().

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

Here is the call graph for this function:

Here is the caller graph for this function:

blink_synced()

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

Definition at line 2032 of file util.qc.

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

Referenced by blink(), and HUD_HealthArmor().

{
    // 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);
}

Here is the call graph for this function:

Here is the caller graph for this function:

compressShortVector()

float compressShortVector

(

vector

vec

)

Definition at line 406 of file util.qc.

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

Referenced by STATIC_INIT().

{
    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;
}

Here is the call graph for this function:

Here is the caller graph for this function:

compressShotOrigin()

float compressShotOrigin

(

vector

v

)

Definition at line 1121 of file util.qc.

References bound(), LOG_DEBUG, rint(), and vtos().

Referenced by ClientInit_misc(), and W_Model().

{
    float rx = rint(v.x * 2);
    float ry = rint(v.y * 4) + 128;
    float rz = rint(v.z * 4) + 128;
    if(rx > 255 || rx < 0)
    {
        LOG_DEBUG("shot origin ", vtos(v), " x out of bounds\n");
        rx = bound(0, rx, 255);
    }
    if(ry > 255 || ry < 0)
    {
        LOG_DEBUG("shot origin ", vtos(v), " y out of bounds\n");
        ry = bound(0, ry, 255);
    }
    if(rz > 255 || rz < 0)
    {
        LOG_DEBUG("shot origin ", vtos(v), " z out of bounds\n");
        rz = bound(0, rz, 255);
    }
    return rx * 0x10000 + ry * 0x100 + rz;
}

Here is the call graph for this function:

Here is the caller graph for this function:

cvar_or()

float cvar_or	(	string	cv,
		float	v
	)

Definition at line 2016 of file util.qc.

References cvar_string(), ERASEABLE, stof(), and v.

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

Here is the call graph for this function:

cvar_settemp()

float cvar_settemp	(	string	pKey,
		string	pValue
	)

Definition at line 696 of file util.qc.

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(), CSQCPlayer_PostUpdate(), CSQCPlayer_Remove(), GameCommand_bot_cmd(), GameCommand_setbots(), GenericCommand_settemp(), NET_HANDLE(), REGISTER_MUTATOR(), View_EventChase(), and View_Ortho().

{
    float created_saved_value;

    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;
}

Here is the call graph for this function:

Here is the caller graph for this function:

cvar_settemp_restore()

float cvar_settemp_restore

(

)

Definition at line 736 of file util.qc.

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

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

{
    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;
}

Here is the call graph for this function:

Here is the caller graph for this function:

decompressShortVector()

vector decompressShortVector

(

float

data

)

decompressShotOrigin()

vector decompressShotOrigin

(

float

f

)

depthfirst()

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

Definition at line 281 of file util.qc.

References count_ordinal(), entity(), floor(), SFL_HIDE_ZERO, SFL_RANK, and SFL_TIME.

Referenced by forAllDescendants(), and GameCommand().

{
    entity e;
    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);
    }
}

Here is the call graph for this function:

Here is the caller graph for this function:

draw_UseSkinFor()

string draw_UseSkinFor

(

string

pic

)

Definition at line 206 of file util.qc.

References draw_currentSkin, strcat(), strlen(), and substring().

Referenced by draw_BorderPicture(), draw_ButtonPicture(), draw_Picture(), draw_PictureSize(), draw_PreloadPicture(), draw_PreloadPictureWithFlags(), draw_setMousePointer(), draw_VertButtonPicture(), and MapVote_DrawMapItem().

{
    if(substring(pic, 0, 1) == "/")
        return substring(pic, 1, strlen(pic)-1);
    else
        return strcat(draw_currentSkin, "/", pic);
}

Here is the call graph for this function:

Here is the caller graph for this function:

execute_next_frame()

void execute_next_frame

(

)

Definition at line 1612 of file util.qc.

References localcmd, and strfree.

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

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

Here is the caller graph for this function:

FindConnectedComponent()

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

Definition at line 1630 of file util.qc.

References AnglesTransform_FromAngles(), AnglesTransform_FromVAngles(), AnglesTransform_ToAngles(), AnglesTransform_ToVAngles(), bound(), CONTENT_EMPTY, CONTENT_LAVA, CONTENT_SKY, CONTENT_SLIME, CONTENT_SOLID, CONTENT_WATER, DPCONTENTS_BODY, DPCONTENTS_LAVA, DPCONTENTS_NODROP, DPCONTENTS_OPAQUE, DPCONTENTS_SKY, DPCONTENTS_SLIME, DPCONTENTS_SOLID, DPCONTENTS_WATER, entity(), ERASEABLE, error(), fixedmakevectors, fixedvectoangles2, gettagindex, gettaginfo, intermission_running, IS_PLAYER, max(), min(), MOVETYPE_FLY, MOVETYPE_FOLLOW, MOVETYPE_NONE, NULL, PROJECTILE_MAKETRIGGER, set_movetype(), setorigin(), SOLID_NOT, strcat(), strunzone(), strzone(), substring(), TC, Team_ColorCode(), teamplay, to, v_forward, v_right, v_up, vector(), and vlen().

Referenced by LinkDoors().

{
    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;
}

Here is the call graph for this function:

Here is the caller graph for this function:

fixPriorityList()

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

Definition at line 485 of file util.qc.

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

Referenced by W_FixWeaponOrder().

{
    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);
}

Here is the call graph for this function:

Here is the caller graph for this function:

get_model_datafilename()

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

Definition at line 1245 of file util.qc.

References ftos(), and strcat().

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

{
    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);
}

Here is the call graph for this function:

Here is the caller graph for this function:

get_model_parameters()

float get_model_parameters	(	string	mod,
		float	skn
	)

Definition at line 1258 of file util.qc.

References car(), cdr(), fgets(), FILE_READ, fopen(), 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_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, stof(), strcat(), string_null, and substring().

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

{
    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;
}

Here is the call graph for this function:

Here is the caller graph for this function:

get_shotvelocity()

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

Definition at line 1081 of file util.qc.

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

Referenced by W_CalculateProjectileVelocity().

{
    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;
}

Here is the call graph for this function:

Here is the caller graph for this function:

getcurrentmod()

string getcurrentmod

(

)

Definition at line 1191 of file util.qc.

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

Referenced by resolvemod().

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

Here is the call graph for this function:

Here is the caller graph for this function:

getWrappedLine()

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

Definition at line 880 of file util.qc.

References find_last_color_code(), getWrappedLine_remaining, strcat(), string_null, strlen(), substring(), and textLengthUpToWidth().

Referenced by GameTypeVote_DrawGameTypeItem(), InfoMessages_drawstring(), Label_draw(), Label_recalcPositionWithText(), m_tooltip(), rewrapCampaign(), and XonoticTextBox_setText().

{
    string s = getWrappedLine_remaining;

    if(w <= 0)
    {
        getWrappedLine_remaining = string_null;
        return s; // the line has no size ANYWAY, nothing would be displayed.
    }

    int take_until = textLengthUpToWidth(s, w, theFontSize, tw);
    if(take_until > 0 && take_until < strlen(s))
    {
        int last_word = take_until - 1;
        while(last_word > 0 && substring(s, last_word, 1) != " ")
            --last_word;

        int skip = 0;
        if(last_word != 0)
        {
            take_until = last_word;
            skip = 1;
        }

        getWrappedLine_remaining = substring(s, take_until + skip, strlen(s) - take_until);
        if(getWrappedLine_remaining == "")
            getWrappedLine_remaining = string_null;
        else if (tw("^7", theFontSize) == 0)
            getWrappedLine_remaining = strcat(find_last_color_code(substring(s, 0, take_until)), getWrappedLine_remaining);
        return substring(s, 0, take_until);
    }
    else
    {
        getWrappedLine_remaining = string_null;
        return s;
    }
}

Here is the call graph for this function:

Here is the caller graph for this function:

getWrappedLineLen()

string getWrappedLineLen	(	float	w,
		textLengthUpToLength_lenFunction_t	tw
	)

Definition at line 918 of file util.qc.

References find_last_color_code(), getWrappedLine_remaining, strcat(), string_null, strlen(), substring(), and textLengthUpToLength().

Referenced by Say().

{
    string s = getWrappedLine_remaining;

    if(w <= 0)
    {
        getWrappedLine_remaining = string_null;
        return s; // the line has no size ANYWAY, nothing would be displayed.
    }

    int take_until = textLengthUpToLength(s, w, tw);
    if(take_until > 0 && take_until < strlen(s))
    {
        int last_word = take_until - 1;
        while(last_word > 0 && substring(s, last_word, 1) != " ")
            --last_word;

        int skip = 0;
        if(last_word != 0)
        {
            take_until = last_word;
            skip = 1;
        }

        getWrappedLine_remaining = substring(s, take_until + skip, strlen(s) - take_until);
        if(getWrappedLine_remaining == "")
            getWrappedLine_remaining = string_null;
        else if (tw("^7") == 0)
            getWrappedLine_remaining = strcat(find_last_color_code(substring(s, 0, take_until)), getWrappedLine_remaining);
        return substring(s, 0, take_until);
    }
    else
    {
        getWrappedLine_remaining = string_null;
        return s;
    }
}

Here is the call graph for this function:

Here is the caller graph for this function:

isGametypeInFilter()

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

mapPriorityList()

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

Definition at line 527 of file util.qc.

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

Referenced by W_NameWeaponOrder(), and W_NumberWeaponOrder().

{
    string neworder;
    float n;

    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);
}

Here is the call graph for this function:

Here is the caller graph for this function:

matchacl()

float matchacl	(	string	acl,
		string	str
	)

Definition at line 1203 of file util.qc.

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

Referenced by _MapInfo_Parse_Settemp().

{
    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;
}

Here is the call graph for this function:

Here is the caller graph for this function:

queue_to_execute_next_frame()

void queue_to_execute_next_frame

(

string

s

)

Definition at line 1620 of file util.qc.

References strcat(), and strcpy.

Referenced by GenericCommand_nextframe().

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

Here is the call graph for this function:

Here is the caller graph for this function:

Shutdown()

void Shutdown

(

)

Definition at line 152 of file main.qc.

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_defstring(), cvar_set(), db_close(), db_dump(), db_save(), deactivate_minigame(), FOREACH_ENTITY_ORDERED, ftos(), HOOK_END, HOOK_START, HUD_MinigameMenu_Close(), isdemo(), localcmd, LOG_INFO, LOG_TRACE, m_hide(), MapInfo_Shutdown(), NULL, orig_slowmo, players, ServerProgsDB, strcat(), strfree, sv_termsofservice_url_escaped, teams, tempdb, TemporaryDB, TIMEOUT_ACTIVE, WarpZone_Shutdown(), WeaponStats_Shutdown(), and world_initialized.

{
    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 (!isdemo())
    {
        if (!(calledhooks & HOOK_START))
            localcmd("\n_cl_hook_gamestart nop\n");
        if (!(calledhooks & HOOK_END))
            localcmd("\ncl_hook_gameend\n");
    }

    localcmd("\ncl_hook_shutdown\n");

    localcmd("\n-button12\n");

    deactivate_minigame();
    HUD_MinigameMenu_Close(NULL, NULL, NULL);

    ReplicateVars(REPLICATEVARS_DESTROY);
}

Here is the call graph for this function:

solve_shotdirection()

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

Definition at line 1018 of file util.qc.

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

{
    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;
}

Here is the call graph for this function:

STATIC_INIT()

STATIC_INIT

(

g_saved_cvars

)

Definition at line 34 of file util.qh.

References entity(), IL_NEW, to, wordwrap(), and wordwrap_cb().

{ g_saved_cvars = IL_NEW(); }

Here is the call graph for this function:

swapInPriorityList()

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

Definition at line 540 of file util.qc.

References argv(), MapInfo_Get_ByName(), MapInfo_Map_maxs, MapInfo_Map_mins, mapname, MOVE_WORLDONLY, NULL, strcasecmp, strcat(), strcpy, strlen(), substring(), tokenize_console, trace_endpos, trace_startsolid, vector(), and world.

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

{
    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;
}

Here is the call graph for this function:

Here is the caller graph for this function:

textLengthUpToLength()

float textLengthUpToLength	(	string	theText,
		float	maxWidth,
		textLengthUpToLength_lenFunction_t	tw
	)

Definition at line 809 of file util.qc.

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

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

{
    // 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) <= maxWidth)
        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)) <= maxWidth)
            left = middle + ofs;
        else
            right = middle;
    }
    while(left < right - 1);

    return left;
}

Here is the call graph for this function:

Here is the caller graph for this function:

textLengthUpToWidth()

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

Definition at line 773 of file util.qc.

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

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

{
    // 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;
}

Here is the call graph for this function:

Here is the caller graph for this function:

textShortenToLength()

string textShortenToLength	(	string	theText,
		float	maxWidth,
		textLengthUpToLength_lenFunction_t	tw
	)

Definition at line 964 of file util.qc.

References strcat(), substring(), and textLengthUpToLength().

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

Here is the call graph for this function:

textShortenToWidth()

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

Definition at line 956 of file util.qc.

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

Referenced by Draw_ShowNames(), draw_TextShortenToWidth(), HUD_Chat(), HUD_Quickmenu_DrawEntry(), minigame_drawcolorcodedstring_trunc(), minigame_drawstring_trunc(), Scoreboard_DrawOthers(), Scoreboard_FixColumnWidth(), and Scoreboard_Rankings_Draw().

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

Here is the call graph for this function:

Here is the caller graph for this function:

translate_key()

ERASEABLE string translate_key

(

string

key

)

Definition at line 1376 of file util.qc.

References prvm_language, and substring().

Referenced by _getcommandkey(), and XonoticKeyBinder_drawListBoxItem().

{
    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;
}

Here is the call graph for this function:

Here is the caller graph for this function:

wordwrap()

string wordwrap	(	string	s,
		float	l
	)

Definition at line 170 of file util.qc.

References entity(), NULL, sprint(), strcat(), to, wordwrap_buffer, wordwrap_buffer_put(), and wordwrap_cb().

Referenced by STATIC_INIT().

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

Here is the call graph for this function:

Here is the caller graph for this function:

wordwrap_cb()

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

Definition at line 215 of file util.qc.

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

Referenced by STATIC_INIT(), and wordwrap().

{
    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);
}

Here is the call graph for this function:

Here is the caller graph for this function:

write_String_To_File()

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

Definition at line 1239 of file util.qc.

References fputs(), and LOG_HELP.

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

Here is the call graph for this function:

xdecode()

float xdecode

(

string

s

)

Definition at line 1546 of file util.qc.

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

{
    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;
}

Here is the call graph for this function:

xencode()

string xencode

(

float

f

)

Variable Documentation

draw_currentSkin

string draw_currentSkin

Definition at line 45 of file util.qh.

Referenced by draw_cursor(), draw_UseSkinFor(), LoadMenuSkinValues(), and m_init_delayed().

g_saved_cvars

IntrusiveList g_saved_cvars

Definition at line 33 of file util.qh.

Referenced by cvar_settemp().

get_model_parameters_age

float get_model_parameters_age

Definition at line 143 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 149 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 150 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 146 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 147 of file util.qh.

Referenced by get_model_parameters(), and skeleton_loadinfo().

get_model_parameters_desc

string get_model_parameters_desc

Definition at line 152 of file util.qh.

Referenced by get_model_parameters(), and XonoticPlayerModelSelector_loadModels().

get_model_parameters_description

string get_model_parameters_description

Definition at line 145 of file util.qh.

Referenced by XonoticPlayerModelSelector_loadModels().

get_model_parameters_fixbone

float get_model_parameters_fixbone

Definition at line 151 of file util.qh.

Referenced by get_model_parameters(), and skeleton_loadinfo().

get_model_parameters_hidden

bool get_model_parameters_hidden

Definition at line 144 of file util.qh.

Referenced by get_model_parameters(), and XonoticPlayerModelSelector_loadModels().

get_model_parameters_modelname

string get_model_parameters_modelname

Definition at line 137 of file util.qh.

Referenced by get_model_parameters(), and XonoticPlayerModelSelector_loadModels().

get_model_parameters_modelskin

float get_model_parameters_modelskin

Definition at line 138 of file util.qh.

Referenced by get_model_parameters(), and XonoticPlayerModelSelector_loadModels().

get_model_parameters_name

string get_model_parameters_name

Definition at line 139 of file util.qh.

Referenced by get_model_parameters(), and XonoticPlayerModelSelector_loadModels().

get_model_parameters_sex

string get_model_parameters_sex

Definition at line 141 of file util.qh.

Referenced by get_model_parameters(), and XonoticPlayerModelSelector_loadModels().

get_model_parameters_species

float get_model_parameters_species

Definition at line 140 of file util.qh.

Referenced by get_model_parameters(), and player_getspecies().

get_model_parameters_weight

float get_model_parameters_weight

Definition at line 142 of file util.qh.

Referenced by get_model_parameters(), and XonoticPlayerModelSelector_loadModels().

getWrappedLine_remaining

string getWrappedLine_remaining

Definition at line 108 of file util.qh.

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

MAX_AIM_BONES

const int MAX_AIM_BONES = 4

Definition at line 148 of file util.qh.

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

message

string message

Definition at line 31 of file util.qh.

netname

string netname

Definition at line 30 of file util.qh.

TIME_DECIMALS

const int TIME_DECIMALS = 2

Definition at line 55 of file util.qh.

Referenced by HUD_Score(), and MakeRaceString().

TIME_FACTOR

const float TIME_FACTOR = 100

Definition at line 56 of file util.qh.

XENCODE_LEN

const float XENCODE_LEN = 5

Definition at line 161 of file util.qh.

XENCODE_MAX

const float XENCODE_MAX = 21295

Definition at line 160 of file util.qh.