G3*_PositionTest


C Specification

#include <nitro/gx/g3imm.h>
#include <nitro/gx/g3b.h>
#include <nitro/gx/g3c.h>

void G3_PositionTest(fx16 x, fx16 y, fx16 z);

// Below are APIs for creating the display list (command list) 
void G3BS_PositionTest(GXDLInfo * info, fx16 x, fx16 y, fx16 z);
void G3B_PositionTest(GXDLInfo * info, fx16 x, fx16 y, fx16 z);
void G3CS_PositionTest(GXDLInfo * info, fx16 x, fx16 y, fx16 z);
void G3C_PositionTest(GXDLInfo * info, fx16 x, fx16 y, fx16 z);

Description

This function converts the position coordinates according to the current clip coordinate matrix (matrix resulting from multiplying the current projection matrix by the current position coordinate matrix). The vector to be converted is set in x, y, and z. Results are obtained with G3X_GetPositionTestResult.

Arguments

x x-component of the test position coordinates
y y-component of the test position coordinates
z z-component of the test position coordinates

Return Values

None

See Also

G3_BoxTest, G3_VectorTest, G3X_GetPositionTestResult

Revision History

01/19/2004 Initial Version