detachCurve

Go to: Synopsis. Return value. Flags. MEL examples.

Synopsis

detachCurve [-caching boolean] [-constructionHistory boolean] [-curveOnSurface boolean] [-keep boolean] [-name string] [-nodeState int] [-object boolean] [-parameter float] [-replaceOriginal boolean] curve

detachCurve is undoable, queryable, and editable.

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.

Return value

In query mode, return type is based on queried flag.

Flags

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 be used more than once in a command.

MEL examples

detachCurve -ch on -p 0.2 -replaceOriginal off curve1;
// 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.

detachCurve -ch on -replaceOriginal off curve1.ep[1];
// Detaches curve1 at its second edit point.

detachCurve -ch on -replaceOriginal off curve1.u[0.2];
// Detaches curve1 at parameter value 0.2

detachCurve -ch on -p 0.4 -k on -k off -rpo off curve1;
// 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.

detachCurve -ch on -p 0.2 -p 0.4 -rpo on curve1;
// 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).

detachCurve -ch on -p 0.2 -p 0.4 circle1;
// 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.