pymel.core.modeling.arclen

arclen(*args, **kwargs)

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.

Modifications:
  • returns a PyNode object for flags: constructionHistory
Flags:
Long name (short name) Argument Types Properties
caching (cch) bool  
   
constructionHistory (ch) bool ../../../_images/create.gif
 

Turn the construction history on or off (where applicable)Flag can appear in Create mode of commandFlag can have multiple arguments, passed either as a tuple or a list.

name (n) unicode  
   
nodeState (nds) int  
   

Derived from mel command maya.cmds.arclen

Example:

import pymel.core as pm

pm.arclen( 'curve1' )
# This command returns a float value that is the length of curve1 in
# the current linear units.

curveInfoNode = pm.arclen('curve1', ch=True)
pm.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.

Previous topic

pymel.core.modeling.arcLengthDimension

Next topic

pymel.core.modeling.attachCurve

Core

Core Modules

Other Modules

This Page