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