pymel.core.modeling.rebuildCurve¶
- rebuildCurve(*args, **kwargs)¶
This command rebuilds a curve by modifying its parameterization. In some cases the shape may also change. The rebuildType (-rt) determines how the curve is to be rebuilt. The optional second curve can be used to specify a reference parameterization.
Flags:
Long Name / Short Name Argument Types Properties caching / cch bool Modifies the node caching mode. See the node documentation for more information. Note:For advanced users only. constructionHistory / ch bool Turn the construction history on or off. degree / d int The degree of the resulting curve 1 - linear, 2 - quadratic, 3 - cubic, 5 - quintic, 7 - heptic Default:3 endKnots / end int End conditions for the curve 0 - uniform end knots, 1 - multiple end knots, Default:0 fitRebuild / fr bool If true use the least squares fit rebuild. Otherwise use the convert method. Default:true frozen / fzn bool keepControlPoints / kcp bool If true, the CVs will remain the same. This forces uniform parameterization unless rebuildType is matchKnots. Default:false keepEndPoints / kep bool If true, keep the endpoints the same. Default:true keepRange / kr int Determine the parameterization for the resulting curve. 0 - reparameterize the resulting curve from 0 to 1, 1 - keep the original curve parameterization, 2 - reparameterize the result from 0 to number of spans Default:1 keepTangents / kt bool If true, keep the end tangents the same. Default:true name / n unicode Sets the name of the newly-created node. If it contains namespace path, the new node will be created under the specified namespace; if the namespace does not exist, it will be created. noChanges / nc bool nodeState / nds int Modifies the node state. See the node documentation for more information. Note:For advanced users only. Flag can have multiple arguments, passed either as a tuple or a list. object / o bool Create the result, or just the dependency node. range / rn bool Force a curve range on complete input curve. rebuildType / rt int How to rebuild the input curve. 0 - uniform, 1 - reduce spans, 2 - match knots, 3 - remove multiple knots, 4 - curvature 5 - rebuild ends 6 - clean Default:0 replaceOriginal / rpo bool Create in place(i.e., replace). Advanced flags smartSurfaceCurveRebuild / scr bool If true, curve on surface is rebuild in 3D and 2D info is kept Default:false spans / s int The number of spans in resulting curve Used only if rebuildType is uniform. Default:4 tolerance / tol float The tolerance with which to rebuild. Default:0.01 Common flags Derived from mel command maya.cmds.rebuildCurve
Example:
import pymel.core as pm # rebuild curve to 5 uniform spans pm.rebuildCurve( rt=0, s=5 ) # rebuild curve by reducing redundant spans pm.rebuildCurve( rt=1 ) # rebuild curve by matching the parameterization of another curve # curve1 is the curve to rebuild # curve2 is the reference curve pm.rebuildCurve( 'curve1', 'curve2', rt=2 ) # rebuild curve by removing all multiple interior knots pm.rebuildCurve( rt=3 ) # rebuild curve using the curvature of the curve # to create more spans where curvature is higher pm.rebuildCurve( rt=4 )