Ninja Library - テクスチャ関数

njGetTextureErrStat

テクスチャのエラーの取得

書式

NJS_TEXERRSTAT *njGetTextureErrStat( void )

引数

なし

戻り値

テクスチャエラー変数のアドレス

解説

テクスチャエラー情報設定変数、_nj_texerr_のポインタを取得します。

これを利用することにより、テクスチャ関数内部で発生したエラーを知ることができます。 この変数の値はnjInitTextureErrStat関数で初期化することができます。

テクスチャ関数で関数実行後失敗が戻った場合、この変数からエラーの種類を確認しエラーに対する対処をします。 エラー値はエラーが起こった関数から次にテクスチャ関数が呼ばれるまで有効です。

各メンバは次のようになっています。
n:テクスチャ番号、デフォルトは0xFFFFFFFF
globalIndex:グローバルインデックス番号、デフォルトは0xFFFFFFFF
texerr:テクスチャ内部のエラーの種類が戻ります。デフォルトは0

以下の値が定義されています。

 定義   値   意味 
 NJD_TEXERR_OTHER   1   その他のエラー 
 NJD_TEXERR_FILEOPEN   2   ファイルオープンエラー 
 NJD_TEXERR_EXTND   3   ファイル拡張子のエラー 
 NJD_TEXERR_HEADER   4   ファイルヘッダエラー 
 NJD_TEXERR_FILELOAD   5   ファイルロードエラー 
 NJD_TEXERR_SURFACE   6   テクスチャメモリ不足エラー 
 NJD_TEXERR_MAINMEMORY   7   メインメモリ不足エラー 
 NJD_TEXERR_TEXMEMLOAD   8   テクスチャメモリロードエラー 
 NJD_TEXERR_GLOBALINDEX   9   グローバルインデックスエラー 

gdstat:GD-ROMからファイルロード中にエラーが発生した場合 GD-ROMのステータス取得関数gdFsGetStat関数を実行し、結果を入れます。 この場合texerrはNJD_TEXERR_FILELOADになっています。

詳しくはShinobi関数リファレンスを参照してください。

gderr:GD-ROMからファイルロード中にエラーが発生した場合、GD-ROMのステータス取得関数を実行した後にGD-ROMのエラー取得関数gdFsGetErrStat関数を実行し、結果をgderrに入れます。

詳しくはShinobi関数リファレンスを参照してください。

用例

NJS_TEXERRSTAT *texerr;
texerr = njGetTextureErrStat();
if(nuLoadTexture(&texlist) < 0){
	if(texerr->gderr == GDD_ERR_UNITATTENT){
	/* Confirm GD open */
		topencheck();
	}
}

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