Converts a GLLib Fixed Point number to a string in base 10.

Parameters:

	value	Fixed Point value to be converted.
	precision	Number or of decimals to print.

Returns:

String representaion of Fixed Point number in base 10

Arctangent.

Note:

this function will create a cache to speed up calculation if GLLibConfig.math_AtanUseCacheTable is set to true, but will also consume up to ((1<<math_fixedPointBase)+1)*4 byte

Parameters:

dx,dy

Slope of the angle.

Returns:

Arctangent of the slope.

Note:

This is not the real atan func as found in common device, it will return an angle in [0, 1] and not in [0, PI/2].

Arctangent, very slow but accurate method, it find angle by dichotomy.

Parameters:

dx,dy

Slope of the angle.

Returns:

Arctangent of the slope.

Note:

This is not the real atan func as found in common device, it will return an angle in [0, 1] and not in [0, PI/2].

Three control point 2D Bezier interpolation.

Parameters:

	x1,y1	First control point.
	x2,y2	Second control point.
	x3,y3	Third control point.
	interp	Interpolation value (ranges from 0 to s_math_F_1).

Returns:

Result returned in s_math_bezierX, s_math_bezierY.

Three control point 3D Bezier interpolation.

Parameters:

	x1,y1,z1	First control point.
	x2,y2,z2	Second control point.
	x3,y3,z3	Third control point.
	interp	Interpolation value (ranges from 0 to s_math_F_1).

Returns:

Result returned in s_math_bezierX, s_math_bezierY, s_math_bezierZ.

Cosinus.

Parameters:

angle

- angle in fixed point 0=0 (1<<math_angleFixedPointBase)=360.

Returns:

Cosinus value of the angle in fixed Point

Convert a degree angle into a fixed point angle.

Parameters:

an

angle in degrees.

Returns:

angle in fixed point.

Compute the determinant of 2 2Dvector.

Parameters:

	x1,y1	X & Y value of the first vector.
	x2,y2	X & Y value of the second vector.

Returns:

The determinant of the 2 vectors.

Compute the distance from a point to a segment/line.

Calculate coordinate of orthogonal projection of point on segment as well.

Parameters:

	(x0,y0)(x1,y1)	Coordinate of segment.
	(x2,y2)	Coordinate of point.

Returns:

Distance from point to segment (orthogonal projection) in fixed point.

Note:

Coordinates of projected point are saved in (s_Math_distPointLineX, s_Math_distPointLineY).

Divide by 10 a number, with result in fixed point.

Faster than classical division.

Parameters:

a

Number to divide by 10.

Returns:

Fixed point value of the number divided by 10.

Compute the dot product of 2 2Dvector.

Parameters:

	x1,y1	X & Y value of the first vector.
	x2,y2	X & Y value of the second vector.

Returns:

The dot product of the 2 vectors.

Addition for Fixed Point.

Parameters:

	summand1	Number to be added in Fixed Point.
	summand2	Number to be added in Fixed Point.

Returns:

Sum of summand1 and summand2 in Fixed Point.

Note:

An assert will indicate if the result overflows Integer.MAX_VALUE.

Convert an angle from degrees to fixed point angle.

Parameters:

angle

in degrees to be converted.

Returns:

angle in Fixed Point.

Convert an angle from degrees to radians (both fixed point and not, since this is just a ratio).

Parameters:

angle

in degrees to be converted into radians.

Returns:

angle in radians. (same precision as input param)

Compute the determinant of 2 2Dvector in Fixed Point.

Parameters:

	x1,y1	X & Y value of the first vector in Fixed Point.
	x2,y2	X & Y value of the second vector in Fixed Point.

Returns:

The determinant of the 2 vectors in Fixed Point.

Division for Fixed Point.

Parameters:

	dividend	Number to be divided in Fixed Point.
	divisor	Number to be divided by in Fixed Point.

Returns:

Quotient of dividend and divisor in Fixed Point.

Note:

An assert will indicate a division by zero.

Compute the dot product of 2 2Dvector in Fixed Point.

Parameters:

	x1,y1	X & Y value of the first vector in Fixed Point.
	x2,y2	X & Y value of the second vector in Fixed Point.

Returns:

The dot product of the 2 vectors in Fixed Point.

Find intersect points between a line and a circle.

Parameters:

	(in_x1,in_y1)	first point on the line.
	(in_x2,in_y2)	second point on the line.
	(in_circleX,in_circleY)	center coordinates of circle.
	(in_radius)	radius of the circle.

Returns:

MATH_INTERSECT_NO_INTERSECT if no intersect between line and circle. MATH_INTERSECT_ONE_POINT if only one intersect point between line and circle (Tangeant). MATH_INTERSECT_TWO_POINTS if two intersect ponts between line and circle.

Note:

Coordinates of intersection points are saved in the array s_Math_intersectPoints[][] First index indicates point: 0 = first point and 1 = second point Second index indicates x or y coordinate: 0 = x coordinate and 1 = y coordinate

Find intersect points between a line and a rectangle.

Parameters:

	(in_x1,in_y1)	first point on the line.
	(in_x2,in_y2)	second point on the line.
	(in_rectX,in_rectY)	coordinates of top-left corner of rectangle.
	(in_rectW,in_rectH)	Width and Height of rectangle.

Returns:

MATH_INTERSECT_NO_INTERSECT if no intersect between line and rectangle. MATH_INTERSECT_ONE_POINT if only one intersect point between line and rectangle . MATH_INTERSECT_TWO_POINTS if two intersect points between line and circle.

Note:

Coordinates of intersection points are saved in the array s_Math_intersectPoints[][] First index indicates point: 0 = first point and 1 = second point Second index indicates x or y coordinate: 0 = x coordinate and 1 = y coordinate

Multiplication for Fixed Point.

Parameters:

	multiplicand	Number to be mutiplied in Fixed Point.
	multiplier	Number to be multiplied by in Fixed Point.

Returns:

Product of multiplicand and multiplier in Fixed Point.

Note:

An assert will indicate if the result overflows Integer.MAX_VALUE.

Nnormal of a vector in Fixed Point.

Parameters:

x,y

X & Y value of the vector in Fixed Point.

Returns:

norm of vector (x,y).

Compute pow of the normal of a vector in Fixed Point.

Parameters:

x,y

X & Y value of the vector in Fixed Point.

Returns:

The pow of the normal of the vector in Fixed Point.

Note:

An assert will indicate if the result overflows Integer.MAX_VALUE.

Compute the distance from a point to a segment/line.

Calculate coordinate of orthogonal projection of point on segment as well.

Parameters:

	(in_lineX1,in_lineY1)(in_lineX2,in_lineY2)	Coordinate of segment.
	(in_pointX,in_pointY)	Coordinate of point.

Returns:

Distance from point to segment (orthogonal projection) in fixed point.

Note:

Coordinates of intersection points in fixed Point are saved in (s_Math_distPointLineX, s_Math_distPointLineY).

Convert an angle from radians to fixed point angle.

Parameters:

angle

in radians to be converted.

Returns:

angle in Fixed Point.

Convert an angle from radians to degrees (both fixed point and not, since this is just a ratio).

Parameters:

angle

in radians to be converted into degrees.

Returns:

angle in degress. (same precision as input param)

Rounds value to closest whole number in Fixed Point.

Parameters:

value

Value to be rounded in Fixed Point.

Returns:

Rounded value in Fixed Point.

Square Root for Long Fixed Point values.

Parameters:

value

Number to get square root of.

Returns:

Square root of val in Fixed Point.

Note:

Iterative process, precise but can be slow, use with caution.

Square Root for Integer Fixed Point values.

Parameters:

value

Number to get square root of.

Returns:

Square root of val in Fixed Point.

Note:

Iterative process, precise but can be slow, use with caution.

Square for Fixed Point.

Parameters:

value

Number to be squared in Fixed Point.

Returns:

Squared value in Fixed Point.

Subtraction for Fixed Point.

Parameters:

	minuend	Number to be subtracted from in Fixed Point.
	subtrahend	Number to be subtracted in Fixed Point.

Returns:

Difference of minuend and subtrahend in Fixed Point.

Note:

An assert will indicate if the result overflows Integer.MAX_VALUE.

Adjust a fixed point in base 8 to this fixed point base.

Parameters:

a

Value to adjsut.

Returns:

The value ajusted.

Convert a fixed point angle into a degree angle.

Parameters:

an

angle in fixed point.

Returns:

angle in degrees.

Convert a fixed point value to an int value.

Parameters:

a

Fixed point value to convert to int.

Returns:

Int value of a.

Math initialisation, by reading specified table from a package.

Parameters:

	packName	Name of the pack witch contains math table.
	cos	Index of cosine table in the pack. Use -1 if no table but all call to Math_Cos & Math_Sin will fail.
	sqrt	Index of sqrt table in the pack. Use -1 if no table but all call to Math_sqrt will fail.

Returns:

True if everything was loaded as requested.

Convert a fixed point value to an int value.

Parameters:

a

Value to convert to fixed point.

Returns:

Fixed point value of a.

return log base 2

Parameters:

a

value to calculate log base 2

Returns:

log base 2 of value

Norm following newton law approximation.

Sqrt(n) is provided by iteration of xk = (xk + n / xk) / 2. The more iteration (k++), the better is the approximation.

Parameters:

	x,y	X and Y coordinate of vector to get the norm from.
	iter	Number of iteration to perform, more iteration gives a better result however more iteration are more cpu intensive.

Returns:

norm of vector (x,y).

Compute pow of the normal of a vector.

Parameters:

x1,y1

X & Y value of the vector.

Returns:

The pow of the normal of the vector.

Quicksort an array of integer.

Parameters:

array

Array of data to sort.

Get an array of indice corresponding to the sorting of an array of data.

Example: data={12, 3, 8} return {1, 2, 0} so that data[1] <= data[2] <= data[0].

Parameters:

	data	Array of data to scale.
	nbItemPerValue	If data is an array of values, how many item are needed per value.
	itemNb	If data is an array of values, which item shoudl be considered for sorting.

Returns:

Array of indices, so that data[indices] are sorted.

Get an array of indice corresponding to the sorting of an array of data.

Example: data={12, 3, 8} return {1, 2, 0} so that data[1] <= data[2] <= data[0].

Parameters:

data

Array of data to scale.

Returns:

Array of indices, so that data[indices] are sorted.

Free all math arrays.

Create a random number.

Returns:

a random int.

Create a random int inside the interval [a, b[.

Parameters:

a,b

Interval for the random number to generate.

Returns:

A number between [a, b[.

Note:

if a=b then return value is a (or b)

set math random seed

Parameters:

seed

seed to use for random number generator.

Tell if 2 axis aligned rectangle intersect.

Parameters:

	(Ax0,Ay0)(Ax1,Ay1)	top left and bottom right coordinate of first rectangle
	(Bx0,By0)(Bx1,By1)	top left and bottom right coordinate of second rectangle

Returns:

true if intersect, false if not

Test 2 numbers to see if they are both of the same sign.

Parameters:

a,b

Numbers to compare.

Returns:

True if both numbers are positive.

True if both numbers are negative.

False Otherwise.

Tell if 2 segment intersect themselves.

Parameters:

	(x1,y1)(x2,y2)	Coordinate of first segment.
	(x3,y3)(x4,y4)	Coordinate of second segment.

Returns:

• MATH_SEGMENTINTERSECT_DO_INTERSECT if intersect.
• MATH_SEGMENTINTERSECT_DONT_INTERSECT if no intersection.
• MATH_SEGMENTINTERSECT_COLLINEAR if two segment are colinear (full or no intersection).

Note:

Coordinates of intersection point are saved in (s_Math_intersectX, s_Math_intersectY).

Warning:

This function can generate some Overflows if large value are used. Be carefull when using this code with FixedPoint values, the boundaries can change with the value of GLLibConfig.math_fixedPointBase.

Sinus.

Parameters:

a

Angle in fixed point 0=0 (1<<math_angleFixedPointBase)=360.

Returns:

Sinus value of the angle.

Square Root slow.

Parameters:

val

Number to get square root of.

Returns:

Square root of val.

Note:

long version is way slower than int function

Square Root.

Parameters:

x

Number to get square root of.

Returns:

Square root of x.

Note:

Integer Square Root function. Contributors include Arne Steinarson for the basic approximation idea, Dann Corbit and Mathew Hendry for the first cut at the algorithm, Lawrence Kirby for the rearrangement, improvments and range optimization, Paul Hsieh for the round-then-adjust idea, and Tim Tyler, for the Java port.

Square Root for Fixed Point.

Parameters:

	val	Number to get square root of.
	precisionLoop	Number of time to go through the algo to get good presicion in the result. Good value are [10-30] 15 is usualy good.

Returns:

Square root of val in Fixed Point.

Note:

Iterative process, can be slow, use with caution.

Tangent.

Parameters:

angle

- Angle in fixed point 0=0 256=360

Returns:

Tangent value of the angle.

180 in fixed point

270 in fixed point

360 in fixed point

90 in fixed point

angle fixed point multiplier eg one degree in fixed point base.(not equal to Math_DegreeToFixedPointAngle(1))

return value of Math_segmentIntersect if there is no or full intersection because both segment are colinear

return value of Math_segmentIntersect if there is an intersection

return value of Math_segmentIntersect if there is no intersection

x coordinate of bezier interpolated value through Math_Bezier2D or Math_Bezier3D

y coordinate of bezier interpolated value through Math_Bezier2D or Math_Bezier3D

z coordinate of bezier interpolated value through Math_Bezier3D

x coordinate of orthogonal projection of point on a segment using Math_distPointLine

y coordinate of orthogonal projection of point on a segment using Math_distPointLine

Fixed point value for number 0.5.

Fixed point value for number 1.

x coordinate of intersection point of 2 segment using Math_segmentIntersect

y coordinate of intersection point of 2 segment using Math_segmentIntersect

Random number generator.