com.maddox.sas1946.il2.util

Class TrueRandom

java.lang.Object

com.maddox.sas1946.il2.util.TrueRandom

public class TrueRandom
extends java.lang.Object

"TrueRandom" Class of the "SAS Common Utils"

This Class is used to provide "true" randomized numbers for IL-2 Sturmovik 1946, in opposite to the reproduceable "pseudo" random numbers being available in the stock game.

Since:

1.0.3

Version:

1.1.0

Author:

SAS~Storebror

Method Summary

Modifier and Type	Method and Description
static void	makeIl2TrueRandom() This method can turn the "pseudo" random behaviour of IL-2 into "real" random behaviour with a single line of code.
static double	nextDouble_Dome(double min, double max) Returns the next pseudorandom, "Dome" type distributed double value between the specified min and max values from this random number generator's sequence.
static double	nextDouble_DomeInv(double min, double max) Returns the next pseudorandom, "Inverted Dome" type distributed double value between the specified min and max values from this random number generator's sequence.
static double	nextDouble_Fade(double min, double max) Returns the next pseudorandom, "Fade" type distributed double value between the specified min and max values from this random number generator's sequence.
static double	nextDouble() Returns the next pseudorandom, uniformly distributed double value between 0.0 and 1.0 from this random number generator's sequence.
static double	nextDouble(double max) Returns a pseudorandom, uniformly distributed double value between 0 (inclusive) and the specified value (exclusive), drawn from this random number generator's sequence.
static double	nextDouble(double min, double max) Returns a pseudorandom, uniformly distributed double value between min (inclusive) and max (exclusive), drawn from this random number generator's sequence.
static float	nextFloat_Dome(float min, float max) Returns the next pseudorandom, "Dome" type distributed float value between the specified min and max values from this random number generator's sequence.
static float	nextFloat_DomeInv(float min, float max) Returns the next pseudorandom, "Inverted Dome" type distributed float value between the specified min and max values from this random number generator's sequence.
static float	nextFloat_Fade(float min, float max) Returns the next pseudorandom, "Fade" type distributed float value between the specified min and max values from this random number generator's sequence.
static float	nextFloat() Returns the next pseudorandom, uniformly distributed float value between 0.0 and 1.0 from this random number generator's sequence.
static float	nextFloat(float max) Returns a pseudorandom, uniformly distributed float value between 0 (inclusive) and the specified value (exclusive), drawn from this random number generator's sequence.
static float	nextFloat(float min, float max) Returns a pseudorandom, uniformly distributed float value between min (inclusive) and max (exclusive), drawn from this random number generator's sequence.
static double	nextGaussian() Returns the next pseudorandom, Gaussian ("normally") distributed double value with mean 0.0 and standard deviation 1.0 from this random number generator's sequence.
static double	nextGaussian(double deviation) Returns the next pseudorandom, Gaussian ("normally") distributed double value with mean 0.0 and the specified deviation from this random number generator's sequence.
static double	nextGaussian(double deviation, double center) Returns the next pseudorandom, Gaussian ("normally") distributed double value with the specified mean and deviation from this random number generator's sequence.
static float	nextInt_Dome(int min, int max) Returns the next pseudorandom, "Dome" type distributed int value between the specified min and max values from this random number generator's sequence.
static float	nextInt_DomeInv(int min, int max) Returns the next pseudorandom, "Inverted Dome" type distributed int value between the specified min and max values from this random number generator's sequence.
static float	nextInt_Fade(int min, int max) Returns the next pseudorandom, "Fade" type distributed int value between the specified min and max values from this random number generator's sequence.
static int	nextInt() Returns the next pseudorandom, uniformly distributed int value from this random number generator's sequence.
static int	nextInt(int max) Returns a pseudorandom, uniformly distributed int value between 0 (inclusive) and the specified value (exclusive), drawn from this random number generator's sequence.
static int	nextInt(int min, int max) Returns a pseudorandom, uniformly distributed int value between min (inclusive) and max (exclusive), drawn from this random number generator's sequence.
static float	nextLong_Dome(long min, long max) Returns the next pseudorandom, "Dome" type distributed long value between the specified min and max values from this random number generator's sequence.
static float	nextLong_DomeInv(long min, long max) Returns the next pseudorandom, "Inverted Dome" type distributed long value between the specified min and max values from this random number generator's sequence.
static float	nextLong_Fade(long min, long max) Returns the next pseudorandom, "Fade" type distributed long value between the specified min and max values from this random number generator's sequence.
static long	nextLong() Returns the next pseudorandom, uniformly distributed long value from this random number generator's sequence.
static long	nextLong(long max) Returns a pseudorandom, uniformly distributed long value between 0 (inclusive) and the specified value (exclusive), drawn from this random number generator's sequence.
static long	nextLong(long min, long max) Returns a pseudorandom, uniformly distributed long value between min (inclusive) and max (exclusive), drawn from this random number generator's sequence.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

makeIl2TrueRandom

public static final void makeIl2TrueRandom()

This method can turn the "pseudo" random behaviour of IL-2 into "real" random behaviour with a single line of code.
Just call this method anywhere in your code and from the moment when this line is processed, all random actions in IL-2 will be really randomized.

Since:

1.0.4

nextInt

public static final int nextInt()

Returns the next pseudorandom, uniformly distributed int value from this random number generator's sequence. The general contract of nextInt is that one int value is pseudorandomly generated and returned. All 2³² possible int values are produced with (approximately) equal probability.

Returns:

the next pseudorandom, uniformly distributed int value from this random number generator's sequence.

Since:

1.0.3

nextInt

public static final int nextInt(int max)

Returns a pseudorandom, uniformly distributed int value between 0 (inclusive) and the specified value (exclusive), drawn from this random number generator's sequence. The general contract of nextInt is that one int value in the specified range is pseudorandomly generated and returned. All max possible int values are produced with (approximately) equal probability.

Parameters:

max - the bound on the random number to be returned. Must be positive.

Returns:

a pseudorandom, uniformly distributed int value between 0 (inclusive) and max (exclusive).

Throws:

java.lang.IllegalArgumentException - if max is not positive.

Since:

1.0.3

nextInt

public static final int nextInt(int min,
                                int max)

Returns a pseudorandom, uniformly distributed int value between min (inclusive) and max (exclusive), drawn from this random number generator's sequence. The general contract of nextInt is that one int value in the specified range is pseudorandomly generated and returned. All max-min possible int values are produced with (approximately) equal probability.

Parameters:

min - the lower bound on the random number to be returned.

max - the upper bound on the random number to be returned. Must be larger than min.

Returns:

a pseudorandom, uniformly distributed int value between min (inclusive) and max (exclusive).

Throws:

java.lang.IllegalArgumentException - if max-min is not positive.

Since:

1.0.3

nextLong

public static final long nextLong()

Returns the next pseudorandom, uniformly distributed long value from this random number generator's sequence. The general contract of nextLong is that one long value is pseudorandomly generated and returned. All 2⁶⁴ possible long values are produced with (approximately) equal probability.

Returns:

the next pseudorandom, uniformly distributed long value from this random number generator's sequence.

Since:

1.0.3

nextLong

public static final long nextLong(long max)

Returns a pseudorandom, uniformly distributed long value between 0 (inclusive) and the specified value (exclusive), drawn from this random number generator's sequence. The general contract of nextLong is that one long value in the specified range is pseudorandomly generated and returned. All max possible long values are produced with (approximately) equal probability.

Parameters:

max - the bound on the random number to be returned. Must be positive.

Returns:

a pseudorandom, uniformly distributed long value between 0 (inclusive) and max (exclusive).

Throws:

java.lang.IllegalArgumentException - if max is not positive.

Since:

1.0.3

nextLong

public static final long nextLong(long min,
                                  long max)

Returns a pseudorandom, uniformly distributed long value between min (inclusive) and max (exclusive), drawn from this random number generator's sequence. The general contract of nextLong is that one long value in the specified range is pseudorandomly generated and returned. All max-min possible long values are produced with (approximately) equal probability.

Parameters:

min - the lower bound on the random number to be returned.

max - the upper bound on the random number to be returned. Must be larger than min.

Returns:

a pseudorandom, uniformly distributed long value between min (inclusive) and max (exclusive).

Throws:

java.lang.IllegalArgumentException - if max-min is not positive.

Since:

1.0.3

nextFloat

public static final float nextFloat()

Returns the next pseudorandom, uniformly distributed float value between 0.0 and 1.0 from this random number generator's sequence. The general contract of nextFloat is that one float value, chosen (approximately) uniformly from the range 0.0f (inclusive) to 1.0f (exclusive), is pseudorandomly generated and returned. All 2²⁴ possible float values of the form m x 2^-24, where m is a positive integer less than 2²⁴, are produced with (approximately) equal probability.

Returns:

the next pseudorandom, uniformly distributed float value between 0.0 and 1.0 from this random number generator's sequence.

Since:

1.0.3

nextFloat

public static final float nextFloat(float max)

Returns a pseudorandom, uniformly distributed float value between 0 (inclusive) and the specified value (exclusive), drawn from this random number generator's sequence. The general contract of nextFloat is that one float value in the specified range is pseudorandomly generated and returned. All 2²⁴ possible float values between 0.0 and max are produced with (approximately) equal probability.

Parameters:

max - the bound on the random number to be returned. Can be positive or negative.

Returns:

a pseudorandom, uniformly distributed float value between 0 (inclusive) and max (exclusive).

Since:

1.0.3

nextFloat

public static final float nextFloat(float min,
                                    float max)

Returns a pseudorandom, uniformly distributed float value between min (inclusive) and max (exclusive), drawn from this random number generator's sequence. The general contract of nextFloat is that one float value in the specified range is pseudorandomly generated and returned. All 2²⁴ possible float values between min and max are produced with (approximately) equal probability.

Parameters:

min - the lower bound on the random number to be returned.

max - the upper bound on the random number to be returned.

Returns:

a pseudorandom, uniformly distributed float value between min (inclusive) and max (exclusive).

Since:

1.0.3

nextDouble

public static final double nextDouble()

Returns the next pseudorandom, uniformly distributed double value between 0.0 and 1.0 from this random number generator's sequence. The general contract of nextDouble is that one double value, chosen (approximately) uniformly from the range 0.0d (inclusive) to 1.0d (exclusive), is pseudorandomly generated and returned. All 2⁵³ possible double values of the form m x 2^-53, where m is a positive integer less than 2⁵³, are produced with (approximately) equal probability.

Returns:

the next pseudorandom, uniformly distributed double value between 0.0 and 1.0 from this random number generator's sequence.

Since:

1.0.3

nextDouble

public static final double nextDouble(double max)

Returns a pseudorandom, uniformly distributed double value between 0 (inclusive) and the specified value (exclusive), drawn from this random number generator's sequence. The general contract of nextDouble is that one double value in the specified range is pseudorandomly generated and returned. All 2⁵³ possible double values between 0.0 and max are produced with (approximately) equal probability.

Parameters:

max - the bound on the random number to be returned. Can be positive or negative.

Returns:

a pseudorandom, uniformly distributed double value between 0 (inclusive) and max (exclusive).

Since:

1.0.3

nextDouble

public static final double nextDouble(double min,
                                      double max)

Returns a pseudorandom, uniformly distributed double value between min (inclusive) and max (exclusive), drawn from this random number generator's sequence. The general contract of nextDouble is that one double value in the specified range is pseudorandomly generated and returned. All 2⁵³ possible double values between min and max are produced with (approximately) equal probability.

Parameters:

min - the lower bound on the random number to be returned.

max - the upper bound on the random number to be returned.

Returns:

a pseudorandom, uniformly distributed double value between min (inclusive) and max (exclusive).

Since:

1.0.3

nextGaussian

public static final double nextGaussian()

Returns the next pseudorandom, Gaussian ("normally") distributed double value with mean 0.0 and standard deviation 1.0 from this random number generator's sequence. The general contract of nextGaussian is that one double value, chosen from (approximately) the usual normal distribution with mean 0.0 and standard deviation 1.0, is pseudorandomly generated and returned.

Returns:

the next pseudorandom, Gaussian ("normally") distributed double value with mean 0.0 and standard deviation 1.0 from this random number generator's sequence.

Since:

1.0.3

nextGaussian

public static final double nextGaussian(double deviation)

Returns the next pseudorandom, Gaussian ("normally") distributed double value with mean 0.0 and the specified deviation from this random number generator's sequence. The general contract of nextGaussian is that one double value, chosen from (approximately) the usual normal distribution with mean 0.0 and the specified deviation, is pseudorandomly generated and returned.

Parameters:

deviation - the deviation for this Gaussian Distribution

Returns:

the next pseudorandom, Gaussian ("normally") distributed double value with mean 0.0 and the specified deviation from this random number generator's sequence.

Since:

1.0.3

nextGaussian

public static final double nextGaussian(double deviation,
                                        double center)

Returns the next pseudorandom, Gaussian ("normally") distributed double value with the specified mean and deviation from this random number generator's sequence. The general contract of nextGaussian is that one double value, chosen from (approximately) the usual normal distribution with the specified mean and deviation, is pseudorandomly generated and returned.

Parameters:

deviation - the deviation for this Gaussian Distribution

center - the mean for this Gaussian Distribution

Returns:

the next pseudorandom, Gaussian ("normally") distributed double value with the specified mean and deviation from this random number generator's sequence.

Since:

1.0.3

nextDouble_Dome

public static final double nextDouble_Dome(double min,
                                           double max)

Returns the next pseudorandom, "Dome" type distributed double value between the specified min and max values from this random number generator's sequence. The general contract of nextDouble_Dome is that one double value, chosen from (approximately) a "Dome" type distribution between the specified min and max values, is pseudorandomly generated and returned.

Parameters:

min - the lower bound on the random number to be returned.

max - the upper bound on the random number to be returned.

Returns:

the next pseudorandom, "Dome" type distributed double value between the specified min and max values from this random number generator's sequence.

Since:

1.0.4

nextFloat_Dome

public static final float nextFloat_Dome(float min,
                                         float max)

Returns the next pseudorandom, "Dome" type distributed float value between the specified min and max values from this random number generator's sequence. The general contract of nextFloat_Dome is that one float value, chosen from (approximately) a "Dome" type distribution between the specified min and max values, is pseudorandomly generated and returned.

Parameters:

min - the lower bound on the random number to be returned.

max - the upper bound on the random number to be returned.

Returns:

the next pseudorandom, "Dome" type distributed float value between the specified min and max values from this random number generator's sequence.

Since:

1.0.4

nextInt_Dome

public static final float nextInt_Dome(int min,
                                       int max)

Returns the next pseudorandom, "Dome" type distributed int value between the specified min and max values from this random number generator's sequence. The general contract of nextInt_Dome is that one int value, chosen from (approximately) a "Dome" type distribution between the specified min and max values, is pseudorandomly generated and returned.

Parameters:

min - the lower bound on the random number to be returned.

max - the upper bound on the random number to be returned.

Returns:

the next pseudorandom, "Dome" type distributed int value between the specified min and max values from this random number generator's sequence.

Since:

1.0.4

nextLong_Dome

public static final float nextLong_Dome(long min,
                                        long max)

Returns the next pseudorandom, "Dome" type distributed long value between the specified min and max values from this random number generator's sequence. The general contract of nextLong_Dome is that one long value, chosen from (approximately) a "Dome" type distribution between the specified min and max values, is pseudorandomly generated and returned.

Parameters:

min - the lower bound on the random number to be returned.

max - the upper bound on the random number to be returned.

Returns:

the next pseudorandom, "Dome" type distributed long value between the specified min and max values from this random number generator's sequence.

Since:

1.0.4

nextDouble_DomeInv

public static final double nextDouble_DomeInv(double min,
                                              double max)

Returns the next pseudorandom, "Inverted Dome" type distributed double value between the specified min and max values from this random number generator's sequence. The general contract of nextDouble_DomeInv is that one double value, chosen from (approximately) a "Inverted Dome" type distribution between the specified min and max values, is pseudorandomly generated and returned.

Parameters:

min - the lower bound on the random number to be returned.

max - the upper bound on the random number to be returned.

Returns:

the next pseudorandom, "Inverted Dome" type distributed double value between the specified min and max values from this random number generator's sequence.

Since:

1.0.4

nextFloat_DomeInv

public static final float nextFloat_DomeInv(float min,
                                            float max)

Returns the next pseudorandom, "Inverted Dome" type distributed float value between the specified min and max values from this random number generator's sequence. The general contract of nextFloat_DomeInv is that one float value, chosen from (approximately) a "Inverted Dome" type distribution between the specified min and max values, is pseudorandomly generated and returned.

Parameters:

min - the lower bound on the random number to be returned.

max - the upper bound on the random number to be returned.

Returns:

the next pseudorandom, "Inverted Dome" type distributed float value between the specified min and max values from this random number generator's sequence.

Since:

1.0.4

nextInt_DomeInv

public static final float nextInt_DomeInv(int min,
                                          int max)

Returns the next pseudorandom, "Inverted Dome" type distributed int value between the specified min and max values from this random number generator's sequence. The general contract of nextInt_DomeInv is that one int value, chosen from (approximately) a "Inverted Dome" type distribution between the specified min and max values, is pseudorandomly generated and returned.

Parameters:

min - the lower bound on the random number to be returned.

max - the upper bound on the random number to be returned.

Returns:

the next pseudorandom, "Inverted Dome" type distributed int value between the specified min and max values from this random number generator's sequence.

Since:

1.0.4

nextLong_DomeInv

public static final float nextLong_DomeInv(long min,
                                           long max)

Returns the next pseudorandom, "Inverted Dome" type distributed long value between the specified min and max values from this random number generator's sequence. The general contract of nextLong_DomeInv is that one long value, chosen from (approximately) a "Inverted Dome" type distribution between the specified min and max values, is pseudorandomly generated and returned.

Parameters:

min - the lower bound on the random number to be returned.

max - the upper bound on the random number to be returned.

Returns:

the next pseudorandom, "Inverted Dome" type distributed long value between the specified min and max values from this random number generator's sequence.

Since:

1.0.4

nextDouble_Fade

public static final double nextDouble_Fade(double min,
                                           double max)

Returns the next pseudorandom, "Fade" type distributed double value between the specified min and max values from this random number generator's sequence. The general contract of nextDouble_Fade is that one double value, chosen from (approximately) a "Fade" type distribution between the specified min and max values, is pseudorandomly generated and returned.

Parameters:

min - the lower bound on the random number to be returned.

max - the upper bound on the random number to be returned.

Returns:

the next pseudorandom, "Fade" type distributed double value between the specified min and max values from this random number generator's sequence.

Since:

1.0.4

nextFloat_Fade

public static final float nextFloat_Fade(float min,
                                         float max)

Returns the next pseudorandom, "Fade" type distributed float value between the specified min and max values from this random number generator's sequence. The general contract of nextFloat_Fade is that one float value, chosen from (approximately) a "Fade" type distribution between the specified min and max values, is pseudorandomly generated and returned.

Parameters:

min - the lower bound on the random number to be returned.

max - the upper bound on the random number to be returned.

Returns:

the next pseudorandom, "Fade" type distributed float value between the specified min and max values from this random number generator's sequence.

Since:

1.0.4

nextInt_Fade

public static final float nextInt_Fade(int min,
                                       int max)

Returns the next pseudorandom, "Fade" type distributed int value between the specified min and max values from this random number generator's sequence. The general contract of nextInt_Fade is that one int value, chosen from (approximately) a "Fade" type distribution between the specified min and max values, is pseudorandomly generated and returned.

Parameters:

min - the lower bound on the random number to be returned.

max - the upper bound on the random number to be returned.

Returns:

the next pseudorandom, "Fade" type distributed int value between the specified min and max values from this random number generator's sequence.

Since:

1.0.4

nextLong_Fade

public static final float nextLong_Fade(long min,
                                        long max)

Returns the next pseudorandom, "Fade" type distributed long value between the specified min and max values from this random number generator's sequence. The general contract of nextLong_Fade is that one long value, chosen from (approximately) a "Fade" type distribution between the specified min and max values, is pseudorandomly generated and returned.

Parameters:

min - the lower bound on the random number to be returned.

max - the upper bound on the random number to be returned.

Returns:

the next pseudorandom, "Fade" type distributed long value between the specified min and max values from this random number generator's sequence.

Since:

1.0.4