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() システム構成の設定