Return View Dependent Location of Point on Curve

Synopsis

num = VDCPRM/obj,{point|x,y,z}[,'view name']

Description

Returns the parameterized location along an existing curve which is nearest a specified point. The proximity of the specified point to the curve is view dependent. Therefore, the calculation takes place as if all geometry is projected into a plane parallel to the screen.

The location is parameterized between 0 and 1 where the distance from 0 to 1 is the length of the curve. If the point lies off the curve, the location returned is either zero or one, depending upon which end of the curve the point is nearer.

Parameters

Parameter

Description

obj

An existing object which represents the curve that the locations are calculated along. The curve may be a line, circle, conic, or spline.

point

An existing point which defines the position near the curve or curve extension where the location should be calculated.

x,y,z

Three numerical values or a three position numerical array which represents the work coordinates of a position near the curve or curve extension where the location should be calculated.

'view name'

A string or string variable which represents the name of the view where the calculation is performed. If the view name is omitted, the calculation is performed in the work view.

Parameter	Description
obj	An existing object which represents the curve that the locations are calculated along. The curve may be a line, circle, conic, or spline.
point	An existing point which defines the position near the curve or curve extension where the location should be calculated.
x,y,z	Three numerical values or a three position numerical array which represents the work coordinates of a position near the curve or curve extension where the location should be calculated.
'view name'	A string or string variable which represents the name of the view where the calculation is performed. If the view name is omitted, the calculation is performed in the work view.