GXS_LoadOBJExtPltt

構文

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

引数

pSrc 転送元のポインタ
destSlotAddr 転送先OBJ拡張パレットスロット内のアドレス
szByte 転送サイズ(バイト単位)

返り値

なし。

説明

OBJパレットデータをサブ2DエンジンのOBJ拡張パレットにDMA転送します。転送先のアドレス(OBJ拡張パレット内)を指定することができます。使用するDMAチャネルはGX_DMAID(gxcommon.hで定義)で、destSlotAddrszByteは4の倍数である必要があります。GXS_BeginLoadOBJExtPltt()GXS_EndLoadOBJExtPltt() の間で呼んで下さい。

(注意1) 内部でDMA転送を行うので、前もって転送元のデータをDC_FlushRange() 等を用いてメインメモリに書き出しておく必要があります。
(注意2) 転送元と転送先で領域が重なる場合については動作結果は不定です。
(注意3) GXS_BeginLoadOBJExtPltt()GXS_EndLoadOBJExtPltt() の間ではGX_SetBankForSubOBJExtPltt(), GX_ResetBankForSubOBJExtPltt(), GX_DisableBankForSubOBJExtPltt() を呼びださないでください。

参照

GXS_BeginLoadOBJExtPltt, GXS_EndLoadOBJExtPltt

履歴

Ver. 2004/02/09