nds/arm9/postest.h File Reference

Position Test Functions.
The position test multiplies a given vector by the position matrix and returns the coords(x,y,z,w). The position test is really quick, about 10x faster than a box test. More...

#include <nds/arm9/video.h>
#include <nds/arm9/videoGL.h>

Functions
GL_STATIC_INL bool	PosTestBusy ()
	true if the hardware is currently performing a position/vertex/box test.
GL_STATIC_INL void	PosTest_Asynch (v16 x, v16 y, v16 z)
	Starts a position test asynchronously.
GL_STATIC_INL void	PosTest (v16 x, v16 y, v16 z)
	Performs a position test.
GL_STATIC_INL int32	PosTestWresult ()
	Returns the distance from the camera of the last position test, pretty darn useful.
GL_STATIC_INL int32	PosTestXresult ()
	Returns absolute X position of the last position test (location if the modelview matrix was identity).
GL_STATIC_INL int32	PosTestYresult ()
	Returns absolute Y position of the last position test (location if the modelview matrix was identity).
GL_STATIC_INL int32	PosTestZresult ()
	Returns absolute Z position of the last position test (location if the modelview matrix was identity).

---

Detailed Description

Position Test Functions.
The position test multiplies a given vector by the position matrix and returns the coords(x,y,z,w). The position test is really quick, about 10x faster than a box test.

---

Function Documentation

GL_STATIC_INL void PosTest	(	v16	x,
		v16	y,
		v16	z
	)

Performs a position test.

Parameters:

	x	specifies x offset from the current modelview matrix
	y	specifies y offset from the current modelview matrix
	z	specifies z offset from the current modelview matrix

                                                {
        PosTest_Asynch(x,y,z);
        while(PosTestBusy());
}

GL_STATIC_INL void PosTest_Asynch	(	v16	x,
		v16	y,
		v16	z
	)

Starts a position test asynchronously.

Parameters:

	x	specifies x offset from the current modelview matrix
	y	specifies y offset from the current modelview matrix
	z	specifies z offset from the current modelview matrix

                                                      {
        GFX_POS_TEST = VERTEX_PACK(x, y);
        GFX_POS_TEST = z;
}

GL_STATIC_INL bool PosTestBusy

(

)

true if the hardware is currently performing a position/vertex/box test.

Returns:

whether a test is being performed

                                 {
        return (GFX_STATUS & BIT(0))!=0;
}

GL_STATIC_INL int32 PosTestWresult

(

)

Returns the distance from the camera of the last position test, pretty darn useful.

Returns:

W magnitude

                                     {
        return GFX_POS_RESULT[3];
}

GL_STATIC_INL int32 PosTestXresult

(

)

Returns absolute X position of the last position test (location if the modelview matrix was identity).

Returns:

Absolute X position

                                     {
        return GFX_POS_RESULT[0];
}

GL_STATIC_INL int32 PosTestYresult

(

)

Returns absolute Y position of the last position test (location if the modelview matrix was identity).

Returns:

Absolute Y position

                                     {
        return GFX_POS_RESULT[1];
}

GL_STATIC_INL int32 PosTestZresult

(

)

Returns absolute Z position of the last position test (location if the modelview matrix was identity).

Returns:

Absolute Z position

                                     {
        return GFX_POS_RESULT[2];
}

---