#include <nitro/gx/gx_load.h>
void GX_LoadBG3Bmp(const void *pSrc, u32 offset, u32 szByte);
pSrc | Pointer to transfer origin |
offset | Offset |
szByte | Transfer size (in bytes) |
None.
For 256-color bitmap BGs and direct color bitmap BGs this function DMA transfers bitmap data to the BG3 screen base address in the BG-VRAM of the main 2D engine. 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 2-byte aligned. The transfer destination address is (u32)
G2_GetBG3ScrPtr()
+ offset
. GX_LoadBG3Scr
is called internally.
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.
03/23/2004 Initial version.