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

## gDPSetTextureImage [macro]

Sets the texture image area.

Syntax

    #include <ultra64.h> /* gbi.h */
    gDPSetTextureImage(Gfx *gdl, s32  fmt, s32  siz, s32  width, s32  img)
    gsDPSetTextureImage(s32  fmt, s32  siz, s32  width, s32  img)

Arguments

- gdl is the display list pointer.

- img is the image address (64-byte alignment).

- fmt is the image format:
  G_IM_FMT_RGBA (RGBA format)
  G_IM_FMT_CI (CI format)
  G_IM_FMT_IA (IA format)
  G_IM_FMT_I (I format)

- siz is the pixel component size:
  G_IM_SIZ_4b (4 bits/texel)
  G_IM_SIZ_8b (8 bits/texel)
  G_IM_SIZ_16b (16 bits/texel)
  G_IM_SIZ_32b (32 bits/texel)

- width is the image width (1~4096 pixels).

Explanation
Sets the frame buffer region for texture images. This macro is used in order to utilize a number of textures. The command is normally embedded in gDPLoadTexture* so it is not directly used.

The different image formats of the fmt argument are explained below:

G_IM_FMT_RGBA
  Each texel comprises four elements of information: RGB (red, green, blue) and alpha (opacity).
G_IM_FMT_CI
  Each texel is comprised of index information specifying palette data.
G_IM_FMT_IA
  Each texel is comprised of I (intensity) information and alpha information.
G_IM_FMT_I
  Each texel is a texture with only I information. Since this is extremely compact, it is useful when only a few colors are being used.

You can choose from among 7 different texture image formats. The table shows the valid combinations of format and size. Select the format that best suits the texture compression method and type.

| G_IM_SIZ_ (Size)
4b | 8b | 16b | 32b
G_IM_FMT_ (Format) | RGBA |  |  | X (5/5/5/1) | X (8/8/8/8)
CI |  | X |  |
IA | X (3/1) | X (4/4) | X (8/8) |
I |  | X |  |

See Also
gDPSetColorImage
gDPSetDepthImage

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