# GX_LoadOBJPltt

## C Specification

      #include <nitro/gx/gx_load.h>

      void GX_LoadOBJPltt(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 palette data to the Main 2D Engine's OBJ palette RAM. 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_PLTT` in the ARM9 memory space + `offset`. Both `offset` and `szByte` must be multiples of 2.

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

`GX_LoadOBJ`, `GX_LoadOAM`

## Revision History

02/09/2004

- Revised and expanded the description.

01/19/2004 Initial version.