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によって下記のようになります。
KMTWOVOLUMESTRIPCONTEXT(2パラメータPolygon)を使用する場合は、PKMSTRIPCONTEXT型へキャストして設定してください。
- VertexType00〜08、15、16を使用する場合 KMSTRIPCONTEXTへのポインタを指定します。
- VertexType09〜14(2パラメータ)を使用する場合 KMTWOVOLUMESTRIPCONTEXTへのポインタを指定します。
また、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 );