#include <nitro/gx/gx_load.h>
void GXS_LoadOBJExtPltt(const void *pSrc, u32 destSlotAddr, u32 szByte);
pSrc | Pointer to transfer origin |
destSlotAddr | Address to inside of the transfer source OBJ expanded palette slot |
szByte | Transfer size (in bytes) |
None.
This function uses DMA to transfer OBJ palette data to the sub 2D Engine's OBJ Extended palette. The transfer destination address (in the OBJ Extended palette) can be specified. The DMA channel that is used is GX_DMAID
(defined in gxcommon.h
). Both destSlotAddr
and szByte
must be 4-byte aligned. Call between GXS_BeginLoadOBJExtPltt
and GXS_EndLoadOBJExtPltt
.
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 undefined. Do not call GX_SetBankForSubOBJExtPltt
, GX_ResetBankForSubOBJExtPltt
, or GX_DisableBankForSubOBJExtPltt
between GXS_BeginLoadOBJExtPltt
and GXS_EndLoadOBJExtPltt
.
GXS_BeginLoadOBJExtPltt
, GXS_EndLoadOBJExtPltt
02/09/2004 Initial version.