# NNS_GfdAllocFrmPlttVram

## 構文

      #include <nnsys/gfd.h>

      NNSGfdTexKey NNS_GfdAllocFrmPlttVram(u32 szByte, BOOL b4Pltt, u32 allocFrom);

## 引数

szByte | 確保したいパレット用メモリの大きさ( 8 - 524280 バイト )
b4Pltt | ４色パレット用メモリを確保する場合に真。
allocFrom | パレット用メモリを確保する方向。

## 返り値

パレット用メモリを示すキー・データ。

## 説明

`szByte`で指定された大きさのパレット用メモリをパレットRAMから確保し、そのパレット用メモリを示すキーを返します。 パレット用メモリの確保でエラーが発生した場合は、エラーを示すキーであるNNS_GFD_ALLOC_ERROR_PLTTKEYを返します。

フレームパレットVRAMマネージャでは、パレットRAMの上位、下位の両方からパレットメモリを確保することができます。 `allocFrom`に`NNS_GFD_ALLOC_FROM_LOW`が指定されている場合には、 パレットRAMの下位からパレットメモリを確保します。 また、`allocFrom`に`NNS_GFD_ALLOC_FROM_HIGH`が指定されている場合には、 パレットRAMの上位からパレットメモリを確保します。

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

`b4Pltt`に`TRUE`が指定されている場合には、 ４色パレット用メモリを確保します。 この場合、４色パレットを置く事が可能な位置にパレット用メモリが確保できたかどうかの判定が行われます。 （４色パレットは、0x10000以降に置く事が出来ません。）

## 参照

`NNS_GfdInitFrmPlttVramManager NNS_GfdFreeFrmPlttVram`

## 履歴

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

2004/07/16 初版