C++ Syntax

MKI_RESULTVALUE

MKI_TransformStartPoint(

MKI_CONST_ENTITY_OBJECT_PTR f_pObjPtr1,

MKI_ENTITY_OBJECT_PTR f_pObjPtr2,

MKI_CONST_POINT_REF f_rPoint );

Transforms the given object so that the start-point of the outline lying nearest to the given reference point is moved next to this reference point. The reference point does not have to be an exact match. All non-geometric data stored in ObjPtr1 will be copied to ObjPtr2, especially all properties and attributes.

Parameters

ObjPtr1

[MKI_CONST_ENTITY_OBJECT_PTR] Address of the object whose start-point shall be moved. This object must be of type MKI_OBJ_SURFACE (see MKI_OBJ_*).

ObjPtr2

[MKI_ENTITY_OBJECT_PTR] Address of a buffer that shall receive the modified object. This buffer must be at least MKI_MaxEntityData() bytes large, and can e.g. be created using MKI_EntityBuffer(). The resulting object will be of type MKI_OBJ_SURFACE (see MKI_OBJ_*).

Point

[MKI_CONST_POINT_REF] Address of the reference point. This point both defines which outline will be modified and to where the start-point of that outline will be moved.

Return Value Changed in Version 2022.1

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