GX_LoadClearImageColor

C Specification

#include <nitro/gx/gx_load.h>

void GX_LoadClearImageColor(const void *pSrc, u32 szByte);

Arguments

pSrc Pointer to transfer origin
szByte Transfer size (in bytes)

Return Values

None.

Description

This function uses DMA to transfer the clear image (color) to the clear image slot. The DMA channel that is used is GX_DMAID (defined in gxcommon.h). szByte must be a multiple of 4. Call between GX_BeginLoadClearImage and GX_EndLoadClearImage.
Notes: Because the DMA transfer is carried out internally, the transfer source data must be flushed to the main memory using a function such as DC_FlushRange prior to the process. If the regions for transfer source and transfer destination overlap, the operation result is undefined. Do not call GX_SetBankForClearImage, GX_ResetBankForClearImage, or GX_DisableBankForClearImage between GX_BeginLoadClearImage and GX_EndLoadClearImage.

See Also

GX_BeginLoadClearImage, GX_LoadClearImageDepth, GX_EndLoadClearImage

Revision History

02/09/2004

01/19/2004 Initial version.