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*_PushMtx</title> 9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css"> 10</head> 11 12<body> 13 14<h1 align="left">G3*_PushMtx <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 <nitro/gx/g3imm.h> 20#include <nitro/gx/g3b.h> 21#include <nitro/gx/g3c.h> 22 23void G3_PushMtx();</CODE> 24 25// Below are APIs for creating the display list (command list)<BR><CODE>void G3B_PushMtx(<A href="../gx/GXDLInfo.html">GXDLInfo</A>* info);</CODE><BR><CODE>void G3C_PushMtx(<A href="../gx/GXDLInfo.html">GXDLInfo</A>* info);</CODE><BR><CODE>void G3BS_PushMtx(<A href="../gx/GXDLInfo.html">GXDLInfo</A>* info);</CODE><BR><CODE>void G3CS_PushMtx(<A href="../gx/GXDLInfo.html">GXDLInfo</A>* info);</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 </table> 35<h2>Return Values</h2> 36<p>None.</p> 37<H2>Description</H2> 38<P>This function pushes the current matrix onto the stack. 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. You can use the <CODE><A href="G3X_IsMtxStackOverflow.html">G3X_IsMtxStackOverflow</A></CODE> function to check whether the push operation caused a matrix stack overflow.<BR><BR> The current matrix stack level can be retrieved with the <A href="G3X_GetMtxStackLevelPV.html"><code>G3X_GetMtxStackLevelPV</code></A> or <A href="G3X_GetMtxStackLevelPJ.html"><code>G3X_GetMtxStackLevelPJ</code></A> functions.</P> 39<h2>See Also</h2> 40<P><CODE><A href="G3_MtxMode.html" target="_self">G3*_MtxMode</A><BR> <A href="G3_Identity.html" target="_self">G3*_Identity</A><BR> <A href="G3_LoadMtx43.html" target="_self">G3*_LoadMtx43</A><BR> <A href="G3_LoadMtx44.html" target="_self">G3*_LoadMtx44</A><BR> <A href="G3_MultMtx43.html" target="_self">G3*_MultMtx43</A><BR> <A href="G3_MultMtx44.html" target="_self">G3*_MultMtx44</A><BR> <A href="G3_MultMtx33.html" target="_self">G3*_MultMtx33</A><BR> <A href="G3_PopMtx.html" target="_self">G3*_PopMtx</A><BR> <A href="G3_StoreMtx.html" target="_self">G3*_StoreMtx</A><BR> <A href="G3_RestoreMtx.html" target="_self">G3*_RestoreMtx</A><BR> <A href="G3_Scale.html" target="_self">G3*_Scale</A><BR> <A href="G3_Translate.html" target="_self">G3*_Translate</A></CODE></P> 41<H2>Revision History</H2> 42<P>2004/01/19 Initial version.</P> 43<hr><p>CONFIDENTIAL</p></body> 44</html> 45
