# GX_LoadOBJ

## C Specification

      #include <nitro/gx/gx_load.h>

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

## 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 2-byte aligned.

Notes:

- Because this is an internal DMA transfer, the transfer source data must be written into main memory using `DC_FlushRange` or some similar function.
- If the regions for transfer source and transfer destination overlap, the operation result is undefined.

## Arguments

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

## Return Values

None

## See Also

`G2_GetOBJCharPtr`

## Revision History

02/09/2004 Revised and added to the description
01/19/2004 Initial Version