Kamui2 Library - テクスチャ制御関数

kmCreateContiguousTextureSurface

連続したアドレス領域へのテクスチャサーフェスの作成

書式

KMSTATUS kmCreateContiguousTextureSurface( pSurfaceDesc, nTexture, nWidth, nHeight, nTextureType )
PKMSURFACEDESC pSurfaceDesc
KMINT32 nTexture
KMINT32 nWidth
KMINT32 nHeight
KMTEXTURETYPE nTextureType

引数

ppSurfaceDesc   (出力)取得するサーフェスディスクプリタへのポインタ配列のポインタ
nTexture   (入力)確保するテクスチャサーフェスの数
nWidth   (入力)テクスチャの横サイズ
nHeight   (入力)テクスチャの縦サイズ
nTextureType   (入力)テクスチャの形式

戻り値

KMSTATUS_SUCCESS   成功
KMSTATUS_INVALID_TEXTURE_TYPE   無効なテクスチャタイプを指定した
KMSTATUS_NOT_ENOUGH_MEMORY   メモリ容量が不足

解説

フレームバッファの連続したアドレス領域に、複数のテクスチャサーフェスを同時に確保します。

この関数で確保した領域は kmFreeTexture()関数で解放してください。 これは、タイルアクセラレータに内蔵されたYUVコンバータを使用して、 連続して複数のYUV422形式のテクスチャを読み込むときに使用します。 詳しくはkmLoadYUVTexture()関数を参照してください。

引数 ppSurfaceDescは、KMSURFACEDESC 構造体へのポインタ配列のポインタです。 この構造体には、Kamuiによってテクスチャサーフェスの情報が返されます。 戻り値にKMSTATUS_NOT_ENOUGH_MEMORYが返された場合には不定となります。

引数 nTextureには、 連続して確保するテクスチャサーフェスの数を指定します。

引数 nWidth, nHeightには、テクスチャの横サイズと縦サイズを指定します。 指定する値は 8、16、32、64、128、256、512、1024のいずれかでなければなりません。

引数 nTextureTypeには、テクスチャの形式を指定します。 詳しくは、kmCreateTextureSurface()の説明を参照してください。


備考

この関数は kmSetSystemConfiguration()関数の呼び出しの後で実行しなければいけません。 しかし、この関数でも"small VQ圧縮形式"、"small VQ圧縮形式Mipmapあり" を除く すべての形式のテクスチャサーフェスをアロケートすることができます。

参照

kmCreateTextureSurface()
 テクスチャ用サーフェスの確保
kmFreeTexture()
 テクスチャデータの解放
kmLoadYUVTexture()
 YUV形式テクスチャデータの読み込み
kmSetSystemConfiguration()
 システム構成の設定

kmCreateContiguousTextureSurface
COPYRIGHT © NEC Corporation / © SEGA ENTERPRISES, LTD., 1998-2000