gSPTextureRectangleFlip

gSPTextureRectangleFlip [Macro]

Function

gSPTextureRectangleFlip

Renders a textured rectangle by flipping the s/t coordinates

Syntax

#include <ultra64.h>        /* gbi.h */
gSPTextureRectangleFlip(
        Gfx *gdl, 
        u32 ulx,
        u32 uly, 
        u32 lrx,
        u32 lry, 
        s32 tile,
        s32 s,
        s32 t, 
        s32 dsdx,
        s32 dtdy)
gsSPTextureRectangleFlip(
        u32 ulx,
        u32 uly, 
        u32 lrx,
        u32 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 inverted s,t coordinates. This macro works just like gSPTextureRectangle, except that the s,t coordinates swap x,y axes in order to flip the texture. You need to be careful when using dtdx and dsdy. The s coordinate is changed so that it describes the y direction, and not the x direction as usual. In the same way, the t coordinate is changed to describe the x direction, and not the y direction as usual. For details about the other features of this macro, see gSPTextureRectangle. Also, to learn more about flipping, please see Section 14.2.1, "Flip" in the N64 Online Programming Manual.

Example

Please refer to Section 14.2.1, Example 14-13, "TextureRectangleFlip Command" in the N64 Programming Manual.

Revision History

02/01/99 Entirely revised.