1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html>
3
4<head>
5<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
6<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 7.0.0.0 for Windows">
7<META http-equiv="Content-Style-Type" content="text/css">
8<title>G3_PositionTest</title>
9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
10</head>
11
12<body>
13
14<h1 align="left">G3*_PositionTest <img src="../../image/NTR.gif"align="middle"><img src="../../image/TWL.gif" align="middle"></H1>
15<H2>Syntax</H2>
16
17<dl>
18  <dd>
19<PRE><CODE>#include &lt;nitro/gx/g3imm.h&gt;
20#include &lt;nitro/gx/g3b.h&gt;
21#include &lt;nitro/gx/g3c.h&gt;
22
23void G3_PositionTest(fx16 x, fx16 y, fx16 z);
24
25// Below are APIs for creating the display list (command list):
26void G3BS_PositionTest(<A href="../gx/GXDLInfo.html">GXDLInfo</A> * info, fx16 x, fx16 y, fx16 z);
27void G3B_PositionTest(<A href="../gx/GXDLInfo.html">GXDLInfo</A> * info, fx16 x, fx16 y, fx16 z);
28void G3CS_PositionTest(<A href="../gx/GXDLInfo.html">GXDLInfo</A> * info, fx16 x, fx16 y, fx16 z);
29void G3C_PositionTest(<A href="../gx/GXDLInfo.html">GXDLInfo</A> * info, fx16 x, fx16 y, fx16 z);<BR></CODE></PRE>
30  </dd>
31</dl><h2>Arguments</h2>
32<TABLE border="1" width="100%">
33  <TBODY>
34    <TR>
35      <TD width="13%"><em><strong><font face="Courier New">info</font></strong></em></TD>
36      <TD width="87%">Command List Information.</TD>
37    </TR>
38    <TR>
39      <TD width="128"><em><strong><font face="Courier New">x</font></strong></em></TD>
40      <TD width="567">x-component of the test position coordinates</TD>
41    </TR>
42    <TR>
43      <TD><em><strong><font face="Courier New">y</font></strong></em></TD>
44      <TD>y-component of the test position coordinates</TD>
45    </TR>
46    <TR>
47      <TD><em><strong><font face="Courier New">z</font></strong></em></TD>
48      <TD>z-component of the test position coordinates</TD>
49    </TR>
50  </TBODY>
51</TABLE>
52<h2>Return Values</h2>
53<p>None.</p>
54<H2>Description</H2>
55<P>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 modify is set with <em><strong>x</strong></em>,<em><strong>y</strong></em>,<em><strong>z</strong></em>. Results are obtained with the <CODE><A href="G3X_GetPositionTestResult.html">G3X_GetPositionTestResult</A></CODE> function.</P>
56<h2>See Also</h2>
57<P><CODE><A href="G3_BoxTest.html">G3_BoxTest</A>, <A href="G3_VectorTest.html">G3_VectorTest</A>, <A href="G3X_GetPositionTestResult.html">G3X_GetPositionTestResult</A></CODE></P>
58<H2>Revision History</H2>
59<P>2004/01/19 Initial version.</P>
60<hr><p>CONFIDENTIAL</p></body>
61</html>
62