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*_PopMatrix</title>
9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
10</head>
11
12<body>
13
14<h1 align="left">G3*_PopMtx <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_PopMtx(int num);
24
25// Below are APIs for creating the display list (command list)<BR>void G3B_PopMtx(<A href="../gx/GXDLInfo.html">GXDLInfo</A>* info, int num);<BR>void G3C_PopMtx(<A href="../gx/GXDLInfo.html">GXDLInfo</A>* info, int num);<BR>void G3BS_PopMtx(<A href="../gx/GXDLInfo.html">GXDLInfo</A>* info, int num);<BR>void G3CS_PopMtx(<A href="../gx/GXDLInfo.html">GXDLInfo</A>* info, int num);</CODE></PRE>
26  </dd>
27</dl><h2>Arguments</h2>
28
29<table border="1" width="100%">
30  <tr>
31    <td width="13%"><em><strong><font face="Courier New">info</font></strong></em></td>
32    <td width="87%">Command List Information.</td>
33  </tr>
34  <tr>
35    <td width="13%"><em><strong><font face="Courier New">num</font></strong></em></td>
36    <td width="87%">Pop number</td>
37  </tr>
38</table>
39<h2>Return Values</h2>
40<p>None.</p>
41<H2>Description</H2>
42<P>This function pops the current matrix from the stack. <code>num</code> specifies the pop number and takes a value between -30 to 31. The <em><strong><code>num</code></strong></em>th matrix from the stack point in the matrix stack specified in matrix mode is popped and set as the current matrix. When the matrix mode is set to <code>Projection</code>, there is only one level in the stack, so <em><strong><code>num</code></strong></em> is reset to <code>1</code> regardless of the value. You can use the <CODE><A href="G3X_IsMtxStackOverflow.html">G3X_IsMtxStackOverflow</A></CODE> function to check whether the pop operation caused a matrix stack underflow. However, because the position coordinate matrix stack and the directional vector matrix are connected, operations are performed on both stacks when the matrix mode is set to either Position or Position-Vector simultaneous set mode. The current matrix stack level can be obtained with the <A href="G3X_GetMtxStackLevelPV.html"><code>G3X_GetMtxStackLevelPV</code></A> or <A href="G3X_GetMtxStackLevelPJ.html"><code>G3X_GetMtxStackLevelPJ</code></A> function.</P>
43<h2>See Also</h2>
44<P><CODE><A href="G3_MtxMode.html" target="_self">G3*_MtxMode</A>, <A href="G3_Identity.html" target="_self">G3*_Identity</A>, <A href="G3_LoadMtx43.html" target="_self">G3*_LoadMtx43</A>, <A href="G3_LoadMtx44.html" target="_self">G3*_LoadMtx44</A>, <A href="G3_MultMtx43.html" target="_self">G3*_MultMtx43</A>, <A href="G3_MultMtx44.html" target="_self">G3*_MultMtx44</A>, <A href="G3_MultMtx33.html" target="_self">G3*_MultMtx33</A>, <A href="G3_PushMtx.html" target="_self">G3*_PushMtx</A>, <A href="G3_StoreMtx.html" target="_self">G3*_StoreMtx</A>, <A href="G3_RestoreMtx.html" target="_self">G3*_RestoreMtx</A>, <A href="G3_Scale.html" target="_self">G3*_Scale</A>, <A href="G3_Translate.html" target="_self">G3*_Translate</A></CODE></P>
45<H2>Revision History</H2>
46<P>2004/01/19 Initial version.</P>
47<hr><p>CONFIDENTIAL</p></body>
48</html>
49