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

   

gSPObjLoadTxRectR

Format
gSPObjLoadTxRectR(Gfx *gdl, uObjTxSprite *txsp)
gsSPObjLoadTxRectR(uObjTxSprite *txsp)
Arguments
  • gdl is the pointer to the display list
  • txsp is the pointer to the UObjTxSprite structure that holds the texture loading and sprite drawing data
What This Macro Does
It is one of the three compound-processing macros that are part of the S2DEX microcode. It performs the texture load operation and then draws a non-rotating sprite by referencing a 2D matrix. Essentially, this command performs the work of two macros (gSPObjLoadTxtr and gSPObjRectangleR) with one macro.

In actual game development, combining the texture loading macro with the appropriate sprite drawing macro is sometimes advantageous for controlling sprites. The S2DEX microcode provides a way to do this with three compound-processing macros:
  • gSPObjLoadTxRect
  • gSPObjLoadTxRectR
  • gSPObjLoadTxSprite
These three macros use the uObjTxSprite data structure, which has been constructed by combining the uObjTxtr structure with the uObjSprite structure. The pointer to the uObjTxSprite structure is given to the macro as an argument. For more information about these data structures, this macro, and the S2DEX microcode, please see the "S2DEX Microcode" section 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