# GXS_LoadBG3Bmp

## C Specification

      #include <nitro/gx/gx_load.h>

      void GXS_LoadBG3Bmp (const void *pSrc, u32 offset, u32 szByte);

## Description

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 sub-2D engine. You can specify an offset in the address of the transfer destination. The DMA channel used is `GX_DMAID` (defined in `gxcommon.h`). `offset` and `szByte` need to be multiples of 2. 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.

## Arguments

`pSrc` | Transfer origin pointer
`offset` | Offset
`szByte` | Transfer Size (in bytes)

## Return Values

None

## See Also

`GXS_LoadBGPltt`, `GXS_LoadBG3Scr`

## Revision History

03/23/2004 Version