vlax-curve-getClosestPointTo

vlax-curve-getArea

V Functions

vlax-curve-getClosestPointToProjection

 

AutoLISP Reference Guide > AutoLISP Functions > V Functions > 

vlax-curve-getClosestPointTo

Returns the point (in WCS) on a curve that is nearest to the specified point

(vlax-curve-getClosestPointTo curve-obj givenPnt [extend])

Arguments

curve-obj

The VLA-object to be measured.

givenPnt

A point (in WCS) for which to find the nearest point on the curve.

extend

If specified and not nil, vlax-curve-getClosestPointTo extends the curve when searching for the nearest point.

Return Values

A 3D point list representing a point on the curve, if successful; otherwise nil.

Examples

Assume that the curve being measured is the arc in the following drawing:

Return the closest point on the arc to the coordinates 6.0, 0.5:

_$ (vlax-curve-getClosestPointTo
arcObj '(6.0 0.5 0.0))

(6.0 1.5 0.0)

Return the closest point on the arc to the coordinates 6.0, 0.5, after extending the arc:

_$ (vlax-curve-getClosestPointTo
arcObj '(6.0 0.5 0.0) T)

(5.7092 0.681753 0.0)