Math library

Returns absolute value

f

float Value

Returns: float - Absolute value

Print( Math.AbsFloat(-12.5) );

>> 12.5

Returns absolute value

i

int Value

Returns: int - Absolute value

Print( Math.AbsInt(-12) );

>> 12

Returns angle in radians from cosinus

c

float Cosinus

Returns: float - Angle in radians

Print( Math.Acos(0.707107) ); // (cosinus 45)

>> 0.785398

Returns area of a right triangle

s

float Length of adjacent leg

a

float Angle of corner bordering adjacent which is not the right corner (in radians)

Returns: float - Area

Returns angle in radians from sinus

s

float Sinus

Returns: float - Angle in radians

Print( Math.Asin(0.707107) ); // (sinus 45)

>> 0.785398

Returns angle in radians from tangent

x

float Tangent

Returns: float - Angle in radians

Returns angle in radians from tangent

y

float Tangent

x

float Tangent

Returns: float - Angle in radians

Print ( Math.Atan2(1, 1) );

>> 0.785398

Returns ceil of value

f

float Value

Returns: float - Ceil of value

Print( Math.Ceil(5.3) );
Print( Math.Ceil(5.8) );

>> 6
>> 6

Clamps 'value' to 'min' if it is lower than 'min', or to 'max' if it is higher than 'max'

value

float Value

min

float Minimum value

max

float Maximum value

Returns: float - Clamped value

Print( Math.Clamp(-0.1, 0, 1) );
Print( Math.Clamp(2, 0, 1) );
Print( Math.Clamp(0.5, 0, 1) );

>> 0
>> 1
>> 0.5

Returns cosinus of angle in radians

angle

float Angle in radians

Returns: float - Cosinus of angle

Print( Math.Cos(0.785398) ); // (45)

>> 0.707107

Return relative difference between angles

angle1

float

angle2

float

Returns: float Difference between angles (angle1 - angle2)

Print( Math.DiffAngle(-45, 45) );
Print( Math.DiffAngle(90, 80) );

>> -90
>> 10

values above '12' will cause int overflow

Returns floor of value

f

float Value

Returns: float - Floor of value

Print( Math.Floor(5.3) );
Print( Math.Floor(5.8) );

>> 5
>> 5

Returns hypotenus of a right triangle

s

float Length of adjacent leg

a

float Angle of corner bordering adjacent which is not the right corner (in radians)

Returns: float - hypotenus

Calculates the linear value that produces the interpolant value within the range [a, b], it's an inverse of Lerp.

a

float Start

b

float End

value

float value

Returns: float - the time given the position between 'a' and 'b' given 'value', there is no clamp on 'value', to stay between [0..1] use 'value' between 'a' and 'b'

Print( Math.InverseLerp(3, 7, 5) );

>> 0.5

Returns if value is between min and max (inclusive)

v

float Value

min

float Minimum value

max

float Maximum value

Returns: bool - if value is within range [min,max]

Print( Math.IsInRange(6.9, 3.6, 9.3) );

>> true

Returns if value is between min and max (inclusive)

v

int Value

min

int Minimum value

max

int Maximum value

Returns: bool - if value is within range [min,max]

Print( Math.IsInRangeInt(6, 3, 9) );

>> true

Returns if point is inside circle

c

vector Center of circle ([0] and [2] will be used, as a circle is 2D)

r

float Radius of circle

p

vector Point ([0] and [2] will be used, as a circle is 2D)

Returns: bool - True when point is in circle

Returns if point is inside rectangle

mi

vector Minimums of rectangle ([0] and [2] will be used, as a rectangle is 2D)

ma

vector Maximums of rectangle ([0] and [2] will be used, as a rectangle is 2D)

p

vector Point ([0] and [2] will be used, as a rectangle is 2D)

Returns: bool - True when point is in rectangle

Linearly interpolates between 'a' and 'b' given 'time'.

a

float Start

b

float End

time

float Time [value needs to be between 0..1 for correct results, no auto clamp applied]

Returns: float - The interpolated result between the two float values.

Print( Math.Lerp(3, 7, 0.5) );

>> 5

Returns the binary (base-2) logarithm of x.

x

float Value whose logarithm is calculated.

Returns: float The binary logarithm of x: log2x.
If x is negative, it causes a domain error:
If x is zero, it may cause a pole error (depending on the library implementation).

Print( Math.Log2(1.0) );

>> 0.0

Returns bigger of two given values

x

float Value

y

float Value

Returns: float - max value

Print( Math.Max(5.3, 2.8) );

>> 5.3

Returns smaller of two given values

x

float Value

y

float Value

Returns: float - min value

Print( Math.Min(5.3, 2.8) );

>> 2.8

Returns the floating-point remainder of x/y rounded towards zero

x

float Value of the quotient numerator

y

float Value of the quotient denominator

Returns: float - The remainder of dividing the arguments

Print( Math.ModFloat(5.3, 2) );
Print( Math.ModFloat(18.5, 4.2) );

>> 1.3
>> 1.7

Normalizes the angle (0...360)

ang

float Angle for normalizing

Returns: float - Normalized angle

Print( Math.NormalizeAngle(390) );
Print( Math.NormalizeAngle(-90) );

>> 30
>> 270

occurences values above '12' will cause Factorial to overflow int.

Return power of v ^ power

v

float Value

power

float Power

Returns: float - The result of raising v to the given power

Print( Math.Pow(2, 4) ); // (2*2*2*2)=16

>> 16

Returns a random bool .

Returns: bool - Random bool either 0 or 1

Print( Math.RandomBool() );
Print( Math.RandomBool() );
Print( Math.RandomBool() );

>> true
>> true
>> false

Returns a random float number between and min[inclusive] and max[exclusive].

min

float Range starts [inclusive]

max

float Range ends [exclusive]

Returns: float - Random number in range

Print( Math.RandomFloat(0,1) );
Print( Math.RandomFloat(0,2) );

>> 0.597561
>> 1.936456

Returns a random float number between and min [inclusive] and max [inclusive].

Returns: float - Random number in range 0.0 .. 1.0

Print( Math.RandomFloat01() );	// 0.0 .. 1.0

>> 0.3
>> 1.0

Returns a random float number between and min [inclusive] and max [inclusive].

min

float Range starts [inclusive]

max

float Range ends [inclusive]

Returns: float - Random number in range

Print( Math.RandomFloatInclusive(0, 1) );	// 0.0 .. 1.0
Print( Math.RandomFloatInclusive(1, 2) );	// 1.0 .. 2.0

>> 0.3
>> 2.0

Returns a random int number between and min [inclusive] and max [exclusive].

min

int Range starts [inclusive]

max

int Range ends [exclusive]

Returns: int - Random number in range

Print( Math.RandomInt(0, 1) );	// only 0
Print( Math.RandomInt(0, 2) );	// 0 or 1

>> 0
>> 1

Returns a random int number between and min [inclusive] and max [inclusive].

min

int Range starts [inclusive]

max

int Range ends [inclusive]

Returns: int - Random number in range

Print( Math.RandomIntInclusive(0, 1) );	// 0 or 1
Print( Math.RandomIntInclusive(0, 2) );	// 0, 1, 2

>> 1
>> 2

Sets the seed for the random number generator.

seed

int New seed for the random number generator, -1 will use time

Returns: int - Returns new seed

Print( Math.Randomize(5) );

>> 5

Returns the floating-point remainder of x/y rounded to nearest

x

float Value of the quotient numerator

y

float Value of the quotient denominator

Returns: float - The remainder of dividing the arguments

Print( Math.RemainderFloat(5.3, 2) );
Print( Math.RemainderFloat(18.5, 4.2) );

>> -0.7
>> 1.7

Returns given value remaped from input range into output range

inputMin

float Minimal value of given input range

inputMax

float Maximal value of given input range

outputMin

float Minimal value of given output range

outputMax

float Maximal value of given output range

inputValue

float Value we want to remap

clampedOutput

bool If value should stay in that range, otherwise it will be extrapolated

Returns: float - Remapped value

Returns mathematical round of value

f

float Value

Returns: float - closest whole number to 'f'

Print( Math.Round(5.3) );
Print( Math.Round(5.8) );

>> 5
>> 6

Returns sign of given value

f

float Value

Returns: float - Sign of given value

Print( Math.SignFloat(-12.0) );
Print( Math.SignFloat(0.0) );
Print( Math.SignFloat(12.0) );

>> -1.0
>> 0
>> 1.0

Returns sign of given value

i

int Value

Returns: int - Sign of given value

Print( Math.SignInt(-12) );
Print( Math.SignInt(0) );
Print( Math.SignInt(12) );

>> -1
>> 0
>> 1

Returns sinus of angle in radians

angle

float Angle in radians

Returns: float - Sinus of angle

Print( Math.Sin(0.785398) ); // (45)

>> 0.707107

Does the CD smoothing function - easy in | easy out / S shaped smoothing

val

actual value

target

value we are reaching for -> Target

velocity

float[1] - array of ONE member - some kind of memory and actual accel/decel rate, need to be zeroed when filter is about to be reset

smoothTime

smoothing parameter, 0.1 .. 0.4 are resonable values, 0.1 is sharp, 0.4 is very smooth

maxVelocity

maximal value change when multiplied by dt

dt

delta time

Returns: float smoothed/filtered value

val = EnfMath.SmoothCD(val, varTarget, valVelocity, 0.3, 1000, dt);

Returns squared value

f

float Value

Returns: float - Squared value

Print( Math.SqrFloat(12.5) );

>> 156.25

Returns squared value

i

int Value

Returns: int - Squared value

Print( Math.SqrInt(12) );

>> 144

Returns square root

val

float Value

Returns: float - Square of value

Print( Math.Sqrt(25));

>> 5

Returns tangent of angle in radians

angle

float Angle in radians

Returns: float - Tangens of angle

Print( Math.Tan(0.785398) ); // (45)

>> 1

Returns if given vectors are equal with given tolerance

v1

float First vector for comparison

v2

float Second vector for comparison

tolerance

float Range in which given vectors can differ

Returns: bool - True if Vectors are equal; otherwise false

Returns wrap number to specified interval [min, max[

f

float Value

min

float Minimum

max

float Maximum

Returns: float - number in specified interval [min, max[

Print( Math.WrapFloat(9.0, 1.0, 9.0) );

>> 1.0

Returns wrap number to specified interval [0, max[

f

float Value

max

float Maximum

Returns: float - number in specified interval [0, max[

Print( Math.WrapFloat0X(9.0, 9.0) );

>> 0.0

Returns wrap number to specified interval, inclusive [0, max]

f

float Value

max

float Maximum

Returns: float - number in specified interval [0, max]

Print( Math.WrapFloat0XInclusive(9.0, 9.0) );

>> 9.0

Returns wrap number to specified interval, inclusive [min, max]

f

float Value

min

float Minimum

max

float Maximum

Returns: float - number in specified interval [min, max]

Print( Math.WrapFloatInclusive(9.0, 1.0, 9.0) );

>> 9.0

Returns wrap number to specified interval [min, max[

i

int Value

min

float Minimum

max

int Maximum

Returns: int - number in specified interval [min, max[

Print( Math.WrapInt(9, 1, 9) );

>> 1

Returns wrap number to specified interval [0, max[

i

int Value

max

int Maximum

Returns: int - number in specified interval [0, max[

Print( Math.WrapInt0X(9, 9) );

>> 0