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

## gDPSetHilite1Tile [macro]

Sets the texture parameters in the RDP for the rendering of a specular light.

Syntax

    #include <ultra64.h> /* gbi.h */
    gDPSetHilite1Tile(Gfx *gdl, s32 tile, Hilite *hilite, s32 width, s32 height)
    gsDPSetHilite1Tile(s32 tile, Hilite *hilite, s32 width, s32 height)

Arguments

- gdl is the display list pointer.

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

- hilite is the address of texture offset structure for specular highlight.

- width is the width of texture for specular highlight (12-bit precision, -2048~2047 pixels).

- height is the height of texture for specular highlight (12-bit precision, -2048~2047 pixels).

Explanation
Calls the gDPSetTileSize, passing the texture offset via the Hilite structure and the texture size via the width and height arguments. The "1" in the command name indicates it is the first specular highlight in the scene.

Cautions
The Hilite structure is shown below:

    typedef struct {
         int          x1, y1, x2, y2;
    } Hilite_t;
    typedef union {
         Hilite_t     h;
         long int     force_structure_alignment[4];
    } Hilite;

The elements in this structure have the following meanings:

x1, y1
  The x,y values of the texture offset for the first highlight (12-bit precision, -2048~2047 pixels).
x2, y2
  The x,y values of the texture offset for the second highlight (12-bit precision, -2048~2047 pixels).

See Also
gDPSetHilite2Tile
gDPSetTileSize
guLookAtHilite

Revision History
2/1/99 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 April, 1999