##### 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