gSPSelectDL [Macro]

Function

gSPSelectDL

Conditionally calls the display list

Syntax

#include <ultra64.h>        /* gs2dex.h */
gSPSelectDL(Gfx *gdl, Gfx *ldl, u8 sid, u32 flag, u32 mask)
gsSPSelectDL(         Gfx *ldl, u8 sid, u32 flag, u32 mask)

Arguments

gdl

the display list pointer.

ldl

the pointer to the display list to link.

sid

the status ID (0, 4, 8 or 12).

flag

the status flag.

mask

the status mask.

Description

Using a method similar to the texture loading decision process, this macro evaluates the status [status ID] and then calls another display list according to the True/False result. The macro uses the following processes to decide whether or not to call the other display list:

• Checks (Status[sid] & mask) == flag.
• If the result is true, the macro terminates without doing anything.
• If the result is false, it updates Status Status[sid] so Status[sid] = (Status[sid] & ~mask) | (flag & mask) and calls the display list specified by ldl.

The status region is set using gSPSetStatus. Please see the "4.7.1 gSPSetStatus" in the latest readme file of S2DEX microcode.

Like a sub-routine call, this macro resumes processing the calling display list after the display list that is linked completes.

See Also

gSPSelectBranchDL

Revision History

02/01/99 Entirely revised.