Go to: Synopsis. Return value. Python examples.

Synopsis

dropoffLocator( float float string selectionList )

Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.

dropoffLocator is undoable, NOT queryable, and NOT editable.

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).

Return value

string[]Locator name(s)

Python examples

import maya.cmds as cmds

# create a wire deformer
#
cmds.polyPlane(w=24,h=24,sx=20,sy=20)
cmds.curve(d=3,p=[(-10, 0, 0),(-6, 0, 10),(-3, 0, -10),(10, 0, 0)],k=[0, 0, 0, 1, 1, 1])
cmds.select('pPlane1')
cmds.wire(w='curve1')

# add a locator at curve point 0.5, with envelope 2 and percent 1
#
cmds.select( 'curve1.u[0.5]', r=True )
cmds.dropoffLocator( 2.0, 1.0, 'wire1' )