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_StoreMtx</title>
9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
10</head>
11
12<body>
13
14<h1 align="left">G3*_StoreMtx <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_StoreMtx(u32 num);</CODE>
24
25// Below are APIs for creating the display list (command list)<BR><CODE>void G3B_StoreMtx(<A href="../gx/GXDLInfo.html">GXDLInfo</A>* info, u32 num);</CODE><BR><CODE>void G3C_StoreMtx(<A href="../gx/GXDLInfo.html">GXDLInfo</A>* info, u32 num);</CODE><BR><CODE>void G3BS_StoreMtx(<A href="../gx/GXDLInfo.html">GXDLInfo</A>* info, u32 num);</CODE><BR><CODE>void G3CS_StoreMtx(<A href="../gx/GXDLInfo.html">GXDLInfo</A>* info, u32 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 stores the current matrix in the specified position in the stack. </I></B>num</I></B> is that position, and values that are unsigned integers (integer portion of 5 bits) from 0-30 can be set up. 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_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