From 24d5e06910a08862afc35457a888076db0b5cfa8 Mon Sep 17 00:00:00 2001 From: varttist Date: Tue, 8 Sep 2026 22:31:03 +0300 Subject: [PATCH] Add `PcgRandom` class --- classes/PcgRandom.lua | 40 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 40 insertions(+) create mode 100644 classes/PcgRandom.lua diff --git a/classes/PcgRandom.lua b/classes/PcgRandom.lua new file mode 100644 index 0000000..cb80d63 --- /dev/null +++ b/classes/PcgRandom.lua @@ -0,0 +1,40 @@ +---Version: 5.18 +---@meta + +---A 32-bit pseudorandom number generator. +--- +---Uses PCG32, an algorithm of the permuted +---congruential generator family, +---offering very strong randomness. +---@class PcgRandom +---@overload fun(seed:integer, seq:integer?):PcgRandom +PcgRandom = {} + +---Return next random integer number `[s32]`. +---@param max integer +---@param min integer +---@return integer +---@overload fun():integer +function PcgRandom:next(max, min) end + +---Return normally distributed random number `[min...max]`. +--- +---This is only a rough approximation of a normal distribution with: +--- +---`mean = (max - min) / 2` and `variance = (((max - min + 1) ^ 2) - 1) / (12 * num_trials)` +--- +---Increasing `num_trials` improves accuracy of the approximation +---@param max integer +---@param min integer +---@param num_trials integer +---@return integer +function PcgRandom:rand_normal_dist(max, min, num_trials) end + +---Return generator state encoded in string. +---@return string +function PcgRandom:get_state() end + +---Restore generator state from encoded string. +---@param state_string string +---@return string +function PcgRandom:set_state(state_string) end