#include <nnsys/gfd.h>
NNSGfdTexKey NNS_GfdAllocFrmPlttVram(u32 szByte, BOOL b4Pltt, u32 allocFrom);
| szByte | 確保したいパレット用メモリの大きさ( 8 - 524280 バイト ) |
| b4Pltt | 4色パレット用メモリを確保する場合に真。 |
| 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が指定されている場合には、
4色パレット用メモリを確保します。
この場合、4色パレットを置く事が可能な位置にパレット用メモリが確保できたかどうかの判定が行われます。
(4色パレットは、0x10000以降に置く事が出来ません。)
NNS_GfdInitFrmPlttVramManager
NNS_GfdFreeFrmPlttVram
2005/01/31 サイズの値域に関する注意書きを追加
2004/07/16 初版