NNS_GfdAllocLnkPlttVram

構文

#include <nnsys/gfd.h>
NNSGfdPlttKey NNS_GfdAllocLnkPlttVram( u32 szByte, BOOL b4Pltt, u32 opt );

引数

szByte 確保したい領域のバイトサイズ( 8 - 524280 バイト )
b4Pltt 4色パレットか。4色パレットならTRUE。
opt オプション。現在は使用されていません。

返り値

確保したVRAM領域を表すパレットキーを返します。 確保に失敗した場合は、エラーを示すキーであるNNS_GFD_ALLOC_ERROR_PLTTKEYを返します。

説明

テクスチャパレットとして使用するVRAM領域を確保し、パレットキーとして取得します。 b4PlttにTRUEが指定されている場合には、4色パレット用メモリを確保します。
(4色パレットは、8バイトアライメントが必要であったり、0x10000 以上の領域では参照が不可能であるなど、 4色パレット特有の制限を持っています。)
アラインメント調整などで発生した空き領域は、空き領域ブロックとして登録されます。
新たな管理情報ブロックが不足した場合は、確保に失敗します。
不要なアラインメント調整を防ぐために、4色パレット用メモリとその他フォーマットパレット用メモリの確保を分類し、 ある程度まとめて行うことを推奨いたします。

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

参照

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

NNS_GfdFreeLnkPlttVram

履歴

2004/10/12 初版