DivideCurveEquidistant

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.

Syntax

rhinoscriptsyntax.DivideCurveEquidistant (curve_id, distance, create_points=False, return_points=True)

rhinoscript.curve.DivideCurveEquidistant (curve_id, distance, create_points=False, return_points=True)

Parameters

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.

Returns

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.

Example

import rhinoscriptsyntax as rs

obj = rs.GetObject("Select a curve", rs.filter.curve)

if obj:

    points = rs.DivideCurveEquidistant(obj, 4, True)

Also See

DivideCurve

DivideCurveLength