Constructs Rendering Parameters (KMSTRIPHEAD).

Prototype declaration:


KMSTATUS KMAPI
kmGenerateStripHead(
        OUT PKMSTRIPHEAD        pStripHead,
        IN  PKMSTRIPCONTEXT     pStripContext,
        IN  KMVERTEXTYPE        nVertexType
);

Description:

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.

Parameters:
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
Return values:
Value Explanation
KMSTATUS_SUCCESS Success
KMSTATUS_INVALID_ADDRESS pStripHead or pStripContext is invalid (NULL).
KMSTATUS_INVALID_SETTING pStripContext size setting is invalid.