MKI_TransformDistortable (Entity Editing) Changed in Version 2022.1

C++ Syntax

MKI_RESULTVALUE

MKI_TransformDistortable(

 MKI_CONST_ENTITY_PTR f_pEntityPtr1,

 MKI_ENTITY_PTR f_pEntityPtr2 );

Transforms the given object into a similar object that does no longer contain circles or circular arcs. This function is sometimes required before distorting an object.

This procedure accepts MKI_ENTITYTYPE_OBJECT, MKI_ENTITYTYPE_CLIP, MKI_ENTITYTYPE_MAPPING, MKI_ENTITYTYPE_HATCH, and MKI_ENTITYTYPE_GROUP as input entity type in EntityPtr1, returning the same entity type in EntityPtr2. All non-geometric data stored in EntityPtr1 will be copied to EntityPtr2, especially all properties and attributes.

Parameters

EntityPtr1

[MKI_CONST_ENTITY_PTR] Address of the object that shall be transformed to a distortable object.

EntityPtr2

[MKI_ENTITY_PTR] Address of a buffer that shall receive the transformed object. This buffer must be at least MKI_MaxEntityData() bytes large, and can e.g. be created using MKI_EntityBuffer().

Return Value Changed in Version 2022.1

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