MathUtils (libGDX Core 1.2.0 API)

java.lang.Object
- com.badlogic.gdx.math.MathUtils

```
public final class MathUtils
extends Object
```
Utility and fast math functions.
Thanks to Riven on JavaGaming.org for the basis of sin/cos/atan2/floor/ceil.

Author:

Nathan Sweet

Field Summary

Fields
Modifier and Type	Field and Description
`static float`	`degRad`
`static float`	`degreesToRadians` multiply by this to convert from degrees to radians
`static float`	`E`
`static float`	`FLOAT_ROUNDING_ERROR`
`static float`	`nanoToSec`
`static float`	`PI`
`static float`	`PI2`
`static float`	`radDeg`
`static float`	`radiansToDegrees` multiply by this to convert from radians to degrees
`static Random`	`random`

Constructor Summary

Constructors
Constructor and Description

MathUtils()

Constructors
Constructor and Description
`MathUtils()`

Method Summary

Methods
Modifier and Type	Method and Description
`static float`	`atan2(float y, float x)` Returns atan2 in radians from a lookup table.
`static int`	`ceil(float x)` Returns the smallest integer greater than or equal to the specified float.
`static int`	`ceilPositive(float x)` Returns the smallest integer greater than or equal to the specified float.
`static float`	`clamp(float value, float min, float max)`
`static int`	`clamp(int value, int min, int max)`
`static short`	`clamp(short value, short min, short max)`
`static float`	`cos(float radians)` Returns the cosine in radians from a lookup table.
`static float`	`cosDeg(float degrees)` Returns the cosine in radians from a lookup table.
`static int`	`floor(float x)` Returns the largest integer less than or equal to the specified float.
`static int`	`floorPositive(float x)` Returns the largest integer less than or equal to the specified float.
`static boolean`	`isEqual(float a, float b)` Returns true if a is nearly equal to b.
`static boolean`	`isEqual(float a, float b, float tolerance)` Returns true if a is nearly equal to b.
`static boolean`	`isPowerOfTwo(int value)`
`static boolean`	`isZero(float value)` Returns true if the value is zero (using the default tolerance as upper bound)
`static boolean`	`isZero(float value, float tolerance)` Returns true if the value is zero.
`static float`	`lerp(float fromValue, float toValue, float progress)` Linearly interpolates between fromValue to toValue on progress position.
`static int`	`nextPowerOfTwo(int value)` Returns the next power of two.
`static float`	`random()` Returns random number between 0.0 (inclusive) and 1.0 (exclusive).
`static float`	`random(float range)` Returns a random number between 0 (inclusive) and the specified value (exclusive).
`static float`	`random(float start, float end)` Returns a random number between start (inclusive) and end (exclusive).
`static int`	`random(int range)` Returns a random number between 0 (inclusive) and the specified value (inclusive).
`static int`	`random(int start, int end)` Returns a random number between start (inclusive) and end (inclusive).
`static boolean`	`randomBoolean()` Returns a random boolean value.
`static boolean`	`randomBoolean(float chance)` Returns true if a random value between 0 and 1 is less than the specified value.
`static int`	`round(float x)` Returns the closest integer to the specified float.
`static int`	`roundPositive(float x)` Returns the closest integer to the specified float.
`static float`	`sin(float radians)` Returns the sine in radians from a lookup table.
`static float`	`sinDeg(float degrees)` Returns the sine in radians from a lookup table.

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - nanoToSec
```
public static final float nanoToSec
```
    See Also:
    Constant Field Values
  - FLOAT_ROUNDING_ERROR
```
public static final float FLOAT_ROUNDING_ERROR
```
    See Also:
    Constant Field Values
  - PI
```
public static final float PI
```
    See Also:
    Constant Field Values
  - PI2
```
public static final float PI2
```
    See Also:
    Constant Field Values
  - E
```
public static final float E
```
    See Also:
    Constant Field Values
  - radiansToDegrees
```
public static final float radiansToDegrees
```
    multiply by this to convert from radians to degrees
    
    See Also:
    Constant Field Values
  - radDeg
```
public static final float radDeg
```
    See Also:
    Constant Field Values
  - degreesToRadians
```
public static final float degreesToRadians
```
    multiply by this to convert from degrees to radians
    
    See Also:
    Constant Field Values
  - degRad
```
public static final float degRad
```
    See Also:
    Constant Field Values
  - random
```
public static Random random
```
- Constructor Detail
  - MathUtils
```
public MathUtils()
```
- Method Detail
  - sin
```
public static float sin(float radians)
```
    Returns the sine in radians from a lookup table.
  - cos
```
public static float cos(float radians)
```
    Returns the cosine in radians from a lookup table.
  - sinDeg
```
public static float sinDeg(float degrees)
```
    Returns the sine in radians from a lookup table.
  - cosDeg
```
public static float cosDeg(float degrees)
```
    Returns the cosine in radians from a lookup table.
  - atan2
```
public static float atan2(float y,
          float x)
```
    Returns atan2 in radians from a lookup table.
  - random
```
public static int random(int range)
```
    Returns a random number between 0 (inclusive) and the specified value (inclusive).
  - random
```
public static int random(int start,
         int end)
```
    Returns a random number between start (inclusive) and end (inclusive).
  - randomBoolean
```
public static boolean randomBoolean()
```
    Returns a random boolean value.
  - randomBoolean
```
public static boolean randomBoolean(float chance)
```
    Returns true if a random value between 0 and 1 is less than the specified value.
  - random
```
public static float random()
```
    Returns random number between 0.0 (inclusive) and 1.0 (exclusive).
  - random
```
public static float random(float range)
```
    Returns a random number between 0 (inclusive) and the specified value (exclusive).
  - random
```
public static float random(float start,
           float end)
```
    Returns a random number between start (inclusive) and end (exclusive).
  - nextPowerOfTwo
```
public static int nextPowerOfTwo(int value)
```
    Returns the next power of two. Returns the specified value if the value is already a power of two.
  - isPowerOfTwo
```
public static boolean isPowerOfTwo(int value)
```
  - clamp
```
public static int clamp(int value,
        int min,
        int max)
```
  - clamp
```
public static short clamp(short value,
          short min,
          short max)
```
  - clamp
```
public static float clamp(float value,
          float min,
          float max)
```
  - lerp
```
public static float lerp(float fromValue,
         float toValue,
         float progress)
```
    Linearly interpolates between fromValue to toValue on progress position.
  - floor
```
public static int floor(float x)
```
    Returns the largest integer less than or equal to the specified float. This method will only properly floor floats from -(2^14) to (Float.MAX_VALUE - 2^14).
  - floorPositive
```
public static int floorPositive(float x)
```
    Returns the largest integer less than or equal to the specified float. This method will only properly floor floats that are positive. Note this method simply casts the float to int.
  - ceil
```
public static int ceil(float x)
```
    Returns the smallest integer greater than or equal to the specified float. This method will only properly ceil floats from -(2^14) to (Float.MAX_VALUE - 2^14).
  - ceilPositive
```
public static int ceilPositive(float x)
```
    Returns the smallest integer greater than or equal to the specified float. This method will only properly ceil floats that are positive.
  - round
```
public static int round(float x)
```
    Returns the closest integer to the specified float. This method will only properly round floats from -(2^14) to (Float.MAX_VALUE - 2^14).
  - roundPositive
```
public static int roundPositive(float x)
```
    Returns the closest integer to the specified float. This method will only properly round floats that are positive.
  - isZero
```
public static boolean isZero(float value)
```
    Returns true if the value is zero (using the default tolerance as upper bound)
  - isZero
```
public static boolean isZero(float value,
             float tolerance)
```
    Returns true if the value is zero.
    
    Parameters:
    tolerance - represent an upper bound below which the value is considered zero.
  - isEqual
```
public static boolean isEqual(float a,
              float b)
```
    Returns true if a is nearly equal to b. The function uses the default floating error tolerance.
    
    Parameters:
    a - the first value.
    b - the second value.
  - isEqual
```
public static boolean isEqual(float a,
              float b,
              float tolerance)
```
    Returns true if a is nearly equal to b.
    
    Parameters:
    a - the first value.
    b - the second value.
    tolerance - represent an upper bound below which the two values are considered equal.

Class MathUtils

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

nanoToSec

FLOAT_ROUNDING_ERROR

PI

PI2

E

radiansToDegrees

radDeg

degreesToRadians

degRad

random

Constructor Detail

MathUtils

Method Detail

sin

cos

sinDeg

cosDeg

atan2

random

random

randomBoolean

randomBoolean

random

random

random

nextPowerOfTwo

isPowerOfTwo

clamp

clamp

clamp

lerp

floor

floorPositive

ceil

ceilPositive

round

roundPositive

isZero

isZero

isEqual

isEqual