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

## gSPTextureRectangleFlip

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 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 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 Online Programming Manual.

See Also
gDPFillRectangle
gDPSetScissor
gDPSetTexturePersp
gSPScisTextureRectangle
gSPTextureRectangle]

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