pymel.core.modeling.rebuildCurve

static modeling.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 ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Modifies the node caching mode. See the node documentation for more information. Note:For advanced users only.
constructionHistory (ch) bool ../../../_images/create.gif
 
Turn the construction history on or off
degree (d) int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
The degree of the resulting curve 1 - linear, 2 - quadratic, 3 - cubic, 5 - quintic, 7 - heptic Default:3
endKnots (end) int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
End conditions for the curve 0 - uniform end knots, 1 - multiple end knots, Default:0
fitRebuild (fr) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
If true use the least squares fit rebuild. Otherwise use the convert method. Default:true
keepControlPoints (kcp) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
If true, the CVs will remain the same. This forces uniform parameterization unless rebuildType is matchKnots. Default:false
keepEndPoints (kep) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
If true, keep the endpoints the same. Default:true
keepRange (kr) int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 

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 ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
If true, keep the end tangents the same. Default:true
name (n) unicode ../../../_images/create.gif
 
Name the resulting object
noChanges (nc) bool  
   
nodeState (nds) int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Modifies the node state. See the node documentation for more information. Note:For advanced users only. Common flags
object (o) bool ../../../_images/create.gif
 
Create the result, or just the dependency node
range (rn) bool ../../../_images/create.gif
 
Force a curve range on complete input curve Flag can have multiple arguments, passed either as a tuple or a list.
rebuildType (rt) int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
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 ../../../_images/create.gif
 
Create in place(i.e., replace)
smartSurfaceCurveRebuild (scr) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
If true, curve on surface is rebuild in 3D and 2D info is kept Default:false Advanced flags
spans (s) int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
The number of spans in resulting curve Used only if rebuildType is uniform. Default:4
tolerance (tol) float ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
The tolerance with which to rebuild. Default:0.01

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 )

Previous topic

pymel.core.modeling.querySubdiv

Next topic

pymel.core.modeling.rebuildSurface

Core

Core Modules

Other Modules

This Page