# 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が指定されている場合には、４×４テクセル圧縮テクスチャ用にテクスチャ用メモリを確保します。
（インデックスパレット用の領域も同時に確保されます。）

キーが表現可能な最小サイズより小さなサイズの確保請求があった場合、請求サイズを最小サイズに切り上げて確保します。
キーが表現可能な最大サイズより大きなサイズの確保請求があった場合、確保処理を行わずエラーキーを返します。
リンクドリスト形式マネージャでは、サイズの大きなテクスチャから順に確保するなど確保の順番を工夫することで、 メモリ領域の断片化が回避され、より効率的にメモリを利用できます。

## 参照

`NNS_GfdFreeLnkTexVram`

## 履歴

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

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

2004/10/12 初版