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 |
fitRebuild(fr) |
boolean |
   |
|
If true use the least squares fit rebuild. Otherwise use the
convert method.
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 |
|
spans(s) |
int |
|
|
The number of spans in resulting curve Used only if rebuildType
is uniform.
Default: 4 |
|
degree(d) |
int |
|
|
The degree of the resulting curve 1 - linear, 2 - quadratic, 3
- cubic, 5 - quintic, 7 - heptic
Default: 3 |
|
tolerance(tol) |
linear |
|
|
The tolerance with which to rebuild.
Default: 0.01 |
|
endKnots(end) |
int |
|
|
End conditions for the curve 0 - uniform end knots, 1 -
multiple end knots,
Default: 0 |
|
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 |
|
keepEndPoints(kep) |
boolean |
|
|
If true, keep the endpoints the same.
Default: true |
|
keepTangents(kt) |
boolean |
|
|
If true, keep the end tangents the same.
Default: true |
|
keepControlPoints(kcp) |
boolean |
|
|
If true, the CVs will remain the same. This forces uniform
parameterization unless rebuildType is matchKnots.
Default: false |
|
smartSurfaceCurveRebuild(
scr) |
boolean |
|
|
If true, curve on surface is rebuild in 3D and 2D info is
kept
Default: false |
|
| 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. |
|
| Common flags |
name(n) |
string |
|
|
Name the resulting object |
|
constructionHistory(ch) |
boolean |
|
|
Turn the construction history on or off |
|
object(o) |
boolean |
|
|
Create the result, or just the dependency node |
|
replaceOriginal(rpo) |
boolean |
|
|
Create "in place" (i.e., replace) |
|
range(rn) |
boolean |
|
|
Force a curve range on complete input curve |
|
| 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 )