C++ Syntax

MKI_RESULTVALUE

MKI_TransformReverseAllOutlines(

MKI_CONST_ENTITY_OBJECT_PTR f_pObjPtr1,

MKI_ENTITY_OBJECT_PTR f_pObjPtr2 );

Reverts the orientation of a given standard object, if possible.

Parameters

ObjPtr1

[MKI_CONST_ENTITY_OBJECT_PTR] Address of the object whose orientation shall be reverted. This object must be of one of the following types (see MKI_OBJ_*):

MKI_OBJ_LINE

MKI_OBJ_CURVE

MKI_OBJ_HATCH

MKI_OBJ_SURFACE

MKI_OBJ_ZIGZAG

MKI_OBJ_CIRCLE

MKI_OBJ_ARC

MKI_OBJ_SECTOR

MKI_OBJ_SEGMENT

MKI_OBJ_ELLIPSE

MKI_OBJ_EARC

MKI_OBJ_ESECTOR

MKI_OBJ_ESEGMENT

MKI_OBJ_GEOENDLESS

MKI_OBJ_GEOBEAM New in Version 2019.1

MKI_OBJ_GEOLINE

MKI_OBJ_GEOCIRCLE

MKI_OBJ_GEOARC

MKI_OBJ_GEOSECTOR

MKI_OBJ_GEOSEGMENT

MKI_OBJ_GEOELLIPSE

MKI_OBJ_GEOEARC

MKI_OBJ_GEOESECTOR

MKI_OBJ_GEOESEGMENT

MKI_OBJ_GEOCURVE

MKI_OBJ_GEOSURFACE

ObjPtr2

[MKI_ENTITY_OBJECT_PTR] Address of a buffer that shall receive the reverted object. This buffer must be at least MKI_MaxEntityData() bytes large, and can e.g. be created using MKI_EntityBuffer(). The resulting object will usually be of the same type as the input object. Exception: A circle will be converted into a surface with two 180 degree arcs!

Return Value Changed in Version 2022.1

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

MKI_RESULT_OK

The object was reverted successfully.

MKI_RESULT_MEMORYFULL

The command cannot be executed due to full memory.

MKI_RESULT_PARAMETER

Parameters were invalid.

Comment

All non-geometric data stored in ObjPtr1 will be copied to ObjPtr2, especially all properties.

In order to insert the resulting reverted object into the drawing, use the MKI_ObjectOpen, MKI_ObjectCopyDataBlocks, and the MKI_ObjectFastInsert functions.