Ninja Library - テクスチャ関数

njReleaseTextureNum

テクスチャ番号によるテクスチャメモリのリリース

書式

Sint32 njReleaseTextureNum( n )
Uint32 n

引数

 テクスチャ番号

戻り値

 1   成功
−1   失敗

解説

カレントテクスチャリストのテクスチャ番号n番のテクスチャを リファレンスカウンタがゼロになるときテクスチャメモリから リリースします。テクスチャをリリースするとき、テクスチャ管理領域 (テクスチャマネージメント、テクスチャシステム領域)も初期化します。 Ninja2からテクスチャリストにロードされていないテクスチャが存在する場合でも エラーを返しません。(不正なテクスチャサーフェスをロードした場合は、エラーになります)


用例

NJS_TEXNAME texname[2];
NJS_TEXLIST texlist ={texname,2};
Sint8 *texbuf;
/* Prepare to read in two textures */
NJS_TEXMANAGE texmng[4];
NJS_TEXSYSTEM texsys[4];

njInitTextureEx(texmng,4,texsys,4);
texbuf = syMalloc(0x20000);
nuInitTextureBuffer(texbuf,0x20000);
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);
/* Load texture */
nuLoadTexture(&texlist);
syFree(texbuf);
/* Set current texture list*/
njSetTexture(&texlist);
/* Release texture #0 in texlist file.pvr*/
njReleaseTextureNum(0);

備考

ロードした他のテクスチャリストで同じテクスチャが登録されているときはすべてのテクスチャリストで解放しない限り、テクスチャメモリ上から解放されることはありません。

※グローバルインデックスが同一のものを同一のテクスチャとしています。詳しくは、テクスチャドキュメントを参照してください。


参照

njReleaseTextureAll() テクスチャメモリの全解放
njReleaseTexture() テクスチャメモリのリリース
njReleaseTextureNumG() グローバルインデックス番号によるテクスチャメモリのリリース

njReleaseTextureNum
COPYRIGHT © SEGA ENTERPRISES, LTD., 1998-2000