# 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で定義)で、destSlotAddrとszByteは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