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 8.0.0.0 for Windows">
7<META http-equiv="Content-Style-Type" content="text/css">
8<title>G3*_RestoreMatrix</title>
9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
10</head>
11
12<body>
13
14<h1 align="left">G3*_RestoreMtx <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_RestoreMtx( u32 num );
24
25// Below are APIs for creating the display list (command list)<BR>void G3B_RestoreMtx(<A href="../gx/GXDLInfo.html">GXDLInfo</A>* info, int num);<BR>void G3C_RestoreMtx(<A href="../gx/GXDLInfo.html">GXDLInfo</A>* info, int num);<BR>void G3BS_RestoreMtx(<A href="../gx/GXDLInfo.html">GXDLInfo</A>* info, int num);<BR>void G3CS_RestoreMtx(<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%">Matrix stack index (0-30, the projection matrix is always 0)</td>
37  </tr>
38</table>
39<h2>Return Values</h2>
40<p>None.</p>
41<H2>Description</H2>
42<P>This reads the matrix from the specified position of the stack. The value of <em><strong><code>num</code></strong></em> from the matrix stack is set up as the specified matrix in matrix mode. When the matrix mode is set to Projection, there is only one level in the stack, so <em><strong><code>num</code></strong></em> is reset to 0 regardless of the value. This command does not change the coordinate stack pointer that is moved by either the <CODE><A href="G3_PushMtx.html">G3*_PushMtx</A></CODE> or <CODE><A href="G3_PopMtx.html">G3*_PopMtx</A></CODE> command.<BR>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.</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_PopMtx.html" target="_self">G3*_PopMtx</a>, <a href="G3_StoreMtx.html" target="_self">G3*_StoreMtx</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