C++ Syntax

MKI_InputGenerateSurfaceStep1(

__int32* f_pMode,

double* f_pTolerance,

Prepares the generation of a surface by enumerating all select objects and creating a set of intersection-free contour elements. This will only work if the current command forced a multi-entity selection.

At a later time, call MKI_InputGenerateSurfaceStep2() to generate a surface based on the buffer filled here and a number of reference points entered by the user.

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_pMode

[__int32*] Address of a tracking mode to be used or nullptr if the application's global settings shall be used. A bit-wise OR combination of flags indicating which entity types shall be used for tracking the input data. The following values can be used:

MKI_TRACKMODE_OBJECTS

Normal drawing objects will be included in the calculation.

MKI_TRACKMODE_TEXTS

Texts (i.e. characters in texts and dimensions) will be included in the calculation.

MKI_TRACKMODE_HATCHINGS

Hatchings (i.e. the resulting contents of dynamic hatchings as well es static hatchings) will be included in the calculation.

MKI_TRACKMODE_GEO

Construction Aid objects will be included in the calculation.

MKI_TRACKMODE_TEMP Renamed in Version 2025.0

Temporary objects will be included in the calculation.

f_pTolerance

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

f_pBuffer

[MKI_BUFFER_REF] Address of a buffer that will be used to store all intermediate data. Allocate the required memory for the buffer by calling f_rBuffer.Alloc( 2, false ) before. This data should be kept until it is used in MKI_InputGenerateSurfaceStep2() and can afterwards be freed using f_rBuffer.Free().

Return Value

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

MKI_RESULT_OK

The preparation was successful and the respective data is stored in f_rBuffer.

MKI_RESULT_IDENT

No valid objects were identified.

MKI_RESULT_COMPLEX

The resulting object would be too complex.

MKI_RESULT_ERROR

The command cannot be executed or the user has cancelled the process because it took too long.

MKI_RESULT_MEMORYFULL

The command cannot be executed due to full memory.

MKI_RESULT_PARAMETER

Parameters were invalid.

Comment

Multi-entity identification is forced by using point types whose names begin with MKI_POINT_ID_MULTI (but not with MKI_POINT_ID_MULTIPOINT). For a complete list of point types, see MKI_POINT_*.