gDPLoadTLUT_pal.3p
1.38 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
.TH gDPLoadTLUT_pal 3P local "Silicon Graphics, Inc."
.SH NAME
.upperok
gDPLoadTLUT_pal16, gsDPLoadTLUT_pal16,
gDPLoadTLUT_pal256, gsDPLoadTLUT_pal256
\- load a texture look-up table into texture memory
.SH C SPECIFICATION
.nf
\f3#include "gbi.h"
gDPLoadTLUT_pal16(Gfx *gdl, unsigned int pal, unsigned int dram)
gsDPLoadTLUT_pal16(unsigned int pal, unsigned int dram)
gDPLoadTLUT_pal256(Gfx *gdl, unsigned int dram)
gsDPLoadTLUT_pal256(unsigned int dram)
\fP
.fi
.SH PARAMETERS
.TP 10
.I *gdl
graphics display list pointer.
.TP
.I pal
Load the texture lookup table into one of sixteen palettes.
Only for 4 bit color indexed textures.
.TP
.I dram
Address of look-up table in RAM.
Must be 64 bit aligned.
.SH DESCRIPTION
A portion of the texture memory can be used for storing texture lookup tables.
The TLUT is located in the upper 256 words of Tmem. Therefore, color index
textures are always loaded in the low 256 words of Tmem. The type of texels in
the TLUT can be either 16-bit RGBA or 16-bit IA. For 256-entry palettes, the
entire upper half of Tmem is used. For 16-entry palettes, the location in the
upper half of Tmem depends on the palette number. 16-entry Palette numbers can range from
0 to 15. A more detailed description is given in the "RDP State Machine" and
"Texture" chapters of the
.I NU64 Programming Manual.
.SH SEE ALSO
.IR gDPLoadTextureBlock (3P),
.IR gDPLoadTextureTile (3P)