GX_SetBankForTex


C Specification

#include <nitro/gx/gx_vramcnt.h>

void GX_SetBankForTex(GXVRamTex tex);

Description

This function allocates the specified VRAM bank to the texture image slot.

If the specified VRAM bank is either disabled or allocated to LCDC, this allocates the VRAM bank to the texture image slot.

GX_VRAM_TEX_NONE The VRAM bank is not allocated to the texture image.
GX_VRAM_TEX_0_A Slot 0 of the texture image is reserved. VRAM-A is allocated.
GX_VRAM_TEX_0_B Slot 0 of the texture image is reserved. VRAM-B is allocated.
GX_VRAM_TEX_0_C Slot 0 of the texture image is reserved. VRAM-C is allocated.
GX_VRAM_TEX_0_D Slot 0 of the texture image is reserved. VRAM-D is allocated.
GX_VRAM_TEX_01_AB Slots 0 and 1 of the texture image are reserved. VRAM-A and -B are allocated.
GX_VRAM_TEX_01_BC Slots 0 and 1 of the texture image are reserved. VRAM-B and -C are allocated.
GX_VRAM_TEX_01_CD Slots 0 and 1 of the texture image are reserved. VRAM-C and -D are allocated.
GX_VRAM_TEX_012_ABC Slots 0, 1, and 2 of the texture image are reserved. VRAM-A, -B, and -C are allocated.
GX_VRAM_TEX_012_BCD Slots 0, 1, and 2 of the texture image are reserved. VRAM-B, -C, and -D are allocated.
GX_VRAM_TEX_0123_ABCD Slots 0, 1, 2, and 3 of the texture image are reserved. VRAM-A, -B, -C, and -D are allocated.
GX_VRAM_TEX_01_AC Slots 0 and 1 of the texture image are reserved. VRAM-A and -C are allocated.
GX_VRAM_TEX_01_AD Slots 0 and 1 of the texture image are reserved. VRAM-A and -D are allocated.
GX_VRAM_TEX_01_BD Slots 0 and 1 of the texture image are reserved. VRAM-B and -D are allocated.
GX_VRAM_TEX_012_ABD Slots 0, 1, and 2 of the texture image are reserved. VRAM-A, -B, and -D are allocated..
GX_VRAM_TEX_012_ACD Slots 0, 1, and 2 of the texture image are reserved. VRAM-A, -C, and -D are allocated.

The following is the type definition for GXVRamTex types.

typedef enum
{

    GX_VRAM_TEX_NONE  = 0x0000,                               // none
    GX_VRAM_TEX_0_A   = GX_VRAM_A,                            // TextureImageSlot 0
    GX_VRAM_TEX_0_B   = GX_VRAM_B,                            // TextureImageSlot 0
    GX_VRAM_TEX_0_C   = GX_VRAM_C,                            // TextureImageSlot 0
    GX_VRAM_TEX_0_D   = GX_VRAM_D,                            // TextureImageSlot 0
    GX_VRAM_TEX_01_AB = GX_VRAM_A | GX_VRAM_B,                // TextureImageSlot 01
    GX_VRAM_TEX_01_BC = GX_VRAM_B | GX_VRAM_C,                // TextureImageSlot 01
    GX_VRAM_TEX_01_CD = GX_VRAM_C | GX_VRAM_D,                // TextureImageSlot 01
    GX_VRAM_TEX_012_ABC = GX_VRAM_A | GX_VRAM_B | GX_VRAM_C,  // TextureImageSlot 012
    GX_VRAM_TEX_012_BCD = GX_VRAM_B | GX_VRAM_C | GX_VRAM_D,  // TextureImageSlot 012
    GX_VRAM_TEX_0123_ABCD = GX_VRAM_A | GX_VRAM_B | GX_VRAM_C | GX_VRAM_D,  // TextureImageSlot 0123

    // The following settings are discontinuous on LCDC
    GX_VRAM_TEX_01_AC = GX_VRAM_A | GX_VRAM_C,                // TextureImageSlot 01
    GX_VRAM_TEX_01_AD = GX_VRAM_A | GX_VRAM_D,                // TextureImageSlot 01
    GX_VRAM_TEX_01_BD = GX_VRAM_B | GX_VRAM_D,                // TextureImageSlot 01
    GX_VRAM_TEX_012_ABD = GX_VRAM_A | GX_VRAM_B | GX_VRAM_D,  // TextureImageSlot 012
    GX_VRAM_TEX_012_ACD = GX_VRAM_A | GX_VRAM_C | GX_VRAM_D   // TextureImageSlot 012
}
GXVRamTex;

Arguments

tex   Specifies a VRAM bank to allocate to the texture image slot

Return Values

None

See Also

GX_GetBankForTex, GX_ResetBankForTex, GX_DisableBankForTex, GX_GetSizeOfTex

Revision History

01/19/2004 Initial Version