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によって下記のようになります。

KMTWOVOLUMESTRIPCONTEXT(2パラメータPolygon)を使用する場合は、PKMSTRIPCONTEXT型へキャストして設定してください。

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

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

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


用例

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

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