You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
openmw/components/misc/rng.hpp

54 lines
1.4 KiB
C++

#ifndef OPENMW_COMPONENTS_MISC_RNG_H
#define OPENMW_COMPONENTS_MISC_RNG_H
#include <cassert>
#include <random>
#include <string_view>
/*
Provides central implementation of the RNG logic
*/
namespace Misc::Rng
{
/// The use of a rather minimalistic prng is preferred to avoid saving a lot of state in the save game.
using Generator = std::minstd_rand;
Generator& getGenerator();
std::string serialize(const Generator& prng);
void deserialize(std::string_view data, Generator& prng);
/// returns default seed for RNG
unsigned int generateDefaultSeed();
/// seed the RNG
void init(unsigned int seed = generateDefaultSeed());
/// return value in range [0.0f, 1.0f) <- note open upper range.
float rollProbability();
float rollProbability(Generator& prng);
/// return value in range [0.0f, 1.0f] <- note closed upper range.
float rollClosedProbability();
float rollClosedProbability(Generator& prng);
/// return value in range [0, max) <- note open upper range.
int rollDice(int max);
int rollDice(int max, Generator& prng);
/// return value in range [0, 99]
inline int roll0to99(Generator& prng)
{
return rollDice(100, prng);
}
inline int roll0to99()
{
return rollDice(100);
}
float deviate(float mean, float deviation);
float deviate(float mean, float deviation, Generator& prng);
}
#endif