Go to: Synopsis. Return value. Flags. Python examples.
detachCurve(
curve
, [caching=boolean], [constructionHistory=boolean], [curveOnSurface=boolean], [keep=boolean], [name=string], [nodeState=int], [object=boolean], [parameter=float], [replaceOriginal=boolean])
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
detachCurve is undoable, queryable, and editable.
The detachCurve command detaches a curve into pieces, given a list
of parameter values. You can also specify which pieces to keep and
which to discard using the "-k" flag.
The names of the newly detached curve(s) is returned. If history is on,
then the name of the resulting dependency node is also returned.
You can use this command to open a periodic curve at a particular
parameter value. You would use this command with only one "-p" flag.
If you are specifying "-k" flags, then you must specify one, none
or all "-k" flags. If you are specifying all "-k" flags, there
must be one more "-k" flag than "-p" flags.
| string[] | Object name and node name |
In query mode, return type is based on queried flag.
caching, constructionHistory, curveOnSurface, keep, name, nodeState, object, parameter, replaceOriginal
| Long name (short name) |
Argument types |
Properties |
|
keep(k)
|
boolean
|
   
|
|
Whether or not to keep a detached piece. This multi attribute should be one element larger than the parameter multi attribute.
Default: true
|
|
parameter(p)
|
float
|
|
|
Parameter values to detach at
Default: 0.0
|
|
| 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.detachCurve( 'curve1', ch=True, p=0.2, replaceOriginal=False )
# Detaches curve1 at parameter value 0.2. The
# result is two curves and a detachCurve dependency node.
# The "-rpo" flag specifies that the original curve is not to be
# replaced; as a result a new curve is created for each curve piece.
# Note that if "k" flag is not used, then the default is that
# all pieces are kept.
cmds.detachCurve( 'curve1.ep[1]', ch=True, replaceOriginal=False )
# Detaches curve1 at its second edit point.
cmds.detachCurve( 'curve1.u[0.2]', ch=True, replaceOriginal=False )
# Detaches curve1 at parameter value 0.2
cmds.detachCurve( 'curve1', ch=True, p=0.4, k=(1 , 0), rpo=False )
# Detaches curve1 at parameter value 0.4 into two curves. Because of
# the "k" flags, two curves are created, but the second one is empty.
# A detachCurve dependency node is also returned.
cmds.detachCurve( 'curve1', ch=True, p=(0.2, 0.4), rpo=True )
# Detaches curve1 into three pieces. Because the "rpo" flag is on,
# the original curve is replaced with the first piece. The names
# of all curve pieces are returned. If curve1 is a result of history,
# then a dependency node is created and its output is connected as
# the input to curve1. If curve1 is not a result of construction
# history, then a dependency node is not created (even though the
# "ch" flag is on).
cmds.detachCurve( 'circle1', ch=True, p=(0.2, 0.4) )
# Detaches a periodic curve, circle1, at two places. Before
# the detach, the circle is periodic, with a start parameter of 0.0,
# and an end parameter of 8.0.
# The first parameter, 0.2, is used to move the start point of the curve,
# also called the "seam". The second parameter, 0.4, is used to perform
# a detach operation. The result is TWO curves only. The first curve
# has a parameter range of 0.2 to 0.4. The second curve has a parameter
# range of 0.4 to 8.2.