# GX_LoadBG1Scr

## Syntax

      #include <nitro/gx/gx_load.h>

      void GX_LoadBG1Scr(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 screen data to the BG1 screen data base address in the Main 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 2-byte aligned. The transfer destination address is `(u32) G2_GetBG1ScrPtr()` + offset.

Notes: Because the DMA transfer is carried out internally, the transfer source data must be written to main memory in advance using a function such as `DC_FlushRange`.
If the regions for transfer source and transfer destination overlap, the operation result is not guaranteed.

## See Also

`GX_LoadBGPltt`, `GX_LoadBG1Char`

## Revision History

2004/02/09

- Revised and expanded the description.

2004/01/19 Initial version.

CONFIDENTIAL