G3*_PopMtx

Syntax

#include <nitro/gx/g3imm.h>
#include <nitro/gx/g3b.h>
#include <nitro/gx/g3c.h>

void G3_PopMtx(int num);

// Below are APIs for creating the display list (command list)
void G3B_PopMtx(GXDLInfo* info, int num);
void G3C_PopMtx(GXDLInfo* info, int num);
void G3BS_PopMtx(GXDLInfo* info, int num);
void G3CS_PopMtx(GXDLInfo* info, int num);

Arguments

info Command List Information.
num Pop number

Return Values

None.

Description

This function pops the current matrix from the stack. num specifies the pop number and takes a value between -30 to 31. The numth 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 Projection, there is only one level in the stack, so num is reset to 1 regardless of the value. You can use the G3X_IsMtxStackOverflow 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 G3X_GetMtxStackLevelPV or G3X_GetMtxStackLevelPJ function.

See Also

G3*_MtxMode, G3*_Identity, G3*_LoadMtx43, G3*_LoadMtx44, G3*_MultMtx43, G3*_MultMtx44, G3*_MultMtx33, G3*_PushMtx, G3*_StoreMtx, G3*_RestoreMtx, G3*_Scale, G3*_Translate

Revision History

2004/01/19 Initial version.


CONFIDENTIAL