C++ Syntax

__int32

MKI_CalcRadiusFit(

MKI_CONST_GEO_OBJECT_REF f_rGeoObj1,

MKI_CONST_GEO_OBJECT_REF f_rGeoObj2,

double f_dRadius,

__int32 f_nObjType,

MKI_GEO_OBJECT_PTR f_pResults );

Calculates circles or circular arcs with a given radius so that they tangent the two given objects.

Parameters

GeoObj1

[MKI_CONST_GEO_OBJECT_REF] First standard object which the calculated object shall be tangenting. Following standard object types are supported (see MKI_OBJ_*):

MKI_OBJ_LINE

MKI_OBJ_CIRCLE

MKI_OBJ_MARK

MKI_OBJ_GEOENDLESS

MKI_OBJ_GEOBEAM New in Version 2019.1

MKI_OBJ_GEOLINE

MKI_OBJ_GEOCIRCLE

GeoObj2

[MKI_CONST_GEO_OBJECT_REF] Second standard object which the calculated object shall be tangenting. Following standard object types are supported (see MKI_OBJ_*):

MKI_OBJ_LINE

MKI_OBJ_CIRCLE

MKI_OBJ_MARK

MKI_OBJ_GEOENDLESS

MKI_OBJ_GEOBEAM New in Version 2019.1

MKI_OBJ_GEOLINE

MKI_OBJ_GEOCIRCLE

Radius

[double] Desired radius of the calculated circles or circular arcs.

ObjType

[__int32] Desired object type of the calculated objects. Following standard object types are supported (see MKI_OBJ_*):

MKI_OBJ_CIRCLE

MKI_OBJ_ARC

MKI_OBJ_SECTOR

MKI_OBJ_SEGMENT

MKI_OBJ_GEOCIRCLE

If the desired object type is either MKI_OBJ_ARC, MKI_OBJ_SECTOR or MKI_OBJ_SEGMENT, the serving application will first calculate circles that fit the given conditions and will then split each circle into two parts that each start and end at the tangent points. As a result, circle parts will always be returned in pairs.

Results

[MKI_GEO_OBJECT_PTR] Address of object buffer to receive the calculated objects. Allow at least 16 objects.

Return Value

Number of objects found. The type of objects returned is determined by the ObjType parameter.

Comment

When initializing the members of the structure MKI_GEO_OBJECT, you need to set only those members that are actually required to describe the object geometrically, i.e., you only have to initialize the following members of MKI_GEO_OBJECT: Type (to indicate which type of object is stored in the structure), p1..p5 (depending on the object type), and Orient (not for the line object types).