GX_LoadOBJExtPltt

C Specification

#include <nitro/gx/gx_load.h>
void GX_LoadOBJExtPltt(const void *pSrc, u32 destSlotAddr, u32 szByte);

Arguments

pSrc Pointer to transfer origin
destSlotAddr Address to inside of the transfer source OBJ expanded palette slot
szByte Transfer size (in bytes)

Return Values

None.

Description

This function uses DMA to transfer OBJ palette data to the Main 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 GX_BeginLoadOBJExtPltt and GX_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_SetBankForOBJExtPltt, GX_ResetBankForOBJExtPltt, or GX_DisableBankForOBJExtPltt between GX_BeginLoadOBJExtPltt and GX_EndLoadOBJExtPltt.

See Also

GX_BeginLoadOBJExtPltt, GX_EndLoadOBJExtPltt

Revision History

02/09/2004

01/19/2004 Initial version.