C++ Syntax

MKI_RESULTVALUE

MKI_InputGenerateSurfaceStep2(

__int32 f_nPointIndex,

__int32 f_nPointCount,

MKI_BUFFER_REF f_rBuffer

double* f_pTolerance,

MKI_CONST_SIMPLIFY_DATA_PTR f_pSimplify,

bool f_fSecondary );

Generates and returns a surface based on an object selection and several reference points. This will only work if MKI_InputGenerateSurfaceStep1() was successfully executed before and the current command requested at least one reference point.

Parameters

f_nPointIndex

[__int32] Zero-based point index. This index states at which point entry the first reference point that was entered. Valid range: 0 <= Value < MKI_INPUT_DEF_MAX.

f_nPointCount

[__int32] Number of total reference points, including the point defined by PointIndex. Valid range: 1 <= Value < MKI_INPUT_MAX.

f_pBuffer

[MKI_BUFFER_REF] Address of a buffer containing the intermediate data created by MKI_InputGenerateSurfaceStep1(). This data should be kept until it is no longer required and can then be freed using f_rBuffer.Free().

f_pTolerance

[double*] Address of a tolerance to be used or nullptr if the application's global settings shall be used.

f_pSimplify

[MKI_CONST_SIMPLIFY_DATA_PTR] Address of a set of simplification options to be used or nullptr if the application's global settings shall be used.

f_fSecondary

[bool] If true, the surface will be stored in the secondary temporary entity. Otherwise, the surface will be stored in the first temporary entity.

Return Value

Result as a bitwise-or combination of flags (see MKI_RESULT_*).

MKI_RESULT_OK

The surface was generated successfully and is stored in the temporary entity that can be accessed using MKI_InputGetTempEntity() or displayed using MKI_InputDrawTempEntity().

MKI_RESULT_IDENT

No valid objects were identified (i.e. MKI_InputGenerateSurfaceStep1() was obviously not successfully executed before).

MKI_RESULT_COMPLEX

The resulting object would be too complex.

MKI_RESULT_ERROR

The command cannot be executed, e.g. since the chosen objects do not form a closed surface.

MKI_RESULT_MEMORYFULL

The command cannot be executed due to full memory.

MKI_RESULT_PARAMETER

Parameters were invalid.

Comment

On how the generation of surfaces works, see the description of the "Trim > Surface / Curve > Generate Surface" command of the serving application.