double MoveToCurveLength (object curve, object obj, double length, double dampen )

Return Value: 1.0 for success, 0.0 for failure

Arguments:

Causes obj to change it's position so that it is attached to the specified curve item. The position on the curve is specified by the length argument, this is the length along the curve starting from the first point (Note: re-ordering the points of the curve in Setup->Tools may affect this function if the first point changes). You can use the GetCurveLength( ) function to find the length of the curve. You are allowed to enter a negative length or a length that is greater than the actual length of the curve, this will cause the item to be place off of the curve as though the curve continued in space. The results might not be desirable so it is suggested that the length value be kept within the physical length of the curve.