random.qh File Reference

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

Go to the source code of this file.

Macros
#define	crandom()
	Returns a random number between -1.0 and 1.0.
#define	prandom_debug()
#define	RandomSelection_AddEnt(e, weight, priority)
#define	RandomSelection_AddFloat(f, weight, priority)
#define	RandomSelection_AddString(s, weight, priority)
#define	RandomSelection_AddVec(v, weight, priority)
#define	USE_PRANDOM

Functions
ERASEABLE float	DistributeEvenly_Get (float weight)
ERASEABLE float	DistributeEvenly_GetRandomized (float weight)
ERASEABLE float	DistributeEvenly_GetRounded (float weight)
ERASEABLE void	DistributeEvenly_Init (float amount, float totalweight)
ERASEABLE float	gsl_ran_ugaussian ()
	Returns a Gaussian random variate, with mean zero and standard deviation sigma 1 From the GNU Scientific Library.
float	prandom ()
	Predictable random number generator (not seeded yet)
vector	prandomvec ()
void	psrandom (float seed)
ERASEABLE void	RandomSelection_Add (entity e, float f, string s, vector v, float weight, float priority)
ERASEABLE void	RandomSelection_Init ()

Variables
float	RandomSelection_best_priority
entity	RandomSelection_chosen_ent
float	RandomSelection_chosen_float
string	RandomSelection_chosen_string
vector	RandomSelection_chosen_vec
float	RandomSelection_totalweight

Macro Definition Documentation

crandom

#define crandom

(

)

Value:

(2 * (random() - 0.5))

Returns a random number between -1.0 and 1.0.

Definition at line 32 of file random.qh.

Referenced by ctf_Handle_Throw(), func_breakable_destroy(), havocbot_movetogoal(), Item_ScheduleRespawn(), ka_DropEvent(), LaunchDebris(), and tka_DropEvent().

prandom_debug

#define prandom_debug

(

)

Definition at line 44 of file random.qh.

Referenced by NET_HANDLE().

RandomSelection_AddEnt

#define RandomSelection_AddEnt	(		e,
			weight,
			priority )

Value:

RandomSelection_Add(e, 0, string_null, '0 0 0', weight, priority)

Definition at line 14 of file random.qh.

Referenced by buff_NewType(), CheatCommand(), CheatImpulse(), GiveRandomWeapons(), invasion_PickMonster(), invasion_PickSpawn(), Item_RandomFromList(), jumppad_push(), MUTATOR_HOOKFUNCTION(), MUTATOR_HOOKFUNCTION(), nade_choose_random(), napalm_damage(), SelectObservePoint(), Simple_TeleportPlayer(), Spawn_WeightedPoint(), SUB_UseTargets_Ex(), train_next_find(), W_Fireball_LaserPlay(), and W_RandomWeapons().

RandomSelection_AddFloat

#define RandomSelection_AddFloat	(		f,
			weight,
			priority )

Value:

RandomSelection_Add(NULL, f, string_null, '0 0 0', weight, priority)

Definition at line 15 of file random.qh.

Referenced by NIX_ChooseNextWeapon(), RandomItems_GetRandomVanillaItemClassName(), and TeamBalance_FindBestTeam().

RandomSelection_AddString

#define RandomSelection_AddString	(		s,
			weight,
			priority )

Value:

RandomSelection_Add(NULL, 0, s, '0 0 0', weight, priority)

Definition at line 16 of file random.qh.

Referenced by bot_setnameandstuff(), FixIntermissionClient(), RandomItems_GetRandomInstagibItemClassName(), RandomItems_GetRandomItemClassNameWithProperty(), RandomItems_GetRandomOverkillItemClassName(), and RandomItems_GetRandomVanillaItemClassName().

RandomSelection_AddVec

#define RandomSelection_AddVec	(		v,
			weight,
			priority )

Value:

RandomSelection_Add(NULL, 0, string_null, v, weight, priority)

Definition at line 17 of file random.qh.

USE_PRANDOM

#define USE_PRANDOM

Definition at line 34 of file random.qh.

Function Documentation

DistributeEvenly_Get()

ERASEABLE float DistributeEvenly_Get

(

float

weight

)

Definition at line 52 of file random.qc.

{
    if (weight <= 0)
        return 0;
    float f = DistributeEvenly_amount * weight / DistributeEvenly_totalweight;
    DistributeEvenly_totalweight -= weight;
    DistributeEvenly_amount -= f;
    return f;
}

References DistributeEvenly_amount, and DistributeEvenly_totalweight.

Referenced by kh_LoserTeam(), and kh_WinnerTeam().

DistributeEvenly_GetRandomized()

ERASEABLE float DistributeEvenly_GetRandomized

(

float

weight

)

Definition at line 74 of file random.qc.

{
    if (weight <= 0)
        return 0;
    float f = floor(random() + DistributeEvenly_amount * weight / DistributeEvenly_totalweight);
    DistributeEvenly_totalweight -= weight;
    DistributeEvenly_amount -= f;
    return f;
}

References DistributeEvenly_amount, DistributeEvenly_totalweight, floor(), and random().

DistributeEvenly_GetRounded()

ERASEABLE float DistributeEvenly_GetRounded

(

float

weight

)

Definition at line 63 of file random.qc.

{
    if (weight <= 0)
        return 0;
    float f = floor(0.5 + DistributeEvenly_amount * weight / DistributeEvenly_totalweight);
    DistributeEvenly_totalweight -= weight;
    DistributeEvenly_amount -= f;
    return f;
}

References DistributeEvenly_amount, DistributeEvenly_totalweight, and floor().

DistributeEvenly_Init()

ERASEABLE void DistributeEvenly_Init	(	float	amount,
		float	totalweight )

Definition at line 42 of file random.qc.

{
    if (DistributeEvenly_amount)
        LOG_TRACE("DistributeEvenly_Init: UNFINISHED DISTRIBUTION (", ftos(DistributeEvenly_amount),
            " for ", ftos(DistributeEvenly_totalweight), " left!)");
    DistributeEvenly_amount = (totalweight) ? amount : 0;
    DistributeEvenly_totalweight = totalweight;
}

References DistributeEvenly_amount, DistributeEvenly_totalweight, ftos(), and LOG_TRACE.

Referenced by kh_LoserTeam(), and kh_WinnerTeam().

gsl_ran_ugaussian()

ERASEABLE float gsl_ran_ugaussian

(

)

Returns a Gaussian random variate, with mean zero and standard deviation sigma 1 From the GNU Scientific Library.

Definition at line 87 of file random.qc.

{
    static float lastvalue;
    static bool lastvalue_set;
    if (lastvalue_set)
    {
        lastvalue_set = false;
        return lastvalue;
    }
 
    const float a = random() * (2 * M_PI);
    const float b = sqrt(-2 * log(random()));
    lastvalue = cos(a) * b;
    lastvalue_set = true;
    return sin(a) * b;
}

References cos(), log(), M_PI, random(), sin(), and sqrt().

Referenced by W_CalculateSpread().

prandom()

float prandom

(

)

Predictable random number generator (not seeded yet)

Definition at line 108 of file random.qc.

    {
        float c;
        c = crc16(false, strcat(ftos(prandom_seed), ftos(prandom_seed + M_PI)));
        prandom_seed = c;
 
    #ifdef USE_PRANDOM_DEBUG
            LOG_TRACE("RANDOM -> ", ftos(c));
    #endif
 
        return c / 65536;  // in [0..1[
    }

References ftos(), LOG_TRACE, M_PI, prandom_seed, and strcat().

Referenced by NET_HANDLE(), NET_HANDLE(), prandomvec(), SND_BRASS_RANDOM(), SND_CASINGS_RANDOM(), SND_GIB_SPLAT_RANDOM(), TossGib(), and turret_gibtoss().

prandomvec()

vector prandomvec

(

)

Definition at line 121 of file random.qc.

    {
        vector v;
 
        do
        {
            v.x = prandom();
            v.y = prandom();
            v.z = prandom();
        }
        while (v * v > 1);
 
        return v;
    }

References prandom(), and vector.

Referenced by NET_HANDLE(), NET_HANDLE(), RaptorCBShellfragToss(), TossGib(), and turret_gibtoss().

psrandom()

void psrandom

(

float

seed

)

Definition at line 136 of file random.qc.

    {
        prandom_seed = seed;
    #ifdef USE_PRANDOM_DEBUG
            LOG_TRACE("SRANDOM ", ftos(seed));
    #endif
    }

References ftos(), LOG_TRACE, and prandom_seed.

Referenced by NET_HANDLE().

RandomSelection_Add()

ERASEABLE void RandomSelection_Add	(	entity	e,
		float	f,
		string	s,
		vector	v,
		float	weight,
		float	priority )

Definition at line 14 of file random.qc.

{
    if (priority > RandomSelection_best_priority)
    {
        RandomSelection_best_priority = priority;
        RandomSelection_chosen_ent = e;
        RandomSelection_chosen_float = f;
        RandomSelection_chosen_string = s;
        RandomSelection_chosen_vec = v;
        RandomSelection_totalweight = weight;
    }
    else if (priority == RandomSelection_best_priority)
    {
        RandomSelection_totalweight += weight;
        if (random() * RandomSelection_totalweight <= weight)
        {
            RandomSelection_chosen_ent = e;
            RandomSelection_chosen_float = f;
            RandomSelection_chosen_string = s;
            RandomSelection_chosen_vec = v;
        }
    }
}

References entity(), random(), RandomSelection_best_priority, RandomSelection_chosen_ent, RandomSelection_chosen_float, RandomSelection_chosen_string, RandomSelection_chosen_vec, RandomSelection_totalweight, and vector.

Referenced by MUTATOR_HOOKFUNCTION().

RandomSelection_Init()

ERASEABLE void RandomSelection_Init

(

)

Definition at line 4 of file random.qc.

{
    RandomSelection_totalweight = 0;
    RandomSelection_chosen_ent = NULL;
    RandomSelection_chosen_float = 0;
    RandomSelection_chosen_string = string_null;
    RandomSelection_best_priority = -1;
}

References NULL, RandomSelection_best_priority, RandomSelection_chosen_ent, RandomSelection_chosen_float, RandomSelection_chosen_string, RandomSelection_totalweight, and string_null.

Referenced by bot_setnameandstuff(), buff_NewType(), CheatCommand(), CheatImpulse(), FixIntermissionClient(), GiveRandomWeapons(), invasion_PickMonster(), invasion_PickSpawn(), invasion_SpawnChosenMonster(), Item_FindTeam(), Item_RandomFromList(), Item_Touch(), jumppad_push(), MapInfo_LoadMapSettings(), MUTATOR_HOOKFUNCTION(), MUTATOR_HOOKFUNCTION(), MUTATOR_HOOKFUNCTION(), nade_choose_random(), napalm_damage(), NIX_ChooseNextWeapon(), RandomItems_GetRandomInstagibItemClassName(), RandomItems_GetRandomItemClassNameWithProperty(), RandomItems_GetRandomOverkillItemClassName(), RandomItems_GetRandomVanillaItemClassName(), SelectObservePoint(), Simple_TeleportPlayer(), Spawn_WeightedPoint(), spawnmonster(), SUB_UseTargets_Ex(), TeamBalance_FindBestTeam(), TeleportPlayer(), train_next_find(), W_Fireball_LaserPlay(), and W_RandomWeapons().

Variable Documentation

RandomSelection_best_priority

float RandomSelection_best_priority

Definition at line 4 of file random.qh.

Referenced by RandomSelection_Add(), and RandomSelection_Init().

RandomSelection_chosen_ent

entity RandomSelection_chosen_ent

Definition at line 5 of file random.qh.

Referenced by buff_NewType(), CheatCommand(), CheatImpulse(), GiveRandomWeapons(), invasion_PickMonster(), invasion_PickSpawn(), Item_FindTeam(), Item_RandomFromList(), Item_Touch(), jumppad_push(), MapInfo_LoadMapSettings(), MUTATOR_HOOKFUNCTION(), MUTATOR_HOOKFUNCTION(), MUTATOR_HOOKFUNCTION(), nade_choose_random(), napalm_damage(), RandomSelection_Add(), RandomSelection_Init(), SelectObservePoint(), Simple_TeleportPlayer(), Spawn_WeightedPoint(), spawnmonster(), SUB_UseTargets_Ex(), train_next_find(), W_Fireball_LaserPlay(), and W_RandomWeapons().

RandomSelection_chosen_float

float RandomSelection_chosen_float

Definition at line 6 of file random.qh.

Referenced by NIX_ChooseNextWeapon(), RandomItems_GetRandomVanillaItemClassName(), RandomSelection_Add(), RandomSelection_Init(), and TeamBalance_FindBestTeam().

RandomSelection_chosen_string

string RandomSelection_chosen_string

Definition at line 7 of file random.qh.

Referenced by bot_setnameandstuff(), FixIntermissionClient(), invasion_SpawnChosenMonster(), RandomItems_GetRandomInstagibItemClassName(), RandomItems_GetRandomItemClassNameWithProperty(), RandomItems_GetRandomOverkillItemClassName(), RandomItems_GetRandomVanillaItemClassName(), RandomSelection_Add(), RandomSelection_Init(), and TeleportPlayer().

RandomSelection_chosen_vec

vector RandomSelection_chosen_vec

Definition at line 8 of file random.qh.

Referenced by MUTATOR_HOOKFUNCTION(), and RandomSelection_Add().

RandomSelection_totalweight

float RandomSelection_totalweight

Definition at line 3 of file random.qh.

Referenced by RandomSelection_Add(), and RandomSelection_Init().