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

## gSPScisTextureRectangle [macro]

Draws a rectangle with scissoring.

Syntax

    #include <ultra64.h>  /* gbi.h */
    gSPScisTextureRectangle (
            Gfx *gdl,
            s32 ulx,
            s32 uly,
            s32 lrx,
            s32 lry,
            s32 tile,
            s32 s,
            s32 t,
            s32 dsdx,
            s32 dtdy)

Arguments

- gdl is the display list pointer.

- ulx is the x-coordinate of upper-left corner of rectangle (10.2, 0.0~1023.75)

- uly is the y-coordinate of upper-left corner of rectangle (10.2, 0.0~1023.75)

- lrx is the x-coordinate of lower-right corner of rectangle (10.2, 0.0~1023.75)

- lry is the y-coordinate of lower-right corner of rectangle (10.2, 0.0~1023.75)

- tile is the tile descriptor index (3-bit precision, 0 - 7)

- s is the texture coordinate s of upper-left corner of rectangle (s10.5)

- t is the texture coordinate t of upper-left corner of rectangle (s10.5)

- dsdx is the change in s for each change in x (s5.10)

- dtdy is the change in t for each change in y (s5.10)

Explanation
Draws a textured 2D rectangle with scissoring. This macro differs from g*SPTextureRectangle in that negative values can be set. However, negative values that are entered are corrected to zero.

For information about other features of this macro, see gSPTextureRectangle.

Notes
In copy mode, scissoring is performed on multiples of 4 pixels, so the rectangle will not be accurately scissored. It will be either the same size or larger than a filled rectangle.

In 1-cycle mode and 2-cycle mode, scissoring is performed accurately.

Cautions
This macro can only be used dynamically. There is no static version.

See Also
gDPFillRectangle
gDPSetScissor
gDPSetTexturePersp
gSPTextureRectangle
gSPTextureRectangleFlip

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-1999
Nintendo of America Inc. All rights reserved
Nintendo and N64 are registered trademarks of Nintendo
Last updated March 1999