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 |
|
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
|
|
preserveShape(ps)
|
int
|
|
|
0 - without preserving the shape
1 - preserve shape
2 - blend
Default: 1
|
|
Common flags |
constructionHistory(ch)
|
boolean
|
|
|
Turn the construction history on or off.
|
|
curveOnSurface(cos)
|
boolean
|
|
|
If possible, create 2D curve as a result.
|
|
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.
|
|
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
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.