Divides a curve such that the linear distance between the points is equal.
Unlike the DivideCurve and DivideCurveLength, which divides a curve based on arc length, or the distance along the curve between two points, this function divides a curve based on the linear distance between points.
rhinoscriptsyntax.DivideCurveEquidistant (curve_id, distance, create_points=False, return_points=True)
rhinoscript.curve.DivideCurveEquidistant (curve_id, distance, create_points=False, return_points=True)
curve_id |
Required. String or Guid. The object's identifier. |
distance |
Required. Number. The linear distance between division points. |
create_points |
Optional. Boolean. Create the division points. If omitted or False, points are not created. |
return_points |
Optional. Boolean. Return a list of 3-D points. If omitted or True, points are returned. If False, then an array of curve parameters are returned. |
List |
If return_points is not specified or True, then a list containing 3-D division points if successful. |
List |
If return_points is False, then a list containing division curve parameters if successful. |
None |
If not successful, or on error. |
import rhinoscriptsyntax as rs
obj = rs.GetObject("Select a curve", rs.filter.curve)
if obj:
points = rs.DivideCurveEquidistant(obj, 4, True)