gDPLoadTLUT_pal16 [Macro]

Function

gDPLoadTextureBlock

Loads palette for 4-bit color index textures

Syntax

#include <ultra64.h>        /* gbi.h */
gDPLoadTLUT_pal16(Gfx *gdl, u32 pal, u32 dram)
gsDPLoadTLUT_pal16(         u32 pal, u32 dram)

Arguments

gdl: Display list pointer
pal: Palette location (0~15)
dram: Texture lookup table (TLUT) address (64-bit alignment)

Description

Transfers a TLUT (dram) to the specified palette location (pal) in texture memory (TMEM). TLUTs are located in the high half of TMEM (the upper 256 words). Accordingly, color index textures are always loaded in the low half (the lower 256 words.) TLUT can use either 16-bit RGBA type texels or 16-bit IA type texels. The palette has 16 entries. These are included in the high half of TMEM, with the location depending on the location of the palette. The texel type is selected with g*DPSetTextureLUT. For a more detailed explanation about this, see Section 12 "RDP Programming" and Section 13 "Texture Mapping" in the N64 Programming Manual.

Note

Addresses in TMEM are divided into a high half and a low half, as shown below:

Revision History

02/01/99 Completely rewritten