Prototype declaration:
KMSTATUS KMAPI kmGenerateStripHead( OUT PKMSTRIPHEAD pStripHead, IN PKMSTRIPCONTEXT pStripContext, IN KMVERTEXTYPE nVertexType );
Description:
Parameters:This function constructs the rendering parameters (KMSTRIPHEAD) from KMSTRIPCONTEXT (KMTWOVOLUMESTRIPCONTEXT). KMSTRIPHEAD can be constructed by two methods, either kmGenerateStripHead or kmGenerateStripHeadXX (00 to 17). Example: Constructing VertexType03 rendering parameters: (1)kmGenerateStripHead(pStripHead,pStripContext,KM_VERTEXTYPE_03); (2)kmGenerateStripHead03 Both (1) and (2) can be used to construct VertexType03 KMSTRIPHEAD. The pStripContext setting depends on the VertexType to be used. - When using VertextType00 to 08, 15, or 16: Specify the pointer for KMSTRIPCONTEXT. - When using VertextType09 to 14 (two parameters): Specify the pointer for KMTWOVOLUMESTRIPCONTEXT. In addition, it is necessary to specify the size of the structure that it to be used in nSize from pStripContext before calling kmGenerateStripHead. Operation is not guaranteed if the same size is not set. For details on the settings within KMSTRIPCONTEXT (KMTWOVOLUMESTRIPCONTEXT), refer to the description of the KMSTRIPCONTEXT (KMTWOVOLUMESTRIPCONTEXT) structure.
Return values:pStripHead(output) This parameter is a pointer to KMSTRIPHEAD. pStripContext(input) This parameter is a pointer to KMSTRIPCONTEXT. When using KMTWOVOLUMESTRIPCONTEXT (two-parameter polygons), cast to the PKMSTRIPCONTEXT type. ex) KMSTRIPHEAD StripHead; KMTWOVOLUMESTRIPCONTEXT TwoVolStripContext; ... TwoVolStripContext.nSize = sizeof(KMTWOVOLUMESTRIPCONTEXT); kmGenerateStripHead( &StripHead, (PKMSTRIPCONTEXT)&TwoVolStripContext,KM_VERTEXTYPE_09 ); nVertexType(input) Sets the 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
Value Explanation KMSTATUS_SUCCESS Success KMSTATUS_INVALID_ADDRESS pStripHead or pStripContext is invalid (NULL). KMSTATUS_INVALID_SETTING pStripContext size setting is invalid.