Returns the point on this Curve object closest to the given point.
Parameters
Parameters
Description
givenPoint
[in] Given point.
pointOnCurve
[out] Receives the closed point on this Curve object.
extend
[in] Extends this Curve object if and only if true.
normal
[in] Normal to the projection plane.
Returns
Returns eOk if successful, or an appropriate error code if not.
Remarks
If normal is specified, this Curve object is projected onto the plane defined by givenPoint and normal, finds the closest point on the projected curve to givenPoint, and projects said closest point back onto the plane of this Curve object. It is this point that is returned as pointOnCurve.