##### NinjaUtil Library - テクスチャ関数

# nuLoadTextureNum

テクスチャ番号によるテクスチャのロード（完了復帰）

### 書式

> `Sint32 nuLoadTextureNum( n )
> Uint32 n
> `

### 引数

> n | テクスチャ番号

### 戻り値

> 1 | 成功
> −1 | 失敗

### 解説

> カレントテクスチャリストのテクスチャ番号nのテクスチャを テクスチャアトリビュートの設定によって以下の動作をします。

> ◎ロード方式に関するアトリビュート

> #### ●NJD_TEXATTR_TYPE_FILE または、設定なし

> ファイルからテクスチャをロードします。 この場合nuInitTextureBuffer関数でテクスチャバッファを設定する必要があります。

> #### ●NJD_TEXATTR_TYPE_MEMORY

> メインメモリからテクスチャをロードします。 この場合テクスチャバッファを設定する必要はありません。

> #### ●NJD_TEXATTR_TYPE_SURFACE

> テクスチャサーフェス領域のみを確保します。 実際にテクスチャメモリへテクスチャをロードしません。 レンダテクスチャやフレームバッファテクスチャを使用する場合に使用します。 この場合テクスチャバッファを設定する必要はありません。

> #### ●NJD_TEXATTR_TYPE_SYSAREA

> テクスチャ管理領域（テクスチャマネージメント領域、テクスチャシステム領域）のみを取得します。 ムービーテクスチャを使用する場合に使用します。 この場合テクスチャバッファを設定する必要はありません。

> この関数実行前には、njSetTexture()関数でカレントテクスチャリストを設定してください。

### 用例

>     /* Set two textures */
>     NJS_TEXNAME texname[2];
>     NJS_TEXLIST texlist ={texname,2};
>     /* Get ready to read two textures */
>     NJS_TEXMANAGE texmng[2];
>     NJS_TEXSYSTEM texsys[2];
>     Sint8 *texbuf;

>     njInitTextureEx(texmng,2,texsys,2);
>     texbuf = syMalloc(0x20000);
>     nuInitTextureBuffer(texbuf,0x20000);
>     /* Set two textures */
>     njSetTextureName(&texname[0],"file1.pvr",0,
>     	NJD_TEXATTR_TYPE_FILE|
>     	NJD_TEXATTR_GLOBALINDEX);
>     njSetTextureName(&texname[1],"file2.pvr",1,
>     	NJD_TEXATTR_TYPE_FILE|
>     	NJD_TEXATTR_GLOBALINDEX);
>     /* Set texlist as the current testure list */
>     /* This must be done first */
>     njSetTexture(&texlist);
>     /* Load texture #0  file1.pvr */
>     nuLoadTextureNum(0);
>     /* Load texture #1  file2.pvr */
>     nuLoadTextureNum(1);
>     syFree(texbuf);
>     /* Set current texture as texture #0 in the texlist */
>     njSetTextureNum(0);

### 備考

> Ninja2からnjLoadTextureNum()関数は削除されました。

nuLoadTextureNum

COPYRIGHT © SEGA ENTERPRISES, LTD., 1998-2000