Maths (MobileDesigner)

java.lang.Object
- com.softwareag.mobile.runtime.utility.Maths

```
public class Maths
extends java.lang.Object
```
High level Fixed Point maths library.
Includes:
- Fixed point conversion and manipulation code
- Square- / cube-roots
- Basic trig functions

Field Summary

Fields
Modifier and Type Field and Description

static int FPI
Fixed point value of PI

Fields
Modifier and Type	Field and Description
`static int`	`FPI` Fixed point value of PI

Constructor Summary

Constructors
Constructor and Description

Maths()

Constructors
Constructor and Description
`Maths()`

Method Summary

Methods
Modifier and Type	Method and Description
`static int`	`cbrt(int i)` Performs a standard integer cube root
`static int`	`Fcbrt(int Fi)` Performs a Fixed point cube root
`static int`	`Fcos(int Frad)` Trig function, taking Fixed Point radians, and returning Fixed Point values.
`static int`	`FcosFromFDeg(int Fdeg)` Fixed point cos from Fixed point degrees
`static int`	`FcosFromiDeg(int deg)` Fixed point cos from integer degrees
`static int`	`FdegToFRad(int Fdeg)` Converts Fixed point degrees to Fixed point radians
`static int`	`Fdiv(int Fi, int Fj)` Fixed point divide.
`static int`	`Fmul(int Fi, int Fj)` Fixed point multiply.
`static long`	`FmulToLong(int Fi, int Fj)` Fixed point multiply (using and returning longs)
`static int`	`FradToFDeg(int Frad)` Converts Fixed point radians to Fixed point degrees
`static int`	`FradToiDeg(int Frad)` Converts Fixed point radians to integer degrees
`static int`	`Fsin(int Frad)` Trig function, taking Fixed Point radians, and returning Fixed Point values.
`static int`	`FsinFromFDeg(int Fdeg)` Fixed point sin from Fixed point degrees
`static int`	`FsinFromiDeg(int deg)` Fixed point sin from integer degrees
`static int`	`Fsqrt(int Fi)` Performs a Fixed point squareroot
`static int`	`FToi(int Fi)` Converts Fixed point to integers (no nearest integer rounding)
`static int`	`FToiNearest(int Fi)` Converts Fixed point to integers (includes nearest integer rounding)
`static int`	`idegToFRad(int deg)` Converts integer degrees to Fixed point radians
`static int`	`iToF(int i)` Converts integers to Fixed point
`static int`	`random(int r)` Standard random number generator implementation - returns a value inclusively between 0 and (r - 1)
`static void`	`setRandomNumberSeed(long seed)` Sets the seed for the random number generator.
`static int`	`sqrt(int i)` Performs a standard integer squareroot
`static int`	`vectorToFDeg(int x, int y)` Fixed point degrees from an x/y vector
`static int`	`vectorToFRad(int x, int y)` Returns a value from -FPI to FPI to describe the angle of this x/y vector : 0,1 returs 0 radians; 1,0 returns FPI/2.
`static int`	`vectorToiDeg(int x, int y)` Integer degrees from an x/y vector

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

- Field Detail
  - FPI
```
public static final int FPI
```
    Fixed point value of PI
    
    See Also:
    Constant Field Values
- Constructor Detail
  - Maths
```
public Maths()
```
- Method Detail
  - iToF
```
public static int iToF(int i)
```
    Converts integers to Fixed point
  - FToi
```
public static int FToi(int Fi)
```
    Converts Fixed point to integers (no nearest integer rounding)
  - FToiNearest
```
public static int FToiNearest(int Fi)
```
    Converts Fixed point to integers (includes nearest integer rounding)
  - FmulToLong
```
public static long FmulToLong(int Fi,
              int Fj)
```
    Fixed point multiply (using and returning longs)
  - Fmul
```
public static int Fmul(int Fi,
       int Fj)
```
    Fixed point multiply. Depending on the value of PARAM_MD_MATHS_FP_PRECISION this may be slow/fast, and accurate/inaccurate with regards to over- and under-flows
  - Fdiv
```
public static int Fdiv(int Fi,
       int Fj)
```
    Fixed point divide. Depending on the value of PARAM_MD_MATHS_FP_PRECISION this may be slow/fast, and accurate/inaccurate with regards to over- and under-flows
  - sqrt
```
public static int sqrt(int i)
```
    Performs a standard integer squareroot
  - Fsqrt
```
public static int Fsqrt(int Fi)
```
    Performs a Fixed point squareroot
  - cbrt
```
public static int cbrt(int i)
```
    Performs a standard integer cube root
  - Fcbrt
```
public static int Fcbrt(int Fi)
```
    Performs a Fixed point cube root
  - FdegToFRad
```
public static int FdegToFRad(int Fdeg)
```
    Converts Fixed point degrees to Fixed point radians
  - FradToFDeg
```
public static int FradToFDeg(int Frad)
```
    Converts Fixed point radians to Fixed point degrees
  - idegToFRad
```
public static int idegToFRad(int deg)
```
    Converts integer degrees to Fixed point radians
  - FradToiDeg
```
public static int FradToiDeg(int Frad)
```
    Converts Fixed point radians to integer degrees
  - Fsin
```
public static int Fsin(int Frad)
```
    Trig function, taking Fixed Point radians, and returning Fixed Point values.
    Uses expansion: sin = 0 + (i) / (1!) - (i ^ 3) / (3!) + (i ^ 5) / (5!) - ...
    Max error: FP (1 / 650), Avg error: FP (1 / 2375)
    (Note: Because of internal cubic calculations, this won't work as is with Parameters.PARAM_MD_MATHS_FP_SHIFT greater than 10)
  - Fcos
```
public static int Fcos(int Frad)
```
    Trig function, taking Fixed Point radians, and returning Fixed Point values.
    Uses expansion: cos = 1 - (i ^ 2) / (2!) + (i ^ 4) / (4!) - ...
    Max error: FP (1 / 650), Avg error: FP (1 / 2375)
    (Note: Because of internal cubic calculations, this won't work as is with Parameters.PARAM_MD_MATHS_FP_SHIFT greater than 10)
  - vectorToFRad
```
public static int vectorToFRad(int x,
               int y)
```
    Returns a value from -FPI to FPI to describe the angle of this x/y vector : 0,1 returs 0 radians; 1,0 returns FPI/2.
    Uses expansion: arcsin = i + (1) * (i ^ 3) / ((2) * 3) + (1 * 3) * (i ^ 5) / ((2 * 4) * 5) + (1 * 3 * 5) * (i ^ 7) / ((2 * 4 * 6) * 7) + ...
    (Uses arcsin instead of arctan as the expansion for arcsin converges quicker at larger angles)
    Max error: FP (1 / 300) radians, Avg error: FP (1 / 850) radians
    (Note: Because of internal cubic calculations, this won't work as is with Parameters.PARAM_MD_MATHS_FP_SHIFT greater than 10)
  - FsinFromFDeg
```
public static int FsinFromFDeg(int Fdeg)
```
    Fixed point sin from Fixed point degrees
  - FsinFromiDeg
```
public static int FsinFromiDeg(int deg)
```
    Fixed point sin from integer degrees
  - FcosFromFDeg
```
public static int FcosFromFDeg(int Fdeg)
```
    Fixed point cos from Fixed point degrees
  - FcosFromiDeg
```
public static int FcosFromiDeg(int deg)
```
    Fixed point cos from integer degrees
  - vectorToFDeg
```
public static int vectorToFDeg(int x,
               int y)
```
    Fixed point degrees from an x/y vector
  - vectorToiDeg
```
public static int vectorToiDeg(int x,
               int y)
```
    Integer degrees from an x/y vector
  - setRandomNumberSeed
```
public static void setRandomNumberSeed(long seed)
```
    Sets the seed for the random number generator.
    However, please do note that random_seed is public - you don't really need a setter...
  - random
```
public static int random(int r)
```
    Standard random number generator implementation - returns a value inclusively between 0 and (r - 1)

Class Maths

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

FPI

Constructor Detail

Maths

Method Detail

iToF

FToi

FToiNearest

FmulToLong

Fmul

Fdiv

sqrt

Fsqrt

cbrt

Fcbrt

FdegToFRad

FradToFDeg

idegToFRad

FradToiDeg

Fsin

Fcos

vectorToFRad

FsinFromFDeg

FsinFromiDeg

FcosFromFDeg

FcosFromiDeg

vectorToFDeg

vectorToiDeg

setRandomNumberSeed

random