pymel.core.modeling.detachCurve¶

detachCurve(*args, **kwargs)¶

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 -kflag. 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 -pflag. If you are specifying -kflags, then you must specify one, none or all -kflags. If you are specifying all -kflags, there must be one more -kflag than -pflags.

Flags:

Long Name / Short Name		Argument Types	Properties
caching / cch		bool
	Modifies the node caching mode. See the node documentation for more information. Note:For advanced users only.
constructionHistory / ch		bool
	Turn the construction history on or off.
curveOnSurface / cos		bool
	If possible, create 2D curve as a result.
frozen / fzn		bool
keep / k		bool
	Whether or not to keep a detached piece. This multi attribute should be one element larger than the parameter multi attribute. Default:true
name / n		unicode
	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.
nodeState / nds		int
	Modifies the node state. See the node documentation for more information. Note:For advanced users only. Flag can have multiple arguments, passed either as a tuple or a list.
object / o		bool
	Create the result, or just the dependency node.
parameter / p		float
	Parameter values to detach at Default:0.0 Common flags
replaceOriginal / rpo		bool
	Create in place(i.e., replace). Advanced flags

Derived from mel command maya.cmds.detachCurve

Example:

import pymel.core as pm

pm.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.

pm.detachCurve( 'curve1.ep[1]', ch=True, replaceOriginal=False )
# Detaches curve1 at its second edit point.

pm.detachCurve( 'curve1.u[0.2]', ch=True, replaceOriginal=False )
# Detaches curve1 at parameter value 0.2

pm.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.

pm.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).

pm.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.