AddPipe

Creates a singled-walled surface with a circular profile around a curve.

Syntax

rhinoscriptsyntax.AddPipe (curve_id, parameters, radii, blend_type=0, cap=0, fit=False)

rhinoscript.surface.AddPipe (curve_id, parameters, radii, blend_type=0, cap=0, fit=False)

Parameters

curve_id

Required.  String or Guid.  The identifier of the path curve object.

parameters

Required.  List or number.  A list of one or more curve parameters where changes in radius occur.

radii

Required.  List or number.  A list of radii; one at each curve parameter in parameters.

blend_type

Optional.  Number.  The type of shape blending, where:

Value

Description

0 (Default)

Local.  The pipe radius stays constant at the ends and changes more rapidly in the middle.

1

Global.  The radius is linearly blended from one end to the other, creating pipes that taper from one radius to the other.

cap

Optional.  Number.  The end cap mode, where:

Value

Description

0 (Default)

None.

1

Flat.  Capped with a planar surface.

2

Round.  Capped with hemispherical surface.

fit

Optional.  Boolean.  If the curve is a polycurve of lines and arcs, the curve is fit and a single surface is created; otherwise the result is a polysurface with joined surfaces created from the polycurve segments.  The default is not to fit (False).

Returns

List

The identifier of the new objects if successful.  If curve_id is a line segment, parameters contains the value 0, radii contains one value, and cap  is either 0 (None) or 1 (Flat), then an extrusion object will be returned. Otherwise, a polysurface object will be returned.  Note, it is possible for more than one object to be returned (when it is not possible to miter sharp corners, for example).

None

If not successful, or on error.

Example

import rhinoscriptsyntax as rs

curve = rs.GetObject("Select curve to create pipe around", rs.filter.curve, True)

if curve:

    domain = rs.CurveDomain(curve)

    rs.AddPipe(curve, 0, 4)

Also See

AddThickPipe