# GX_LoadOBJ

## C Specification

      #include <nitro/gx/gx_load.h>

      void GX_LoadOBJ(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 standard OBJ data to the Main 2D Engine OBJ-VRAM. An offset can be specified for the transfer destination address. The DMA channel that is used is `GX_DMAID` (defined in `gxcommon.h`). The transfer destination address is `HW_OBJ_VRAM` in the ARM9 memory space + `offset`. Both `offset` and `szByte` must be multiples of 4.

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

G2_GetOBJCharPtr

## Revision History

02/09/2004

- Revised and expanded the description.

01/19/2004 Initial version.