N64® Functions Menu

al - Audio Library Functions
gDP - DP GBI Macros
gdSP - General GBI Macros
gSP - SP GBI Macros
gt - Turbo Microcode RDP
gu - Graphics Utilities
Math - Math Functions
nuSys - NuSystem
os - N64 Operating System
sp - Sprite Library Functions
uh - Host to Target IO
64DD - N64 Disk Drive

Nintendo® Confidential

   

gSPObjSubMatrix

Format
gSPObjSubMatrix(Gfx *gdl, uObjMtx *mtx)
gsSPObjSubMatrix(uObjMtx *mtx)
Arguments
  • gdl is the pointer to the display list
  • mtx is the pointer to the 2D matrix structure
What This Macro Does
It is an S2DEX microcode macro that loads the data in the uObjSubMtx structure to the 2D matrix region of the RSP. However, the uObjSubMtx structure is a subset of uObjMtx, and holds the values of 2D matrix elements {X, Y, BaseScaleX, BaseScaleY} used by gSPObjRectangleR.

This macro changes the 2D matrix elements {X, Y, BaseScaleX, BaseScaleY} that correspond to the variable members of uObjSubMtx structure only; it does not affect the values in {A, B, C, D}. This macro is used mainly in conjunction with gSPObjRectangleR.

The S2DEX microcode uses a 2D matrix to hold the drawing data. This macro is one of the following two macros provided for the purpose of modifying this 2D matrix:
  • gSPObjMatrix
  • gSPObjSubMatrix
For detailed information on S2DEX microcode GBI macros and data structures, please see the "S2DEX Microcode" area of the N64 Programming Manual.

See Also
S2DEX Microcode
guS2DInitBg


Nintendo® Confidential

Warning: all information in this document is confidential and covered by a non-disclosure agreement. You are responsible for keeping this information confidential and protected. Nintendo will vigorously enforce this responsibility.


Copyright © 1998
Nintendo of America Inc. All rights reserved
Nintendo and N64 are registered trademarks of Nintendo
Last updated January 1998