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

# kmChangeContextFaceColor

FaceColorの変更

### 書式

> `KMSTATUS kmChangeContextFaceColor( pVertexBuffDesc, nParam, pFaceColor )
> PKMVERTEXBUFFDESC pVertexBuffDesc
> KMINT32 nParam
> PKMFLOATCOLOR pFaceColor
> `

### 引数

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

### 戻り値

> KMSTATUS_SUCCESS | 成功

### 解説

> kmSetVertexRenderState()関数/kmSetStripHead()関数でpVertexBuffDesc->pGlobalParamに登録した レンダリングパラメータのFaceColorを変更します。 対応する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へ レンダリングパラメータを登録していない場合の動作は保証しません。

### 参照

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

kmChangeContextFaceColor

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