gSPScisTextureRectangle [Macro]

Function

gSPScisTextureRectangle

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

the display list pointer.

ulx

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

uly

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

lrx

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

lry

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

tile

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

s

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

t

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

dsdx

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

dtdy

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

Description

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.

Note

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.

This macro can only be used dynamically. There is no static version (gsSPScisTextureRectangle).

See Also

gDPFillRectangle, gDPSetScissor, gDPSetTexturePersp, gSPTextureRectangle, gSPTextureRectangleFlip

Revision History

02/01/99 Entirely revised.