Random number: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
No edit summary
No edit summary
Line 1: Line 1:
{{stub}}
{{stub}}
There is no built-in [[entity]] to generate random numbers in Valve's Source games.
There is no built-in [[entity]] to generate random numbers in Valve's {{Source|4}} games.


''However'', you can use [[logic_case]]'s <code>PickRandom</code> input to trigger one of up to sixteen random outputs.
''However'', you can use [[logic_case]]'s <code>PickRandom</code> input to trigger one of up to sixteen random outputs.
[[Category:Technical]]


== IUniformRandomStream ==
== IUniformRandomStream ==
Line 31: Line 30:
       Assert(random->RandomInt(0, 2) < 2);
       Assert(random->RandomInt(0, 2) < 2);
     }
     }
[[Category:Source]]
[[Category:C++]]

Revision as of 09:31, 12 June 2023

Stub

This article or section is a stub. You can help by expanding it.

There is no built-in entity to generate random numbers in Valve's Source Source games.

However, you can use logic_case's PickRandom input to trigger one of up to sixteen random outputs.

IUniformRandomStream

   //-----------------------------------------------------------------------------
   // A generator of uniformly distributed random numbers
   //-----------------------------------------------------------------------------
   class IUniformRandomStream
   {
   public:
   	// Sets the seed of the random number generator
   	virtual void	SetSeed( int iSeed ) = 0;
   
   	// Generates random numbers
   	virtual float	RandomFloat( float flMinVal = 0.0f, float flMaxVal = 1.0f ) = 0;
   	virtual int		RandomInt( int iMinVal, int iMaxVal ) = 0;
   	virtual float	RandomFloatExp( float flMinVal = 0.0f, float flMaxVal = 1.0f, float flExponent = 1.0f ) = 0;
   };    

This is a random generator included in the source SDK, which allows you to generate random numbers, for instance to choose a random spawn point within an area:

   CEmpSpawn *picked = candidates[random->RandomInt(0, candidates.Count() - 1)];

random is a global set up in the initialization of the source SDK. Note the - 1; RandomInt(0,1) includes the upperbound, unlike its counterpart in the C++ stdlib and boost libraries. This upper bound behaviour can be readily tested by putting this anywhere you know will run:

   for (int i = 0; i < 50000; ++i) {
     Assert(random->RandomInt(0, 2) < 2);
   }