using System; using System.Diagnostics; using System.Threading; namespace Lidgren.Network { /// /// A fast random number generator for .NET /// Colin Green, January 2005 /// /// September 4th 2005 /// Added NextBytesUnsafe() - commented out by default. /// Fixed bug in Reinitialise() - y,z and w variables were not being reset. /// /// Key points: /// 1) Based on a simple and fast xor-shift pseudo random number generator (RNG) specified in: /// Marsaglia, George. (2003). Xorshift RNGs. /// http://www.jstatsoft.org/v08/i14/xorshift.pdf /// /// This particular implementation of xorshift has a period of 2^128-1. See the above paper to see /// how this can be easily extened if you need a longer period. At the time of writing I could find no /// information on the period of System.Random for comparison. /// /// 2) Faster than System.Random. Up to 15x faster, depending on which methods are called. /// /// 3) Direct replacement for System.Random. This class implements all of the methods that System.Random /// does plus some additional methods. The like named methods are functionally equivalent. /// /// 4) Allows fast re-initialisation with a seed, unlike System.Random which accepts a seed at construction /// time which then executes a relatively expensive initialisation routine. This provides a vast speed improvement /// if you need to reset the pseudo-random number sequence many times, e.g. if you want to re-generate the same /// sequence many times. An alternative might be to cache random numbers in an array, but that approach is limited /// by memory capacity and the fact that you may also want a large number of different sequences cached. Each sequence /// can each be represented by a single seed value (int) when using FastRandom. /// /// Notes. /// A further performance improvement can be obtained by declaring local variables as static, thus avoiding /// re-allocation of variables on each call. However care should be taken if multiple instances of /// FastRandom are in use or if being used in a multi-threaded environment. /// /// public sealed class NetRandom : Random { public static NetRandom Instance = new NetRandom(); protected override double Sample() { return NextDouble(); } // The +1 ensures NextDouble doesn't generate 1.0 private const double c_realUnitInt = 1.0 / ((double)int.MaxValue + 1.0); private const double c_realUnitUint = 1.0 / ((double)uint.MaxValue + 1.0); private const uint c_y = 842502087, c_z = 3579807591, c_w = 273326509; private static int s_extraSeed = 42; uint m_x, m_y, m_z, m_w; /// /// Returns a random seed based on time and working set /// public static int GetRandomSeed(object forObject) { // mix some semi-random properties int seed = (int)Environment.TickCount; seed ^= forObject.GetHashCode(); seed ^= (int)(Stopwatch.GetTimestamp()); seed ^= (int)(Environment.WorkingSet); // will return 0 on mono int extraSeed = Interlocked.Increment(ref s_extraSeed); return seed + extraSeed; } /// /// Initialises a new instance using time dependent seed. /// public NetRandom() { // Initialise using the system tick count Reinitialise(GetRandomSeed(this)); } /// /// Initialises a new instance using an int value as seed. /// This constructor signature is provided to maintain compatibility with /// System.Random /// public NetRandom(int seed) { Reinitialise(seed); } /// /// Reinitialises using an int value as a seed. /// /// public void Reinitialise(int seed) { // The only stipulation stated for the xorshift RNG is that at least one of // the seeds x,y,z,w is non-zero. We fulfill that requirement by only allowing // resetting of the x seed m_x = (uint)seed; m_y = c_y; m_z = c_z; m_w = c_w; } /// /// Generates a uint. Values returned are over the full range of a uint, /// uint.MinValue to uint.MaxValue, including the min and max values. /// [CLSCompliant(false)] public uint NextUInt() { uint t = (m_x ^ (m_x << 11)); m_x = m_y; m_y = m_z; m_z = m_w; return (m_w = (m_w ^ (m_w >> 19)) ^ (t ^ (t >> 8))); } /// /// Generates a random int. Values returned are over the range 0 to int.MaxValue-1. /// MaxValue is not generated to remain functionally equivalent to System.Random.Next(). /// If you require an int from the full range, including negative values then call /// NextUint() and cast the value to an int. /// /// public override int Next() { uint t = (m_x ^ (m_x << 11)); m_x = m_y; m_y = m_z; m_z = m_w; return (int)(0x7FFFFFFF & (m_w = (m_w ^ (m_w >> 19)) ^ (t ^ (t >> 8)))); } /// /// Generates a random int over the range 0 to upperBound-1, and not including upperBound. /// public override int Next(int maxValue) { if (maxValue < 0) throw new ArgumentOutOfRangeException("maxValue", maxValue, "maxValue must be >=0"); uint t = (m_x ^ (m_x << 11)); m_x = m_y; m_y = m_z; m_z = m_w; // The explicit int cast before the first multiplication gives better performance. // See comments in NextDouble. return (int)((c_realUnitInt * (int)(0x7FFFFFFF & (m_w = (m_w ^ (m_w >> 19)) ^ (t ^ (t >> 8))))) * maxValue); } /// /// Generates a random int over the range minValue to maxValue-1, and not including maxValue. /// maxValue must be >= minValue. minValue may be negative. /// public override int Next(int minValue, int maxValue) { if (minValue > maxValue) throw new ArgumentOutOfRangeException("maxValue", maxValue, "maxValue must be >=minValue"); uint t = (m_x ^ (m_x << 11)); m_x = m_y; m_y = m_z; m_z = m_w; // The explicit int cast before the first multiplication gives better performance. // See comments in NextDouble. int range = maxValue - minValue; if (range < 0) { // If range is <0 then an overflow has occured and must resort to using long integer arithmetic instead (slower). // We also must use all 32 bits of precision, instead of the normal 31, which again is slower. return minValue + (int)((c_realUnitUint * (double)(m_w = (m_w ^ (m_w >> 19)) ^ (t ^ (t >> 8)))) * (double)((long)maxValue - (long)minValue)); } // 31 bits of precision will suffice if range<=int.MaxValue. This allows us to cast to an int anf gain // a little more performance. return minValue + (int)((c_realUnitInt * (double)(int)(0x7FFFFFFF & (m_w = (m_w ^ (m_w >> 19)) ^ (t ^ (t >> 8))))) * (double)range); } /// /// Generates a random double. Values returned are from 0.0 up to but not including 1.0. /// /// public override double NextDouble() { uint t = (m_x ^ (m_x << 11)); m_x = m_y; m_y = m_z; m_z = m_w; // Here we can gain a 2x speed improvement by generating a value that can be cast to // an int instead of the more easily available uint. If we then explicitly cast to an // int the compiler will then cast the int to a double to perform the multiplication, // this final cast is a lot faster than casting from a uint to a double. The extra cast // to an int is very fast (the allocated bits remain the same) and so the overall effect // of the extra cast is a significant performance improvement. return (c_realUnitInt * (int)(0x7FFFFFFF & (m_w = (m_w ^ (m_w >> 19)) ^ (t ^ (t >> 8))))); } /// /// Generates a random double. Values returned are from 0.0 up to but not including 1.0. /// /// public float NextFloat() { uint t = (m_x ^ (m_x << 11)); m_x = m_y; m_y = m_z; m_z = m_w; // Here we can gain a 2x speed improvement by generating a value that can be cast to // an int instead of the more easily available uint. If we then explicitly cast to an // int the compiler will then cast the int to a double to perform the multiplication, // this final cast is a lot faster than casting from a uint to a double. The extra cast // to an int is very fast (the allocated bits remain the same) and so the overall effect // of the extra cast is a significant performance improvement. return (float)(c_realUnitInt * (int)(0x7FFFFFFF & (m_w = (m_w ^ (m_w >> 19)) ^ (t ^ (t >> 8))))); } /// /// Generates a random double. Values returned are from 0.0 up to but not including roof /// /// public float NextFloat(float roof) { uint t = (m_x ^ (m_x << 11)); m_x = m_y; m_y = m_z; m_z = m_w; // Here we can gain a 2x speed improvement by generating a value that can be cast to // an int instead of the more easily available uint. If we then explicitly cast to an // int the compiler will then cast the int to a double to perform the multiplication, // this final cast is a lot faster than casting from a uint to a double. The extra cast // to an int is very fast (the allocated bits remain the same) and so the overall effect // of the extra cast is a significant performance improvement. float f = (float)(c_realUnitInt * (int)(0x7FFFFFFF & (m_w = (m_w ^ (m_w >> 19)) ^ (t ^ (t >> 8))))); return f * roof; } /// /// Generates a random double. Values returned are from min up to but not including min + variance /// /// public float NextFloat(float min, float variance) { uint t = (m_x ^ (m_x << 11)); m_x = m_y; m_y = m_z; m_z = m_w; // Here we can gain a 2x speed improvement by generating a value that can be cast to // an int instead of the more easily available uint. If we then explicitly cast to an // int the compiler will then cast the int to a double to perform the multiplication, // this final cast is a lot faster than casting from a uint to a double. The extra cast // to an int is very fast (the allocated bits remain the same) and so the overall effect // of the extra cast is a significant performance improvement. float f = (float)(c_realUnitInt * (int)(0x7FFFFFFF & (m_w = (m_w ^ (m_w >> 19)) ^ (t ^ (t >> 8))))); return min + f * variance; } /// /// If passed 0.7f it will return true 7 times out of 10 /// /// public bool Chance(float percentChance) { uint t = (m_x ^ (m_x << 11)); m_x = m_y; m_y = m_z; m_z = m_w; // Here we can gain a 2x speed improvement by generating a value that can be cast to // an int instead of the more easily available uint. If we then explicitly cast to an // int the compiler will then cast the int to a double to perform the multiplication, // this final cast is a lot faster than casting from a uint to a double. The extra cast // to an int is very fast (the allocated bits remain the same) and so the overall effect // of the extra cast is a significant performance improvement. double hit = (c_realUnitInt * (int)(0x7FFFFFFF & (m_w = (m_w ^ (m_w >> 19)) ^ (t ^ (t >> 8))))); return (hit < percentChance); } /// /// Returns a System.Single larger or equal to 0 and smaller than 1.0f - gaussian distributed! /// public float NextGaussian() { return (float)((NextDouble() + NextDouble() + NextDouble()) / 3.0); } /// /// Fills the provided byte array with random bytes. /// Increased performance is achieved by dividing and packaging bits directly from the /// random number generator and storing them in 4 byte 'chunks'. /// /// public override void NextBytes(byte[] buffer) { // Fill up the bulk of the buffer in chunks of 4 bytes at a time. uint x = this.m_x, y = this.m_y, z = this.m_z, w = this.m_w; int i = 0; uint t; for (; i < buffer.Length - 3; ) { // Generate 4 bytes. t = (x ^ (x << 11)); x = y; y = z; z = w; w = (w ^ (w >> 19)) ^ (t ^ (t >> 8)); buffer[i++] = (byte)(w & 0x000000FF); buffer[i++] = (byte)((w & 0x0000FF00) >> 8); buffer[i++] = (byte)((w & 0x00FF0000) >> 16); buffer[i++] = (byte)((w & 0xFF000000) >> 24); } // Fill up any remaining bytes in the buffer. if (i < buffer.Length) { // Generate 4 bytes. t = (x ^ (x << 11)); x = y; y = z; z = w; w = (w ^ (w >> 19)) ^ (t ^ (t >> 8)); buffer[i++] = (byte)(w & 0x000000FF); if (i < buffer.Length) { buffer[i++] = (byte)((w & 0x0000FF00) >> 8); if (i < buffer.Length) { buffer[i++] = (byte)((w & 0x00FF0000) >> 16); if (i < buffer.Length) { buffer[i] = (byte)((w & 0xFF000000) >> 24); } } } } this.m_x = x; this.m_y = y; this.m_z = z; this.m_w = w; } // /// // /// A version of NextBytes that uses a pointer to set 4 bytes of the byte buffer in one operation // /// thus providing a nice speedup. Note that this requires the unsafe compilation flag to be specified // /// and so is commented out by default. // /// // /// // public unsafe void NextBytesUnsafe(byte[] buffer) // { // if(buffer.Length % 4 != 0) // throw new ArgumentException("Buffer length must be divisible by 4", "buffer"); // // uint x=this.x, y=this.y, z=this.z, w=this.w; // uint t; // // fixed(byte* pByte0 = buffer) // { // uint* pDWord = (uint*)pByte0; // for(int i = 0, len = buffer.Length>>2; i < len; i++) // { // t=(x^(x<<11)); // x=y; y=z; z=w; // *pDWord++ = w = (w^(w>>19))^(t^(t>>8)); // } // } // // this.x=x; this.y=y; this.z=z; this.w=w; // } // Buffer 32 bits in bitBuffer, return 1 at a time, keep track of how many have been returned // with bitBufferIdx. uint bitBuffer; int bitBufferIdx = 32; /// /// Generates random bool. /// Increased performance is achieved by buffering 32 random bits for /// future calls. Thus the random number generator is only invoked once /// in every 32 calls. /// /// public bool NextBool() { if (bitBufferIdx == 32) { // Generate 32 more bits. uint t = (m_x ^ (m_x << 11)); m_x = m_y; m_y = m_z; m_z = m_w; bitBuffer = m_w = (m_w ^ (m_w >> 19)) ^ (t ^ (t >> 8)); // Reset the idx that tells us which bit to read next. bitBufferIdx = 1; return (bitBuffer & 0x1) == 1; } bitBufferIdx++; return ((bitBuffer >>= 1) & 0x1) == 1; } } }