math.h File Reference

hardware coprocessor math instructions. More...

#include <nds/ndstypes.h>

Macros
#define	f32tofloat(n)   (((float)(n)) / (float)(1 << 12))
	Convert f32 to float.
#define	f32toint(n)   ((n) / (1 << 12))
	Convert f32 to int.
#define	floattof32(n)   ((int)((n) * (1 << 12)))
	Convert float to f32.
#define	inttof32(n)   ((n) * (1 << 12))
	Convert int to f32.

Functions
ARM_CODE void	crossf32 (const int32_t *a, const int32_t *b, int32_t *result)
	20.12 fixed point cross product.
static int32_t	div32 (int32_t num, int32_t den)
	Integer divide.
static void	div32_asynch (int32_t num, int32_t den)
	Asynchronous integer divide start.
static int32_t	div32_result (void)
	Asynchronous integer divide result.
static int32_t	div64 (int64_t num, int32_t den)
	Integer 64 bit divide.
static void	div64_asynch (int64_t num, int32_t den)
	Asynchronous integer 64 bit divide start.
static int32_t	div64_result (void)
	Asynchronous integer 64 bit divide result.
static int32_t	divf32 (int32_t num, int32_t den)
	Fixed point divide.
static void	divf32_asynch (int32_t num, int32_t den)
	Asynchronous fixed point divide start.
static int32_t	divf32_result (void)
	Asynchronous fixed point divide result.
static int32_t	dotf32 (int32_t *a, int32_t *b)
	20.12 fixed point dot product.
ARM_CODE float	hw_sqrtf (float x)
	32-bit floating point sqrt
static int32_t	mod32 (int32_t num, int32_t den)
	Integer modulo.
static void	mod32_asynch (int32_t num, int32_t den)
	Asynchronous integer modulo start.
static int32_t	mod32_result (void)
	Asynchronous integer modulo result.
static int32_t	mod64 (int64_t num, int32_t den)
	Integer 64 bit modulo.
static void	mod64_asynch (int64_t num, int32_t den)
	Asynchronous integer 64 bit modulo start.
static int32_t	mod64_result (void)
	Asynchronous integer 64 bit modulo result.
static int32_t	mulf32 (int32_t a, int32_t b)
	Fixed point multiply.
ARM_CODE void	normalizef32 (int32_t *a)
	20.12 fixed point normalize (set magnitude to 1.0 and keep the direction).
static uint32_t	sqrt32 (uint32_t a)
	32-bit integer sqrt.
static void	sqrt32_asynch (uint32_t a)
	Asynchronous 32-bit integer sqrt start.
static uint32_t	sqrt32_result (void)
	Asynchronous 32-bit integer sqrt result.
static uint32_t	sqrt64 (uint64_t a)
	64-bit integer sqrt.
static void	sqrt64_asynch (uint64_t a)
	Asynchronous 64-bit integer sqrt start.
static uint32_t	sqrt64_result (void)
	Asynchronous 64-bit integer sqrt result.
static uint32_t	sqrtf32 (uint32_t a)
	Fixed point sqrt.
static void	sqrtf32_asynch (uint32_t a)
	Asynchronous fixed point sqrt start.
static uint32_t	sqrtf32_result (void)
	Asynchronous fixed point sqrt result.

Detailed Description

hardware coprocessor math instructions.

Warning

Only one type of sqrt and one type of division can be used concurrently.

Function Documentation

crossf32()

ARM_CODE void crossf32	(	const int32_t *	a,
		const int32_t *	b,
		int32_t *	result
	)

20.12 fixed point cross product.

Cross product:

result = A x B

x = Ay * Bz - By * Az
y = Az * Bx - Bz * Ax
z = Ax * By - Bx * Ay

Parameters

a	Pointer to fixed 3 dimensions vector.
b	Pointer to fixed 3 dimensions vector.
result	Pointer to fixed 3 dimensions vector that will contain the result.

div32()

static int32_t div32 ( int32_t  num, int32_t  den  )

inlinestatic

Integer divide.

Parameters

num	Numerator.
den	Denominator.

Returns

32 bit integer result.

div32_asynch()

static void div32_asynch ( int32_t  num, int32_t  den  )

inlinestatic

Asynchronous integer divide start.

Parameters

num	Numerator.
den	Denominator.

div32_result()

static int32_t div32_result ( void  )

inlinestatic

Asynchronous integer divide result.

Returns

32 bit integer result.

div64()

static int32_t div64 ( int64_t  num, int32_t  den  )

inlinestatic

Integer 64 bit divide.

Parameters

num	64 bit numerator.
den	32 bit denominator.

Returns

32 bit integer result.

div64_asynch()

static void div64_asynch ( int64_t  num, int32_t  den  )

inlinestatic

Asynchronous integer 64 bit divide start.

Parameters

num	64 bit numerator.
den	32 bit denominator.

div64_result()

static int32_t div64_result ( void  )

inlinestatic

Asynchronous integer 64 bit divide result.

Returns

32 bit integer result.

divf32()

static int32_t divf32 ( int32_t  num, int32_t  den  )

inlinestatic

Fixed point divide.

Parameters

num	20.12 numerator.
den	20.12 denominator.

Returns

Returns 20.12 result.

divf32_asynch()

static void divf32_asynch ( int32_t  num, int32_t  den  )

inlinestatic

Asynchronous fixed point divide start.

Parameters

num	20.12 numerator.
den	20.12 denominator.

divf32_result()

static int32_t divf32_result ( void  )

inlinestatic

Asynchronous fixed point divide result.

Returns

Returns 20.12 result.

dotf32()

static int32_t dotf32 ( int32_t *  a, int32_t *  b  )

inlinestatic

20.12 fixed point dot product.

Dot Product:

Result = Ax * Bx + Ay * By + Az * Bz

Parameters

a	Pointer to fixed 3 dimensions vector.
b	Pointer to fixed 3 dimensions vector.

Returns

32 bit integer result

hw_sqrtf()

ARM_CODE float hw_sqrtf

(

float

x

)

32-bit floating point sqrt

Warning

Not safe to call inside an interrupt handler.

Parameters

x	Valid 32 bit non-negative floating point value.

Returns

32 bit floating point value

mod32()

static int32_t mod32 ( int32_t  num, int32_t  den  )

inlinestatic

Integer modulo.

Parameters

num	Numerator.
den	Denominator.

Returns

32 bit integer remainder.

mod32_asynch()

static void mod32_asynch ( int32_t  num, int32_t  den  )

inlinestatic

Asynchronous integer modulo start.

Parameters

num	Numerator.
den	Denominator.

mod32_result()

static int32_t mod32_result ( void  )

inlinestatic

Asynchronous integer modulo result.

Returns

32 bit integer remainder.

mod64()

static int32_t mod64 ( int64_t  num, int32_t  den  )

inlinestatic

Integer 64 bit modulo.

Parameters

num	64 bit numerator.
den	32 bit denominator.

Returns

Returns 32 bit integer remainder.

mod64_asynch()

static void mod64_asynch ( int64_t  num, int32_t  den  )

inlinestatic

Asynchronous integer 64 bit modulo start.

Parameters

num	64 bit numerator.
den	32 bit denominator.

mod64_result()

static int32_t mod64_result ( void  )

inlinestatic

Asynchronous integer 64 bit modulo result.

Returns

Returns 32 bit integer remainder.

mulf32()

static int32_t mulf32 ( int32_t  a, int32_t  b  )

inlinestatic

Fixed point multiply.

Parameters

a	20.12 value.
b	20.12 value.

Returns

Returns 20.12 result.

normalizef32()

ARM_CODE void normalizef32

(

int32_t *

a

)

20.12 fixed point normalize (set magnitude to 1.0 and keep the direction).

Warning

This function uses both div and sqrt accelerators

Parameters

a	Pointer to the vector to normalize.

sqrt32()

static uint32_t sqrt32 ( uint32_t  a )

inlinestatic

32-bit integer sqrt.

Parameters

a	32 bit positive integer value.

Returns

32 bit integer result.

sqrt32_asynch()

static void sqrt32_asynch ( uint32_t  a )

inlinestatic

Asynchronous 32-bit integer sqrt start.

Parameters

a	32 bit positive integer value.

sqrt32_result()

static uint32_t sqrt32_result ( void  )

inlinestatic

Asynchronous 32-bit integer sqrt result.

Returns

32 bit integer result.

sqrt64()

static uint32_t sqrt64 ( uint64_t  a )

inlinestatic

64-bit integer sqrt.

Parameters

a	64 bit positive integer value.

Returns

32 bit integer result.

sqrt64_asynch()

static void sqrt64_asynch ( uint64_t  a )

inlinestatic

Asynchronous 64-bit integer sqrt start.

Parameters

a	64 bit positive integer value.

sqrt64_result()

static uint32_t sqrt64_result ( void  )

inlinestatic

Asynchronous 64-bit integer sqrt result.

Returns

32 bit integer result.

sqrtf32()

static uint32_t sqrtf32 ( uint32_t  a )

inlinestatic

Fixed point sqrt.

Parameters

a	20.12 positive value.

Returns

20.12 result.

sqrtf32_asynch()

static void sqrtf32_asynch ( uint32_t  a )

inlinestatic

Asynchronous fixed point sqrt start.

Parameters

a	20.12 positive value.

sqrtf32_result()

static uint32_t sqrtf32_result ( void  )

inlinestatic

Asynchronous fixed point sqrt result.

Returns

20.12 result.