Go to: Synopsis. Return value. Flags. Python examples.
closeCurve( curve , [blendBias=float], [blendKnotInsertion=boolean],
[caching=boolean], [constructionHistory=boolean],
[curveOnSurface=boolean],
[name=string], [nodeState=int], [object=boolean], [parameter=float], [preserveShape=int], [replaceOriginal=boolean])
Note: Strings representing object names and
arguments must be separated by commas. This is not depicted in the
synopsis.
closeCurve is undoable, queryable, and editable.
The closeCurve command closes a curve, making it periodic. The
pathname to the newly closed curve and the name of the resulting
dependency node are returned. If a curve is not specified in the
command, then the first active curve will be used.
| string[] |
Object name and node name |
In query mode, return type is based on queried flag.
blendBias, blendKnotInsertion, caching, constructionHistory, curveOnSurface, name, nodeState,
object, parameter, preserveShape, replaceOriginal
| Long name (short name) |
Argument types |
Properties |
preserveShape(ps) |
int |
   |
|
0 - without preserving the shape 1 - preserve shape 2 -
blend
Default: 1 |
|
blendBias(bb) |
float |
|
|
Skew the result toward the first or the second curve depending
on the blend value being smaller or larger than 0.5.
Default: 0.5 |
|
blendKnotInsertion(bki) |
boolean |
|
|
If set to true, insert a knot in one of the original curves
(relative position given by the parameter attribute below) in order
to produce a slightly different effect.
Default: false |
|
parameter(p) |
float |
|
|
The parameter value for the positioning of the newly inserted
knot.
Default: 0.1 |
|
| 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) |
|
curveOnSurface(cos) |
boolean |
|
|
If possible, create 2D curve as a result |
|
| 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
cmds.closeCurve( 'curve1', ch=True, ps=True )
# Closes curve1 with history and by preserving shape. The result will
# be the name of the closed curve, and the name of the newly created
# dependency node.
cmds.closeCurve( 'curve1', ch=True, ps=False )
# Closes curve1 with history and will not preserve the shape of the
# curve.
cmds.closeCurve( 'curve1', ch=True, rpo=True )
# Closes curve1 with history and replaces the original curve with
# the closed one.