Random.h

#pragma once
 
#include <Foundation/Containers/DynamicArray.h>
#include <Foundation/IO/Stream.h>
#include <Foundation/Math/Declarations.h>
 
class PL_FOUNDATION_DLL plRandom
{
public:
  plRandom();
 
  void Initialize(plUInt64 uiSeed); // [tested]
 
  void InitializeFromCurrentTime();
 
  void Save(plStreamWriter& inout_stream) const; // [tested]
 
  void Load(plStreamReader& inout_stream); // [tested]
 
  plUInt32 UInt(); // [tested]
 
  plUInt32 UIntInRange(plUInt32 uiRange); // [tested]
 
  plInt32 IntInRange(plInt32 iMinValue, plUInt32 uiRange); // [tested]
 
  plInt32 IntMinMax(plInt32 iMinValue, plInt32 iMaxValue); // [tested]
 
  PL_ALWAYS_INLINE bool Bool() { return static_cast<bool>(UInt() & 1); } // [tested]
 
  PL_ALWAYS_INLINE double DoubleZeroToOneExclusive() { return (double)UInt() / (double)(0xFFFFFFFFUL); } // [tested]
 
  PL_ALWAYS_INLINE double DoubleZeroToOneInclusive() { return (double)UInt() / (double)(0xFFFFFFFFUL + 1.0); } // [tested]
 
  double DoubleInRange(double fMinValue, double fRange); // [tested]
 
  double DoubleMinMax(double fMinValue, double fMaxValue); // [tested]
 
  double DoubleVariance(double fValue, double fVariance);
 
  double DoubleVarianceAroundZero(double fAbsMaxValue);
 
  PL_ALWAYS_INLINE float FloatZeroToOneExclusive() { return static_cast<float>(DoubleZeroToOneExclusive()); } // [tested]
 
  PL_ALWAYS_INLINE float FloatZeroToOneInclusive() { return static_cast<float>(DoubleZeroToOneInclusive()); } // [tested]
 
  PL_ALWAYS_INLINE float FloatInRange(float fMinValue, float fRange) { return static_cast<float>(DoubleInRange(fMinValue, fRange)); } // [tested]
 
  PL_ALWAYS_INLINE float FloatMinMax(float fMinValue, float fMaxValue) { return static_cast<float>(DoubleMinMax(fMinValue, fMaxValue)); } // [tested]
 
  PL_ALWAYS_INLINE float FloatVariance(float fValue, float fVariance) { return static_cast<float>(DoubleVariance(fValue, fVariance)); }
 
  PL_ALWAYS_INLINE float FloatVarianceAroundZero(float fAbsMaxValue) { return static_cast<float>(DoubleVarianceAroundZero(fAbsMaxValue)); }
 
private:
  plUInt32 m_uiIndex;
  plUInt32 m_uiState[16];
};
 
 
class PL_FOUNDATION_DLL plRandomGauss
{
public:
  void Initialize(plUInt64 uiRandomSeed, plUInt32 uiMaxValue, float fVariance = 1.0f); // [tested]
 
  plUInt32 UnsignedValue(); // [tested]
 
  plInt32 SignedValue(); // [tested]
 
  void Save(plStreamWriter& inout_stream) const; // [tested]
 
  void Load(plStreamReader& inout_stream); // [tested]
 
private:
  void SetupTable(plUInt32 uiMaxValue, float fSigma);
 
  float m_fSigma;
  double m_fAreaSum;
  plDynamicArray<float> m_GaussAreaSum;
  plRandom m_Generator;
};
 
#include <Foundation/Math/Implementation/AllClassesRandom_inl.h>