Prototype declaration:
KMSTATUS KMAPI kmGenerateStripHead13( OUT PKMSTRIPHEAD pStripHead, IN PKMSTRIPCONTEXT pStripContext, );
Description:
Parameters:This function constructs rendering parameters (KMSTRIPHEAD) for VertexType13 from KMTWOVOLUMESTRIPCONTEXT. Set the parameters that are to be used in the members indicated below in KMTWOVOLUMESTRIPCONTEXT. Operation is not guaranteed if all parameters are not set. pStripContext->nSize ( = sizeof(KMTWOVOLUMESTRIPCONTEXT) ) pStripContext->StripControl.nListType pStripContext->StripControl.nUserClipMode pStripContext->StripControl.nIntensityMode pStripContext->StripControl.bOffset pStripContext->StripControl.bGouraud pStripContext->ObjectControl.nDepthCompare pStripContext->ObjectControl.nCullingMode pStripContext->ObjectControl.bZWriteDisable pStripContext->ObjectControl.bDCalcControl pStripContext->ImageControl[KM_IMAGE_PARAM1].nSRCBlendingMode pStripContext->ImageControl[KM_IMAGE_PARAM1].nDSTBlendingMode pStripContext->ImageControl[KM_IMAGE_PARAM1].bSRCSelect pStripContext->ImageControl[KM_IMAGE_PARAM1].bDSTSelect pStripContext->ImageControl[KM_IMAGE_PARAM1].nFogMode pStripContext->ImageControl[KM_IMAGE_PARAM1].bColorClamp pStripContext->ImageControl[KM_IMAGE_PARAM1].bUseAlpha pStripContext->ImageControl[KM_IMAGE_PARAM1].bIgnoreTextureAlpha pStripContext->ImageControl[KM_IMAGE_PARAM1].nFlipUV pStripContext->ImageControl[KM_IMAGE_PARAM1].nClampUV pStripContext->ImageControl[KM_IMAGE_PARAM1].nFilterMode pStripContext->ImageControl[KM_IMAGE_PARAM1].bSuperSampleMode pStripContext->ImageControl[KM_IMAGE_PARAM1].dwMipmapAdjust pStripContext->ImageControl[KM_IMAGE_PARAM1].nTextureShadingMode pStripContext->ImageControl[KM_IMAGE_PARAM1].pTextureSurfaceDesc pStripContext->ImageControl[KM_IMAGE_PARAM2].nSRCBlendingMode pStripContext->ImageControl[KM_IMAGE_PARAM2].nDSTBlendingMode pStripContext->ImageControl[KM_IMAGE_PARAM2].bSRCSelect pStripContext->ImageControl[KM_IMAGE_PARAM2].bDSTSelect pStripContext->ImageControl[KM_IMAGE_PARAM2].nFogMode pStripContext->ImageControl[KM_IMAGE_PARAM2].bColorClamp pStripContext->ImageControl[KM_IMAGE_PARAM2].bUseAlpha pStripContext->ImageControl[KM_IMAGE_PARAM2].bIgnoreTextureAlpha pStripContext->ImageControl[KM_IMAGE_PARAM2].nFlipUV pStripContext->ImageControl[KM_IMAGE_PARAM2].nClampUV pStripContext->ImageControl[KM_IMAGE_PARAM2].nFilterMode pStripContext->ImageControl[KM_IMAGE_PARAM2].bSuperSampleMode pStripContext->ImageControl[KM_IMAGE_PARAM2].dwMipmapAdjust pStripContext->ImageControl[KM_IMAGE_PARAM2].nTextureShadingMode pStripContext->ImageControl[KM_IMAGE_PARAM2].pTextureSurfaceDesc The following members are required when: pStripContext->StripControl.nIntensityMode = KM_INTENSITY. pStripContext->type.intensity.Face[KM_INTENSITY_BASE].fAlpha pStripContext->type.intensity.Face[KM_INTENSITY_BASE].fRed pStripContext->type.intensity.Face[KM_INTENSITY_BASE].fGreen pStripContext->type.intensity.Face[KM_INTENSITY_BASE].fBlue pStripContext->type.intensity.Face[KM_INTENSITY_BASE_2ND].fAlpha pStripContext->type.intensity.Face[KM_INTENSITY_BASE_2ND].fRed pStripContext->type.intensity.Face[KM_INTENSITY_BASE_2ND].fGreen pStripContext->type.intensity.Face[KM_INTENSITY_BASE_2ND].fBlue When using a palette texture, the following member settings are needed. pStripContext->ImageControl[KM_IMAGE_PARAM1].dwPaletteBank pStripContext->ImageControl[KM_IMAGE_PARAM2].dwPaletteBank
Return values:pStripHead(output) This specifies the pointer for KMSTRIPHEAD. pStripContext(input) This specifies the pointer for KMTWOVOLUMESTRIPCONTEXT. Cast to the PKMSTRIPCONTEXT type. ex) KMSTRIPHEAD StripHead; KMTWOVOLUMESTRIPCONTEXT TwoVolStripContext; .... TwoVolStripContext.nSize = sizeof(KMTWOVOLUMESTRIPCONTEXT); kmGenerateStripHead13( &StripHead, (PKMSTRIPCONTEXT)&TwoVolStripContext );
Value Explanation KMSTATUS_SUCCESS Success KMSTATUS_INVALID_ADDRESS pStripHead or pStripContext is invalid (NULL). KMSTATUS_INVALID_SETTING pStripContext size setting is invalid.