G3_PositionTest

# 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