Prototype declaration:
KMSTATUS KMAPI kmInitStripContext( IN KMDWORD dwIndex, OUT PKMVOID pStripContext );
Description:
Parameters:This function initializes StripContext (KMSTRIPCONTEXT). There are two methods: one that uses the KMSTRIPCONTEXT (KMTWOVOLUMESTRIPCONTEXT) that was registered by the user through kmRegisterDefaultStripContext, and one that uses the basic KMSTRIPCONTEXT (KMTWOVOLUMESTRIPCONTEXT) that is provided by the Kamui2 system. 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.
Return values:dwIndex(input) This sets up the index (below) that is to be used. - When using the basic KMSTRIPCONTEXT (KMTWOVOLUMESTRIPCONTEXT) that is provided by the system For a polygon: Specify by ORing the following setting flags and the ListType. KM_STRIPCONTEXT_SYS_FLAT Basic setting for Flatshading KM_STRIPCONTEXT_SYS_GOURAUD Basic setting for GouraudShading (Example) KM_STRIPCONTEXT_SYS_GOURAUD | KM_OPAQUE_POLYGON Use the basic setting for GouraudShading in OpaquePolygon. For a modifier: Specify by ORing the following setting flags and the ListType. KM_STRIPCONTEXT_SYS_NORMAL_MODIFIER Basic setting for normal modifiers (except first and last) KM_STRIPCONTEXT_SYS_INCLUDE_FIRST_MODIFIER Basic setting for first INCLUDE modifier KM_STRIPCONTEXT_SYS_EXCLUDE_FIRST_MODIFIER Basic setting for first EXCLUDE modifier KM_STRIPCONTEXT_SYS_INCLUDE_LAST_MODIFIER Basic setting for last INCLUDE modifier KM_STRIPCONTEXT_SYS_EXCLUDE_LAST_MODIFIER Basic setting for last EXCLUDE modifier (Example) KM_STRIPCONTEXT_SYS_INCLUDE_LAST_MODIFIER | KM_OPAQUE_MODIFIER Use the basic setting for the last INCLUDE modifier in OpaqueModifier. - When using a user-defined KMSTRIPCONTEXT (KMTWOVOLUMESTRIPCONTEXT) that was registered through kmRegisterDefaultStripContext: KM_STRIPCONTEXT_USER00 KM_STRIPCONTEXT_USER01 KM_STRIPCONTEXT_USER02 KM_STRIPCONTEXT_USER03 KM_STRIPCONTEXT_USER04 KM_STRIPCONTEXT_USER05 KM_STRIPCONTEXT_USER06 KM_STRIPCONTEXT_USER07 KM_STRIPCONTEXT_USER08 KM_STRIPCONTEXT_USER09 pStripContext(output) This specifies the pointer for the structure that is to be used (either KMSTRIPCONTEXT or KMTWOVOLUMESTRIPCONTEXT). [Basic KMSTRIPCONTEXT (KMTWOVOLUMESTRIPCONTEXT) settings] The settings for the basic KMSTRIPCONTEXT (KMTWOVOLUMESTRIPCONTEXT) that is provided by the system are shown below. pStripContext->StripControl.nListType Specified ListType setting pStripContext->StripControl.nUserClipMode KM_USERCLIP_DISABLE pStripContext->StripControl.nShadowMode KM_NORMAL_POLYGON pStripContext->StripControl.nIntensityMode KM_INTENSITY pStripContext->StripControl.bOffset KM_FALSE pStripContext->StripControl.bGouraud Specified ShadingMode setting pStripContext->ObjectControl.nDepthCompare KM_GREATER pStripContext->ObjectControl.nCullingMode KM_NOCULLING pStripContext->ObjectControl.bZWriteDisable KM_FALSE pStripContext->ObjectControl.bDCalcControl KM_FALSE pStripContext->ObjectControl.dwModifierInstruction Specified Modifier setting - Common KM_INTENSITY_BASE/KM_INTENSITY_BASE_2ND/KM_INTENSITY_OFFSET pStripContext->type.intensity.Face[XX].fAlpha 1.0f pStripContext->type.intensity.Face[XX].fRed 1.0f pStripContext->type.intensity.Face[XX].fGreen 1.0f pStripContext->type.intensity.Face[XX].fBlue 1.0f - Common KM_IMAGE_PARAM1/KM_IMAGE_PARAM2 pStripContext->ImageControl[XX].nSRCBlendingMode KM_ONE (KM_SRCALPHA when using TransPolygon) pStripContext->ImageControl[XX].nDSTBlendingMode KM_ZERO (KM_INVSRCCOLOR when using TransPolygon) pStripContext->ImageControl[XX].bSRCSelect KM_FALSE pStripContext->ImageControl[XX].bDSTSelect KM_FALSE pStripContext->ImageControl[XX].nFogMode KM_NOFOG pStripContext->ImageControl[XX].bColorClamp KM_FALSE pStripContext->ImageControl[XX].bUseAlpha KM_FALSE (KM_TRUE when using TransPolygon) pStripContext->ImageControl[XX].bIgnoreTexureAlpha KM_FALSE pStripContext->ImageControl[XX].nFlipUV KM_NOFLIP pStripContext->ImageControl[XX].nClampUV KM_NOCLAMP pStripContext->ImageControl[XX].nFilterMode KM_POINT_SAMPLE pStripContext->ImageControl[XX].bSuperSampleMode KM_FALSE pStripContext->ImageControl[XX].dwMipmapAdjust KM_MIPMAP_D_ADJUST_1_00 pStripContext->ImageControl[XX].nTextureShadingMode KM_MODULATE (KM_MODULATE_ALPHA when using TransPolygon) pStripContext->ImageControl[XX].dwPaletteBank 0 pStripContext->ImageControl[XX].pTextureSurfaceDesc NULL
Value Explanation KMSTATUS_SUCCESS Success KMSTATUS_INVALID_ADDRESS pStripContext is invalid (NULL). KMSTATUS_INVALID_SETTING pStripContext size setting is invalid.