NNS_GfdAllocLnkTexVram

構文

#include <nnsys/gfd.h>
NNSGfdTexKey NNS_GfdAllocLnkTexVram( u32 szByte, BOOL is4x4comp, u32 opt );

引数

szByte 確保したい領域のバイトサイズ( 16 - 524272 バイト )
is4x4comp 4x4圧縮テクスチャか?圧縮テクスチャならばTRUE。
opt オプション。現在は使用されていません。

返り値

確保したVRAM領域を表すテクスチャキー。

説明

szByteで指定されたサイズのテクスチャメモリをVRAMから確保し、そのVRAM領域を表すテクスチャキーを返します。 確保に失敗した場合は、エラーを示すキーであるNNS_GFD_ALLOC_ERROR_TEXKEYを返します。

is4x4compにTRUEが指定されている場合には、4×4テクセル圧縮テクスチャ用にテクスチャ用メモリを確保します。
(インデックスパレット用の領域も同時に確保されます。)

キーが表現可能な最小サイズより小さなサイズの確保請求があった場合、請求サイズを最小サイズに切り上げて確保します。
キーが表現可能な最大サイズより大きなサイズの確保請求があった場合、確保処理を行わずエラーキーを返します。

リンクドリスト形式マネージャでは、サイズの大きなテクスチャから順に確保するなど確保の順番を工夫することで、 メモリ領域の断片化が回避され、より効率的にメモリを利用できます。

参照

NNS_GfdFreeLnkTexVram

履歴

2007/08/24 内部動作の説明と、効率的な利用方法についての注意書きを追加

2005/01/31 サイズの値域に関する注意書きを追加

2004/10/12 初版