gDPLoadTextureBlock_4b [Macro]

Loads texture as a contiguous 4-bit texture block

Syntax

#include <ultra64.h>        /* gbi.h */
gDPLoadTextureBlock_4b(
        Gfx *gdl, 
        u32 timg,
        u32 fmt, 
        u32 width,
        u32 height,
        u32 pal, 
        u32 cms, 
        u32 cmt,
        u32 masks,
        u32 maskt, 
        u32 shifts,
        u32 shiftt )
gsDPLoadTextureBlock_4b(
        u32 timg,
        u32 fmt, 
        u32 width,
        u32 height, 
        u32 pal, 
        u32 cms,
        u32 cmt, 
        u32 masks,
        u32 maskt, 
        u32 shifts,
        u32 shiftt )

Arguments

gdl

Display list pointer

 

timg

Address of the texture image (64-bit alignment)

 

fmt

Texture image format:

G_IM_FMT_CI (CI format)

G_IM_FMT_IA (IA format)

G_IM_FMT_I (I format)

 

width

Texture image width

 

height

Texture image height

 

pal

Location of palette for 4-bit color index texture (4-bit precision, 0~15)

 

cms

s-axis mirror, no-mirror, wrap and clamp flags

G_TX_MIRROR (enable mirror operations)

G_TX_NOMIRROR(disable mirror operations)

G_TX_WRAP (enable wrap operations)

G_TX_CLAMP (enable clamp operations)

 

cmt

t-axis mirror, no-mirror, wrap and clamp flags

G_TX_MIRROR(enable mirror operations)

G_TX_NOMIRROR(disable mirror operations)

G_TX_WRAP(enable wrap operations)

G_TX_CLAMP (enable clamp operations)

 

masks

s-axis mask (4-bit precision, 0~15)

G_TX_NOMASK (do not mask, 0)

numeric value n(mask, 1~15)

 

maskt

t-axis mask (4-bit precision, 0~15)

G_TX_NOMASK(do not mask, 0)

numeric value n(mask, 1~15)

 

shifts

s-coordinate shift value (4-bit precision, 0~15)

G_TX_NOLOD(do not shift, 0)

numeric value n(shift, 1~15)

 

shiftt

t-coordinate shift value (4-bit precision, 0~15)

G_TX_NOLOD(do not shift, 0)

numeric value n (shift, 1~15)

Description

Loads a 4-bit texture from DRAM into texture memory (TMEM). The size is implicitly 4 bits, so no size argument in included. Because this macro loads the texture image into a contiguous region in memory, it is the most efficient way to load a texture. DRAM transfers are also most efficient with large blocks.

gDPLoadTextureBlock* is actually comprised of a number of 64-bit GBI commands. Thus, if you need to find out the exact size of the display list, you need to consider how many GBI commands it is comprised of.

Regarding the fmt argument:

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 3 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.