##### Kamui2 Library - 描画パラメータ設定(Kamui1互換用)関数

# kmChangeContextTextureAddress

TextureAddressの変更

### 書式

> `KMSTATUS kmChangeContextTextureAddress( pVertexBuffDesc, nParam, pTextureSurfaceDesc )
> PKMVERTEXBUFFDESC pVertexBuffDesc,
> KMINT32 nParam,
> PKMSURFACEDESC pTextureSurfaceDesc
> `

### 引数

> pVertexBuffDesc | (入力/出力)KMVERTEXBUFFDESCへのポインタ
> nParam | (入力)書き換えるパラメータ
> pTextureSurfaceDesc | (入力)KMSURFACEDESCへのポインタ

### 戻り値

> KMSTATUS_SUCCESS | 成功

### 解説

> kmSetVertexRenderState()関数、kmSetStripHead()関数でpVertexBuffDesc->pGlobalParamに登録したレンダリングパラメータのTextureAddressを変更します。

> この関数では、TextureAddress以外は変更しないので下記のメンバに変更がない場合使用可能です。

> - pTextureSurfaceDesc->PixelFormat
> - pTextureSurfaceDesc->u0.USize
> - pTextureSurfaceDesc->u1.VSize
> - pTextureSurfaceDesc->fSurfaceFlags
> 上記のメンバに変更がある場合は、kmChangeContextTextureAddress()関数は使用せず、 kmChangeContextTextureSurface()関数を使用してください。 対応するVertexTypeは以下のようになります。

> VertexType | 対応状況
> VertexType00 | ×
> VertexType01 | ×
> VertexType02 | ×
> VertexType03 | ○
> VertexType04 | ○
> VertexType05 | ○
> VertexType06 | ○
> VertexType07 | ○
> VertexType08 | ○
> VertexType09 | ×
> VertexType10 | ×
> VertexType11 | ◎
> VertexType12 | ◎
> VertexType13 | ◎
> VertexType14 | ◎
> VertexType15 | ×
> VertexType16 | ○
> VertexType17 | ×

> ◎:KM_IMAGE_PARAM1 / KM_IMAGE_PARAM2 設定可能
> ○:KM_IMAGE_PARAM1のみ設定可能

> 引数nParamには、次の書き換えるパラメータを設定します。

> 定義 | 意味
> KM_IMAGE_PARAM1 | 1パラメータ
> KM_IMAGE_PARAM2 | 2パラメータ

### 備考

> この関数は、kmStartVertexStrip()関数でストリップを開始する前に pVertexBuffDesc->pGlobalParam の一部を変更します。事前に同一パス内において、pVertexBuffDesc->pGlobalParamへレンダリングパラメータを登録していない場合の動作は保証しません。

### 参照

> kmChangeContextTextureSurface() | TextureSurfaceの変更
> kmSetStripHead() | レンダリングパラメータ(KMSTRIPHEAD)の登録
> kmSetVertexRenderState() | レンダリングパラメータ(KMVERTEXCONTEXT)の登録(通常時)
> kmStartVertexStrip() | 頂点データストリップの開始

kmChangeContextTextureAddress

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