GXS_LoadBG3Bmp

構文

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

引数

pSrc 転送元のポインタ
offset オフセット
szByte 転送サイズ(バイト単位)

返り値

なし。

説明

256色ビットマップBG、ダイレクトカラービットマップBGにおいて、ビットマップデータをサブ2DエンジンのBG-VRAM内のBG3スクリーンベースアドレスにDMA転送します。転送先のアドレスにはオフセットを指定することができます。使用するDMAチャネルはGX_DMAID(gxcommon.hで定義)で、offsetszByteは2の倍数である必要があります。転送先アドレスは、(u32)G2S_GetBG3ScrPtr() + offsetになります。
内部でGXS_LoadBG3Scr を呼び出します。

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

参照

GXS_LoadBGPltt, GXS_LoadBG3Scr

履歴

Ver. 2004/03/23