Go to: Synopsis. Return value. Related. Flags. Python examples.
rebuildCurve(
curve [curve]
, [caching=boolean], [constructionHistory=boolean], [degree=int], [endKnots=int], [fitRebuild=boolean], [keepControlPoints=boolean], [keepEndPoints=boolean], [keepRange=int], [keepTangents=boolean], [name=string], [nodeState=int], [object=boolean], [range=boolean], [rebuildType=int], [replaceOriginal=boolean], [smartSurfaceCurveRebuild=boolean], [spans=int], [tolerance=linear])
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
rebuildCurve is undoable, queryable, and editable.
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.
| string[] | Object name and node name |
In query mode, return type is based on queried flag.
fitBspline, smoothCurve
caching, constructionHistory, degree, endKnots, fitRebuild, keepControlPoints, keepEndPoints, keepRange, keepTangents, name, nodeState, object, range, rebuildType, replaceOriginal, smartSurfaceCurveRebuild, spans, tolerance
| Long name (short name) |
Argument types |
Properties |
|
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)
|
boolean
|
|
|
If true use the least squares fit rebuild.
Otherwise use the convert method.
Default: true
|
|
keepControlPoints(kcp)
|
boolean
|
|
|
If true, the CVs will remain the same.
This forces uniform parameterization unless rebuildType is matchKnots.
Default: false
|
|
keepEndPoints(kep)
|
boolean
|
|
|
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)
|
boolean
|
|
|
If true, keep the end tangents the same.
Default: true
|
|
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
|
|
smartSurfaceCurveRebuild(scr)
|
boolean
|
|
|
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)
|
linear
|
|
|
The tolerance with which to rebuild.
Default: 0.01
|
|
| Common flags |
constructionHistory(ch)
|
boolean
|
|
|
Turn the construction history on or off.
|
|
name(n)
|
string
|
|
|
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.
|
|
object(o)
|
boolean
|
|
|
Create the result, or just the dependency node.
|
|
range(rn)
|
boolean
|
|
|
Force a curve range on complete input curve.
|
|
replaceOriginal(rpo)
|
boolean
|
|
|
Create "in place" (i.e., replace).
|
|
| Advanced flags |
caching(cch)
|
boolean
|
|
|
Modifies the node caching mode. See the node documentation for more information.
Note: For advanced users only.
|
|
nodeState(nds)
|
int
|
|
|
Modifies the node state. See the node documentation for more information.
Note: For advanced users only.
|
|
|
Flag can appear in Create mode of command
|
Flag can appear in Edit mode of command
|
|
Flag can appear in Query mode of command
|
Flag can have multiple arguments, passed either as a tuple or a list.
|
import maya.cmds as cmds
# rebuild curve to 5 uniform spans
cmds.rebuildCurve( rt=0, s=5 )
# rebuild curve by reducing redundant spans
cmds.rebuildCurve( rt=1 )
# rebuild curve by matching the parameterization of another curve
# curve1 is the curve to rebuild
# curve2 is the reference curve
cmds.rebuildCurve( 'curve1', 'curve2', rt=2 )
# rebuild curve by removing all multiple interior knots
cmds.rebuildCurve( rt=3 )
# rebuild curve using the curvature of the curve
# to create more spans where curvature is higher
cmds.rebuildCurve( rt=4 )