GXS_LoadBG1Char

C Specification

#include <nitro/gx/gx_load.h>
void GXS_LoadBG1Char(const void *pSrc, u32 offset, u32 szByte);

Arguments

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

Return Values

None.

Description

This function uses DMA to transfer character data to the BG1 character data base address in the sub 2D Engine BG-VRAM. An offset can be specified for the transfer destination address. The DMA channel that is used is GX_DMAID (defined in gxcommon.h). Both offset and szByte must be 4-byte aligned. The transfer destination address is (u32) G2S_GetBG1CharPtr() + offset.

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 not guaranteed.

See Also

GXS_LoadBGPltt, GXS_LoadBG1Scr

Revision History

02/09/2004 Initial version.