# NNS_G3dTexLoad

## 構文

      #include <nnsys/g3d/kernel.h>

      void
      NNS_G3dTexLoad(
          NNSG3dResTex* pTex,
          BOOL          exec_begin_end
      );

## 引数

pTex | テクスチャリソースへのポインタ
exec_begin_end | `TRUE`の時、TWL-SDKの`GX_BeginLoadTex`関数と`GX_EndLoadTex`関数を呼びます

## 返り値

なし。

## 説明

テクスチャリソース内に格納されているテクスチャを、設定されているテクスチャ・キーが指し示すVRAM領域にロードすると同時に、 テクスチャリソース内のテクスチャをVRAMにロードした事を示すフラッグをセットします。 この関数を呼ぶ前に、必ず`NNS_G3dTexSetTexKey`関数を用いて、テクスチャ・キーを設定しておく必要があります。 また、テクスチャのロードにDMA転送を使用するため、あらかじめ`DC_Flush*`/`DC_Store*`関数等を用いてテクスチャをメモリにライトバックしておく必要があります。

exec_begin_endに`TRUE`が指定されている場合、テクスチャデータのVRAMへのロードの前後に、 TWL-SDKのAPIである`GX_BeginLoadTex`関数と`GX_EndLoadTex`関数を呼びます。 exec_begin_endに`FALSE`を指定した場合は、ユーザ側で`GX_BeginLoadTex`関数と`GX_EndLoadTex`関数を呼び出す必要があります。 連続してテクスチャデータをロードする場合には、exec_begin_endに`FALSE`を指定して、 ユーザ側で`GX_BeginLoadTex`関数と`GX_EndLoadTex`関数を呼び出した方が効率的です。

## 参照

`NNS_G3dTexSetTexKey NNS_G3dTexReleaseTexKey`

## 履歴

2008/06/20 NITRO-SDKをTWL-SDKに変更
2008/01/23 DMA転送を使用する旨を追記
2004/08/19 説明文の誤記を修正
2004/08/02 初版