MKI_CalcPerpendicular (Calculation) Changed in Version 2019.1

C++ Syntax

__int32

MKI_CalcPerpendicular(

 MKI_CONST_GEO_OBJECT_REF f_rGeoObj,

 MKI_CONST_POINT_REF f_rPoint,

 MKI_POINT_PTR f_pResults );

Drops a perpendicular from a point onto a standard object and calculates the resulting perpendicular base points (i.e. end-points of the perpendicular).

Parameters

GeoObj

[MKI_CONST_GEO_OBJECT_REF] Standard object onto which the perpendicular is to be dropped. Following standard object types are supported (see MKI_OBJ_*):

MKI_OBJ_LINE

MKI_OBJ_CURVE

MKI_OBJ_CIRCLE

MKI_OBJ_ELLIPSE

MKI_OBJ_GEOENDLESS

MKI_OBJ_GEOBEAM New in Version 2019.1

MKI_OBJ_GEOLINE

MKI_OBJ_GEOCURVE

MKI_OBJ_GEOCIRCLE

MKI_OBJ_GEOELLIPSE

Point

[MKI_CONST_POINT_REF] Coordinates of the reference point in internal [mm] (relative to the page center, scale-independent).

Results

[MKI_POINT_PTR] Address of point buffer to receive the calculated perpendicular base points. Allow at least 16 points.

Return Value

Number of perpendicular base points found.

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).