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

   

gSPBgRectCopy

 Format 
gSPBgRectCopy(Gfx *gdl, uObjBg *bg)
gsSPBgRectCopy(uObjBg *bg)
 Arguments
  • gdl is the pointer to the display list
  • bg is the pointer to the drawing data structure uObjBg, which is the structure that holds the BG drawing information
What This Function Does
It is the simplest BG drawing GBI macro supplied by S2DEX. It has the following features and limitations:
  • Scale change (magnifying / shrinking) is not possible.
  • Scrolling in a closed region (making vertical / horizontal loop) is possible.
  • Horizontal texture flipping is possible (not vertical texture flipping).
  • Drawing is possible in copy mode only.
  • Texture interpolation display and subpixel movement are not possible.
  • Anti-aliasing is not possible.
This GBI macro loads the texture data from DRAM to TMEM as necessary, and then draws. It is designed for drawing in the copy mode. Its biggest advantage is that it has the fastest drawing speed. When using this macro, you must set CycleType to the Copy mode.

The S2DEX microcode can easily create vertical and horizontal scroll surfaces in a closed area (this function was included in the Super NES) by using this macro. Developing scroll games such as 2D Mario will be easier using this feature.

For more 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
gSPBgRect1Cyc


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