gSPDisplayList [Macro]

Function

gSPDisplayList

Calls a child display list from the current display list

Syntax

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

Arguments

gdl

the display list pointer.

dl

the segment address of the child display list.

Description

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

02/01/99 Completely rewritten.