util

Class Randomizer

java.lang.Object

util.Randomizer

All Implemented Interfaces:

IRandomizer

public class Randomizer
extends java.lang.Object
implements IRandomizer

Utility class that supplies class routines for generating various random values

Field Summary

Fields

Modifier and Type	Field and Description
static Randomizer	Singleton Singleton design pattern

Constructor Summary

Constructors

Modifier	Constructor and Description
private	Randomizer() Private constructor for Singleton

Method Summary

Modifier and Type	Method and Description
java.awt.Rectangle	randomBounds(java.awt.Rectangle rect, java.awt.Dimension maxDim) Generates a randomly located and sized rectangle
java.lang.Object	randomChoice(java.lang.Object x, java.lang.Object y, double probX) Returns a random choice of one of two objects, x and y, where probX is the probability that x will be picked (0<=x<=1).
<T> T	randomChoiceList(T... choices) Return one of the vararg input parameters with equal probability.
java.awt.Color	randomColor() Generates a random color
java.awt.Dimension	randomDim(java.awt.Dimension maxDim) Returns a random square Dimension, whose width is maxDim.width/2<=width<=maxDim.width
double	randomDouble(double min, double max) Returns a random double greater than or equal to min and less than or equal to max.
int	randomInt(int min, int max) Returns a random integer greater than or equal to min and less than or equal to max.
java.awt.Point	randomLoc(java.awt.Dimension dim) Generates a random location point subject to the constraint that 0<=X<=maxX and 0<=Y<=maxY.
java.awt.Point	randomLoc(java.awt.Rectangle rect) Generates a random location point subject to the constraint that 0<=X<=maxX and 0<=Y<=maxY.
java.awt.Point	randomVel(java.awt.Rectangle rect) Returns a random velocity (as a Point) subject to the constraint that the absolute value of the velocity (speed) is less than maxV.

Methods inherited from class java.lang.Object

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

Field Detail

Singleton

public static Randomizer Singleton

Singleton design pattern

Constructor Detail

Randomizer

private Randomizer()

Private constructor for Singleton

Method Detail

randomLoc

public java.awt.Point randomLoc(java.awt.Rectangle rect)

Generates a random location point subject to the constraint that 0<=X<=maxX and 0<=Y<=maxY.

Specified by:

randomLoc in interface IRandomizer

Parameters:

rect - the bounds for the location

Returns:

a random Point subject to the bounds

randomLoc

public java.awt.Point randomLoc(java.awt.Dimension dim)

Generates a random location point subject to the constraint that 0<=X<=maxX and 0<=Y<=maxY.

Specified by:

randomLoc in interface IRandomizer

Parameters:

dim - the bounds for the location

Returns:

a random Point subject to the bounds

randomInt

public int randomInt(int min,
                     int max)

Returns a random integer greater than or equal to min and less than or equal to max.

Specified by:

randomInt in interface IRandomizer

Parameters:

min - the min value

max - the max vale

Returns:

a random int subject to the bounds

randomDouble

public double randomDouble(double min,
                           double max)

Returns a random double greater than or equal to min and less than or equal to max.

Specified by:

randomDouble in interface IRandomizer

Parameters:

min - the min value

max - the max vale

Returns:

a random double subject to the bounds

randomVel

public java.awt.Point randomVel(java.awt.Rectangle rect)

Returns a random velocity (as a Point) subject to the constraint that the absolute value of the velocity (speed) is less than maxV.

Specified by:

randomVel in interface IRandomizer

Parameters:

rect - the bounds for the velocity

Returns:

a random Point subject to the bounds

randomDim

public java.awt.Dimension randomDim(java.awt.Dimension maxDim)

Returns a random square Dimension, whose width is maxDim.width/2<=width<=maxDim.width

Specified by:

randomDim in interface IRandomizer

Parameters:

maxDim - The bounds for the dimension

Returns:

a random Dimension subject to the bounds

randomBounds

public java.awt.Rectangle randomBounds(java.awt.Rectangle rect,
                                       java.awt.Dimension maxDim)

Generates a randomly located and sized rectangle

Specified by:

randomBounds in interface IRandomizer

Parameters:

rect - The bounds for the location of the rectangle

maxDim - The bounds for the size of the rectangle

Returns:

a random Rectangle subject to the bounds.

randomColor

public java.awt.Color randomColor()

Generates a random color

Specified by:

randomColor in interface IRandomizer

Returns:

a random Color

randomChoice

public java.lang.Object randomChoice(java.lang.Object x,
                                     java.lang.Object y,
                                     double probX)

Returns a random choice of one of two objects, x and y, where probX is the probability that x will be picked (0<=x<=1).

Specified by:

randomChoice in interface IRandomizer

Parameters:

x - The first object to choose from

y - The second object to choose from

probX - The probability of choosing the first object

Returns:

Either the first or second object as per the probability of choosing them.

randomChoiceList

public <T> T randomChoiceList(T... choices)

Return one of the vararg input parameters with equal probability. The input parameters must all be of the same type and the return type will match that type.

Specified by:

randomChoiceList in interface IRandomizer

Type Parameters:

T - The type of the input parameters and thus the return type

Parameters:

choices - vararg list of choices

Returns:

One of the input parameters