GX_LoadTex

Syntax

#include <nitro/gx/gx_load.h>

void GX_LoadTex(const void *pSrc, u32 destSlotAddr, u32 szByte);

Arguments

pSrc Pointer to transfer origin
destSlotAddr Address in transfer destination texture image slot
szByte Transfer size (in bytes)

Return Values

None.

Description

This function uses DMA to transfer texture images to the texture image slot. The transfer destination address (in the texture image slot) can be specified. Use the GX_DMAID DMA channel (defined in gxcommon.h). Both destSlotAddr and szByte must be 4-byte aligned. Call this function between the GX_BeginLoadTex and GX_EndLoadTex functions.

Notes: Because the DMA transfer is carried out internally, the transfer source data must be written to main memory in advance using a function such as DC_FlushRange.
If the regions for transfer source and transfer destination overlap, the operation result is undefined. Do not call GX_SetBankForTex, GX_ResetBankForTex, or GX_DisableBankForTex between GX_BeginLoadTex and GX_EndLoadTex.

See Also

GX_BeginLoadTex
GX_EndLoadTex

Revision History

2004/02/09

2004/01/19 Initial version.


CONFIDENTIAL