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

## gDPScisFillRectangle [macro]

Renders a solid color rectangle in the screen coordinates.

Syntax

    #include <ultra64.h> /* gbi.h */
    gDPScisFillRectangle(Gfx *gdl, s32 ulx, s32 uly, s32 lrx, s32 lry)

Arguments

- gdl is the display list pointer.

- ulx is the left edge coordinates of rectangle (10-bit precision, -231-1023)

- uly is the top edge coordinates of rectangle (10-bit precision, -231-1023)

- lrx is the right edge coordinates of rectangle (10-bit precision, -231-1023)

- lry is the bottom edge coordinates of rectangle (10-bit precision, -231-1023)

Explanation
Renders a scissored 2D rectangle using the fill color set in the RDP's blender (BL). Unlike gDPFillRectangle, this command can take negative values. However, any negative value that is input is corrected to 0.

Notes
This macro can only be used dynamically. There is no static version (i.e., there is no gsDPScisFillRectangle).

See Also

gDPFillRectangle
gDPSetCycleType
gDPSetFillColor
gSPTextureRectangle

Revision History
2/1/99 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-1999
Nintendo of America Inc. All rights reserved
Nintendo and N64 are registered trademarks of Nintendo
Last Updated April, 1999