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

## gSPBranchLessZrg

Syntax

    #include <ultra64.h> /* gbi.h */
    gSPBranchLessZrg(
            Gfx *gdl,
            Gfx *branchdl,
            u32 vtx,
            f32 zval,
            f32 near,
            f32 far,
            s32 flag,
            s32 zmin,
            s32 zmax)
    gsSPBranchLessZrg(
            Gfx *branchdl,
            u32 vtx,
            f32 zval,
            f32 near,
            f32 far,
            s32 flag,
            s32 zmin,
            s32 zmax)

Arguments

- gdl is the display list pointer.

- branchdl is the pointer to the display list branch.

- vtx is the vertex (index in the vertex buffer).

- zval is the Z value which becomes the branch condition.

- near is the location of the near plane (a value specified by either guPerspective or guOrtho).

- far is the location of the far plane (a value specified by either guPerspective or guOrtho).

- flag is the projection method:
  G_BZ_PERSP (Perspective projection).
  G_BZ_ORTHO (Orthogonal projection).

- zmin is the minimum value of Z (= vp.vtrans[2] - vp.vscale[2])

- zmax is the maximum value of Z (= vp.vtrans[2] + vp.vscale[2])

Explanation
This macro can specify the minimum/maximum values of Z (zmin/zmax) and conditionally branch the display list. Most applications use a Z value that is greater than 0 and less than G_MAXZ/2. This macro is used when this range needs to be changed. When no change is necessary, please use g*SPBranchLessZ. For details, see gSPBranchLessZ.

See Also
gSPBranchLessZ

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