Go to: Synopsis. Return value. Flags. MEL examples.
arclen [-constructionHistory boolean]
curve
arclen is undoable, queryable, and editable.
This command returns the arclength of a curve if the history
flag is not set (the default). If the history flag is set, a node
is created that can produce the arclength, and is connected and
its name returned. Having the construction history option on
makes this command useful for expressions.
| float | Length in non history mode. |
| string | Node name, in history mode. |
In query mode, return type is based on queried flag.
constructionHistory
| Long name (short name) |
Argument types |
Properties |
|
-constructionHistory(-ch)
|
boolean
|
|
|
Turn the construction history on or off (where applicable).
|
|
|
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.
|
arclen curve1;
// This command returns a float value that is the length of curve1 in
// the current linear units.
string $curveInfoNode = `arclen -ch on curve1`;
expression -s ("surface1.sx = " + $curveInfoNode + ".arcLength");
// The first command produces a curve info node for curve1 and returns
// the name of the curve info node. The second command shows how the
// arc length attribute of the curve info node can be used to set up
// an expression, ie. it drives one of the scale factors of surface1.