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





gSPDisplayList

Syntax
#include <ultra64.h>/* gbi.h */
gSPDisplayList(Gfx *gdl, Gfx *dl)
gsSPDisplayList(Gfx *dl)

Arguments

  • gdl is the display list pointer.

  • dl is the segment address of the child display list.

Explanation
gSPDisplayList calls a child display list from the current display list. This kind of display list hierarchy can be used to make re-use of display lists or to structure the display list data in a way that reflects the actual rendering model. The display list hierarchy can have up to 10 steps (18 steps for gspF3DEX.fifo.o and gspF3DEX.NoN.fifo.o). This macro works like a subroutine call: when the processing of the child display list is complete, the processing of the parent display list which made the call resumes. For details, please see Section 11.2 "Display List Processing" in the N64 Online Programming Manual.

Note
All display lists must be terminated by the gSPEndDisplayList macro.

See also
gSPBranchList
gSPEndDisplayList

Revision History
2/1/1999 Completely rewritten.


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 March 1999