##### Kamui2 Library - ストリップデータ構築関数

# kmGenerateStripHead

レンダリングパラメータ(KMSTRIPHEAD)の構築

### 書式

> `KMSTATUS kmGenerateStripHead( pStripHead, pStripContext, nVertexType )
> PKMSTRIPHEAD pStripHead
> PKMSTRIPCONTEXT pStripContext
> KMVERTEXTYPE nVertexType
> `

### 引数

> pStripHead | (出力)KMSTRIPHEADへのポインタ
> pStripContext | (入力)KMSTRIPCONTEXT(KMTWOVOLUMESTRIPCONTEXT)へのポインタ
> nVertexType | (入力)VertexType

### 戻り値

> KMSTATUS_SUCCESS | 成功
> KMSTATUS_INVALID_ADDRESS | pStripHeadまたはpStripContextが不正(NULL)
> KMSTATUS_INVALID_SETTING | pStripContextのサイズ設定が不正

### 解説

> KMSTRIPCONTEXT(KMTWOVOLUMESTRIPCONTEXT)からレンダリングパラメータ(KMSTRIPHEAD)の構築を行います。 KMSTRIPHEADの構築は kmGenerateStripHead()関数による方法と、kmGenerateStripHead00()関数〜kmGenerateStripHead17()関数による方法の2方式で行うことができます。

> (使用例)VertexType03のレンダリングパラメータの構築
> (1)kmGenerateStripHead(pStripHead,pStripContext,KM_VERTEXTYPE_03);
> (2)kmGenerateStripHead03
> (1)、(2)はともにVertexType03のKMSTRIPHEADを構築することができます。

> pStripContextの設定は、使用するVertexTypeによって下記のようになります。

> - VertexType00〜08、15、16を使用する場合 KMSTRIPCONTEXTへのポインタを指定します。
> - VertexType09〜14(2パラメータ)を使用する場合 KMTWOVOLUMESTRIPCONTEXTへのポインタを指定します。
> KMTWOVOLUMESTRIPCONTEXT(2パラメータPolygon)を使用する場合は、PKMSTRIPCONTEXT型へキャストして設定してください。

> また、kmGenerateStripHead()関数を呼び出す前に pStripContext->nSize に必ず使用する構造体のサイズを設定する必要があります。 正しいサイズが設定されていない場合の動作は保証しません。

> KMSTRIPCONTEXT(KMTWOVOLUMESTRIPCONTEXT)内の詳細な設定については、それぞれのリファレンスを参照してください。

> 引数nVertexTypeには、次のVertexTypeを設定します。

> - KM_VERTEXTYPE_00
> - KM_VERTEXTYPE_01
> - KM_VERTEXTYPE_02
> - KM_VERTEXTYPE_03
> - KM_VERTEXTYPE_04
> - KM_VERTEXTYPE_05
> - KM_VERTEXTYPE_06
> - KM_VERTEXTYPE_07
> - KM_VERTEXTYPE_08
> - KM_VERTEXTYPE_09
> - KM_VERTEXTYPE_10
> - KM_VERTEXTYPE_11
> - KM_VERTEXTYPE_12
> - KM_VERTEXTYPE_13
> - KM_VERTEXTYPE_14
> - KM_VERTEXTYPE_15
> - KM_VERTEXTYPE_16
> - KM_VERTEXTYPE_17

### 用例

>     KMSTRIPHEAD StripHead;
>     KMTWOVOLUMESTRIPCONTEXT TwoVolStripContext;
>     	:
>     TwoVolStripContext.nSize = sizeof(KMTWOVOLUMESTRIPCONTEXT);
>     kmGenerateStripHead( &StripHead,
>     	(PKMSTRIPCONTEXT)&TwoVolStripContext,KM_VERTEXTYPE_09 );

kmGenerateStripHead

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