pymel.core.animation.dropoffLocator

dropoffLocator(*args, **kwargs)

This command adds one or more dropoff locators to a wire curve, one for each selected curve point. The dropoff locators can be used to provide localized tuning of the wire deformation about the curve point. The arguments are two floats, the envelope and percentage, followed by the wire node name and then by the curve point(s).

Derived from mel command maya.cmds.dropoffLocator

Example:

import pymel.core as pm

# create a wire deformer
#
pm.polyPlane(w=24,h=24,sx=20,sy=20)
# Result: [nt.Transform(u'pPlane1'), nt.PolyPlane(u'polyPlane1')] #
pm.curve(d=3,p=[(-10, 0, 0),(-6, 0, 10),(-3, 0, -10),(10, 0, 0)],k=[0, 0, 0, 1, 1, 1])
# Result: nt.Transform(u'curve1') #
pm.select('pPlane1')
pm.wire(w='curve1')
# Result: [nt.Wire(u'wire1'), nt.Transform(u'curve1')] #

# add a locator at curve point 0.5, with envelope 2 and percent 1
#
pm.select( 'curve1.u[0.5]', r=True )
pm.dropoffLocator( 2.0, 1.0, 'wire1' )
# Result: [nt.DropoffLocator(u'curveShape1->locatorShape1')] #