# GXS_LoadBG2Char

## C Specification

      #include <nitro/gx/gx_load.h>

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

## Description

This function uses DMA to transfer character data to the BG2 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_GetBG2CharPtr()` + `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.

## Arguments

`pSrc` | Pointer to transfer source
`offset` | Offset
`szByte` | Transfer size (in bytes)

## Return Values

None

## See Also

`GXS_LoadBGPltt`, `GXS_LoadBG2Scr`

## Revision History

02/09/2004 Initial Version