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