Go to: Synopsis. Return value. Flags. Python examples.
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
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.
|Long name (short name)||Argument types||Properties|
|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.arclen( 'curve1' ) # This command returns a float value that is the length of curve1 in # the current linear units. curveInfoNode = cmds.arclen('curve1', ch=True) cmds.expression( s= 'surface1.sx = %s.arcLength' % curveInfoNode ) # 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. # # Note the expression command still only creates MEL expressions, although they can # be called from Python.