MathUtils

java.lang.Object
- com.fr.stable.collections.utils.MathUtils

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

作者:

Nathan Sweet

字段概要

字段
限定符和类型	字段和说明
`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 java.util.Random`	`random`

构造器概要

构造器
构造器和说明

MathUtils()

构造器
构造器和说明
`MathUtils()`

方法概要

方法
限定符和类型	方法和说明
`static float`	`atan2(float y, float x)` Returns atan2 in radians, faster but less accurate than Math.atan2.
`static int`	`ceil(float value)` Returns the smallest integer greater than or equal to the specified float.
`static int`	`ceilPositive(float value)` Returns the smallest integer greater than or equal to the specified float.
`static double`	`clamp(double value, double min, double max)`
`static float`	`clamp(float value, float min, float max)`
`static int`	`clamp(int value, int min, int max)`
`static long`	`clamp(long value, long min, long 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 value)` Returns the largest integer less than or equal to the specified float.
`static int`	`floorPositive(float value)` 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 float`	`lerpAngle(float fromRadians, float toRadians, float progress)` Linearly interpolates between two angles in radians.
`static float`	`lerpAngleDeg(float fromDegrees, float toDegrees, float progress)` Linearly interpolates between two angles in degrees.
`static float`	`log(float a, float value)`
`static float`	`log2(float value)`
`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 long`	`random(long range)` Returns a random number between 0 (inclusive) and the specified value (inclusive).
`static long`	`random(long start, long 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`	`randomSign()` Returns -1 or 1, randomly.
`static float`	`randomTriangular()` Returns a triangularly distributed random number between -1.0 (exclusive) and 1.0 (exclusive), where values around zero are more likely.
`static float`	`randomTriangular(float max)` Returns a triangularly distributed random number between `-max` (exclusive) and `max` (exclusive), where values around zero are more likely.
`static float`	`randomTriangular(float min, float max)` Returns a triangularly distributed random number between `min` (inclusive) and `max` (exclusive), where the `mode` argument defaults to the midpoint between the bounds, giving a symmetric distribution.
`static float`	`randomTriangular(float min, float max, float mode)` Returns a triangularly distributed random number between `min` (inclusive) and `max` (exclusive), where values around `mode` are more likely.
`static int`	`round(float value)` Returns the closest integer to the specified float.
`static int`	`roundPositive(float value)` 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.

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 字段详细资料
  - nanoToSec
```
public static final float nanoToSec
```
    另请参阅:
    常量字段值
  - FLOAT_ROUNDING_ERROR
```
public static final float FLOAT_ROUNDING_ERROR
```
    另请参阅:
    常量字段值
  - PI
```
public static final float PI
```
    另请参阅:
    常量字段值
  - PI2
```
public static final float PI2
```
    另请参阅:
    常量字段值
  - E
```
public static final float E
```
    另请参阅:
    常量字段值
  - radiansToDegrees
```
public static final float radiansToDegrees
```
    multiply by this to convert from radians to degrees
    
    另请参阅:
    常量字段值
  - radDeg
```
public static final float radDeg
```
    另请参阅:
    常量字段值
  - degreesToRadians
```
public static final float degreesToRadians
```
    multiply by this to convert from degrees to radians
    
    另请参阅:
    常量字段值
  - degRad
```
public static final float degRad
```
    另请参阅:
    常量字段值
  - random
```
public static java.util.Random random
```
- 构造器详细资料
  - MathUtils
```
public MathUtils()
```
- 方法详细资料
  - 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, faster but less accurate than Math.atan2. Average error of 0.00231 radians (0.1323 degrees), largest error of 0.00488 radians (0.2796 degrees).
  - 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).
  - random
```
public static long random(long range)
```
    Returns a random number between 0 (inclusive) and the specified value (inclusive).
  - random
```
public static long random(long start,
          long 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).
  - randomSign
```
public static int randomSign()
```
    Returns -1 or 1, randomly.
  - randomTriangular
```
public static float randomTriangular()
```
    Returns a triangularly distributed random number between -1.0 (exclusive) and 1.0 (exclusive), where values around zero are more likely.
    This is an optimized version of randomTriangular(-1, 1, 0)
  - randomTriangular
```
public static float randomTriangular(float max)
```
    Returns a triangularly distributed random number between -max (exclusive) and max (exclusive), where values around zero are more likely.
    This is an optimized version of randomTriangular(-max, max, 0)
    
    参数:
    max - the upper limit
  - randomTriangular
```
public static float randomTriangular(float min,
                     float max)
```
    Returns a triangularly distributed random number between min (inclusive) and max (exclusive), where the mode argument defaults to the midpoint between the bounds, giving a symmetric distribution.
    This method is equivalent of randomTriangular(min, max, (min + max) * .5f)
    
    参数:
    min - the lower limit
    max - the upper limit
  - randomTriangular
```
public static float randomTriangular(float min,
                     float max,
                     float mode)
```
    Returns a triangularly distributed random number between min (inclusive) and max (exclusive), where values around mode are more likely.
    
    参数:
    min - the lower limit
    max - the upper limit
    mode - the point around which the values are more likely
  - 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 short clamp(short value,
          short min,
          short max)
```
  - clamp
```
public static int clamp(int value,
        int min,
        int max)
```
  - clamp
```
public static long clamp(long value,
         long min,
         long max)
```
  - clamp
```
public static float clamp(float value,
          float min,
          float max)
```
  - clamp
```
public static double clamp(double value,
           double min,
           double max)
```
  - lerp
```
public static float lerp(float fromValue,
         float toValue,
         float progress)
```
    Linearly interpolates between fromValue to toValue on progress position.
  - lerpAngle
```
public static float lerpAngle(float fromRadians,
              float toRadians,
              float progress)
```
    Linearly interpolates between two angles in radians. Takes into account that angles wrap at two pi and always takes the direction with the smallest delta angle.
    
    参数:
    fromRadians - start angle in radians
    toRadians - target angle in radians
    progress - interpolation value in the range [0, 1]
    
    返回:
    the interpolated angle in the range [0, PI2[
  - lerpAngleDeg
```
public static float lerpAngleDeg(float fromDegrees,
                 float toDegrees,
                 float progress)
```
    Linearly interpolates between two angles in degrees. Takes into account that angles wrap at 360 degrees and always takes the direction with the smallest delta angle.
    
    参数:
    fromDegrees - start angle in degrees
    toDegrees - target angle in degrees
    progress - interpolation value in the range [0, 1]
    
    返回:
    the interpolated angle in the range [0, 360[
  - floor
```
public static int floor(float value)
```
    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 value)
```
    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 value)
```
    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 value)
```
    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 value)
```
    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 value)
```
    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.
    
    参数:
    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.
    
    参数:
    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.
    
    参数:
    a - the first value.
    b - the second value.
    tolerance - represent an upper bound below which the two values are considered equal.
  - log
```
public static float log(float a,
        float value)
```
    返回:
    the logarithm of value with base a
  - log2
```
public static float log2(float value)
```
    返回:
    the logarithm of value with base 2

类 MathUtils

字段概要

构造器概要

方法概要

从类继承的方法 java.lang.Object

字段详细资料

nanoToSec

FLOAT_ROUNDING_ERROR

PI

PI2

E

radiansToDegrees

radDeg

degreesToRadians

degRad

random

构造器详细资料

MathUtils

方法详细资料

sin

cos

sinDeg

cosDeg

atan2

random

random

random

random

randomBoolean

randomBoolean

random

random

random

randomSign

randomTriangular

randomTriangular

randomTriangular

randomTriangular

nextPowerOfTwo

isPowerOfTwo

clamp

clamp

clamp

clamp

clamp

lerp

lerpAngle

lerpAngleDeg

floor

floorPositive

ceil

ceilPositive

round

roundPositive

isZero

isZero

isEqual

isEqual

log

log2